广告组 → 获取单个
AI-generatedOverview
This node integrates with the Google Ads API to manage advertising campaigns, ad groups, and ads. Specifically, for the "广告组" (Ad Group) resource with the "获取单个" (Get Single) operation, it retrieves detailed information about a single ad group by its ID.
Common scenarios where this node is useful include:
- Fetching details of a specific ad group to analyze its status or configuration.
- Integrating Google Ads data into workflows for reporting or automation.
- Validating ad group existence or properties before performing updates or deletions.
Example: You want to retrieve the name, ID, and status of an ad group with a known ID to display in a dashboard or trigger further actions based on its status.
Properties
| Name | Meaning |
|---|---|
| 认证方式 | Authentication method to use. Options: OAuth2 (recommended), Service Account |
| 管理员客户ID | Manager Customer ID - the Google Ads manager account ID that manages the client accounts |
| 客户ID | Client Customer ID - the specific Google Ads customer account ID |
| 广告组ID | Ad Group ID - the unique identifier of the ad group to retrieve |
Output
The output JSON object contains the fields of the requested ad group:
id: The unique identifier of the ad group.name: The name of the ad group.status: The current status of the ad group (e.g., enabled, paused).
If the ad group is found, the node outputs a single JSON object representing it. If not found, no output is produced for that item.
No binary data output is involved in this operation.
Dependencies
- Requires valid Google Ads API credentials, either via OAuth2 or a service account.
- Needs appropriate scopes for Google Ads API access (
https://www.googleapis.com/auth/adwords). - Requires developer token and correct customer IDs configured in the credentials.
- Uses the
@htdangkhoa/google-adslibrary andgoogle-auth-libraryfor authentication and API calls.
Troubleshooting
- Authentication errors: Ensure the provided OAuth2 tokens or service account credentials are valid and have the necessary permissions.
- Invalid Customer IDs: Verify that the manager and client customer IDs are correct and accessible by the authenticated user.
- Ad Group Not Found: If no results are returned, confirm the ad group ID exists under the specified client account.
- API Quotas/Rate Limits: Google Ads API enforces quotas; hitting limits may cause errors. Implement retries or backoff as needed.
- Error messages typically include authentication failures, permission denials, or invalid resource names. Check credentials and parameter correctness.