AdsApp.ReportColumnHeader
Stay organized with collections
Save and categorize content based on your preferences.
Represents a column header of a report.
Methods:
getBulkUploadColumnName()
Returns the name of the column header to use in bulk uploads.
These names are the columns as they would appear in a report download
from the Google Ads UI, and as recognized in bulk uploads.
NOTE: If you're generating a CsvUpload with Report, make sure to use this method in
creation. Typical usage:
var upload = AdsApp.bulkUploads().newCsvUpload([
report.getColumnHeader("AdGroupId").getBulkUploadColumnName(),
report.getColumnHeader("AdGroupName").getBulkUploadColumnName()
...]);
This method will return an error if the query uses GAQL rather than
AWQL.
Return values:
| Type | Description |
|---|
String |
The name of the column header to use in bulk uploads. |
getReportColumnName()
Returns the name of the column header as used in report queries.
These names are the selectable columns in the query of AdsApp.report(String, Object).
Return values:
| Type | Description |
|---|
String |
The name of the column header as used in report queries. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eRepresents a column header within a report, providing methods to retrieve its name for bulk uploads and report queries.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetBulkUploadColumnName()\u003c/code\u003e returns the column header name for use in bulk uploads, mirroring the format seen in report downloads and bulk uploads from the Google Ads UI.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetReportColumnName()\u003c/code\u003e returns the column header name used within report queries, specifically for selectable columns when using \u003ccode\u003eAdsApp.report()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating a \u003ccode\u003eCsvUpload\u003c/code\u003e with a \u003ccode\u003eReport\u003c/code\u003e, ensure to use \u003ccode\u003egetBulkUploadColumnName()\u003c/code\u003e for column creation.\u003c/p\u003e\n"],["\u003cp\u003eNote that \u003ccode\u003egetBulkUploadColumnName()\u003c/code\u003e will result in an error if the query employs GAQL instead of AWQL.\u003c/p\u003e\n"]]],[],null,["Represents a column header of a report.\n\nMethods:\n\n| Member | Type | Description |\n|-------------------------------------------------------|----------|------------------------------------------------------------------|\n| [getBulkUploadColumnName](#getBulkUploadColumnName_0) | `String` | Returns the name of the column header to use in bulk uploads. |\n| [getReportColumnName](#getReportColumnName_0) | `String` | Returns the name of the column header as used in report queries. |\n\n`getBulkUploadColumnName()` Returns the name of the column header to use in bulk uploads.\n\nThese names are the columns as they would appear in a report download\nfrom the Google Ads UI, and as recognized in bulk uploads.\n\nNOTE: If you're generating a [CsvUpload](/google-ads/scripts/docs/reference/adsapp/adsapp_csvupload) with [Report](/google-ads/scripts/docs/reference/adsapp/adsapp_report), make sure to use this method in\ncreation. Typical usage:\n\n```gdscript\n var upload = AdsApp.bulkUploads().newCsvUpload([\n report.getColumnHeader(\"AdGroupId\").getBulkUploadColumnName(),\n report.getColumnHeader(\"AdGroupName\").getBulkUploadColumnName()\n ...]);\n```\n\nThis method will return an error if the query uses GAQL rather than\nAWQL.\n\nReturn values:\n\n| Type | Description |\n|----------|-------------------------------------------------------|\n| `String` | The name of the column header to use in bulk uploads. |\n\n`getReportColumnName()` Returns the name of the column header as used in report queries.\n\nThese names are the selectable columns in the query of [AdsApp.report(String, Object)](/google-ads/scripts/docs/reference/adsapp/adsapp#report_2).\n\nReturn values:\n\n| Type | Description |\n|----------|----------------------------------------------------------|\n| `String` | The name of the column header as used in report queries. |"]]
