أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
REST Resource: customers.customColumns
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: عمود مخصّص
| تمثيل 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
صحيح عندما يشير العمود المخصّص إلى سمة واحدة أو أكثر.
|
referencesMetrics |
boolean
صحيح عندما يشير العمود المخصّص إلى مقياس واحد أو أكثر.
|
queryable |
boolean
صحيح عندما يكون العمود المخصّص متاحًا للاستخدام في طلب البحث SearchAds360Service.Search وSearchAds360Service.SearchStream.
|
referencedSystemColumns[] |
string
قائمة أعمدة النظام المُشار إليها في هذا العمود المخصّص على سبيل المثال، أشار العمود المخصّص "مجموع مرّات الظهور والنقرات" إلى أعمدة النظام {"metrics.clicks", "metrics.impressions"}.
|
renderType |
enum (CustomColumnRenderType)
كيفية تفسير قيمة النتيجة للعمود المخصّص
|
CustomColumnValueType
فهرس يحتوي على أنواع قيم الأعمدة المخصّصة المحتملة
| عمليات التعداد |
UNSPECIFIED |
غير محدّد |
UNKNOWN |
غير معروف. |
STRING |
قيمة العمود المخصّص هي سلسلة. |
INT64 |
قيمة العمود المخصّص هي عدد int64. |
DOUBLE |
قيمة العمود المخصّص هي رقم مزدوج. |
BOOLEAN |
قيمة العمود المخصّص منطقية. |
DATE |
قيمة العمود المخصّص هي تاريخ بالتنسيق YYYYMMDD. |
CustomColumnRenderType
رقم تعداد يحتوي على الطرق المختلفة التي يمكن من خلالها تفسير عمود مخصّص
| عمليات التعداد |
UNSPECIFIED |
غير محدّد |
UNKNOWN |
غير معروف. |
NUMBER |
العمود المخصّص هو قيمة رقمية أساسية. اطّلِع على حقل valueType لتحديد ما إذا كان عددًا صحيحًا أو عددًا مزدوجًا. |
PERCENT |
يجب ضرب العمود المخصّص في 100 لاسترداد قيمة النسبة المئوية. |
MONEY |
قيمة العمود المخصّص هي قيمة مالية وتكون بالميكروم. |
STRING |
قيمة العمود المخصّص هي سلسلة. |
BOOLEAN |
قيمة العمود المخصّص منطقية. |
DATE |
قيمة العمود المخصّص هي تاريخ يتم تمثيله كعدد صحيح بالتنسيق YYYYMMDD. |
الطُرق |
|
|
عرض العمود المخصّص المطلوب بالتفصيل الكامل |
|
|
تعرِض هذه السمة جميع الأعمدة المخصّصة المرتبطة بالعميل بالتفصيل الكامل. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
