type ReportDownloadOptions (v202505)

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

  • The exportFormat field specifies how the report file is generated, with options like TSV, TSV_EXCEL, CSV_DUMP, XML, and XLSX, and defaults to CSV_DUMP.

  • The includeReportProperties field determines whether report properties like network and user are included, defaulting to false.

  • The includeTotalsRow field specifies whether a totals row is included, defaulting to true for most formats except CSV_DUMP.

  • The useGzipCompression field controls whether the report file is compressed to a gzip file, defaulting to 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/v202505

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.