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). השדות מהמשאבים האלה לא מפלחים מדדים כשהם כלולים בשאילתות חיפוש.

השדה הזה מוגדר רק לפריטי מידע שנוצרו בתהליך הפיתוח (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

פלט בלבד. האם ניתן להשתמש בתוצר המידע (Artifact) במשפט 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.BolValue

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

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

מפות Google לסוג הודעה של מאגר נתונים זמני. הפרטים של סוג הנתונים מופיעים ב-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

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