Select only change logs with the specified action.
minChangeTime
string
Select only change logs whose change time is after the specified
minChangeTime
.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is "2015-07-18T22:54:00-04:00". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.
maxResults
integer
Maximum number of results to return.
maxChangeTime
string
Select only change logs whose change time is before the specified
maxChangeTime
.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is
"2015-07-18T22:54:00-04:00"
. In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.
[[["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 2025-09-02 UTC."],[[["\u003cp\u003eRetrieves a list of change logs, supporting paging for easier navigation.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of change logs by various criteria such as IDs, user profiles, object types, actions, and time ranges.\u003c/p\u003e\n"],["\u003cp\u003eProvides detailed information within the response, including change log details and pagination for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/dfatrafficking\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eOffers comprehensive enums for ObjectType and Action, allowing granular control over the retrieved change logs.\u003c/p\u003e\n"]]],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ChangeLogsListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves a list of change logs. This method supports [paging](/doubleclick-advertisers/trafficking_tasks#list).\n\nHTTP request\n\n`GET https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/changeLogs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `profileId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` User profile ID associated with this request. |\n\nQuery parameters\n\n| Parameters ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ids[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Select only change logs with these IDs. |\n| `userProfileIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Select only change logs with these user profile IDs. |\n| `searchString` | `string` Select only change logs whose object ID, user name, old or new values match the search string. |\n| `objectType` | `enum (`[ObjectType](/doubleclick-advertisers/rest/Shared.Types/ObjectType)`)` Select only change logs with the specified object type. |\n| `action` | `enum (`[Action](/doubleclick-advertisers/rest/Shared.Types/Action)`)` Select only change logs with the specified action. |\n| `minChangeTime` | `string` Select only change logs whose change time is after the specified `minChangeTime` .The time should be formatted as an [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is \"2015-07-18T22:54:00-04:00\". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset. |\n| `maxResults` | `integer` Maximum number of results to return. |\n| `maxChangeTime` | `string` Select only change logs whose change time is before the specified `maxChangeTime` .The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is `\"2015-07-18T22:54:00-04:00\"` . In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset. |\n| `objectIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Select only change logs with these object IDs. |\n| `pageToken` | `string` Value of the `nextPageToken` from the previous result page. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Change Log changeLogs.list Response\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"changeLogs\": [ { object (/doubleclick-advertisers/rest/v4/changeLogs#ChangeLog) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#changeLogsListResponse\"` . |\n| `nextPageToken` | `string` Pagination token to be used for the next list operation. |\n| `changeLogs[]` | `object (`[ChangeLog](/doubleclick-advertisers/rest/v4/changeLogs#ChangeLog)`)` Change log collection. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/dfatrafficking`"]]