Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Treten Sie der Google-Gruppe
searchads-api-announcements bei, um über kommende Verbesserungen und Releases auf dem Laufenden zu bleiben.
REST Resource: customers.customColumns
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: CustomColumn
JSON-Darstellung |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType ),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType )
} |
Felder |
resourceName |
string
Der Ressourcenname der benutzerdefinierten Spalte. Ressourcennamen für benutzerdefinierte Spalten haben folgendes Format: customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
ID der benutzerdefinierten Spalte.
|
name |
string
Benutzerdefinierter Name der benutzerdefinierten Spalte.
|
description |
string
Benutzerdefinierte Beschreibung der benutzerdefinierten Spalte.
|
valueType |
enum (CustomColumnValueType )
Der Typ des Ergebniswerts der benutzerdefinierten Spalte.
|
referencesAttributes |
boolean
„Wahr“, wenn sich die benutzerdefinierte Spalte auf ein oder mehrere Attribute bezieht.
|
referencesMetrics |
boolean
„Wahr“, wenn sich die benutzerdefinierte Spalte auf einen oder mehrere Messwerte bezieht.
|
queryable |
boolean
"True", wenn die benutzerdefinierte Spalte in der Abfrage von SearchAds360Service.Search und SearchAds360Service.SearchStream verwendet werden kann.
|
referencedSystemColumns[] |
string
Liste der referenzierten Systemspalten dieser benutzerdefinierten Spalte. Beispiel: Eine benutzerdefinierte Spalte „Summe von Impressionen und Klicks“ verweist auf die Systemspalten {„metrics.clicks“, „metrics.impressions“}.
|
renderType |
enum (CustomColumnRenderType )
Wie der Ergebniswert der benutzerdefinierten Spalte interpretiert werden soll.
|
CustomColumnValueType
Enum mit möglichen Typen für benutzerdefinierte Spaltenwerte.
Enums |
UNSPECIFIED |
Nicht angegeben. |
UNKNOWN |
Unbekannt |
STRING |
Der Wert der benutzerdefinierten Spalte ist ein String. |
INT64 |
Der Wert der benutzerdefinierten Spalte ist eine int64-Zahl. |
DOUBLE |
Der Wert der benutzerdefinierten Spalte ist eine doppelte Zahl. |
BOOLEAN |
Der Wert der benutzerdefinierten Spalte ist ein boolescher Wert. |
DATE |
Der Wert der benutzerdefinierten Spalte ist ein Datum im Format JJJJMMTT. |
CustomColumnRenderType
Enum mit den verschiedenen Möglichkeiten, wie eine benutzerdefinierte Spalte interpretiert werden kann.
Enums |
UNSPECIFIED |
Nicht angegeben. |
UNKNOWN |
Unbekannt |
NUMBER |
Die benutzerdefinierte Spalte ist ein numerischer Rohwert. Im Feld „valueType“ sehen Sie, ob es sich um eine Ganzzahl oder einen Doppelpunkt handelt. |
PERCENT |
Der Prozentsatz wird ermittelt, indem die benutzerdefinierte Spalte mit 100 multipliziert wird. |
MONEY |
Der Wert der benutzerdefinierten Spalte ist ein Geldwert und wird in Mikros angegeben. |
STRING |
Der Wert der benutzerdefinierten Spalte ist ein String. |
BOOLEAN |
Der Wert der benutzerdefinierten Spalte ist ein boolescher Wert. |
DATE |
Der Wert der benutzerdefinierten Spalte ist ein Datum, das als Ganzzahl im Format JJJJMMTT dargestellt wird. |
Methoden |
|
Die angeforderte benutzerdefinierte Spalte in voller Detaillierung. |
|
Hier werden alle benutzerdefinierten Spalten mit Details zum Kunden zurückgegeben. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]