REST Resource: googleAdsFields

משאב: GoogleAdsField

שדה או משאב (ארטיפקט) שמשמשים את GoogleAdsService.

ייצוג JSON
{
  "resourceName": string,
  "category": enum (GoogleAdsFieldCategory),
  "selectableWith": [
    string
  ],
  "attributeResources": [
    string
  ],
  "metrics": [
    string
  ],
  "segments": [
    string
  ],
  "enumValues": [
    string
  ],
  "dataType": enum (GoogleAdsFieldDataType),
  "name": string,
  "selectable": boolean,
  "filterable": boolean,
  "sortable": boolean,
  "typeUrl": string,
  "isRepeated": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של פריט המידע שנוצר בתהליך הפיתוח (Artifact). שמות של משאבי Artifact הם בתבנית:

googleAdsFields/{name}

category

enum (GoogleAdsFieldCategory)

פלט בלבד. הקטגוריה של פריט המידע שנוצר בתהליך הפיתוח (Artifact).

selectableWith[]

string

פלט בלבד. השמות של כל המשאבים, הפלחים והמדדים שניתן לבחור באמצעות פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר.

attributeResources[]

string

פלט בלבד. השמות של כל המשאבים שניתן לבחור בהם בארטיפקט המתואר. השדות מהמשאבים האלה לא מפלחים מדדים כשהם נכללים בשאילתות חיפוש.

השדה הזה מוגדר רק לפריטי מידע שנוצרו בתהליך הפיתוח (Artifact) שהקטגוריה שלהם היא Resource.

metrics[]

string

פלט בלבד. בשדה הזה מפורטים השמות של כל המדדים שניתן לבחור עם פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר כשמשתמשים בו בסעיף FROM. הוא מוגדר רק לפריטי מידע שנוצרו בתהליך פיתוח (Artifact) שהקטגוריה שלהם היא Resource.

segments[]

string

פלט בלבד. השדה הזה מפרט את השמות של כל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact), בין אם מדובר בפלח או במשאב אחר, שמדדי הפילוח שלהם נכללים בשאילתות החיפוש וכשנעשה שימוש בארטיפקט המתואר בסעיף FROM. הוא מוגדר רק לפריטי מידע שנוצרו בתהליך פיתוח (Artifact) שהקטגוריה שלהם היא Resource.

enumValues[]

string

פלט בלבד. ערכים שהארטיפקט יכול להניח אם הוא שדה מסוג ENUM.

השדה הזה מוגדר רק עבור פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של הקטגוריה SEGMENT או ATTRIBUTE.

dataType

enum (GoogleAdsFieldDataType)

פלט בלבד. השדה הזה קובע את האופרטורים שבהם ניתן להשתמש עם פריט המידע שנוצר בתהליך הפיתוח (Artifact) בסעיפים של WHERE.

name

string

פלט בלבד. השם של פריט המידע שנוצר בתהליך הפיתוח (Artifact).

selectable

boolean

פלט בלבד. האם ניתן להשתמש בארטיפקט במשפט SELECT בשאילתות חיפוש.

filterable

boolean

פלט בלבד. האם ניתן להשתמש בארטיפקט במשפט WHERE בשאילתות חיפוש.

sortable

boolean

פלט בלבד. האם ניתן להשתמש בארטיפקט במשפט ORDER BY בשאילתות חיפוש.

typeUrl

string

פלט בלבד. כתובת ה-URL של פרוטו שמתאר את סוג הנתונים של פריט המידע שנוצר בתהליך הפיתוח (Artifact).

isRepeated

boolean

פלט בלבד. האם פריט המידע שנוצר בתהליך הפיתוח (Artifact) חוזר על עצמו.

GoogleAdsFieldCategory

הקטגוריה של פריט המידע שנוצר בתהליך הפיתוח (Artifact).

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין
UNKNOWN לא ידוע
RESOURCE פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר הוא משאב.
ATTRIBUTE פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר הוא שדה, והוא תכונה של משאב. הכללת שדה של מאפיין משאב בשאילתה עשויה לפלח את השאילתה אם המשאב שאליו הוא מיוחס מפלח את המשאב שנמצא בסעיף FROM.
SEGMENT פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר הוא שדה והוא תמיד מפלח את שאילתות החיפוש.
METRIC פריט המידע שנוצר בתהליך הפיתוח (Artifact) המתואר הוא שדה והוא מדד. המערכת אף פעם לא מפלחת שאילתות חיפוש.

GoogleAdsFieldDataType

אלה הסוגים השונים של פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של Google AdsService.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין
UNKNOWN לא ידוע
BOOLEAN

מפות אל google.protobuf.BoolValue

אופרטורים רלוונטיים: =, !=

DATE

מפות אל google.protobuf.StringValue. עם זאת, אפשר להשוות אותו באמצעות קבוצת האופרטורים הספציפית לתאריכים.

אופרטורים רלוונטיים: =, <, >, <=, >=, BETWEEN, DURING ו-IN

DOUBLE

מפות אל google.protobuf.DoubleValue

אופרטורים רלוונטיים: =, !=, <, >, IN, NOT IN

ENUM

מפות לטיפוסים בני מנייה (enum). ניתן למצוא את ההגדרה הספציפית שלה ב-typeUrl.

אופרטורים רלוונטיים: =, !=, IN, NOT IN

FLOAT

מפות אל google.protobuf.FloatValue

אופרטורים רלוונטיים: =, !=, <, >, IN, NOT IN

INT32

מפות אל google.protobuf.Int32Value

אופרטורים רלוונטיים: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

INT64

מפות אל google.protobuf.Int64Value

אופרטורים רלוונטיים: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

MESSAGE

מפות אל סוג הודעה של מאגר נתונים זמני. הפרטים של סוג הנתונים מופיעים ב-typeUrl.

אין אופרטורים שפועלים עם שדות MESSAGE.

RESOURCE_NAME

מפות אל google.protobuf.StringValue. מייצג את שם המשאב (מזהה ייחודי) של משאב או של אחד מהמפתחות הזרים שלו.

אין אופרטורים שפועלים עם השדות Resource_NAME.

STRING

מפות אל google.protobuf.StringValue.

אופרטורים רלוונטיים: =, !=, LIKE, NOT LIKE, IN, NOT IN

UINT64

מפות אל google.protobuf.UInt64Value

אופרטורים רלוונטיים: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

שיטות

get

מחזירה רק את השדה המבוקש.
מחזירה את כל השדות שתואמים לשאילתת החיפוש.