change_status

  • ChangeStatus reflects the status of returned resources and can have up to a 3-minute delay.

  • Attributed resources for ChangeStatus include various Google Ads entities like ad groups, campaigns, assets, and customers.

  • Fields from attributed resources can be selected in SELECT and WHERE clauses but will not segment metrics.

  • ChangeStatus fields provide details such as the affected resource, the time of the last change, the status of the change (ADDED, CHANGED, REMOVED), the type of resource, and the resource name.

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.v22.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.v22.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