Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on January 29th at 10:00 AM EST! We will discuss the new features added in v23 of the Google Ads API.
ChangeEvent
Stay organized with collections
Save and categorize content based on your preferences.
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.
codeProto definition
| Fields |
ad_group
|
string
Output only. The AdGroup affected by this change.
|
asset
|
string
Output only. The Asset affected by this change.
|
campaign
|
string
Output only. The Campaign affected by this change.
|
change_date_time
|
string
Output only. Time at which the change was committed on this resource.
|
change_resource_name
|
string
Output only. The Simply resource this change occurred on.
|
change_resource_type
|
ChangeEventResourceType
Output only. The type of the changed resource. This dictates what resource will be set in old_resource and new_resource.
|
changed_fields
|
FieldMask
Output only. A list of fields that are changed in the returned resource.
|
client_type
|
ChangeClientType
Output only. Where the change was made through.
|
new_resource
|
ChangedResource
Output only. The new resource after the change. Only changed fields will be populated.
|
old_resource
|
ChangedResource
Output only. The old resource before the change. Only changed fields will be populated.
|
resource_change_operation
|
ResourceChangeOperation
Output only. The operation on the changed resource.
|
resource_name
|
string
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}
|
user_email
|
string
Output only. The email of the user who made this change.
|
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-01-22 UTC.
[[["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-01-22 UTC."],[],[]]