Google Ads Advanced icon

Google Ads Advanced

使用 Google Ads API

Actions16

广告系列 → 修改预算

AI-generated

Overview

This node integrates with the Google Ads API to manage advertising campaigns, ad groups, and ads. Specifically, for the "广告系列" (Campaign) resource and the "修改预算" (Update Budget) operation, it allows users to update the budget amount of an existing campaign budget by specifying the budget ID and the new amount in micros (1 unit = 1,000,000 micros).

Common scenarios where this node is beneficial include:

  • Dynamically adjusting campaign budgets based on performance metrics or external triggers.
  • Automating budget updates across multiple campaigns without manual intervention.
  • Integrating budget management into broader marketing automation workflows.

Example: Automatically increase the budget of a high-performing campaign during peak sales periods by updating the budget amount via this node.

Properties

Name Meaning
认证方式 Authentication method to connect to Google Ads API. Options: OAuth2 (recommended), Service Account
管理员客户ID Manager Customer ID - the Google Ads manager account identifier
客户ID Client Customer ID - the specific Google Ads client account identifier
预算ID Budget ID - the identifier of the campaign budget to be updated
预算金额(微元) Budget Amount in micros - the new budget amount specified in micros (1 yuan = 1,000,000 micros)

Output

The node outputs JSON objects representing the response from the Google Ads API mutation operation that updates the campaign budget. The output typically includes details about the updated budget resource, such as its resource name and updated fields.

If the update is successful, the output JSON contains the mutation operation response confirming the budget update.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Google Ads API credentials, either via OAuth2 or a service account.
  • Needs proper configuration of authentication credentials within n8n.
  • Uses the @htdangkhoa/google-ads library and google-auth-library for API communication and authentication.
  • Requires network access to Google Ads API endpoints.
  • The user must have appropriate permissions on the Google Ads account to modify campaign budgets.

Troubleshooting

  • Authentication errors: Ensure that the provided OAuth2 tokens or service account credentials are valid and have the necessary scopes (https://www.googleapis.com/auth/adwords).
  • Invalid Budget ID: If the budget ID does not exist or is incorrect, the API will return an error. Verify the budget ID before running the node.
  • Insufficient permissions: The authenticated user/account must have permission to update campaign budgets.
  • AmountMicros format: The budget amount must be specified as an integer in micros (e.g., 1,000,000 micros = 1 unit of currency). Providing invalid or zero values may cause errors.
  • API quota limits: Exceeding Google Ads API quotas can result in errors; monitor usage accordingly.
  • Network issues: Connectivity problems can cause failures; ensure stable internet connection.

If the node encounters an error and "Continue On Fail" is enabled, it will output the error message in the JSON under an error field instead of stopping execution.

Links and References

Discussion