Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yaklaşan geliştirmeler ve sürümlerden haberdar olmak için
searchads-api-announcements Google grubuna katılın.
REST Resource: customers.customColumns
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: CustomColumn
JSON gösterimi |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType ),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType )
} |
Alanlar |
resourceName |
string
Özel sütunun kaynak adı. Özel sütun kaynak adları şu biçimdedir: customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
Özel sütunun kimliği.
|
name |
string
Özel sütunun kullanıcı tanımlı adı.
|
description |
string
Özel sütunun kullanıcı tanımlı açıklaması.
|
valueType |
enum (CustomColumnValueType )
Özel sütunun sonuç değerinin türü.
|
referencesAttributes |
boolean
Özel sütun bir veya daha fazla özelliğe atıfta bulunduğunda doğru değerini döndürür.
|
referencesMetrics |
boolean
Özel sütun bir veya daha fazla metriği referans aldığında doğru değerini döndürür.
|
queryable |
boolean
Özel sütun, SearchAds360Service.Search ve SearchAds360Service.SearchStream sorgusunda kullanılabiliyorsa doğru değerini döndürür.
|
referencedSystemColumns[] |
string
Bu özel sütunda başvurulan sistem sütunlarının listesi. Örneğin, "gösterim ve tıklama sayısı toplamı" adlı özel bir sütun, {"metrics.clicks", "metrics.impressions"} sistem sütunlarına referans vermiştir.
|
renderType |
enum (CustomColumnRenderType )
Özel sütunun sonuç değerinin nasıl yorumlanması gerektiği.
|
CustomColumnValueType
Olası özel sütun değeri türlerini içeren bir enum.
Sıralamalar |
UNSPECIFIED |
Belirtilmedi. |
UNKNOWN |
Bilinmiyor. |
STRING |
Özel sütun değeri bir dizedir. |
INT64 |
Özel sütun değeri bir int64 sayısıdır. |
DOUBLE |
Özel sütun değeri, çift değerdir. |
BOOLEAN |
Özel sütun değeri boole değeridir. |
DATE |
Özel sütun değeri, YYYYAAGG biçiminde bir tarihtir. |
CustomColumnRenderType
Özel bir sütunun farklı yorumlanabileceği yöntemleri içeren sıralama.
Sıralamalar |
UNSPECIFIED |
Belirtilmedi. |
UNKNOWN |
Bilinmiyor. |
NUMBER |
Özel sütun, işlenmemiş bir sayısal değerdir. Tam sayı mı yoksa çift mi olduğunu belirlemek için valueType alanına bakın. |
PERCENT |
Yüzde değerinin alınması için özel sütunun 100 ile çarpılması gerekir. |
MONEY |
Özel sütun değeri parasal bir değerdir ve mikro cinsindendir. |
STRING |
Özel sütun değeri bir dizedir. |
BOOLEAN |
Özel sütun değeri bir boole değeridir. |
DATE |
Özel sütun değeri, YYYYAAGG biçiminde tam sayı olarak temsil edilen bir tarihtir. |
Yöntemler |
|
İstenen özel sütunu tüm ayrıntılarıyla döndürür. |
|
Müşteriyle ilişkilendirilen tüm özel sütunları tam ayrıntı olarak döndürür. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]