change_event

Help me build a query

Describes the granular change of returned resources of certain resource types. Changes made through the UI or API in the past 30 days are included. Previous and new values of the changed fields are shown. ChangeEvent could have up to 3 minutes delay to reflect a new change.

Attributed resources
ad_group
asset
campaign
customer
feed
feed_item

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_event.ad_group Field description Output only. The AdGroup affected by this change. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.asset Field description Output only. The Asset affected by this change. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.campaign Field description Output only. The Campaign affected by this change. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.change_date_time Field description Output only. Time at which the change was committed on this resource. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable True Selectable True Sortable True Repeated False

change_event.change_resource_name Field description Output only. The Simply resource this change occurred on. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable False Selectable True Sortable False Repeated False

change_event.change_resource_type Field description Output only. The type of the changed resource. This dictates what resource will be set in old_resource and new_resource. Category ATTRIBUTE Data Type ENUM AD AD_GROUP AD_GROUP_AD AD_GROUP_ASSET AD_GROUP_BID_MODIFIER AD_GROUP_CRITERION AD_GROUP_FEED ASSET ASSET_SET ASSET_SET_ASSET CAMPAIGN CAMPAIGN_ASSET CAMPAIGN_ASSET_SET CAMPAIGN_BUDGET CAMPAIGN_CRITERION CAMPAIGN_FEED CUSTOMER_ASSET FEED FEED_ITEM UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType Filterable True Selectable True Sortable True Repeated False

change_event.changed_fields Field description Output only. A list of fields that are changed in the returned resource. Category ATTRIBUTE Data Type MESSAGE Type URL google.protobuf.FieldMask Filterable False Selectable True Sortable False Repeated False

change_event.client_type Field description Output only. Where the change was made through. Category ATTRIBUTE Data Type ENUM GOOGLE_ADS_API GOOGLE_ADS_AUTOMATED_RULE GOOGLE_ADS_BULK_UPLOAD GOOGLE_ADS_EDITOR GOOGLE_ADS_MOBILE_APP GOOGLE_ADS_RECOMMENDATIONS GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION GOOGLE_ADS_SCRIPTS GOOGLE_ADS_WEB_CLIENT INTERNAL_TOOL OTHER SEARCH_ADS_360_POST SEARCH_ADS_360_SYNC UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v18.enums.ChangeClientTypeEnum.ChangeClientType Filterable True Selectable True Sortable False Repeated False

change_event.feed Field description Output only. The Feed affected by this change. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.feed_item Field description Output only. The FeedItem affected by this change. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.new_resource Field description Output only. The new resource after the change. Only changed fields will be populated. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v18.resources.ChangeEvent.ChangedResource Filterable False Selectable True Sortable False Repeated False

change_event.old_resource Field description Output only. The old resource before the change. Only changed fields will be populated. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v18.resources.ChangeEvent.ChangedResource Filterable False Selectable True Sortable False Repeated False

change_event.resource_change_operation Field description Output only. The operation on the changed resource. Category ATTRIBUTE Data Type ENUM CREATE REMOVE UNKNOWN UNSPECIFIED UPDATE Type URL google.ads.googleads.v18.enums.ResourceChangeOperationEnum.ResourceChangeOperation Filterable True Selectable True Sortable True Repeated False

change_event.resource_name Field description Output only. The resource name of the change event. Change event resource names have the form: customers/{customer_id}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

change_event.user_email Field description Output only. The email of the user who made this change. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False