La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google
searchads-api-announcements per non perderti i prossimi miglioramenti e release.
REST Resource: customers.customColumns
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: CustomColumn
| Rappresentazione JSON |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType)
} |
| Campi |
resourceName |
string
Il nome della risorsa della colonna personalizzata. I nomi delle risorse delle colonne personalizzate hanno il formato: customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
ID della colonna personalizzata.
|
name |
string
Nome definito dall'utente della colonna personalizzata.
|
description |
string
Descrizione della colonna personalizzata definita dall'utente.
|
valueType |
enum (CustomColumnValueType)
Il tipo del valore del risultato della colonna personalizzata.
|
referencesAttributes |
boolean
True se la colonna personalizzata fa riferimento a uno o più attributi.
|
referencesMetrics |
boolean
True se la colonna personalizzata fa riferimento a una o più metriche.
|
queryable |
boolean
True se la colonna personalizzata è disponibile per l'utilizzo nella query di SearchAds360Service.Search e SearchAds360Service.SearchStream.
|
referencedSystemColumns[] |
string
L'elenco delle colonne di sistema di riferimento di questa colonna personalizzata. Ad esempio, una colonna personalizzata "somma di impressioni e clic" ha fatto riferimento alle colonne di sistema {"metrics.clicks", "metrics.impressions"}.
|
renderType |
enum (CustomColumnRenderType)
Indica come deve essere interpretato il valore del risultato della colonna personalizzata.
|
CustomColumnValueType
Enum contenente i possibili tipi di valori delle colonne personalizzate.
| Enum |
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Sconosciuto. |
STRING |
Il valore della colonna personalizzata è una stringa. |
INT64 |
Il valore della colonna personalizzata è un numero int64. |
DOUBLE |
Il valore della colonna personalizzata è un numero doppio. |
BOOLEAN |
Il valore della colonna personalizzata è booleano. |
DATE |
Il valore della colonna personalizzata è una data nel formato AAAAMMGG. |
CustomColumnRenderType
Enum contenente i diversi modi in cui una colonna personalizzata può essere interpretata.
| Enum |
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Sconosciuto. |
NUMBER |
La colonna personalizzata è un valore numerico non elaborato. Consulta il campo valueType per determinare se si tratta di un numero intero o di un numero doppio. |
PERCENT |
La colonna personalizzata deve essere moltiplicata per 100 per recuperare il valore percentuale. |
MONEY |
Il valore della colonna personalizzata è un valore monetario ed è espresso in micro. |
STRING |
Il valore della colonna personalizzata è una stringa. |
BOOLEAN |
Il valore della colonna personalizzata è booleano. |
DATE |
Il valore della colonna personalizzata è una data rappresentata come numero intero nel formato AAAAMMGG. |
Metodi |
|
|
Restituisce la colonna personalizzata richiesta in dettaglio. |
|
|
Restituisce tutte le colonne personalizzate associate al cliente in modo dettagliato. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eA \u003ccode\u003eCustomColumn\u003c/code\u003e is a user-defined column in Search Ads 360 that can reference attributes and metrics to create custom calculations or data views, with its structure and properties defined in a JSON format.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCustomColumnValueType\u003c/code\u003e and \u003ccode\u003eCustomColumnRenderType\u003c/code\u003e are enumerations that determine the data type and interpretation of values in a custom column, respectively, influencing how the column's output is displayed and used.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize methods like \u003ccode\u003eget\u003c/code\u003e and \u003ccode\u003elist\u003c/code\u003e to retrieve details or a complete list of custom columns associated with a Search Ads 360 customer, enabling programmatic management and analysis of custom data within the platform.\u003c/p\u003e\n"]]],["Custom columns are user-defined fields in Search Ads 360, defined by a `resourceName`, `id`, `name`, and `description`. They can reference attributes or metrics, be queryable, and include system columns. The `valueType` (e.g., string, int64, date) determines the column's data type, while `renderType` (e.g., number, percent, money) dictates how it's interpreted. Methods include `get` for retrieving a specific column and `list` for all columns.\n"],null,["# REST Resource: customers.customColumns\n\n- [Resource: CustomColumn](#CustomColumn)\n - [JSON representation](#CustomColumn.SCHEMA_REPRESENTATION)\n- [CustomColumnValueType](#CustomColumnValueType)\n- [CustomColumnRenderType](#CustomColumnRenderType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomColumn\n----------------------\n\nA custom column. See searchAds360.search Ads 360 custom column at \u003chttps://support.google.com/sa360/answer/9633916\u003e\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"resourceName\": string, \"id\": string, \"name\": string, \"description\": string, \"valueType\": enum (/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumnValueType), \"referencesAttributes\": boolean, \"referencesMetrics\": boolean, \"queryable\": boolean, \"referencedSystemColumns\": [ string ], \"renderType\": enum (/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumnRenderType) } ``` |\n\n| Fields ||\n|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resourceName` | `string` The resource name of the custom column. Custom column resource names have the form: `customers/{customerId}/customColumns/{custom_column_id}` |\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of the custom column. |\n| `name` | `string` User-defined name of the custom column. |\n| `description` | `string` User-defined description of the custom column. |\n| `valueType` | `enum (`[CustomColumnValueType](/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumnValueType)`)` The type of the result value of the custom column. |\n| `referencesAttributes` | `boolean` True when the custom column is referring to one or more attributes. |\n| `referencesMetrics` | `boolean` True when the custom column is referring to one or more metrics. |\n| `queryable` | `boolean` True when the custom column is available to be used in the query of SearchAds360Service.Search and SearchAds360Service.SearchStream. |\n| `referencedSystemColumns[]` | `string` The list of the referenced system columns of this custom column. For example, A custom column \"sum of impressions and clicks\" has referenced system columns of {\"metrics.clicks\", \"metrics.impressions\"}. |\n| `renderType` | `enum (`[CustomColumnRenderType](/search-ads/reporting/api/reference/rest/v0/customers.customColumns#CustomColumnRenderType)`)` How the result value of the custom column should be interpreted. |\n\nCustomColumnValueType\n---------------------\n\nEnum containing possible custom column value types.\n\n| Enums ||\n|---------------|--------------------------------------------------------|\n| `UNSPECIFIED` | Not specified. |\n| `UNKNOWN` | Unknown. |\n| `STRING` | The custom column value is a string. |\n| `INT64` | The custom column value is an int64 number. |\n| `DOUBLE` | The custom column value is a double number. |\n| `BOOLEAN` | The custom column value is a boolean. |\n| `DATE` | The custom column value is a date, in YYYYMMDD format. |\n\nCustomColumnRenderType\n----------------------\n\nEnum containing the different ways a custom column can be interpreted.\n\n| Enums ||\n|---------------|---------------------------------------------------------------------------------------------------------------|\n| `UNSPECIFIED` | Not specified. |\n| `UNKNOWN` | Unknown. |\n| `NUMBER` | The custom column is a raw numerical value. See valueType field to determine if it is an integer or a double. |\n| `PERCENT` | The custom column should be multiplied by 100 to retrieve the percentage value. |\n| `MONEY` | The custom column value is a monetary value and is in micros. |\n| `STRING` | The custom column value is a string. |\n| `BOOLEAN` | The custom column value is a boolean. |\n| `DATE` | The custom column value is a date represented as an integer in YYYYMMDD format. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [get](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/get) | Returns the requested custom column in full detail. |\n| ### [list](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/list) | Returns all the custom columns associated with the customer in full detail. |"]]
