Learn more about migrating to the Google Ads API by watching our latest webinar

change_event

Describes the granular change of returned resource of certain resource types. Changes made through UI, API and new versions of Editor by external users (including external users, and internal users that can be shown externally) in the past 30 days will be shown. The change shows the old values of the changed fields before the change and the new values right after the change. ChangeEvent could have up to 3 minutes delay to reflect a new change.

Attributed resources
ad_group
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 descriptionOutput only. The AdGroup affected by this change.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_event.campaign

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

change_event.change_date_time

Field descriptionOutput only. Time at which the change was committed on this resource.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_event.change_resource_name

Field descriptionOutput only. The Simply resource this change occurred on.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

change_event.change_resource_type

Field descriptionOutput only. The type of the changed resource. This dictates what resource will be set in old_resource and new_resource.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v6.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_event.changed_fields

Field descriptionOutput only. A list of fields that are changed in the returned resource.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.protobuf.FieldMask
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

change_event.client_type

Field descriptionOutput only. Where the change was made through.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v6.enums.ChangeClientTypeEnum.ChangeClientType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_event.feed

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

change_event.feed_item

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

change_event.new_resource

Field descriptionOutput only. The new resource after the change. Only changed fields will be populated.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v6.resources.ChangeEvent.ChangedResource
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

change_event.old_resource

Field descriptionOutput only. The old resource before the change. Only changed fields will be populated.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v6.resources.ChangeEvent.ChangedResource
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

change_event.resource_change_operation

Field descriptionOutput only. The operation on the changed resource.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v6.enums.ResourceChangeOperationEnum.ResourceChangeOperation
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

change_event.resource_name

Field descriptionOutput only. The resource name of the change event. Change event resource names have the form: `customers/{customer_id}/changeEvent/{timestamp_micros}~{command_index}~{mutate_index}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

change_event.user_email

Field descriptionOutput only. The email of the user who made this change.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse