asset_group_asset

  • The AssetGroupAsset resource links an asset to an asset group in the Google Ads API.

  • You can select fields from the AssetGroupAsset resource and its attributed resources in queries.

  • When querying asset_group_asset, you can select resource fields, segments, and metrics.

  • Attributed resource fields will not segment metrics when asset_group_asset is in the FROM clause.

AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.

Attributed resources
asset
asset_group
campaign
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields of asset_group_asset. However, when you specify asset_group_asset in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when asset_group_asset is specified in the FROM clause.

Is asset_group_asset specified in the FROM clause of your query?

asset_group_asset.asset

Field description

Immutable. The asset which this asset group asset is linking.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_asset.asset_group

Field description

Immutable. The asset group which this asset group asset is linking.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_asset.field_type

Field description

The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetFieldTypeEnum.AssetFieldType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.performance_label

Field description

Output only. The performance of this asset group asset.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.policy_summary.approval_status

Field description

The overall approval status, which is calculated based on the status of its individual policy topic entries.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.policy_summary.policy_topic_entries

Field description

The list of policy findings.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v20.common.PolicyTopicEntry
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset_group_asset.policy_summary.review_status

Field description

Where in the review process the resource is.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.PolicyReviewStatusEnum.PolicyReviewStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.primary_status

Field description

Output only. Provides the PrimaryStatus of this asset link. Primary status is meant essentially to differentiate between the plain "status" field, which has advertiser set values of enabled, paused, or removed. The primary status takes into account other signals (for assets its mainly policy and quality approvals) to come up with a more comprehensive status to indicate its serving state.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetLinkPrimaryStatusEnum.AssetLinkPrimaryStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.primary_status_details

Field description

Output only. Provides the details of the primary status and its associated reasons.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v20.common.AssetLinkPrimaryStatusDetails
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

asset_group_asset.primary_status_reasons

Field description

Output only. Provides a list of reasons for why an asset is not serving or not serving at full capacity.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetLinkPrimaryStatusReasonEnum.AssetLinkPrimaryStatusReason
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

asset_group_asset.resource_name

Field description

Immutable. The resource name of the asset group asset. Asset group asset resource name have the form: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

asset_group_asset.source

Field description

Output only. Source of the asset group asset.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetSourceEnum.AssetSource
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

asset_group_asset.status

Field description

The status of the link between an asset and asset group.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v20.enums.AssetLinkStatusEnum.AssetLinkStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

segments.date

Field description

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.day_of_week

Field description

Day of the week, for example, MONDAY.

CategorySEGMENT
Data Type
Type URLgoogle.ads.googleads.v20.enums.DayOfWeekEnum.DayOfWeek
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.month

Field description

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.quarter

Field description

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.week

Field description

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

CategorySEGMENT
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

segments.year

Field description

Year, formatted as yyyy.

CategorySEGMENT
Data TypeINT32
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

metrics.conversions

Field description

The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

CategoryMETRIC
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

metrics.conversions_value

Field description

The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

CategoryMETRIC
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with

metrics.value_per_conversion

Field description

The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

CategoryMETRIC
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable with