Search Ads 360 Reporting API versi baru kini tersedia. Bergabunglah dengan grup Google
searchads-api-announcements untuk terus mendapatkan informasi terbaru tentang peningkatan dan rilis mendatang.
REST Resource: customers.customColumns
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: CustomColumn
Representasi JSON |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType ),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType )
} |
Kolom |
resourceName |
string
Nama resource kolom kustom. Nama resource kolom kustom memiliki bentuk: customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
ID kolom kustom.
|
name |
string
Nama kolom kustom yang ditentukan pengguna.
|
description |
string
Deskripsi kolom kustom yang ditentukan pengguna.
|
valueType |
enum (CustomColumnValueType )
Jenis nilai hasil kolom kustom.
|
referencesAttributes |
boolean
Benar jika kolom kustom merujuk ke satu atau beberapa atribut.
|
referencesMetrics |
boolean
Benar jika kolom kustom merujuk ke satu atau beberapa metrik.
|
queryable |
boolean
Benar jika kolom kustom tersedia untuk digunakan dalam kueri SearchAds360Service.Search dan SearchAds360Service.SearchStream.
|
referencedSystemColumns[] |
string
Daftar kolom sistem yang direferensikan dari kolom kustom ini. Misalnya, kolom kustom "jumlah tayangan dan klik" telah mereferensikan kolom sistem {"metrics.clicks", "metrics.impressions"}.
|
renderType |
enum (CustomColumnRenderType )
Cara menafsirkan nilai hasil kolom kustom.
|
CustomColumnValueType
Enum yang berisi kemungkinan jenis nilai kolom kustom.
Enum |
UNSPECIFIED |
Tidak ditentukan. |
UNKNOWN |
Tak diketahui. |
STRING |
Nilai kolom kustom adalah string. |
INT64 |
Nilai kolom kustom adalah angka int64. |
DOUBLE |
Nilai kolom kustom berupa angka ganda. |
BOOLEAN |
Nilai kolom kustom adalah boolean. |
DATE |
Nilai kolom kustom adalah tanggal, dalam format YYYYMMDD. |
CustomColumnRenderType
Enum yang berisi berbagai cara penafsiran kolom kustom.
Enum |
UNSPECIFIED |
Tidak ditentukan. |
UNKNOWN |
Tak diketahui. |
NUMBER |
Kolom kustom adalah nilai numerik mentah. Lihat kolom valueType untuk menentukan apakah nilainya berupa bilangan bulat atau ganda. |
PERCENT |
Kolom kustom harus dikalikan dengan 100 untuk mengambil nilai persentase. |
MONEY |
Nilai kolom kustom adalah nilai uang dan dalam mikro. |
STRING |
Nilai kolom kustom adalah string. |
BOOLEAN |
Nilai kolom kustom adalah boolean. |
DATE |
Nilai kolom kustom adalah tanggal yang direpresentasikan sebagai bilangan bulat dalam format YYYYMMDD. |
Metode |
|
Menampilkan kolom kustom yang diminta dengan detail lengkap. |
|
Menampilkan semua kolom kustom yang terkait dengan pelanggan secara mendetail. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]