Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google
searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
REST Resource: customers.customColumns
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทรัพยากร: CustomColumn
| การแสดง JSON |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType)
} |
| ช่อง |
resourceName |
string
ชื่อแหล่งข้อมูลของคอลัมน์ที่กำหนดเอง ชื่อทรัพยากรคอลัมน์ที่กำหนดเองจะมีรูปแบบดังนี้ customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
รหัสของคอลัมน์ที่กำหนดเอง
|
name |
string
ชื่อคอลัมน์ที่กำหนดเองโดยผู้ใช้
|
description |
string
คําอธิบายคอลัมน์ที่กําหนดเองโดยผู้ใช้
|
valueType |
enum (CustomColumnValueType)
ประเภทของค่าผลลัพธ์ของคอลัมน์ที่กำหนดเอง
|
referencesAttributes |
boolean
จริงเมื่อคอลัมน์ที่กำหนดเองอ้างอิงแอตทริบิวต์อย่างน้อย 1 รายการ
|
referencesMetrics |
boolean
เป็นจริงเมื่อคอลัมน์ที่กำหนดเองอ้างอิงถึงเมตริกอย่างน้อย 1 รายการ
|
queryable |
boolean
เป็นจริงเมื่อคอลัมน์ที่กําหนดเองพร้อมใช้งานในคําค้นหาของ SearchAds360Service.Search และ SearchAds360Service.SearchStream
|
referencedSystemColumns[] |
string
รายการคอลัมน์ระบบที่อ้างอิงถึงของคอลัมน์ที่กำหนดเองนี้ ตัวอย่างเช่น คอลัมน์ที่กำหนดเอง "ผลรวมของการแสดงผลและการคลิก" อ้างอิงคอลัมน์ระบบ {"metrics.clicks", "metrics.impressions"}
|
renderType |
enum (CustomColumnRenderType)
วิธีตีความค่าผลลัพธ์ของคอลัมน์ที่กำหนดเอง
|
CustomColumnValueType
Enum ที่มีประเภทค่าคอลัมน์ที่กำหนดเองที่เป็นไปได้
| Enum |
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ไม่รู้จัก |
STRING |
ค่าคอลัมน์ที่กำหนดเองคือสตริง |
INT64 |
ค่าคอลัมน์ที่กำหนดเองคือตัวเลข int64 |
DOUBLE |
ค่าคอลัมน์ที่กำหนดเองคือตัวเลขทศนิยม |
BOOLEAN |
ค่าคอลัมน์ที่กำหนดเองคือบูลีน |
DATE |
ค่าคอลัมน์ที่กำหนดเองคือวันที่ในรูปแบบ ปปปปดดวว |
CustomColumnRenderType
Enum ที่มีวิธีต่างๆ ในการตีความคอลัมน์ที่กำหนดเอง
| Enum |
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ไม่รู้จัก |
NUMBER |
คอลัมน์ที่กำหนดเองคือค่าตัวเลขดิบ ดูช่อง valueType เพื่อระบุว่าเป็นจำนวนเต็มหรือจำนวนทศนิยม |
PERCENT |
คอลัมน์ที่กำหนดเองควรคูณด้วย 100 เพื่อดึงค่าเปอร์เซ็นต์ |
MONEY |
ค่าของคอลัมน์ที่กำหนดเองเป็นมูลค่าทางการเงินและอยู่ในหน่วยไมโคร |
STRING |
ค่าของคอลัมน์ที่กำหนดเองคือสตริง |
BOOLEAN |
ค่าคอลัมน์ที่กำหนดเองคือบูลีน |
DATE |
ค่าคอลัมน์ที่กำหนดเองคือวันที่ที่แสดงเป็นจำนวนเต็มในรูปแบบ ปปปปดดวว |
เมธอด |
|
|
แสดงผลคอลัมน์ที่กำหนดเองที่ขออย่างละเอียด |
|
|
แสดงคอลัมน์ที่กำหนดเองทั้งหมดที่เกี่ยวข้องกับลูกค้าโดยละเอียด |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]
