ChangeLogs: list

Retrieves a list of change logs. This method supports paging. Try it now.

Request

HTTP request

GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/changeLogs

Parameters

Parameter name Value Description
Path parameters
profileId long User profile ID associated with this request.
Optional query parameters
action string Select only change logs with the specified action.

Acceptable values are:
  • "ACTION_ADD"
  • "ACTION_ASSIGN"
  • "ACTION_ASSOCIATE"
  • "ACTION_CREATE"
  • "ACTION_DELETE"
  • "ACTION_DISABLE"
  • "ACTION_EMAIL_TAGS"
  • "ACTION_ENABLE"
  • "ACTION_LINK"
  • "ACTION_MARK_AS_DEFAULT"
  • "ACTION_PUSH"
  • "ACTION_REMOVE"
  • "ACTION_SEND"
  • "ACTION_SHARE"
  • "ACTION_UNASSIGN"
  • "ACTION_UNLINK"
  • "ACTION_UPDATE"
ids long Select only change logs with these IDs.
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.
maxResults integer Maximum number of results to return. Acceptable values are 0 to 1000, inclusive. (Default: 1000)
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.
objectIds long Select only change logs with these object IDs.
objectType string Select only change logs with the specified object type.

Acceptable values are:
  • "OBJECT_ACCOUNT"
  • "OBJECT_ACCOUNT_BILLING_FEATURE"
  • "OBJECT_AD"
  • "OBJECT_ADVERTISER"
  • "OBJECT_ADVERTISER_GROUP"
  • "OBJECT_BILLING_ACCOUNT_GROUP"
  • "OBJECT_BILLING_FEATURE"
  • "OBJECT_BILLING_MINIMUM_FEE"
  • "OBJECT_BILLING_PROFILE"
  • "OBJECT_CAMPAIGN"
  • "OBJECT_CONTENT_CATEGORY"
  • "OBJECT_CREATIVE"
  • "OBJECT_CREATIVE_ASSET"
  • "OBJECT_CREATIVE_BUNDLE"
  • "OBJECT_CREATIVE_FIELD"
  • "OBJECT_CREATIVE_GROUP"
  • "OBJECT_DFA_SITE"
  • "OBJECT_EVENT_TAG"
  • "OBJECT_FLOODLIGHT_ACTIVITY_GROUP"
  • "OBJECT_FLOODLIGHT_ACTVITY"
  • "OBJECT_FLOODLIGHT_CONFIGURATION"
  • "OBJECT_FLOODLIGHT_DV360_LINK"
  • "OBJECT_INSTREAM_CREATIVE"
  • "OBJECT_LANDING_PAGE"
  • "OBJECT_MEDIA_ORDER"
  • "OBJECT_PLACEMENT"
  • "OBJECT_PLACEMENT_STRATEGY"
  • "OBJECT_PLAYSTORE_LINK"
  • "OBJECT_PROVIDED_LIST_CLIENT"
  • "OBJECT_RATE_CARD"
  • "OBJECT_REMARKETING_LIST"
  • "OBJECT_RICHMEDIA_CREATIVE"
  • "OBJECT_SD_SITE"
  • "OBJECT_SEARCH_LIFT_STUDY"
  • "OBJECT_SIZE"
  • "OBJECT_SUBACCOUNT"
  • "OBJECT_TARGETING_TEMPLATE"
  • "OBJECT_USER_PROFILE"
  • "OBJECT_USER_PROFILE_FILTER"
  • "OBJECT_USER_ROLE"
pageToken string Value of the nextPageToken from the previous result page.
searchString string Select only change logs whose object ID, user name, old or new values match the search string.
userProfileIds long Select only change logs with these user profile IDs.

Authorization

This request requires authorization with the following scope:

Scope
https://www.googleapis.com/auth/dfatrafficking

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "dfareporting#changeLogsListResponse",
  "nextPageToken": string,
  "changeLogs": [
    changeLogs Resource
  ]
}
Property name Value Description Notes
kind string Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLogsListResponse".
nextPageToken string Pagination token to be used for the next list operation.
changeLogs[] list Change log collection.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.