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="doubleclickbidmanager_v1_1.html">DoubleClick Bid Manager API</a> . <a href="doubleclickbidmanager_v1_1.queries.html">queries</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
81  <code><a href="#createquery">createquery(asynchronous=None, body=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Creates a query.</p>
83<p class="toc_element">
84  <code><a href="#deletequery">deletequery(queryId, x__xgafv=None)</a></code></p>
85<p class="firstline">Deletes a stored query as well as the associated stored reports.</p>
86<p class="toc_element">
87  <code><a href="#getquery">getquery(queryId, x__xgafv=None)</a></code></p>
88<p class="firstline">Retrieves a stored query.</p>
89<p class="toc_element">
90  <code><a href="#listqueries">listqueries(pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
91<p class="firstline">Retrieves stored queries.</p>
92<p class="toc_element">
93  <code><a href="#listqueries_next">listqueries_next(previous_request, previous_response)</a></code></p>
94<p class="firstline">Retrieves the next page of results.</p>
95<p class="toc_element">
96  <code><a href="#runquery">runquery(queryId, asynchronous=None, body=None, x__xgafv=None)</a></code></p>
97<p class="firstline">Runs a stored query to generate a report.</p>
98<h3>Method Details</h3>
99<div class="method">
100    <code class="details" id="close">close()</code>
101  <pre>Close httplib2 connections.</pre>
102</div>
103
104<div class="method">
105    <code class="details" id="createquery">createquery(asynchronous=None, body=None, x__xgafv=None)</code>
106  <pre>Creates a query.
107
108Args:
109  body: object, The request body.
110    The object takes the form of:
111
112{ # Represents a query.
113  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;doubleclickbidmanager#query&quot;.
114  &quot;metadata&quot;: { # Query metadata. # Query metadata.
115    &quot;dataRange&quot;: &quot;A String&quot;, # Range of report data.
116    &quot;format&quot;: &quot;A String&quot;, # Format of the generated report.
117    &quot;googleCloudStoragePathForLatestReport&quot;: &quot;A String&quot;, # The path to the location in Google Cloud Storage where the latest report is stored.
118    &quot;googleDrivePathForLatestReport&quot;: &quot;A String&quot;, # The path in Google Drive for the latest report.
119    &quot;latestReportRunTimeMs&quot;: &quot;A String&quot;, # The time when the latest report started to run.
120    &quot;locale&quot;: &quot;A String&quot;, # Locale of the generated reports. Valid values are cs CZECH de GERMAN en ENGLISH es SPANISH fr FRENCH it ITALIAN ja JAPANESE ko KOREAN pl POLISH pt-BR BRAZILIAN_PORTUGUESE ru RUSSIAN tr TURKISH uk UKRAINIAN zh-CN CHINA_CHINESE zh-TW TAIWAN_CHINESE An locale string not in the list above will generate reports in English.
121    &quot;reportCount&quot;: 42, # Number of reports that have been generated for the query.
122    &quot;running&quot;: True or False, # Whether the latest report is currently running.
123    &quot;sendNotification&quot;: True or False, # Whether to send an email notification when a report is ready. Default to false.
124    &quot;shareEmailAddress&quot;: [ # List of email addresses which are sent email notifications when the report is finished. Separate from sendNotification.
125      &quot;A String&quot;,
126    ],
127    &quot;title&quot;: &quot;A String&quot;, # Query title. It is used to name the reports generated from this query.
128  },
129  &quot;params&quot;: { # Parameters of a query or report. # Query parameters.
130    &quot;filters&quot;: [ # Filters used to match traffic data in your report.
131      { # Filter used to match traffic data in your report.
132        &quot;type&quot;: &quot;A String&quot;, # Filter type.
133        &quot;value&quot;: &quot;A String&quot;, # Filter value.
134      },
135    ],
136    &quot;groupBys&quot;: [ # Data is grouped by the filters listed in this field.
137      &quot;A String&quot;,
138    ],
139    &quot;includeInviteData&quot;: True or False, # Deprecated. This field is no longer in use.
140    &quot;metrics&quot;: [ # Metrics to include as columns in your report.
141      &quot;A String&quot;,
142    ],
143    &quot;options&quot;: { # Additional query options. # Additional query options.
144      &quot;includeOnlyTargetedUserLists&quot;: True or False, # Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.
145      &quot;pathQueryOptions&quot;: { # Path Query Options for Report Options. # Options that contain Path Filters and Custom Channel Groupings.
146        &quot;channelGrouping&quot;: { # A channel grouping defines a set of rules that can be used to categorize events in a path report. # Custom Channel Groupings.
147          &quot;fallbackName&quot;: &quot;A String&quot;, # The name to apply to an event that does not match any of the rules in the channel grouping.
148          &quot;name&quot;: &quot;A String&quot;, # Channel Grouping name.
149          &quot;rules&quot;: [ # Rules within Channel Grouping. There is a limit of 100 rules that can be set per channel grouping.
150            { # A Rule defines a name, and a boolean expression in [conjunctive normal form](http: //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that can be // applied to a path event to determine if that name should be applied.
151              &quot;disjunctiveMatchStatements&quot;: [
152                { # DisjunctiveMatchStatement that OR&#x27;s all contained filters.
153                  &quot;eventFilters&quot;: [ # Filters. There is a limit of 100 filters that can be set per disjunctive match statement.
154                    { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
155                      &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
156                        &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
157                        &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
158                        &quot;values&quot;: [ # Value to filter on.
159                          &quot;A String&quot;,
160                        ],
161                      },
162                    },
163                  ],
164                },
165              ],
166              &quot;name&quot;: &quot;A String&quot;, # Rule name.
167            },
168          ],
169        },
170        &quot;pathFilters&quot;: [ # Path Filters. There is a limit of 100 path filters that can be set per report.
171          { # Path filters specify which paths to include in a report. A path is the result of combining DV360 events based on User ID to create a workflow of users&#x27; actions. When a path filter is set, the resulting report will only include paths that match the specified event at the specified position. All other paths will be excluded.
172            &quot;eventFilters&quot;: [ # Filter on an event to be applied to some part of the path.
173              { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
174                &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
175                  &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
176                  &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
177                  &quot;values&quot;: [ # Value to filter on.
178                    &quot;A String&quot;,
179                  ],
180                },
181              },
182            ],
183            &quot;pathMatchPosition&quot;: &quot;A String&quot;, # Indicates the position of the path the filter should match to (first, last, or any event in path).
184          },
185        ],
186      },
187    },
188    &quot;type&quot;: &quot;A String&quot;, # Report type.
189  },
190  &quot;queryId&quot;: &quot;A String&quot;, # Query ID.
191  &quot;reportDataEndTimeMs&quot;: &quot;A String&quot;, # The ending time for the data that is shown in the report. Note, reportDataEndTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
192  &quot;reportDataStartTimeMs&quot;: &quot;A String&quot;, # The starting time for the data that is shown in the report. Note, reportDataStartTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
193  &quot;schedule&quot;: { # Information on how frequently and when to run a query. # Information on how often and when to run a query.
194    &quot;endTimeMs&quot;: &quot;A String&quot;, # Datetime to periodically run the query until.
195    &quot;frequency&quot;: &quot;A String&quot;, # How often the query is run.
196    &quot;nextRunMinuteOfDay&quot;: 42, # Time of day at which a new report will be generated, represented as minutes past midnight. Range is 0 to 1439. Only applies to scheduled reports.
197    &quot;nextRunTimezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report generation time. Defaults to America/New_York.
198    &quot;startTimeMs&quot;: &quot;A String&quot;, # When to start running the query. Not applicable to `ONE_TIME` frequency.
199  },
200  &quot;timezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report data time. Defaults to America/New_York.
201}
202
203  asynchronous: boolean, If true, tries to run the query asynchronously. Only applicable when the frequency is ONE_TIME.
204  x__xgafv: string, V1 error format.
205    Allowed values
206      1 - v1 error format
207      2 - v2 error format
208
209Returns:
210  An object of the form:
211
212    { # Represents a query.
213  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;doubleclickbidmanager#query&quot;.
214  &quot;metadata&quot;: { # Query metadata. # Query metadata.
215    &quot;dataRange&quot;: &quot;A String&quot;, # Range of report data.
216    &quot;format&quot;: &quot;A String&quot;, # Format of the generated report.
217    &quot;googleCloudStoragePathForLatestReport&quot;: &quot;A String&quot;, # The path to the location in Google Cloud Storage where the latest report is stored.
218    &quot;googleDrivePathForLatestReport&quot;: &quot;A String&quot;, # The path in Google Drive for the latest report.
219    &quot;latestReportRunTimeMs&quot;: &quot;A String&quot;, # The time when the latest report started to run.
220    &quot;locale&quot;: &quot;A String&quot;, # Locale of the generated reports. Valid values are cs CZECH de GERMAN en ENGLISH es SPANISH fr FRENCH it ITALIAN ja JAPANESE ko KOREAN pl POLISH pt-BR BRAZILIAN_PORTUGUESE ru RUSSIAN tr TURKISH uk UKRAINIAN zh-CN CHINA_CHINESE zh-TW TAIWAN_CHINESE An locale string not in the list above will generate reports in English.
221    &quot;reportCount&quot;: 42, # Number of reports that have been generated for the query.
222    &quot;running&quot;: True or False, # Whether the latest report is currently running.
223    &quot;sendNotification&quot;: True or False, # Whether to send an email notification when a report is ready. Default to false.
224    &quot;shareEmailAddress&quot;: [ # List of email addresses which are sent email notifications when the report is finished. Separate from sendNotification.
225      &quot;A String&quot;,
226    ],
227    &quot;title&quot;: &quot;A String&quot;, # Query title. It is used to name the reports generated from this query.
228  },
229  &quot;params&quot;: { # Parameters of a query or report. # Query parameters.
230    &quot;filters&quot;: [ # Filters used to match traffic data in your report.
231      { # Filter used to match traffic data in your report.
232        &quot;type&quot;: &quot;A String&quot;, # Filter type.
233        &quot;value&quot;: &quot;A String&quot;, # Filter value.
234      },
235    ],
236    &quot;groupBys&quot;: [ # Data is grouped by the filters listed in this field.
237      &quot;A String&quot;,
238    ],
239    &quot;includeInviteData&quot;: True or False, # Deprecated. This field is no longer in use.
240    &quot;metrics&quot;: [ # Metrics to include as columns in your report.
241      &quot;A String&quot;,
242    ],
243    &quot;options&quot;: { # Additional query options. # Additional query options.
244      &quot;includeOnlyTargetedUserLists&quot;: True or False, # Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.
245      &quot;pathQueryOptions&quot;: { # Path Query Options for Report Options. # Options that contain Path Filters and Custom Channel Groupings.
246        &quot;channelGrouping&quot;: { # A channel grouping defines a set of rules that can be used to categorize events in a path report. # Custom Channel Groupings.
247          &quot;fallbackName&quot;: &quot;A String&quot;, # The name to apply to an event that does not match any of the rules in the channel grouping.
248          &quot;name&quot;: &quot;A String&quot;, # Channel Grouping name.
249          &quot;rules&quot;: [ # Rules within Channel Grouping. There is a limit of 100 rules that can be set per channel grouping.
250            { # A Rule defines a name, and a boolean expression in [conjunctive normal form](http: //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that can be // applied to a path event to determine if that name should be applied.
251              &quot;disjunctiveMatchStatements&quot;: [
252                { # DisjunctiveMatchStatement that OR&#x27;s all contained filters.
253                  &quot;eventFilters&quot;: [ # Filters. There is a limit of 100 filters that can be set per disjunctive match statement.
254                    { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
255                      &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
256                        &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
257                        &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
258                        &quot;values&quot;: [ # Value to filter on.
259                          &quot;A String&quot;,
260                        ],
261                      },
262                    },
263                  ],
264                },
265              ],
266              &quot;name&quot;: &quot;A String&quot;, # Rule name.
267            },
268          ],
269        },
270        &quot;pathFilters&quot;: [ # Path Filters. There is a limit of 100 path filters that can be set per report.
271          { # Path filters specify which paths to include in a report. A path is the result of combining DV360 events based on User ID to create a workflow of users&#x27; actions. When a path filter is set, the resulting report will only include paths that match the specified event at the specified position. All other paths will be excluded.
272            &quot;eventFilters&quot;: [ # Filter on an event to be applied to some part of the path.
273              { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
274                &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
275                  &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
276                  &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
277                  &quot;values&quot;: [ # Value to filter on.
278                    &quot;A String&quot;,
279                  ],
280                },
281              },
282            ],
283            &quot;pathMatchPosition&quot;: &quot;A String&quot;, # Indicates the position of the path the filter should match to (first, last, or any event in path).
284          },
285        ],
286      },
287    },
288    &quot;type&quot;: &quot;A String&quot;, # Report type.
289  },
290  &quot;queryId&quot;: &quot;A String&quot;, # Query ID.
291  &quot;reportDataEndTimeMs&quot;: &quot;A String&quot;, # The ending time for the data that is shown in the report. Note, reportDataEndTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
292  &quot;reportDataStartTimeMs&quot;: &quot;A String&quot;, # The starting time for the data that is shown in the report. Note, reportDataStartTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
293  &quot;schedule&quot;: { # Information on how frequently and when to run a query. # Information on how often and when to run a query.
294    &quot;endTimeMs&quot;: &quot;A String&quot;, # Datetime to periodically run the query until.
295    &quot;frequency&quot;: &quot;A String&quot;, # How often the query is run.
296    &quot;nextRunMinuteOfDay&quot;: 42, # Time of day at which a new report will be generated, represented as minutes past midnight. Range is 0 to 1439. Only applies to scheduled reports.
297    &quot;nextRunTimezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report generation time. Defaults to America/New_York.
298    &quot;startTimeMs&quot;: &quot;A String&quot;, # When to start running the query. Not applicable to `ONE_TIME` frequency.
299  },
300  &quot;timezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report data time. Defaults to America/New_York.
301}</pre>
302</div>
303
304<div class="method">
305    <code class="details" id="deletequery">deletequery(queryId, x__xgafv=None)</code>
306  <pre>Deletes a stored query as well as the associated stored reports.
307
308Args:
309  queryId: string, Query ID to delete. (required)
310  x__xgafv: string, V1 error format.
311    Allowed values
312      1 - v1 error format
313      2 - v2 error format
314</pre>
315</div>
316
317<div class="method">
318    <code class="details" id="getquery">getquery(queryId, x__xgafv=None)</code>
319  <pre>Retrieves a stored query.
320
321Args:
322  queryId: string, Query ID to retrieve. (required)
323  x__xgafv: string, V1 error format.
324    Allowed values
325      1 - v1 error format
326      2 - v2 error format
327
328Returns:
329  An object of the form:
330
331    { # Represents a query.
332  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;doubleclickbidmanager#query&quot;.
333  &quot;metadata&quot;: { # Query metadata. # Query metadata.
334    &quot;dataRange&quot;: &quot;A String&quot;, # Range of report data.
335    &quot;format&quot;: &quot;A String&quot;, # Format of the generated report.
336    &quot;googleCloudStoragePathForLatestReport&quot;: &quot;A String&quot;, # The path to the location in Google Cloud Storage where the latest report is stored.
337    &quot;googleDrivePathForLatestReport&quot;: &quot;A String&quot;, # The path in Google Drive for the latest report.
338    &quot;latestReportRunTimeMs&quot;: &quot;A String&quot;, # The time when the latest report started to run.
339    &quot;locale&quot;: &quot;A String&quot;, # Locale of the generated reports. Valid values are cs CZECH de GERMAN en ENGLISH es SPANISH fr FRENCH it ITALIAN ja JAPANESE ko KOREAN pl POLISH pt-BR BRAZILIAN_PORTUGUESE ru RUSSIAN tr TURKISH uk UKRAINIAN zh-CN CHINA_CHINESE zh-TW TAIWAN_CHINESE An locale string not in the list above will generate reports in English.
340    &quot;reportCount&quot;: 42, # Number of reports that have been generated for the query.
341    &quot;running&quot;: True or False, # Whether the latest report is currently running.
342    &quot;sendNotification&quot;: True or False, # Whether to send an email notification when a report is ready. Default to false.
343    &quot;shareEmailAddress&quot;: [ # List of email addresses which are sent email notifications when the report is finished. Separate from sendNotification.
344      &quot;A String&quot;,
345    ],
346    &quot;title&quot;: &quot;A String&quot;, # Query title. It is used to name the reports generated from this query.
347  },
348  &quot;params&quot;: { # Parameters of a query or report. # Query parameters.
349    &quot;filters&quot;: [ # Filters used to match traffic data in your report.
350      { # Filter used to match traffic data in your report.
351        &quot;type&quot;: &quot;A String&quot;, # Filter type.
352        &quot;value&quot;: &quot;A String&quot;, # Filter value.
353      },
354    ],
355    &quot;groupBys&quot;: [ # Data is grouped by the filters listed in this field.
356      &quot;A String&quot;,
357    ],
358    &quot;includeInviteData&quot;: True or False, # Deprecated. This field is no longer in use.
359    &quot;metrics&quot;: [ # Metrics to include as columns in your report.
360      &quot;A String&quot;,
361    ],
362    &quot;options&quot;: { # Additional query options. # Additional query options.
363      &quot;includeOnlyTargetedUserLists&quot;: True or False, # Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.
364      &quot;pathQueryOptions&quot;: { # Path Query Options for Report Options. # Options that contain Path Filters and Custom Channel Groupings.
365        &quot;channelGrouping&quot;: { # A channel grouping defines a set of rules that can be used to categorize events in a path report. # Custom Channel Groupings.
366          &quot;fallbackName&quot;: &quot;A String&quot;, # The name to apply to an event that does not match any of the rules in the channel grouping.
367          &quot;name&quot;: &quot;A String&quot;, # Channel Grouping name.
368          &quot;rules&quot;: [ # Rules within Channel Grouping. There is a limit of 100 rules that can be set per channel grouping.
369            { # A Rule defines a name, and a boolean expression in [conjunctive normal form](http: //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that can be // applied to a path event to determine if that name should be applied.
370              &quot;disjunctiveMatchStatements&quot;: [
371                { # DisjunctiveMatchStatement that OR&#x27;s all contained filters.
372                  &quot;eventFilters&quot;: [ # Filters. There is a limit of 100 filters that can be set per disjunctive match statement.
373                    { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
374                      &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
375                        &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
376                        &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
377                        &quot;values&quot;: [ # Value to filter on.
378                          &quot;A String&quot;,
379                        ],
380                      },
381                    },
382                  ],
383                },
384              ],
385              &quot;name&quot;: &quot;A String&quot;, # Rule name.
386            },
387          ],
388        },
389        &quot;pathFilters&quot;: [ # Path Filters. There is a limit of 100 path filters that can be set per report.
390          { # Path filters specify which paths to include in a report. A path is the result of combining DV360 events based on User ID to create a workflow of users&#x27; actions. When a path filter is set, the resulting report will only include paths that match the specified event at the specified position. All other paths will be excluded.
391            &quot;eventFilters&quot;: [ # Filter on an event to be applied to some part of the path.
392              { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
393                &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
394                  &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
395                  &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
396                  &quot;values&quot;: [ # Value to filter on.
397                    &quot;A String&quot;,
398                  ],
399                },
400              },
401            ],
402            &quot;pathMatchPosition&quot;: &quot;A String&quot;, # Indicates the position of the path the filter should match to (first, last, or any event in path).
403          },
404        ],
405      },
406    },
407    &quot;type&quot;: &quot;A String&quot;, # Report type.
408  },
409  &quot;queryId&quot;: &quot;A String&quot;, # Query ID.
410  &quot;reportDataEndTimeMs&quot;: &quot;A String&quot;, # The ending time for the data that is shown in the report. Note, reportDataEndTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
411  &quot;reportDataStartTimeMs&quot;: &quot;A String&quot;, # The starting time for the data that is shown in the report. Note, reportDataStartTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
412  &quot;schedule&quot;: { # Information on how frequently and when to run a query. # Information on how often and when to run a query.
413    &quot;endTimeMs&quot;: &quot;A String&quot;, # Datetime to periodically run the query until.
414    &quot;frequency&quot;: &quot;A String&quot;, # How often the query is run.
415    &quot;nextRunMinuteOfDay&quot;: 42, # Time of day at which a new report will be generated, represented as minutes past midnight. Range is 0 to 1439. Only applies to scheduled reports.
416    &quot;nextRunTimezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report generation time. Defaults to America/New_York.
417    &quot;startTimeMs&quot;: &quot;A String&quot;, # When to start running the query. Not applicable to `ONE_TIME` frequency.
418  },
419  &quot;timezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report data time. Defaults to America/New_York.
420}</pre>
421</div>
422
423<div class="method">
424    <code class="details" id="listqueries">listqueries(pageSize=None, pageToken=None, x__xgafv=None)</code>
425  <pre>Retrieves stored queries.
426
427Args:
428  pageSize: integer, Maximum number of results per page. Must be between 1 and 100. Defaults to 100 if unspecified.
429  pageToken: string, Optional pagination token.
430  x__xgafv: string, V1 error format.
431    Allowed values
432      1 - v1 error format
433      2 - v2 error format
434
435Returns:
436  An object of the form:
437
438    { # List queries response.
439  &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;doubleclickbidmanager#listQueriesResponse&quot;.
440  &quot;nextPageToken&quot;: &quot;A String&quot;, # Next page&#x27;s pagination token if one exists.
441  &quot;queries&quot;: [ # Retrieved queries.
442    { # Represents a query.
443      &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;doubleclickbidmanager#query&quot;.
444      &quot;metadata&quot;: { # Query metadata. # Query metadata.
445        &quot;dataRange&quot;: &quot;A String&quot;, # Range of report data.
446        &quot;format&quot;: &quot;A String&quot;, # Format of the generated report.
447        &quot;googleCloudStoragePathForLatestReport&quot;: &quot;A String&quot;, # The path to the location in Google Cloud Storage where the latest report is stored.
448        &quot;googleDrivePathForLatestReport&quot;: &quot;A String&quot;, # The path in Google Drive for the latest report.
449        &quot;latestReportRunTimeMs&quot;: &quot;A String&quot;, # The time when the latest report started to run.
450        &quot;locale&quot;: &quot;A String&quot;, # Locale of the generated reports. Valid values are cs CZECH de GERMAN en ENGLISH es SPANISH fr FRENCH it ITALIAN ja JAPANESE ko KOREAN pl POLISH pt-BR BRAZILIAN_PORTUGUESE ru RUSSIAN tr TURKISH uk UKRAINIAN zh-CN CHINA_CHINESE zh-TW TAIWAN_CHINESE An locale string not in the list above will generate reports in English.
451        &quot;reportCount&quot;: 42, # Number of reports that have been generated for the query.
452        &quot;running&quot;: True or False, # Whether the latest report is currently running.
453        &quot;sendNotification&quot;: True or False, # Whether to send an email notification when a report is ready. Default to false.
454        &quot;shareEmailAddress&quot;: [ # List of email addresses which are sent email notifications when the report is finished. Separate from sendNotification.
455          &quot;A String&quot;,
456        ],
457        &quot;title&quot;: &quot;A String&quot;, # Query title. It is used to name the reports generated from this query.
458      },
459      &quot;params&quot;: { # Parameters of a query or report. # Query parameters.
460        &quot;filters&quot;: [ # Filters used to match traffic data in your report.
461          { # Filter used to match traffic data in your report.
462            &quot;type&quot;: &quot;A String&quot;, # Filter type.
463            &quot;value&quot;: &quot;A String&quot;, # Filter value.
464          },
465        ],
466        &quot;groupBys&quot;: [ # Data is grouped by the filters listed in this field.
467          &quot;A String&quot;,
468        ],
469        &quot;includeInviteData&quot;: True or False, # Deprecated. This field is no longer in use.
470        &quot;metrics&quot;: [ # Metrics to include as columns in your report.
471          &quot;A String&quot;,
472        ],
473        &quot;options&quot;: { # Additional query options. # Additional query options.
474          &quot;includeOnlyTargetedUserLists&quot;: True or False, # Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.
475          &quot;pathQueryOptions&quot;: { # Path Query Options for Report Options. # Options that contain Path Filters and Custom Channel Groupings.
476            &quot;channelGrouping&quot;: { # A channel grouping defines a set of rules that can be used to categorize events in a path report. # Custom Channel Groupings.
477              &quot;fallbackName&quot;: &quot;A String&quot;, # The name to apply to an event that does not match any of the rules in the channel grouping.
478              &quot;name&quot;: &quot;A String&quot;, # Channel Grouping name.
479              &quot;rules&quot;: [ # Rules within Channel Grouping. There is a limit of 100 rules that can be set per channel grouping.
480                { # A Rule defines a name, and a boolean expression in [conjunctive normal form](http: //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that can be // applied to a path event to determine if that name should be applied.
481                  &quot;disjunctiveMatchStatements&quot;: [
482                    { # DisjunctiveMatchStatement that OR&#x27;s all contained filters.
483                      &quot;eventFilters&quot;: [ # Filters. There is a limit of 100 filters that can be set per disjunctive match statement.
484                        { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
485                          &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
486                            &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
487                            &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
488                            &quot;values&quot;: [ # Value to filter on.
489                              &quot;A String&quot;,
490                            ],
491                          },
492                        },
493                      ],
494                    },
495                  ],
496                  &quot;name&quot;: &quot;A String&quot;, # Rule name.
497                },
498              ],
499            },
500            &quot;pathFilters&quot;: [ # Path Filters. There is a limit of 100 path filters that can be set per report.
501              { # Path filters specify which paths to include in a report. A path is the result of combining DV360 events based on User ID to create a workflow of users&#x27; actions. When a path filter is set, the resulting report will only include paths that match the specified event at the specified position. All other paths will be excluded.
502                &quot;eventFilters&quot;: [ # Filter on an event to be applied to some part of the path.
503                  { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
504                    &quot;dimensionFilter&quot;: { # Dimension Filter on path events. # Filter on a dimension.
505                      &quot;filter&quot;: &quot;A String&quot;, # Dimension the filter is applied to.
506                      &quot;match&quot;: &quot;A String&quot;, # Indicates how the filter should be matched to the value.
507                      &quot;values&quot;: [ # Value to filter on.
508                        &quot;A String&quot;,
509                      ],
510                    },
511                  },
512                ],
513                &quot;pathMatchPosition&quot;: &quot;A String&quot;, # Indicates the position of the path the filter should match to (first, last, or any event in path).
514              },
515            ],
516          },
517        },
518        &quot;type&quot;: &quot;A String&quot;, # Report type.
519      },
520      &quot;queryId&quot;: &quot;A String&quot;, # Query ID.
521      &quot;reportDataEndTimeMs&quot;: &quot;A String&quot;, # The ending time for the data that is shown in the report. Note, reportDataEndTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
522      &quot;reportDataStartTimeMs&quot;: &quot;A String&quot;, # The starting time for the data that is shown in the report. Note, reportDataStartTimeMs is required if metadata.dataRange is CUSTOM_DATES and ignored otherwise.
523      &quot;schedule&quot;: { # Information on how frequently and when to run a query. # Information on how often and when to run a query.
524        &quot;endTimeMs&quot;: &quot;A String&quot;, # Datetime to periodically run the query until.
525        &quot;frequency&quot;: &quot;A String&quot;, # How often the query is run.
526        &quot;nextRunMinuteOfDay&quot;: 42, # Time of day at which a new report will be generated, represented as minutes past midnight. Range is 0 to 1439. Only applies to scheduled reports.
527        &quot;nextRunTimezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report generation time. Defaults to America/New_York.
528        &quot;startTimeMs&quot;: &quot;A String&quot;, # When to start running the query. Not applicable to `ONE_TIME` frequency.
529      },
530      &quot;timezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report data time. Defaults to America/New_York.
531    },
532  ],
533}</pre>
534</div>
535
536<div class="method">
537    <code class="details" id="listqueries_next">listqueries_next(previous_request, previous_response)</code>
538  <pre>Retrieves the next page of results.
539
540Args:
541  previous_request: The request for the previous page. (required)
542  previous_response: The response from the request for the previous page. (required)
543
544Returns:
545  A request object that you can call &#x27;execute()&#x27; on to request the next
546  page. Returns None if there are no more items in the collection.
547    </pre>
548</div>
549
550<div class="method">
551    <code class="details" id="runquery">runquery(queryId, asynchronous=None, body=None, x__xgafv=None)</code>
552  <pre>Runs a stored query to generate a report.
553
554Args:
555  queryId: string, Query ID to run. (required)
556  body: object, The request body.
557    The object takes the form of:
558
559{ # Request to run a stored query to generate a report.
560  &quot;dataRange&quot;: &quot;A String&quot;, # Report data range used to generate the report.
561  &quot;reportDataEndTimeMs&quot;: &quot;A String&quot;, # The ending time for the data that is shown in the report. Note, reportDataEndTimeMs is required if dataRange is CUSTOM_DATES and ignored otherwise.
562  &quot;reportDataStartTimeMs&quot;: &quot;A String&quot;, # The starting time for the data that is shown in the report. Note, reportDataStartTimeMs is required if dataRange is CUSTOM_DATES and ignored otherwise.
563  &quot;timezoneCode&quot;: &quot;A String&quot;, # Canonical timezone code for report data time. Defaults to America/New_York.
564}
565
566  asynchronous: boolean, If true, tries to run the query asynchronously.
567  x__xgafv: string, V1 error format.
568    Allowed values
569      1 - v1 error format
570      2 - v2 error format
571</pre>
572</div>
573
574</body></html>