Page Summary
-
This method retrieves a list of change logs and supports paging.
-
The HTTP request uses a GET method with a URL that includes a required path parameter for the user profile ID.
-
The request supports various optional query parameters to filter the results, such as IDs, user profile IDs, search string, object type, action, and time range.
-
The request body must be empty.
-
The response body contains a list of change logs, a kind identifier, and a next page token for pagination.
-
This method requires the
https://www.googleapis.com/auth/dfatraffickingOAuth scope for authorization.
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- ObjectType
- Action
- Try it!
Retrieves a list of change logs. This method supports paging .
HTTP request
GET https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/{profileId}/changeLogs
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
profileId
|
User profile ID associated with this request. |
Query parameters
| Parameters | |
|---|---|
ids[]
|
Select only change logs with these IDs. |
userProfileIds[]
|
Select only change logs with these user profile IDs. |
searchString
|
Select only change logs whose object ID, user name, old or new values match the search string. |
objectType
|
Select only change logs with the specified object type. |
action
|
Select only change logs with the specified action. |
minChangeTime
|
Select only change logs whose change time is after the specified .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
|
Maximum number of results to return. |
maxChangeTime
|
Select only change logs whose change time is before the specified .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 . 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[]
|
Select only change logs with these object IDs. |
pageToken
|
Value of the from the previous result page. |
Request body
The request body must be empty.
Response body
Change Log changeLogs.list Response
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"kind"
:
string
,
"nextPageToken"
:
string
,
"changeLogs"
:
[
{
object (
|
| Fields | |
|---|---|
kind
|
Identifies what kind of resource this is. Value: the fixed string . |
nextPageToken
|
Pagination token to be used for the next list operation. |
changeLogs[]
|
Change log collection. |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/dfatrafficking
ObjectType
| Enums | |
|---|---|
OBJECT_ADVERTISER
|
|
OBJECT_FLOODLIGHT_CONFIGURATION
|
|
OBJECT_AD
|
|
OBJECT_FLOODLIGHT_ACTVITY
|
|
OBJECT_CAMPAIGN
|
|
OBJECT_FLOODLIGHT_ACTIVITY_GROUP
|
|
OBJECT_CREATIVE
|
|
OBJECT_PLACEMENT
|
|
OBJECT_DFA_SITE
|
|
OBJECT_USER_ROLE
|
|
OBJECT_USER_PROFILE
|
|
OBJECT_ADVERTISER_GROUP
|
|
OBJECT_ACCOUNT
|
|
OBJECT_SUBACCOUNT
|
|
OBJECT_RICHMEDIA_CREATIVE
|
|
OBJECT_INSTREAM_CREATIVE
|
|
OBJECT_MEDIA_ORDER
|
|
OBJECT_CONTENT_CATEGORY
|
|
OBJECT_PLACEMENT_STRATEGY
|
|
OBJECT_SD_SITE
|
|
OBJECT_SIZE
|
|
OBJECT_CREATIVE_GROUP
|
|
OBJECT_CREATIVE_ASSET
|
|
OBJECT_USER_PROFILE_FILTER
|
|
OBJECT_LANDING_PAGE
|
|
OBJECT_CREATIVE_FIELD
|
|
OBJECT_REMARKETING_LIST
|
|
OBJECT_PROVIDED_LIST_CLIENT
|
|
OBJECT_EVENT_TAG
|
|
OBJECT_CREATIVE_BUNDLE
|
|
OBJECT_BILLING_ACCOUNT_GROUP
|
|
OBJECT_BILLING_FEATURE
|
|
OBJECT_RATE_CARD
|
|
OBJECT_ACCOUNT_BILLING_FEATURE
|
|
OBJECT_BILLING_MINIMUM_FEE
|
|
OBJECT_BILLING_PROFILE
|
|
OBJECT_PLAYSTORE_LINK
|
|
OBJECT_TARGETING_TEMPLATE
|
|
OBJECT_SEARCH_LIFT_STUDY
|
|
OBJECT_FLOODLIGHT_DV360_LINK
|
|
OBJECT_ADVERTISER_CUSTOMER_LINK
|
|
OBJECT_CONVERSION_DOMAIN
|
|
OBJECT_ACCOUNT_CONVERSION_DOMAIN
|
|
Action
| Enums | |
|---|---|
ACTION_CREATE
|
|
ACTION_UPDATE
|
|
ACTION_DELETE
|
|
ACTION_ENABLE
|
|
ACTION_DISABLE
|
|
ACTION_ADD
|
|
ACTION_REMOVE
|
|
ACTION_MARK_AS_DEFAULT
|
|
ACTION_ASSOCIATE
|
|
ACTION_ASSIGN
|
|
ACTION_UNASSIGN
|
|
ACTION_SEND
|
|
ACTION_LINK
|
|
ACTION_UNLINK
|
|
ACTION_PUSH
|
|
ACTION_EMAIL_TAGS
|
|
ACTION_SHARE
|
|
