List
|
|||||
|
|
Retrieves a list of change logs. This method supports paging
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your DoubleClick Campaign Manager's (DCM) display ad campaigns
Input
This building block consumes 11 input parameters
Name | Format | Description |
---|---|---|
profileId Required |
INTEGER |
User profile ID associated with this request |
action |
ENUMERATION |
Select only change logs with the specified action |
ids |
INTEGER |
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 |
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 |
INTEGER |
Select only change logs with these object IDs |
objectType |
ENUMERATION |
Select only change logs with the specified object type |
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 |
INTEGER |
Select only change logs with these user profile IDs |
= Parameter name
= Format
profileId INTEGER Required User profile ID associated with this request |
action ENUMERATION Select only change logs with the specified action |
ids INTEGER 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 |
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 INTEGER Select only change logs with these object IDs |
objectType ENUMERATION Select only change logs with the specified object type |
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 INTEGER Select only change logs with these user profile IDs |
Output
This building block provides 17 output parameters
Name | Format | Description |
---|---|---|
changeLogs[] |
OBJECT |
Describes a change that a user has made to a resource |
changeLogs[].accountId |
INTEGER |
Account ID of the modified object |
changeLogs[].action |
STRING |
Action which caused the change |
changeLogs[].changeTime |
DATE_TIME |
Time when the object was modified |
changeLogs[].fieldName |
STRING |
Field name of the object which changed |
changeLogs[].id |
INTEGER |
ID of this change log |
changeLogs[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog" |
changeLogs[].newValue |
STRING |
New value of the object field |
changeLogs[].objectId |
INTEGER |
ID of the object of this change log. The object could be a campaign, placement, ad, or other type |
changeLogs[].objectType |
STRING |
Object type of the change log |
changeLogs[].oldValue |
STRING |
Old value of the object field |
changeLogs[].subaccountId |
INTEGER |
Subaccount ID of the modified object |
changeLogs[].transactionId |
INTEGER |
Transaction ID of this change log. When a single API call results in many changes, each change will have a separate ID in the change log but will share the same transactionId |
changeLogs[].userProfileId |
INTEGER |
ID of the user who modified the object |
changeLogs[].userProfileName |
STRING |
User profile name of the user who modified the object |
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 |
= Parameter name
= Format
changeLogs[] OBJECT Describes a change that a user has made to a resource |
changeLogs[].accountId INTEGER Account ID of the modified object |
changeLogs[].action STRING Action which caused the change |
changeLogs[].changeTime DATE_TIME Time when the object was modified |
changeLogs[].fieldName STRING Field name of the object which changed |
changeLogs[].id INTEGER ID of this change log |
changeLogs[].kind STRING Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog" |
changeLogs[].newValue STRING New value of the object field |
changeLogs[].objectId INTEGER ID of the object of this change log. The object could be a campaign, placement, ad, or other type |
changeLogs[].objectType STRING Object type of the change log |
changeLogs[].oldValue STRING Old value of the object field |
changeLogs[].subaccountId INTEGER Subaccount ID of the modified object |
changeLogs[].transactionId INTEGER Transaction ID of this change log. When a single API call results in many changes, each change will have a separate ID in the change log but will share the same transactionId |
changeLogs[].userProfileId INTEGER ID of the user who modified the object |
changeLogs[].userProfileName STRING User profile name of the user who modified the object |
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 |