广告 → 获取多个
AI-generatedOverview
This node integrates with the Google Ads API to manage advertising campaigns, ad groups, and ads. Specifically, for the "广告" (Ad) resource with the "获取多个" (Get All) operation, it retrieves multiple ads under a specified ad group.
Common scenarios where this node is useful include:
- Fetching all ads within a particular ad group to analyze their status or details.
- Automating reporting workflows by extracting ad data regularly.
- Integrating Google Ads data into other systems or dashboards.
For example, a marketing analyst could use this node to pull all active ads from a specific ad group to evaluate performance or compliance.
Properties
| Name | Meaning |
|---|---|
| 认证方式 | Authentication method to access Google Ads API. Options: OAuth2 (recommended), Service Account |
| 管理员客户ID | Manager Customer ID - the Google Ads manager account identifier (e.g., "9998887777") |
| 客户ID | Client Customer ID - the specific client account identifier under the manager (e.g., "6665554444") |
| 广告组ID | Ad Group ID - the identifier of the ad group whose ads are to be retrieved |
| 其他选项 | Additional options for filtering ads when retrieving them |
| └─ 按状态筛选广告 | Filter ads by status. Options: 全部 (all), 启用 (ENABLED), 暂停 (PAUSED), 移除 (REMOVED) |
Output
The output is an array of JSON objects, each representing an ad retrieved from the specified ad group. Each object contains fields such as:
ad_group_ad.ad.id: The unique identifier of the ad.ad_group_ad.ad.name: The name of the ad.ad_group_ad.status: The current status of the ad (e.g., ENABLED, PAUSED).
If the node encounters errors during execution and "Continue On Fail" is enabled, error messages will be included in the output JSON under an error field.
The node does not output binary data.
Dependencies
- Requires valid Google Ads API credentials, either via OAuth2 or a service account.
- Needs appropriate permissions on the Google Ads accounts specified by the Manager Customer ID and Client Customer ID.
- Uses the Google Ads API client libraries and Google authentication libraries.
- Requires configuration of credentials in n8n with necessary tokens or keys.
Troubleshooting
- Authentication Errors: If the node fails to authenticate, verify that the provided OAuth2 tokens or service account credentials are correct and have sufficient permissions.
- Invalid IDs: Ensure that the Manager Customer ID, Client Customer ID, and Ad Group ID are accurate and correspond to existing entities in Google Ads.
- API Quotas/Rate Limits: Google Ads API enforces quotas; hitting these limits may cause errors. Consider implementing retries or reducing request frequency.
- Empty Results: If no ads are returned, check if the ad group actually contains ads matching the filter criteria (e.g., status).
- Error Messages: Errors thrown by the node will typically include messages from the Google Ads API. Review these messages for hints on misconfiguration or invalid parameters.