Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
Send feedback
change_event
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition 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.
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 ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.asset
Field description Output only. The Asset affected by this change.
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.campaign
Field description Output only. The Campaign affected by this change.
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.change_date_time
Field description Output only. Time at which the change was committed on this resource.
Category ATTRIBUTEData Type DATEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.change_resource_name
Field description Output only. The Simply resource this change occurred on.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
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 ATTRIBUTEData 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.v26.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.changed_fields
Field description Output only. A list of fields that are changed in the returned resource.
Category ATTRIBUTEData Type MESSAGEType URL google.protobuf.FieldMask Filterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.client_type
Field description Output only. Where the change was made through.
Category ATTRIBUTEData 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.v26.enums.ChangeClientTypeEnum.ChangeClientType Filterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.new_resource
Field description Output only. The new resource after the change. Only changed fields will be
populated.
Category ATTRIBUTEData Type MESSAGEType URL google.ads.googleads.v26.resources.ChangeEvent.ChangedResource Filterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.old_resource
Field description Output only. The old resource before the change. Only changed fields will
be populated.
Category ATTRIBUTEData Type MESSAGEType URL google.ads.googleads.v26.resources.ChangeEvent.ChangedResource Filterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
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 ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
change_event.user_email
Field description Output only. The email of the user who made this change.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-14 UTC."],[],[]]
