1 <html><body> 2 <style> 3 4 body, 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 15 body { 16 font-size: 13px; 17 padding: 1em; 18 } 19 20 h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23 } 24 25 h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28 } 29 30 h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34 } 35 36 pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39 } 40 41 pre { 42 margin-top: 0.5em; 43 } 44 45 h1, h2, h3, p { 46 font-family: Arial, sans serif; 47 } 48 49 h1, 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">DoubleClick Search 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="#generate">generate(body)</a></code></p> 79 <p class="firstline">Generates and returns a report immediately.</p> 80 <p class="toc_element"> 81 <code><a href="#get">get(reportId)</a></code></p> 82 <p class="firstline">Polls for the status of a report request.</p> 83 <p class="toc_element"> 84 <code><a href="#getFile">getFile(reportId, reportFragment)</a></code></p> 85 <p class="firstline">Downloads a report file encoded in UTF-8.</p> 86 <p class="toc_element"> 87 <code><a href="#getFile_media">getFile_media(reportId, reportFragment)</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="#request">request(body)</a></code></p> 91 <p class="firstline">Inserts a report request into the reporting system.</p> 92 <h3>Method Details</h3> 93 <div class="method"> 94 <code class="details" id="generate">generate(body)</code> 95 <pre>Generates and returns a report immediately. 96 97 Args: 98 body: object, The request body. (required) 99 The object takes the form of: 100 101 { # A request object used to create a DoubleClick Search report. 102 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows. 103 { 104 "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. 105 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 106 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 107 # - "sold": returns metrics only for products that were sold 108 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 109 "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. 110 "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. 111 "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. 112 # 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. 113 "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. 114 "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. 115 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 116 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 117 "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. 118 }, 119 "sortOrder": "A String", # The sort direction, which is either ascending or descending. 120 }, 121 ], 122 "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. 123 "adGroupId": "A String", # DS ad group ID. 124 "agencyId": "A String", # DS agency ID. 125 "engineAccountId": "A String", # DS engine account ID. 126 "campaignId": "A String", # DS campaign ID. 127 "advertiserId": "A String", # DS advertiser ID. 128 "keywordId": "A String", # DS keyword ID. 129 "adId": "A String", # DS ad ID. 130 }, 131 "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. 132 "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). 133 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 134 "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. 135 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 136 "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. 137 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 138 }, 139 "startRow": 0, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are 0 to 50000, inclusive. Defaults to 0. 140 "rowCount": 10000, # Synchronous report only. The maxinum number of rows to return; additional rows are dropped. Acceptable values are 0 to 10000, inclusive. Defaults to 10000. 141 "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 reference for the columns that are available for each type. 142 "verifySingleTimeZone": false, # If true, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to false. 143 "filters": [ # A list of filters to be applied to the report. 144 { 145 "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. 146 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 147 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 148 # - "sold": returns metrics only for products that were sold 149 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 150 "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. 151 "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. 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. 153 # 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. 154 "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. 155 "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. 156 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 157 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 158 "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. 159 }, 160 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 161 "values": [ # A list of values to filter the column value against. 162 "", 163 ], 164 }, 165 ], 166 "downloadFormat": "A String", # Format that the report should be returned in. Currently csv or tsv is supported. 167 "includeDeletedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. Deprecated, please use includeRemovedEntities instead. 168 "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. 169 { # A request object used to create a DoubleClick Search report. 170 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 171 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 172 # - "sold": returns metrics only for products that were sold 173 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 174 "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. 175 "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. 176 "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. 177 # 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. 178 "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. 179 "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. 180 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 181 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 182 "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. 183 }, 184 ], 185 "includeRemovedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. 186 } 187 188 189 Returns: 190 An object of the form: 191 192 { # 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. 193 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has succesfully completed. 194 { 195 "url": "A String", # Use this url to download the report file. 196 "byteCount": "A String", # The size of this report file in bytes. 197 }, 198 ], 199 "kind": "doubleclicksearch#report", # Identifies this as a Report resource. Value: the fixed string doubleclicksearch#report. 200 "rows": [ # Synchronous report only. Generated report rows. 201 { # A row in a DoubleClick Search report. 202 "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. 203 }, 204 ], 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 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows. 207 { 208 "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. 209 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 210 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 211 # - "sold": returns metrics only for products that were sold 212 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 213 "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. 214 "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. 215 "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. 216 # 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. 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 "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. 219 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 220 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 221 "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. 222 }, 223 "sortOrder": "A String", # The sort direction, which is either ascending or descending. 224 }, 225 ], 226 "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. 227 "adGroupId": "A String", # DS ad group ID. 228 "agencyId": "A String", # DS agency ID. 229 "engineAccountId": "A String", # DS engine account ID. 230 "campaignId": "A String", # DS campaign ID. 231 "advertiserId": "A String", # DS advertiser ID. 232 "keywordId": "A String", # DS keyword ID. 233 "adId": "A String", # DS ad ID. 234 }, 235 "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. 236 "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). 237 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 238 "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. 239 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 240 "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. 241 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 242 }, 243 "startRow": 0, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are 0 to 50000, inclusive. Defaults to 0. 244 "rowCount": 10000, # Synchronous report only. The maxinum number of rows to return; additional rows are dropped. Acceptable values are 0 to 10000, inclusive. Defaults to 10000. 245 "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 reference for the columns that are available for each type. 246 "verifySingleTimeZone": false, # If true, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to false. 247 "filters": [ # A list of filters to be applied to the report. 248 { 249 "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. 250 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 251 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 252 # - "sold": returns metrics only for products that were sold 253 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 254 "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. 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 "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. 257 # 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. 258 "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. 259 "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. 260 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 261 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 262 "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. 263 }, 264 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 265 "values": [ # A list of values to filter the column value against. 266 "", 267 ], 268 }, 269 ], 270 "downloadFormat": "A String", # Format that the report should be returned in. Currently csv or tsv is supported. 271 "includeDeletedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. Deprecated, please use includeRemovedEntities instead. 272 "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. 273 { # A request object used to create a DoubleClick Search report. 274 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 275 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 276 # - "sold": returns metrics only for products that were sold 277 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 278 "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. 279 "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. 280 "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. 281 # 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. 282 "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. 283 "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. 284 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 285 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 286 "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. 287 }, 288 ], 289 "includeRemovedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. 290 }, 291 "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. 292 "rowCount": 42, # The number of report rows generated by the report, not including headers. 293 "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. 294 "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. 295 "id": "A String", # Asynchronous report only. Id of the report. 296 }</pre> 297 </div> 298 299 <div class="method"> 300 <code class="details" id="get">get(reportId)</code> 301 <pre>Polls for the status of a report request. 302 303 Args: 304 reportId: string, ID of the report request being polled. (required) 305 306 Returns: 307 An object of the form: 308 309 { # 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. 310 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has succesfully completed. 311 { 312 "url": "A String", # Use this url to download the report file. 313 "byteCount": "A String", # The size of this report file in bytes. 314 }, 315 ], 316 "kind": "doubleclicksearch#report", # Identifies this as a Report resource. Value: the fixed string doubleclicksearch#report. 317 "rows": [ # Synchronous report only. Generated report rows. 318 { # A row in a DoubleClick Search report. 319 "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. 320 }, 321 ], 322 "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. 323 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows. 324 { 325 "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. 326 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 327 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 328 # - "sold": returns metrics only for products that were sold 329 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 330 "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. 331 "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. 332 "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. 333 # 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. 334 "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. 335 "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. 336 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 337 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 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 }, 340 "sortOrder": "A String", # The sort direction, which is either ascending or descending. 341 }, 342 ], 343 "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. 344 "adGroupId": "A String", # DS ad group ID. 345 "agencyId": "A String", # DS agency ID. 346 "engineAccountId": "A String", # DS engine account ID. 347 "campaignId": "A String", # DS campaign ID. 348 "advertiserId": "A String", # DS advertiser ID. 349 "keywordId": "A String", # DS keyword ID. 350 "adId": "A String", # DS ad ID. 351 }, 352 "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. 353 "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). 354 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 355 "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. 356 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 357 "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. 358 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 359 }, 360 "startRow": 0, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are 0 to 50000, inclusive. Defaults to 0. 361 "rowCount": 10000, # Synchronous report only. The maxinum number of rows to return; additional rows are dropped. Acceptable values are 0 to 10000, inclusive. Defaults to 10000. 362 "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 reference for the columns that are available for each type. 363 "verifySingleTimeZone": false, # If true, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to false. 364 "filters": [ # A list of filters to be applied to the report. 365 { 366 "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. 367 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 368 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 369 # - "sold": returns metrics only for products that were sold 370 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 371 "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. 372 "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. 373 "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. 374 # 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. 375 "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. 376 "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. 377 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 378 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 379 "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. 380 }, 381 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 382 "values": [ # A list of values to filter the column value against. 383 "", 384 ], 385 }, 386 ], 387 "downloadFormat": "A String", # Format that the report should be returned in. Currently csv or tsv is supported. 388 "includeDeletedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. Deprecated, please use includeRemovedEntities instead. 389 "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. 390 { # A request object used to create a DoubleClick Search report. 391 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 392 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 393 # - "sold": returns metrics only for products that were sold 394 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 395 "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. 396 "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. 397 "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. 398 # 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. 399 "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. 400 "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. 401 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 402 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 403 "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. 404 }, 405 ], 406 "includeRemovedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. 407 }, 408 "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. 409 "rowCount": 42, # The number of report rows generated by the report, not including headers. 410 "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. 411 "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. 412 "id": "A String", # Asynchronous report only. Id of the report. 413 }</pre> 414 </div> 415 416 <div class="method"> 417 <code class="details" id="getFile">getFile(reportId, reportFragment)</code> 418 <pre>Downloads a report file encoded in UTF-8. 419 420 Args: 421 reportId: string, ID of the report. (required) 422 reportFragment: integer, The index of the report fragment to download. (required) 423 </pre> 424 </div> 425 426 <div class="method"> 427 <code class="details" id="getFile_media">getFile_media(reportId, reportFragment)</code> 428 <pre>Downloads a report file encoded in UTF-8. 429 430 Args: 431 reportId: string, ID of the report. (required) 432 reportFragment: integer, The index of the report fragment to download. (required) 433 </pre> 434 </div> 435 436 <div class="method"> 437 <code class="details" id="request">request(body)</code> 438 <pre>Inserts a report request into the reporting system. 439 440 Args: 441 body: object, The request body. (required) 442 The object takes the form of: 443 444 { # A request object used to create a DoubleClick Search report. 445 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows. 446 { 447 "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. 448 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 449 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 450 # - "sold": returns metrics only for products that were sold 451 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 452 "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. 453 "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. 454 "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. 455 # 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. 456 "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. 457 "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. 458 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 459 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 460 "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. 461 }, 462 "sortOrder": "A String", # The sort direction, which is either ascending or descending. 463 }, 464 ], 465 "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. 466 "adGroupId": "A String", # DS ad group ID. 467 "agencyId": "A String", # DS agency ID. 468 "engineAccountId": "A String", # DS engine account ID. 469 "campaignId": "A String", # DS campaign ID. 470 "advertiserId": "A String", # DS advertiser ID. 471 "keywordId": "A String", # DS keyword ID. 472 "adId": "A String", # DS ad ID. 473 }, 474 "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. 475 "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). 476 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 477 "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. 478 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 479 "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. 480 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 481 }, 482 "startRow": 0, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are 0 to 50000, inclusive. Defaults to 0. 483 "rowCount": 10000, # Synchronous report only. The maxinum number of rows to return; additional rows are dropped. Acceptable values are 0 to 10000, inclusive. Defaults to 10000. 484 "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 reference for the columns that are available for each type. 485 "verifySingleTimeZone": false, # If true, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to false. 486 "filters": [ # A list of filters to be applied to the report. 487 { 488 "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. 489 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 490 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 491 # - "sold": returns metrics only for products that were sold 492 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 493 "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. 494 "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. 495 "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. 496 # 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. 497 "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. 498 "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. 499 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 500 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 501 "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. 502 }, 503 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 504 "values": [ # A list of values to filter the column value against. 505 "", 506 ], 507 }, 508 ], 509 "downloadFormat": "A String", # Format that the report should be returned in. Currently csv or tsv is supported. 510 "includeDeletedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. Deprecated, please use includeRemovedEntities instead. 511 "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. 512 { # A request object used to create a DoubleClick Search report. 513 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 514 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 515 # - "sold": returns metrics only for products that were sold 516 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 517 "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. 518 "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. 519 "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. 520 # 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. 521 "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. 522 "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. 523 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 524 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 525 "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. 526 }, 527 ], 528 "includeRemovedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. 529 } 530 531 532 Returns: 533 An object of the form: 534 535 { # 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. 536 "files": [ # Asynchronous report only. Contains a list of generated report files once the report has succesfully completed. 537 { 538 "url": "A String", # Use this url to download the report file. 539 "byteCount": "A String", # The size of this report file in bytes. 540 }, 541 ], 542 "kind": "doubleclicksearch#report", # Identifies this as a Report resource. Value: the fixed string doubleclicksearch#report. 543 "rows": [ # Synchronous report only. Generated report rows. 544 { # A row in a DoubleClick Search report. 545 "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. 546 }, 547 ], 548 "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. 549 "orderBy": [ # Synchronous report only. A list of columns and directions defining sorting to be performed on the report rows. 550 { 551 "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. 552 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 553 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 554 # - "sold": returns metrics only for products that were sold 555 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 556 "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. 557 "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. 558 "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. 559 # 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. 560 "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. 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 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 563 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 564 "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. 565 }, 566 "sortOrder": "A String", # The sort direction, which is either ascending or descending. 567 }, 568 ], 569 "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. 570 "adGroupId": "A String", # DS ad group ID. 571 "agencyId": "A String", # DS agency ID. 572 "engineAccountId": "A String", # DS engine account ID. 573 "campaignId": "A String", # DS campaign ID. 574 "advertiserId": "A String", # DS advertiser ID. 575 "keywordId": "A String", # DS keyword ID. 576 "adId": "A String", # DS ad ID. 577 }, 578 "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. 579 "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). 580 "timeRange": { # If metrics are requested in a report, this argument will be used to restrict the metrics to a specific time range. 581 "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. 582 "endDate": "A String", # Inclusive date in YYYY-MM-DD format. 583 "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. 584 "startDate": "A String", # Inclusive date in YYYY-MM-DD format. 585 }, 586 "startRow": 0, # Synchronous report only. Zero-based index of the first row to return. Acceptable values are 0 to 50000, inclusive. Defaults to 0. 587 "rowCount": 10000, # Synchronous report only. The maxinum number of rows to return; additional rows are dropped. Acceptable values are 0 to 10000, inclusive. Defaults to 10000. 588 "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 reference for the columns that are available for each type. 589 "verifySingleTimeZone": false, # If true, the report would only be created if all the requested stat data are sourced from a single timezone. Defaults to false. 590 "filters": [ # A list of filters to be applied to the report. 591 { 592 "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. 593 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 594 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 595 # - "sold": returns metrics only for products that were sold 596 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 597 "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. 598 "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. 599 "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. 600 # 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. 601 "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. 602 "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. 603 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 604 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 605 "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. 606 }, 607 "operator": "A String", # Operator to use in the filter. See the filter reference for a list of available operators. 608 "values": [ # A list of values to filter the column value against. 609 "", 610 ], 611 }, 612 ], 613 "downloadFormat": "A String", # Format that the report should be returned in. Currently csv or tsv is supported. 614 "includeDeletedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. Deprecated, please use includeRemovedEntities instead. 615 "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. 616 { # A request object used to create a DoubleClick Search report. 617 "groupByColumn": false, # Synchronous report only. Set to true to group by this column. Defaults to false. 618 "productReportPerspective": "A String", # Returns metrics only for a specific type of product activity. Accepted values are: 619 # - "sold": returns metrics only for products that were sold 620 # - "advertised": returns metrics only for products that were advertised in a Shopping campaign, and that might or might not have been sold 621 "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. 622 "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. 623 "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. 624 # 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. 625 "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. 626 "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. 627 "columnName": "A String", # Name of a DoubleClick Search column to include in the report. 628 "platformSource": "A String", # The platform that is used to provide data for the custom dimension. Acceptable values are "floodlight". 629 "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. 630 }, 631 ], 632 "includeRemovedEntities": false, # Determines if removed entities should be included in the report. Defaults to false. 633 }, 634 "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. 635 "rowCount": 42, # The number of report rows generated by the report, not including headers. 636 "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. 637 "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. 638 "id": "A String", # Asynchronous report only. Id of the report. 639 }</pre> 640 </div> 641 642 </body></html>
