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
הערך True מופיע כאשר העמודה בהתאמה אישית מפנה למאפיין אחד או יותר.
|
referencesMetrics |
boolean
הערך הוא True כשהעמודה בהתאמה אישית מפנה למדד אחד או יותר.
|
queryable |
boolean
הערך True מופיע כאשר העמודה בהתאמה אישית זמינה לשימוש בשאילתה של SearchAds360Service.Search ושל SearchAds360Service.SearchStream.
|
referencedSystemColumns[] |
string
הרשימה של עמודות המערכת שאליהן מתבצעת הפניה של העמודה המותאמת אישית הזו. לדוגמה, עמודה בהתאמה אישית בשם 'סכום החשיפות והקליקים' הפנתה לעמודות המערכת {"metrics.clicks", "metrics.impressions"}.
|
renderType |
enum (CustomColumnRenderType )
איך צריך לפרש את ערך התוצאה של העמודה בהתאמה אישית.
|
CustomColumnValueType
Enum שמכיל את סוגי הערכים האפשריים של עמודות בהתאמה אישית.
טיפוסים בני מנייה (enum) |
UNSPECIFIED |
לא צוין. |
UNKNOWN |
לא ידוע. |
STRING |
הערך של העמודה בהתאמה אישית הוא מחרוזת. |
INT64 |
הערך של העמודה בהתאמה אישית הוא מספר int64. |
DOUBLE |
הערך של העמודה בהתאמה אישית הוא מספר כפול. |
BOOLEAN |
הערך של העמודה בהתאמה אישית הוא בוליאני. |
DATE |
הערך בעמודה בהתאמה אישית הוא תאריך בפורמט YYYYMMDD. |
CustomColumnRenderType
ערכים של טיפוסים בני מנייה (enum) המכיל את הדרכים השונות שבהן ניתן לפרש עמודה מותאמת אישית.
טיפוסים בני מנייה (enum) |
UNSPECIFIED |
לא צוין. |
UNKNOWN |
לא ידוע. |
NUMBER |
העמודה בהתאמה אישית היא ערך מספרי גולמי. בודקים את השדה valueType כדי לקבוע אם מדובר במספר שלם או במספר כפול. |
PERCENT |
כדי לאחזר את ערך האחוז, צריך להכפיל את העמודה בהתאמה אישית ב-100. |
MONEY |
הערך בעמודה בהתאמה אישית הוא ערך כספי ב-micros. |
STRING |
הערך של העמודה בהתאמה אישית הוא מחרוזת. |
BOOLEAN |
הערך של העמודה בהתאמה אישית הוא בוליאני. |
DATE |
הערך בעמודה בהתאמה אישית הוא תאריך שמיוצג כמספר שלם בפורמט YYYYMMDD. |
שיטות |
|
הפונקציה מחזירה את העמודה בהתאמה אישית המבוקשת בפירוט מלא. |
|
הפונקציה מחזירה את כל העמודות בהתאמה אישית שמשויכות ללקוח בפירוט מלא. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 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. |"]]