• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5  margin: 0;
6  padding: 0;
7  border: 0;
8  font-weight: inherit;
9  font-style: inherit;
10  font-size: 100%;
11  font-family: inherit;
12  vertical-align: baseline;
13}
14
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50  border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54  margin-top: 0.5em;
55}
56
57.firstline {
58  margin-left: 2 em;
59}
60
61.method  {
62  margin-top: 1em;
63  border: solid 1px #CCC;
64  padding: 1em;
65  background: #EEE;
66}
67
68.details {
69  font-weight: bold;
70  font-size: 14px;
71}
72
73</style>
74
75<h1><a href="dfareporting_v3_1.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v3_1.changeLogs.html">changeLogs</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#get">get(profileId, id)</a></code></p>
79<p class="firstline">Gets one change log by ID.</p>
80<p class="toc_element">
81  <code><a href="#list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</a></code></p>
82<p class="firstline">Retrieves a list of change logs. This method supports paging.</p>
83<p class="toc_element">
84  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88    <code class="details" id="get">get(profileId, id)</code>
89  <pre>Gets one change log by ID.
90
91Args:
92  profileId: string, User profile ID associated with this request. (required)
93  id: string, Change log ID. (required)
94
95Returns:
96  An object of the form:
97
98    { # Describes a change that a user has made to a resource.
99    "changeTime": "A String", # Time when the object was modified.
100    "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
101    "subaccountId": "A String", # Subaccount ID of the modified object.
102    "userProfileId": "A String", # ID of the user who modified the object.
103    "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
104    "newValue": "A String", # New value of the object field.
105    "userProfileName": "A String", # User profile name of the user who modified the object.
106    "fieldName": "A String", # Field name of the object which changed.
107    "oldValue": "A String", # Old value of the object field.
108    "action": "A String", # Action which caused the change.
109    "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.
110    "objectType": "A String", # Object type of the change log.
111    "id": "A String", # ID of this change log.
112    "accountId": "A String", # Account ID of the modified object.
113  }</pre>
114</div>
115
116<div class="method">
117    <code class="details" id="list">list(profileId, objectType=None, maxChangeTime=None, pageToken=None, maxResults=None, action=None, minChangeTime=None, searchString=None, userProfileIds=None, ids=None, objectIds=None)</code>
118  <pre>Retrieves a list of change logs. This method supports paging.
119
120Args:
121  profileId: string, User profile ID associated with this request. (required)
122  objectType: string, Select only change logs with the specified object type.
123    Allowed values
124      OBJECT_ACCOUNT -
125      OBJECT_ACCOUNT_BILLING_FEATURE -
126      OBJECT_AD -
127      OBJECT_ADVERTISER -
128      OBJECT_ADVERTISER_GROUP -
129      OBJECT_BILLING_ACCOUNT_GROUP -
130      OBJECT_BILLING_FEATURE -
131      OBJECT_BILLING_MINIMUM_FEE -
132      OBJECT_BILLING_PROFILE -
133      OBJECT_CAMPAIGN -
134      OBJECT_CONTENT_CATEGORY -
135      OBJECT_CREATIVE -
136      OBJECT_CREATIVE_ASSET -
137      OBJECT_CREATIVE_BUNDLE -
138      OBJECT_CREATIVE_FIELD -
139      OBJECT_CREATIVE_GROUP -
140      OBJECT_DFA_SITE -
141      OBJECT_EVENT_TAG -
142      OBJECT_FLOODLIGHT_ACTIVITY_GROUP -
143      OBJECT_FLOODLIGHT_ACTVITY -
144      OBJECT_FLOODLIGHT_CONFIGURATION -
145      OBJECT_INSTREAM_CREATIVE -
146      OBJECT_LANDING_PAGE -
147      OBJECT_MEDIA_ORDER -
148      OBJECT_PLACEMENT -
149      OBJECT_PLACEMENT_STRATEGY -
150      OBJECT_PLAYSTORE_LINK -
151      OBJECT_PROVIDED_LIST_CLIENT -
152      OBJECT_RATE_CARD -
153      OBJECT_REMARKETING_LIST -
154      OBJECT_RICHMEDIA_CREATIVE -
155      OBJECT_SD_SITE -
156      OBJECT_SEARCH_LIFT_STUDY -
157      OBJECT_SIZE -
158      OBJECT_SUBACCOUNT -
159      OBJECT_TARGETING_TEMPLATE -
160      OBJECT_USER_PROFILE -
161      OBJECT_USER_PROFILE_FILTER -
162      OBJECT_USER_ROLE -
163  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.
164  pageToken: string, Value of the nextPageToken from the previous result page.
165  maxResults: integer, Maximum number of results to return.
166  action: string, Select only change logs with the specified action.
167    Allowed values
168      ACTION_ADD -
169      ACTION_ASSIGN -
170      ACTION_ASSOCIATE -
171      ACTION_CREATE -
172      ACTION_DELETE -
173      ACTION_DISABLE -
174      ACTION_EMAIL_TAGS -
175      ACTION_ENABLE -
176      ACTION_LINK -
177      ACTION_MARK_AS_DEFAULT -
178      ACTION_PUSH -
179      ACTION_REMOVE -
180      ACTION_SEND -
181      ACTION_SHARE -
182      ACTION_UNASSIGN -
183      ACTION_UNLINK -
184      ACTION_UPDATE -
185  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.
186  searchString: string, Select only change logs whose object ID, user name, old or new values match the search string.
187  userProfileIds: string, Select only change logs with these user profile IDs. (repeated)
188  ids: string, Select only change logs with these IDs. (repeated)
189  objectIds: string, Select only change logs with these object IDs. (repeated)
190
191Returns:
192  An object of the form:
193
194    { # Change Log List Response
195    "nextPageToken": "A String", # Pagination token to be used for the next list operation.
196    "kind": "dfareporting#changeLogsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLogsListResponse".
197    "changeLogs": [ # Change log collection.
198      { # Describes a change that a user has made to a resource.
199        "changeTime": "A String", # Time when the object was modified.
200        "kind": "dfareporting#changeLog", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#changeLog".
201        "subaccountId": "A String", # Subaccount ID of the modified object.
202        "userProfileId": "A String", # ID of the user who modified the object.
203        "objectId": "A String", # ID of the object of this change log. The object could be a campaign, placement, ad, or other type.
204        "newValue": "A String", # New value of the object field.
205        "userProfileName": "A String", # User profile name of the user who modified the object.
206        "fieldName": "A String", # Field name of the object which changed.
207        "oldValue": "A String", # Old value of the object field.
208        "action": "A String", # Action which caused the change.
209        "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.
210        "objectType": "A String", # Object type of the change log.
211        "id": "A String", # ID of this change log.
212        "accountId": "A String", # Account ID of the modified object.
213      },
214    ],
215  }</pre>
216</div>
217
218<div class="method">
219    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
220  <pre>Retrieves the next page of results.
221
222Args:
223  previous_request: The request for the previous page. (required)
224  previous_response: The response from the request for the previous page. (required)
225
226Returns:
227  A request object that you can call 'execute()' on to request the next
228  page. Returns None if there are no more items in the collection.
229    </pre>
230</div>
231
232</body></html>