The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
Method: customers.customColumns.list
Stay organized with collections
Save and categorize content based on your preferences.
Returns all the custom columns associated with the customer in full detail.
HTTP request
GET https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
customerId |
string
Required. The ID of the customer to apply the CustomColumn list operation to.
|
Request body
The request body must be empty.
Response body
Response message for fetching all custom columns associated with a customer.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"customColumns": [
{
object (CustomColumn)
}
]
} |
| Fields |
customColumns[] |
object (CustomColumn)
The CustomColumns owned by the provided customer.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/doubleclicksearch
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-04-02 UTC.
[null,null,["Last updated 2025-04-02 UTC."],[[["\u003cp\u003eRetrieves detailed information about all custom columns associated with a specific customer.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP GET request with the customer ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns a JSON response containing an array of custom columns.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details retrieving customer-specific custom columns via an API. A `GET` request to `https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns` is made, where `customerId` is a required path parameter. The request body must be empty. A successful response returns a JSON structure with an array of `customColumns` objects containing custom column details, requiring the authorization scope `https://www.googleapis.com/auth/doubleclicksearch`.\n"],null,["# Method: customers.customColumns.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCustomColumnsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns all the custom columns associated with the customer in full detail.\n\n### HTTP request\n\n`GET https://searchads360.googleapis.com/v0/customers/{customerId}/customColumns`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------|\n| `customerId` | `string` Required. The ID of the customer to apply the CustomColumn list operation to. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for fetching all custom columns associated with a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customColumns\": [ { object (/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumn) } ] } ``` |\n\n| Fields ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customColumns[]` | `object (`[CustomColumn](/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumn)`)` The CustomColumns owned by the provided customer. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclicksearch`"]]
