DCM/DFA Reporting And Trafficking API . changeLogs

Instance Methods

get(profileId, id)

Gets one change log by ID.

list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)

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

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

get(profileId, id)
Gets one change log by ID.

Args:
  profileId: string, User profile ID associated with this request. (required)
  id: string, Change log ID. (required)

Returns:
  An object of the form:

    { # Describes a change that a user has made to a resource.
    "changeTime": "A String", # Time when the object was modified.
    "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
    "subaccountId": "A String", # Subaccount ID of the modified object.
    "userProfileId": "A String", # ID of the user who modified the object.
    "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
    "newValue": "A String", # New value of the object field.
    "userProfileName": "A String", # User profile name of the user who modified the object.
    "fieldName": "A String", # Field name of the object which changed.
    "oldValue": "A String", # Old value of the object field.
    "action": "A String", # Action which caused the change.
    "transactionId": "A String", # 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.
    "objectType": "A String", # Object type of the change log.
    "id": "A String", # ID of this change log.
    "accountId": "A String", # Account ID of the modified object.
  }
list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)
Retrieves a list of change logs. This method supports paging.

Args:
  profileId: string, User profile ID associated with this request. (required)
  objectType: string, Select only change logs with the specified object type.
    Allowed values
      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 - 
  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.
  pageToken: string, Value of the nextPageToken from the previous result page.
  maxResults: integer, Maximum number of results to return.
  action: string, Select only change logs with the specified action.
    Allowed values
      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 - 
  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.
  searchString: string, Select only change logs whose object ID, user name, old or new values match the search string.
  userProfileIds: string, Select only change logs with these user profile IDs. (repeated)
  ids: string, Select only change logs with these IDs. (repeated)
  objectIds: string, Select only change logs with these object IDs. (repeated)

Returns:
  An object of the form:

    { # Change Log List Response
    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
    "kind": "dfareporting#changeLogsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLogsListResponse".
    "changeLogs": [ # Change log collection.
      { # Describes a change that a user has made to a resource.
        "changeTime": "A String", # Time when the object was modified.
        "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
        "subaccountId": "A String", # Subaccount ID of the modified object.
        "userProfileId": "A String", # ID of the user who modified the object.
        "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
        "newValue": "A String", # New value of the object field.
        "userProfileName": "A String", # User profile name of the user who modified the object.
        "fieldName": "A String", # Field name of the object which changed.
        "oldValue": "A String", # Old value of the object field.
        "action": "A String", # Action which caused the change.
        "transactionId": "A String", # 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.
        "objectType": "A String", # Object type of the change log.
        "id": "A String", # ID of this change log.
        "accountId": "A String", # Account ID of the modified object.
      },
    ],
  }
list_next(previous_request, previous_response)
Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.