The DCM/DFA Reporting and Trafficking API v2.7 is deprecated and will be sunset on November 30th, 2017. All users must migrate to a newer API version by that date.

ChangeLogs: list

Requires authorization

Retrieves a list of change logs. This method supports paging.

Request

HTTP request

GET https://www.googleapis.com/dfareporting/v2.8/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 before 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_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 (read more about authentication and authorization).

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

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.

Send feedback about...

DoubleClick Campaign Manager
DoubleClick Campaign Manager