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="doubleclicksearch_v2.html">Search Ads 360 API</a> . <a href="doubleclicksearch_v2.reports.html">reports</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="#generate">generate(body=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Generates and returns a report immediately.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(reportId, x__xgafv=None)</a></code></p> 85<p class="firstline">Polls for the status of a report request.</p> 86<p class="toc_element"> 87 <code><a href="#getFile">getFile(reportId, reportFragment, x__xgafv=None)</a></code></p> 88<p class="firstline">Downloads a report file encoded in UTF-8.</p> 89<p class="toc_element"> 90 <code><a href="#getFile_media">getFile_media(reportId, reportFragment, x__xgafv=None)</a></code></p> 91<p class="firstline">Downloads a report file encoded in UTF-8.</p> 92<p class="toc_element"> 93 <code><a href="#request">request(body=None, x__xgafv=None)</a></code></p> 94<p class="firstline">Inserts a report request into the reporting system.</p> 95<h3>Method Details</h3> 96<div class="method"> 97 <code class="details" id="close">close()</code> 98 <pre>Close httplib2 connections.</pre> 99</div> 100 101<div class="method"> 102 <code class="details" id="generate">generate(body=None, x__xgafv=None)</code> 103 <pre>Generates and returns a report immediately. 104 105Args: 106 body: object, The request body. 107 The object takes the form of: 108 109{ # A request object used to create a DoubleClick Search report. 110 "columns": [ # The columns to include in the report. This includes both DoubleClick Search columns and saved columns. For DoubleClick Search columns, only the `columnName` parameter is required. For saved columns only the `savedColumnName` parameter is required. Both `columnName` and `savedColumnName` cannot be set in the same stanza.\ The maximum number of columns per request is 300. 111 { # A request object used to create a DoubleClick Search report. 112 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 113 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 114 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 115 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 116 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 117 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 118 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 119 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 120 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 121 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 122 }, 123 ], 124 "downloadFormat": "A String", # Format that the report should be returned in. Currently `csv` or `tsv` is supported. 125 "filters": [ # A list of filters to be applied to the report.\ The maximum number of filters per request is 300. 126 { 127 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the filter on. This can be a DoubleClick Search column or a saved column. 128 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 129 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 130 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 131 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 132 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 133 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 134 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 135 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 136 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 137 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 138 }, 139 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 140 "values": [ # A list of values to filter the column value against.\ The maximum number of filter values per request is 300. 141 "", 142 ], 143 }, 144 ], 145 "includeDeletedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. Deprecated, please use `includeRemovedEntities` instead. 146 "includeRemovedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. 147 "maxRowsPerFile": 42, # Asynchronous report only. The maximum number of rows per report file. A large report is split into many files based on this field. Acceptable values are `1000000` to `100000000`, inclusive. 148 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows.\ The maximum number of orderings per request is 300. 149 { 150 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the sort on. This can be a DoubleClick Search-defined column or a saved column. 151 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 152 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 153 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 154 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 155 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 156 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 157 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 158 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 159 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 160 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 161 }, 162 "sortOrder": "A String", # The sort direction, which is either `ascending` or `descending`. 163 }, 164 ], 165 "reportScope": { # The reportScope is a set of IDs that are used to determine which subset of entities will be returned in the report. The full lineage of IDs from the lowest scoped level desired up through agency is required. 166 "adGroupId": "A String", # DS ad group ID. 167 "adId": "A String", # DS ad ID. 168 "advertiserId": "A String", # DS advertiser ID. 169 "agencyId": "A String", # DS agency ID. 170 "campaignId": "A String", # DS campaign ID. 171 "engineAccountId": "A String", # DS engine account ID. 172 "keywordId": "A String", # DS keyword ID. 173 }, 174 "reportType": "A String", # Determines the type of rows that are returned in the report. For example, if you specify `reportType: keyword`, each row in the report will contain data about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) reference for the columns that are available for each type. 175 "rowCount": 42, # Synchronous report only. The maximum number of rows to return; additional rows are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to `10000`. 176 "startRow": 42, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. 177 "statisticsCurrency": "A String", # Specifies the currency in which monetary will be returned. Possible values are: `usd`, `agency` (valid if the report is scoped to agency or lower), `advertiser` (valid if the report is scoped to * advertiser or lower), or `account` (valid if the report is scoped to engine account or lower). 178 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 179 "changedAttributesSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed attribute reports work. 180 "changedMetricsSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed metrics reports work. 181 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 182 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 183 }, 184 "verifySingleTimeZone": True or False, # If `true`, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to `false`. 185} 186 187 x__xgafv: string, V1 error format. 188 Allowed values 189 1 - v1 error format 190 2 - v2 error format 191 192Returns: 193 An object of the form: 194 195 { # A DoubleClick Search report. This object contains the report request, some report metadata such as currency code, and the generated report rows or report files. 196 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has successfully completed. 197 { 198 "byteCount": "A String", # The size of this report file in bytes. 199 "url": "A String", # Use this url to download the report file. 200 }, 201 ], 202 "id": "A String", # Asynchronous report only. Id of the report. 203 "isReportReady": True or False, # Asynchronous report only. True if and only if the report has completed successfully and the report files are ready to be downloaded. 204 "kind": "A String", # Identifies this as a Report resource. Value: the fixed string `doubleclicksearch#report`. 205 "request": { # A request object used to create a DoubleClick Search report. # The request that created the report. Optional fields not specified in the original request are filled with default values. 206 "columns": [ # The columns to include in the report. This includes both DoubleClick Search columns and saved columns. For DoubleClick Search columns, only the `columnName` parameter is required. For saved columns only the `savedColumnName` parameter is required. Both `columnName` and `savedColumnName` cannot be set in the same stanza.\ The maximum number of columns per request is 300. 207 { # A request object used to create a DoubleClick Search report. 208 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 209 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 210 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 211 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 212 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 213 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 214 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 215 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 216 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 217 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 218 }, 219 ], 220 "downloadFormat": "A String", # Format that the report should be returned in. Currently `csv` or `tsv` is supported. 221 "filters": [ # A list of filters to be applied to the report.\ The maximum number of filters per request is 300. 222 { 223 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the filter on. This can be a DoubleClick Search column or a saved column. 224 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 225 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 226 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 227 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 228 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 229 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 230 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 231 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 232 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 233 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 234 }, 235 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 236 "values": [ # A list of values to filter the column value against.\ The maximum number of filter values per request is 300. 237 "", 238 ], 239 }, 240 ], 241 "includeDeletedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. Deprecated, please use `includeRemovedEntities` instead. 242 "includeRemovedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. 243 "maxRowsPerFile": 42, # Asynchronous report only. The maximum number of rows per report file. A large report is split into many files based on this field. Acceptable values are `1000000` to `100000000`, inclusive. 244 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows.\ The maximum number of orderings per request is 300. 245 { 246 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the sort on. This can be a DoubleClick Search-defined column or a saved column. 247 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 248 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 249 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 250 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 251 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 252 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 253 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 254 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 255 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 256 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 257 }, 258 "sortOrder": "A String", # The sort direction, which is either `ascending` or `descending`. 259 }, 260 ], 261 "reportScope": { # The reportScope is a set of IDs that are used to determine which subset of entities will be returned in the report. The full lineage of IDs from the lowest scoped level desired up through agency is required. 262 "adGroupId": "A String", # DS ad group ID. 263 "adId": "A String", # DS ad ID. 264 "advertiserId": "A String", # DS advertiser ID. 265 "agencyId": "A String", # DS agency ID. 266 "campaignId": "A String", # DS campaign ID. 267 "engineAccountId": "A String", # DS engine account ID. 268 "keywordId": "A String", # DS keyword ID. 269 }, 270 "reportType": "A String", # Determines the type of rows that are returned in the report. For example, if you specify `reportType: keyword`, each row in the report will contain data about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) reference for the columns that are available for each type. 271 "rowCount": 42, # Synchronous report only. The maximum number of rows to return; additional rows are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to `10000`. 272 "startRow": 42, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. 273 "statisticsCurrency": "A String", # Specifies the currency in which monetary will be returned. Possible values are: `usd`, `agency` (valid if the report is scoped to agency or lower), `advertiser` (valid if the report is scoped to * advertiser or lower), or `account` (valid if the report is scoped to engine account or lower). 274 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 275 "changedAttributesSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed attribute reports work. 276 "changedMetricsSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed metrics reports work. 277 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 278 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 279 }, 280 "verifySingleTimeZone": True or False, # If `true`, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to `false`. 281 }, 282 "rowCount": 42, # The number of report rows generated by the report, not including headers. 283 "rows": [ # Synchronous report only. Generated report rows. 284 { # A row in a DoubleClick Search report. 285 "a_key": "", # Indicates the columns that are represented in this row. That is, each key corresponds to a column with a non-empty cell in this row. 286 }, 287 ], 288 "statisticsCurrencyCode": "A String", # The currency code of all monetary values produced in the report, including values that are set by users (e.g., keyword bid settings) and metrics (e.g., cost and revenue). The currency code of a report is determined by the `statisticsCurrency` field of the report request. 289 "statisticsTimeZone": "A String", # If all statistics of the report are sourced from the same time zone, this would be it. Otherwise the field is unset. 290}</pre> 291</div> 292 293<div class="method"> 294 <code class="details" id="get">get(reportId, x__xgafv=None)</code> 295 <pre>Polls for the status of a report request. 296 297Args: 298 reportId: string, ID of the report request being polled. (required) 299 x__xgafv: string, V1 error format. 300 Allowed values 301 1 - v1 error format 302 2 - v2 error format 303 304Returns: 305 An object of the form: 306 307 { # A DoubleClick Search report. This object contains the report request, some report metadata such as currency code, and the generated report rows or report files. 308 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has successfully completed. 309 { 310 "byteCount": "A String", # The size of this report file in bytes. 311 "url": "A String", # Use this url to download the report file. 312 }, 313 ], 314 "id": "A String", # Asynchronous report only. Id of the report. 315 "isReportReady": True or False, # Asynchronous report only. True if and only if the report has completed successfully and the report files are ready to be downloaded. 316 "kind": "A String", # Identifies this as a Report resource. Value: the fixed string `doubleclicksearch#report`. 317 "request": { # A request object used to create a DoubleClick Search report. # The request that created the report. Optional fields not specified in the original request are filled with default values. 318 "columns": [ # The columns to include in the report. This includes both DoubleClick Search columns and saved columns. For DoubleClick Search columns, only the `columnName` parameter is required. For saved columns only the `savedColumnName` parameter is required. Both `columnName` and `savedColumnName` cannot be set in the same stanza.\ The maximum number of columns per request is 300. 319 { # A request object used to create a DoubleClick Search report. 320 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 321 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 322 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 323 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 324 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 325 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 326 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 327 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 328 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 329 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 330 }, 331 ], 332 "downloadFormat": "A String", # Format that the report should be returned in. Currently `csv` or `tsv` is supported. 333 "filters": [ # A list of filters to be applied to the report.\ The maximum number of filters per request is 300. 334 { 335 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the filter on. This can be a DoubleClick Search column or a saved column. 336 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 337 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 338 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 339 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 340 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 341 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 342 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 343 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 344 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 345 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 346 }, 347 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 348 "values": [ # A list of values to filter the column value against.\ The maximum number of filter values per request is 300. 349 "", 350 ], 351 }, 352 ], 353 "includeDeletedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. Deprecated, please use `includeRemovedEntities` instead. 354 "includeRemovedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. 355 "maxRowsPerFile": 42, # Asynchronous report only. The maximum number of rows per report file. A large report is split into many files based on this field. Acceptable values are `1000000` to `100000000`, inclusive. 356 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows.\ The maximum number of orderings per request is 300. 357 { 358 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the sort on. This can be a DoubleClick Search-defined column or a saved column. 359 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 360 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 361 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 362 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 363 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 364 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 365 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 366 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 367 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 368 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 369 }, 370 "sortOrder": "A String", # The sort direction, which is either `ascending` or `descending`. 371 }, 372 ], 373 "reportScope": { # The reportScope is a set of IDs that are used to determine which subset of entities will be returned in the report. The full lineage of IDs from the lowest scoped level desired up through agency is required. 374 "adGroupId": "A String", # DS ad group ID. 375 "adId": "A String", # DS ad ID. 376 "advertiserId": "A String", # DS advertiser ID. 377 "agencyId": "A String", # DS agency ID. 378 "campaignId": "A String", # DS campaign ID. 379 "engineAccountId": "A String", # DS engine account ID. 380 "keywordId": "A String", # DS keyword ID. 381 }, 382 "reportType": "A String", # Determines the type of rows that are returned in the report. For example, if you specify `reportType: keyword`, each row in the report will contain data about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) reference for the columns that are available for each type. 383 "rowCount": 42, # Synchronous report only. The maximum number of rows to return; additional rows are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to `10000`. 384 "startRow": 42, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. 385 "statisticsCurrency": "A String", # Specifies the currency in which monetary will be returned. Possible values are: `usd`, `agency` (valid if the report is scoped to agency or lower), `advertiser` (valid if the report is scoped to * advertiser or lower), or `account` (valid if the report is scoped to engine account or lower). 386 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 387 "changedAttributesSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed attribute reports work. 388 "changedMetricsSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed metrics reports work. 389 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 390 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 391 }, 392 "verifySingleTimeZone": True or False, # If `true`, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to `false`. 393 }, 394 "rowCount": 42, # The number of report rows generated by the report, not including headers. 395 "rows": [ # Synchronous report only. Generated report rows. 396 { # A row in a DoubleClick Search report. 397 "a_key": "", # Indicates the columns that are represented in this row. That is, each key corresponds to a column with a non-empty cell in this row. 398 }, 399 ], 400 "statisticsCurrencyCode": "A String", # The currency code of all monetary values produced in the report, including values that are set by users (e.g., keyword bid settings) and metrics (e.g., cost and revenue). The currency code of a report is determined by the `statisticsCurrency` field of the report request. 401 "statisticsTimeZone": "A String", # If all statistics of the report are sourced from the same time zone, this would be it. Otherwise the field is unset. 402}</pre> 403</div> 404 405<div class="method"> 406 <code class="details" id="getFile">getFile(reportId, reportFragment, x__xgafv=None)</code> 407 <pre>Downloads a report file encoded in UTF-8. 408 409Args: 410 reportId: string, ID of the report. (required) 411 reportFragment: integer, The index of the report fragment to download. (required) 412 x__xgafv: string, V1 error format. 413 Allowed values 414 1 - v1 error format 415 2 - v2 error format 416</pre> 417</div> 418 419<div class="method"> 420 <code class="details" id="getFile_media">getFile_media(reportId, reportFragment, x__xgafv=None)</code> 421 <pre>Downloads a report file encoded in UTF-8. 422 423Args: 424 reportId: string, ID of the report. (required) 425 reportFragment: integer, The index of the report fragment to download. (required) 426 x__xgafv: string, V1 error format. 427 Allowed values 428 1 - v1 error format 429 2 - v2 error format 430</pre> 431</div> 432 433<div class="method"> 434 <code class="details" id="request">request(body=None, x__xgafv=None)</code> 435 <pre>Inserts a report request into the reporting system. 436 437Args: 438 body: object, The request body. 439 The object takes the form of: 440 441{ # A request object used to create a DoubleClick Search report. 442 "columns": [ # The columns to include in the report. This includes both DoubleClick Search columns and saved columns. For DoubleClick Search columns, only the `columnName` parameter is required. For saved columns only the `savedColumnName` parameter is required. Both `columnName` and `savedColumnName` cannot be set in the same stanza.\ The maximum number of columns per request is 300. 443 { # A request object used to create a DoubleClick Search report. 444 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 445 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 446 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 447 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 448 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 449 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 450 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 451 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 452 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 453 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 454 }, 455 ], 456 "downloadFormat": "A String", # Format that the report should be returned in. Currently `csv` or `tsv` is supported. 457 "filters": [ # A list of filters to be applied to the report.\ The maximum number of filters per request is 300. 458 { 459 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the filter on. This can be a DoubleClick Search column or a saved column. 460 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 461 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 462 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 463 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 464 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 465 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 466 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 467 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 468 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 469 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 470 }, 471 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 472 "values": [ # A list of values to filter the column value against.\ The maximum number of filter values per request is 300. 473 "", 474 ], 475 }, 476 ], 477 "includeDeletedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. Deprecated, please use `includeRemovedEntities` instead. 478 "includeRemovedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. 479 "maxRowsPerFile": 42, # Asynchronous report only. The maximum number of rows per report file. A large report is split into many files based on this field. Acceptable values are `1000000` to `100000000`, inclusive. 480 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows.\ The maximum number of orderings per request is 300. 481 { 482 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the sort on. This can be a DoubleClick Search-defined column or a saved column. 483 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 484 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 485 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 486 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 487 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 488 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 489 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 490 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 491 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 492 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 493 }, 494 "sortOrder": "A String", # The sort direction, which is either `ascending` or `descending`. 495 }, 496 ], 497 "reportScope": { # The reportScope is a set of IDs that are used to determine which subset of entities will be returned in the report. The full lineage of IDs from the lowest scoped level desired up through agency is required. 498 "adGroupId": "A String", # DS ad group ID. 499 "adId": "A String", # DS ad ID. 500 "advertiserId": "A String", # DS advertiser ID. 501 "agencyId": "A String", # DS agency ID. 502 "campaignId": "A String", # DS campaign ID. 503 "engineAccountId": "A String", # DS engine account ID. 504 "keywordId": "A String", # DS keyword ID. 505 }, 506 "reportType": "A String", # Determines the type of rows that are returned in the report. For example, if you specify `reportType: keyword`, each row in the report will contain data about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) reference for the columns that are available for each type. 507 "rowCount": 42, # Synchronous report only. The maximum number of rows to return; additional rows are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to `10000`. 508 "startRow": 42, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. 509 "statisticsCurrency": "A String", # Specifies the currency in which monetary will be returned. Possible values are: `usd`, `agency` (valid if the report is scoped to agency or lower), `advertiser` (valid if the report is scoped to * advertiser or lower), or `account` (valid if the report is scoped to engine account or lower). 510 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 511 "changedAttributesSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed attribute reports work. 512 "changedMetricsSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed metrics reports work. 513 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 514 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 515 }, 516 "verifySingleTimeZone": True or False, # If `true`, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to `false`. 517} 518 519 x__xgafv: string, V1 error format. 520 Allowed values 521 1 - v1 error format 522 2 - v2 error format 523 524Returns: 525 An object of the form: 526 527 { # A DoubleClick Search report. This object contains the report request, some report metadata such as currency code, and the generated report rows or report files. 528 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has successfully completed. 529 { 530 "byteCount": "A String", # The size of this report file in bytes. 531 "url": "A String", # Use this url to download the report file. 532 }, 533 ], 534 "id": "A String", # Asynchronous report only. Id of the report. 535 "isReportReady": True or False, # Asynchronous report only. True if and only if the report has completed successfully and the report files are ready to be downloaded. 536 "kind": "A String", # Identifies this as a Report resource. Value: the fixed string `doubleclicksearch#report`. 537 "request": { # A request object used to create a DoubleClick Search report. # The request that created the report. Optional fields not specified in the original request are filled with default values. 538 "columns": [ # The columns to include in the report. This includes both DoubleClick Search columns and saved columns. For DoubleClick Search columns, only the `columnName` parameter is required. For saved columns only the `savedColumnName` parameter is required. Both `columnName` and `savedColumnName` cannot be set in the same stanza.\ The maximum number of columns per request is 300. 539 { # A request object used to create a DoubleClick Search report. 540 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 541 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 542 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 543 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 544 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 545 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 546 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 547 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 548 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 549 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 550 }, 551 ], 552 "downloadFormat": "A String", # Format that the report should be returned in. Currently `csv` or `tsv` is supported. 553 "filters": [ # A list of filters to be applied to the report.\ The maximum number of filters per request is 300. 554 { 555 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the filter on. This can be a DoubleClick Search column or a saved column. 556 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 557 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 558 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 559 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 560 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 561 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 562 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 563 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 564 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 565 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 566 }, 567 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 568 "values": [ # A list of values to filter the column value against.\ The maximum number of filter values per request is 300. 569 "", 570 ], 571 }, 572 ], 573 "includeDeletedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. Deprecated, please use `includeRemovedEntities` instead. 574 "includeRemovedEntities": True or False, # Determines if removed entities should be included in the report. Defaults to `false`. 575 "maxRowsPerFile": 42, # Asynchronous report only. The maximum number of rows per report file. A large report is split into many files based on this field. Acceptable values are `1000000` to `100000000`, inclusive. 576 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows.\ The maximum number of orderings per request is 300. 577 { 578 "column": { # A request object used to create a DoubleClick Search report. # Column to perform the sort on. This can be a DoubleClick Search-defined column or a saved column. 579 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 580 "customDimensionName": "A String", # Segments a report by a custom dimension. The report must be scoped to an advertiser or lower, and the custom dimension must already be set up in DoubleClick Search. The custom dimension name, which appears in DoubleClick Search, is case sensitive.\ If used in a conversion report, returns the value of the specified custom dimension for the given conversion, if set. This column does not segment the conversion report. 581 "customMetricName": "A String", # Name of a custom metric to include in the report. The report must be scoped to an advertiser or lower, and the custom metric must already be set up in DoubleClick Search. The custom metric name, which appears in DoubleClick Search, is case sensitive. 582 "endDate": "A String", # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `startDate`. 583 "groupByColumn": True or False, # Synchronous report only. Set to `true` to group by this column. Defaults to `false`. 584 "headerText": "A String", # Text used to identify this column in the report output; defaults to `columnName` or `savedColumnName` when not specified. This can be used to prevent collisions between DoubleClick Search columns and saved columns with the same name. 585 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 586 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: - "`sold`": returns metrics only for products that were sold - "`advertised`": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 587 "savedColumnName": "A String", # Name of a saved column to include in the report. The report must be scoped at advertiser or lower, and this saved column must already be created in the DoubleClick Search UI. 588 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall time range of the report for this column only. Must be provided together with `endDate`. 589 }, 590 "sortOrder": "A String", # The sort direction, which is either `ascending` or `descending`. 591 }, 592 ], 593 "reportScope": { # The reportScope is a set of IDs that are used to determine which subset of entities will be returned in the report. The full lineage of IDs from the lowest scoped level desired up through agency is required. 594 "adGroupId": "A String", # DS ad group ID. 595 "adId": "A String", # DS ad ID. 596 "advertiserId": "A String", # DS advertiser ID. 597 "agencyId": "A String", # DS agency ID. 598 "campaignId": "A String", # DS campaign ID. 599 "engineAccountId": "A String", # DS engine account ID. 600 "keywordId": "A String", # DS keyword ID. 601 }, 602 "reportType": "A String", # Determines the type of rows that are returned in the report. For example, if you specify `reportType: keyword`, each row in the report will contain data about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) reference for the columns that are available for each type. 603 "rowCount": 42, # Synchronous report only. The maximum number of rows to return; additional rows are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to `10000`. 604 "startRow": 42, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. 605 "statisticsCurrency": "A String", # Specifies the currency in which monetary will be returned. Possible values are: `usd`, `agency` (valid if the report is scoped to agency or lower), `advertiser` (valid if the report is scoped to * advertiser or lower), or `account` (valid if the report is scoped to engine account or lower). 606 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 607 "changedAttributesSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed attribute reports work. 608 "changedMetricsSinceTimestamp": "A String", # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See additional references on how changed metrics reports work. 609 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 610 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 611 }, 612 "verifySingleTimeZone": True or False, # If `true`, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to `false`. 613 }, 614 "rowCount": 42, # The number of report rows generated by the report, not including headers. 615 "rows": [ # Synchronous report only. Generated report rows. 616 { # A row in a DoubleClick Search report. 617 "a_key": "", # Indicates the columns that are represented in this row. That is, each key corresponds to a column with a non-empty cell in this row. 618 }, 619 ], 620 "statisticsCurrencyCode": "A String", # The currency code of all monetary values produced in the report, including values that are set by users (e.g., keyword bid settings) and metrics (e.g., cost and revenue). The currency code of a report is determined by the `statisticsCurrency` field of the report request. 621 "statisticsTimeZone": "A String", # If all statistics of the report are sourced from the same time zone, this would be it. Otherwise the field is unset. 622}</pre> 623</div> 624 625</body></html>