API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه 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 )
} |
فیلدها |
---|
resource Name | string نام منبع ستون سفارشی. نام منابع ستون سفارشی به شکل زیر است: customers/{customerId}/customColumns/{custom_column_id} |
id | string ( int64 format) شناسه ستون سفارشی |
name | string نام ستون سفارشی تعریف شده توسط کاربر. |
description | string شرح تعریف شده توسط کاربر از ستون سفارشی. |
value Type | enum ( CustomColumnValueType ) نوع مقدار نتیجه ستون سفارشی. |
references Attributes | boolean درست زمانی که ستون سفارشی به یک یا چند ویژگی اشاره دارد. |
references Metrics | boolean درست زمانی که ستون سفارشی به یک یا چند معیار اشاره دارد. |
queryable | boolean درست زمانی که ستون سفارشی برای استفاده در جستار SearchAds360Service.Search و SearchAds360Service.SearchStream در دسترس باشد. |
referenced System Columns[] | string لیست ستون های سیستم ارجاع شده این ستون سفارشی. به عنوان مثال، یک ستون سفارشی "مجموع نمایش ها و کلیک ها" به ستون های سیستمی از {"metrics.clicks"، "metrics.impressions"} ارجاع داده شده است. |
render Type | enum ( CustomColumnRenderType ) چگونه مقدار نتیجه ستون سفارشی باید تفسیر شود. |
CustomColumnValueType
Enum حاوی انواع مقدار ستون سفارشی ممکن است.
Enums |
---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | ناشناس. |
STRING | مقدار ستون سفارشی یک رشته است. |
INT64 | مقدار ستون سفارشی یک عدد int64 است. |
DOUBLE | مقدار ستون سفارشی یک عدد دو برابر است. |
BOOLEAN | مقدار ستون سفارشی یک بولی است. |
DATE | مقدار ستون سفارشی یک تاریخ است، در قالب YYYYMMDD. |
CustomColumnRenderType
Enum حاوی راه های مختلفی برای تفسیر یک ستون سفارشی است.
Enums |
---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | ناشناس. |
NUMBER | ستون سفارشی یک مقدار عددی خام است. فیلد valueType را ببینید تا مشخص کنید عدد صحیح است یا دوتایی. |
PERCENT | برای بازیابی مقدار درصد، ستون سفارشی باید در 100 ضرب شود. |
MONEY | مقدار ستون سفارشی یک مقدار پولی است و بر حسب میکرو است. |
STRING | مقدار ستون سفارشی یک رشته است. |
BOOLEAN | مقدار ستون سفارشی یک بولی است. |
DATE | مقدار ستون سفارشی تاریخی است که به عنوان یک عدد صحیح در قالب YYYYMMDD نمایش داده می شود. |
روش ها |
---|
| ستون سفارشی درخواستی را با جزئیات کامل برمی گرداند. |
| تمام ستون های سفارشی مرتبط با مشتری را با جزئیات کامل برمی گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-19 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-19 بهوقت ساعت هماهنگ جهانی."],[[["A `CustomColumn` 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."],["`CustomColumnValueType` and `CustomColumnRenderType` 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."],["Developers can utilize methods like `get` and `list` 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."]]],["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"]]