type ReportDownloadOptions (v202508)

  • ReportDownloadOptions represent options for API report download requests and are used with ReportService.getReportDownloadUrlWithOptions.

  • The exportFormat field specifies the format of the report file, with CSV_DUMP as the default, and options including TSV, TSV_EXCEL, XML, and XLSX.

  • The includeReportProperties and includeTotalsRow fields control whether report properties and a totals row are included, with defaults of false and true respectively (except for CSV_DUMP).

  • The useGzipCompression field determines if the report file is compressed to a gzip file, with a default of true.
Service
ReportService
Dependencies
getReportDownloadUrlWithOpt...
▼
ReportDownloadOptions

Represents the options for an API report download request. See ReportService.getReportDownloadUrlWithOptions.

Namespace
https://www.google.com/apis/ads/publisher/v202508

Field

exportFormat

ExportFormat

The ExportFormat used to generate the report. Default value is ExportFormat.CSV_DUMP.

Enumerations
TSV
The report file is generated as a list of Tab Separated Values.
TSV_EXCEL
The report file is generated as a list of tab-separated values for Excel.
CSV_DUMP
The report file is generated as a list of Comma Separated Values, to be used with automated machine processing.
  • There is no pretty printing for the output, and no total row.
  • Column headers are the qualified name e.g. "Dimension.ORDER_NAME".
  • Network currency Monetary amounts are represented as micros in the currency of the network.
  • Starting from v201705, local currency Monetary amounts are represented as currency symbol + ' ' + micros.
  • Dates are formatted according to the ISO 8601 standard YYYY-MM-DD
  • DateTimes are formatted according to the ISO 8601 standard YYYY-MM-DDThh:mm:ss[+-]hh:mm
XML
The report file is generated as XML.
XLSX
The report file is generated as an Office Open XML spreadsheet designed for Excel 2007+.

includeReportProperties

xsd:boolean

Whether or not to include the report properties (e.g. network, user, date generated...) in the generated report. Default is false.

includeTotalsRow

xsd:boolean

Whether or not to include the totals row. Default is true for all formats except ExportFormat.CSV_DUMP.

useGzipCompression

xsd:boolean

Whether or not to compress the report file to a gzip file. Default is true.

Regardless of value, gzip http compression is available from the URL by normal means.