change_status

  • ChangeStatus describes the status of a returned resource and may have up to a 3-minute delay to reflect changes.

  • Fields from attributed resources like ad_group, asset, and campaign can be selected in queries, but will not segment metrics.

  • The change_status resource includes fields indicating the affected resource (e.g., change_status.ad_group, change_status.campaign), the last change time (change_status.last_change_date_time), and the status of the change (change_status.resource_status).

  • The type of the changed resource (change_status.resource_type) determines which resource-specific fields will be set.

Describes the status of returned resource. ChangeStatus could have up to 3 minutes delay to reflect a new change.

Attributed resources
ad_group
asset
asset_group
asset_set
campaign
campaign_budget
combined_audience
customer
shared_set

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.

change_status.ad_group

Field descriptionOutput only. The AdGroup affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.ad_group_ad

Field descriptionOutput only. The AdGroupAd affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.ad_group_asset

Field descriptionOutput only. The AdGroupAsset affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.ad_group_bid_modifier

Field descriptionOutput only. The AdGroupBidModifier affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.ad_group_criterion

Field descriptionOutput only. The AdGroupCriterion affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.asset

Field descriptionOutput only. The Asset affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.asset_group

Field descriptionOutput only. The AssetGroup affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.asset_set

Field descriptionOutput only. The AssetSet affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign

Field descriptionOutput only. The Campaign affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign_asset

Field descriptionOutput only. The CampaignAsset affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign_asset_set

Field descriptionOutput only. The CampaignAssetSet affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign_budget

Field descriptionOutput only. The CampaignBudget affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign_criterion

Field descriptionOutput only. The CampaignCriterion affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.campaign_shared_set

Field descriptionOutput only. The CampaignSharedSet affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.combined_audience

Field descriptionOutput only. The CombinedAudience affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.customer_asset

Field descriptionOutput only. The CustomerAsset affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.last_change_date_time

Field descriptionOutput only. Time at which the most recent change has occurred on this resource.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_status.resource_name

Field descriptionOutput only. The resource name of the change status. Change status resource names have the form: customers/{customer_id}/changeStatus/{change_status_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_status.resource_status

Field descriptionOutput only. Represents the status of the changed resource.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ChangeStatusOperationEnum.ChangeStatusOperation
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_status.resource_type

Field descriptionOutput only. Represents the type of the changed resource. This dictates what fields will be set. For example, for AD_GROUP, campaign and ad_group fields will be set.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v21.enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_status.shared_set

Field descriptionOutput only. The SharedSet affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse