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. It supports operations such as retrieving, creating, updating, and deleting these entities. The node is useful for automating Google Ads management tasks within workflows, enabling marketers and advertisers to programmatically control their ad assets.

For the specific Resource "广告系列" (Campaign) and Operation "获取单个" (Get Single), the node fetches detailed information about a single advertising campaign by its ID. This is beneficial when you want to retrieve the current status, name, or other details of a particular campaign for reporting, auditing, or further processing.

Practical example:

  • Automatically fetch a campaign's details before updating its budget or status in a workflow.
  • Retrieve campaign info to generate reports or trigger alerts based on campaign status.

Properties

Name Meaning
认证方式 Authentication method to use: OAuth2 (recommended) or Service Account
管理员客户ID Manager Customer ID (required string) — The Google Ads manager account customer ID
客户ID Client Customer ID (required string) — The specific client account customer ID
广告系列ID Campaign ID (required string) — The unique identifier of the campaign to retrieve

Output

The output JSON object contains the fields of the requested campaign, specifically:

  • campaign.id: The unique identifier of the campaign.
  • campaign.name: The name of the campaign.
  • campaign.status: The current status of the campaign (e.g., enabled, paused).

Example output JSON:

{
  "id": "1234567890",
  "name": "Spring Sale Campaign",
  "status": "ENABLED"
}

No binary data output is produced by this operation.

Dependencies

  • Requires valid Google Ads API credentials, either via OAuth2 or a Service Account with appropriate permissions.
  • Needs configuration of an API key credential including developer token, customer IDs, and authentication tokens.
  • Uses the Google Ads API client library and Google Auth Library internally.

Troubleshooting

  • Authentication errors:
    Ensure that the provided OAuth2 tokens or service account credentials are valid and have sufficient permissions to access the specified customer accounts.

  • Invalid campaign ID:
    If the campaign ID does not exist or is incorrect, the node will return no results. Verify the campaign ID is correct and belongs to the specified client customer.

  • API quota limits:
    Exceeding Google Ads API quotas may cause errors. Monitor usage and apply for higher quotas if necessary.

  • Network or connectivity issues:
    Temporary network failures can cause request errors. Retrying the operation may resolve transient issues.

Links and References

Discussion