API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google
searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
REST Resource: customers.customColumns
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: CustomColumn
Biểu diễn dưới dạng JSON |
{
"resourceName": string,
"id": string,
"name": string,
"description": string,
"valueType": enum (CustomColumnValueType ),
"referencesAttributes": boolean,
"referencesMetrics": boolean,
"queryable": boolean,
"referencedSystemColumns": [
string
],
"renderType": enum (CustomColumnRenderType )
} |
Trường |
resourceName |
string
Tên tài nguyên của cột tuỳ chỉnh. Tên tài nguyên cột tuỳ chỉnh có dạng: customers/{customerId}/customColumns/{custom_column_id}
|
id |
string (int64 format)
Mã của cột tuỳ chỉnh.
|
name |
string
Tên do người dùng xác định của cột tuỳ chỉnh.
|
description |
string
Nội dung mô tả do người dùng xác định cho cột tuỳ chỉnh.
|
valueType |
enum (CustomColumnValueType )
Loại giá trị kết quả của cột tuỳ chỉnh.
|
referencesAttributes |
boolean
Đúng khi cột tuỳ chỉnh tham chiếu đến một hoặc nhiều thuộc tính.
|
referencesMetrics |
boolean
Đúng khi cột tuỳ chỉnh đề cập đến một hoặc nhiều chỉ số.
|
queryable |
boolean
Đúng khi có thể sử dụng cột tuỳ chỉnh trong truy vấn của SearchAds360Service.Search và SearchAds360Service.SearchStream.
|
referencedSystemColumns[] |
string
Danh sách các cột hệ thống được tham chiếu của cột tuỳ chỉnh này. Ví dụ: "Tổng số lượt hiển thị và lượt nhấp" trong một cột tuỳ chỉnh có các cột hệ thống tham chiếu {"chi.clicks", "chiso.display"}.
|
renderType |
enum (CustomColumnRenderType )
Cách diễn giải giá trị kết quả của cột tuỳ chỉnh.
|
CustomColumnValueType
Enum chứa các loại giá trị cột tuỳ chỉnh có thể có.
Enum |
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Không xác định. |
STRING |
Giá trị cột tuỳ chỉnh là một chuỗi. |
INT64 |
Giá trị cột tuỳ chỉnh là một số int64. |
DOUBLE |
Giá trị của cột tuỳ chỉnh là một số kép. |
BOOLEAN |
Giá trị cột tuỳ chỉnh là boolean. |
DATE |
Giá trị cột tuỳ chỉnh là một ngày, ở định dạng YYYYMMDD. |
CustomColumnRenderType
Enum chứa nhiều cách diễn giải cột tuỳ chỉnh.
Enum |
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Không xác định. |
NUMBER |
Cột tuỳ chỉnh là một giá trị thô dạng số. Xem trường valueType để xác định xem đó là số nguyên hay số thực. |
PERCENT |
Bạn phải nhân cột tuỳ chỉnh với 100 để truy xuất giá trị phần trăm. |
MONEY |
Giá trị cột tuỳ chỉnh là một giá trị tiền tệ và có định dạng micro. |
STRING |
Giá trị của cột tuỳ chỉnh là một chuỗi. |
BOOLEAN |
Giá trị cột tuỳ chỉnh là một giá trị boolean. |
DATE |
Giá trị cột tuỳ chỉnh là ngày được biểu thị dưới dạng số nguyên ở định dạng YYYYMMDD. |
Phương thức |
|
Trả về cột tuỳ chỉnh được yêu cầu một cách đầy đủ. |
|
Trả về tất cả cột tuỳ chỉnh được liên kết với khách hàng một cách chi tiết. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]