get_asset_group

Get all the stored fields of one Google Ads asset group.

Ask for the stored fields of one asset group of a Performance Max campaign. The agent reads the fields that AdCrunch stored from Google Ads for it.

Show me the “Performance Max — winter” asset group.

The agent reads the stored fields of that asset group. You see its name, its status and its campaign, in the words of Google Ads. Read your accounts shows the full job.

Reference

Available on:

Get all the stored fields of one Google Ads asset group, by its ad account and its id. AdCrunch stores the id, the name, the status and the campaign of an asset group. It does not store its headlines, its images or its audience signals. Each field has the value that Google Ads sent, with the names of Google Ads. It sends the payload that AdCrunch stored from the provider at the last ingestion, with the field names of the provider. Use it when a row of list_asset_groups does not hold the field that you need. To read the row of the provider now, use gads_list_asset_groups with ids set to the id. An ad account that your organization does not own, an id that AdCrunch does not store for that ad account, and a provider that has no asset groups each give not_found.

Input

Argument	Type	Required	Description
`advertiserId`	string	yes	The ad account that holds the asset group, prefixed `acc_`. It must belong to your organization. Each row of list_asset_groups gives it as `advertiserId`.
`id`	string	yes	The id that the provider gives the asset group, with no prefix. Each row of list_asset_groups gives it as `id`.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`assetGroup`	map of any	yes	The payload that AdCrunch stored from Google Ads for the asset group, with the keys of Google Ads: `id`, `name`, `status` and `campaignId`.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
payload_unavailable
forbidden
invalid_request
internal_error

Scope

The token must hold observe:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Read-only. The tool changes nothing.
Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "advertiserId": "acc_4829301756",
  "id": "6390218745"
}

The result, in structuredContent:

{
  "assetGroup": {
    "campaignId": "20993874561",
    "id": "6390218745",
    "name": "Performance Max — winter",
    "status": "ENABLED"
  }
}