REST Resource: searchAds360Fields

משאב: SearchAds360Field

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

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

string

שם המשאב של הארטיפקט. שמות המשאבים של הארטיפקטים הם בפורמט:

SearchAds360Fields/{name}

category

enum (SearchAds360FieldCategory)

הקטגוריה של הארטיפקט.

selectableWith[]

string

השמות של כל המשאבים, הפלחים והמדדים שאפשר לבחור באמצעות הארטיפקט המתואר.

attributeResources[]

string

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

השדה הזה מוגדר רק לארטיפקטים שהקטגוריה שלהם היא RESOURCE.

metrics[]

string

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

segments[]

string

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

enumValues[]

string

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

השדה הזה מוגדר רק לארטיפקטים בקטגוריה SEGMENT או ATTRIBUTE.

dataType

enum (SearchAds360FieldDataType)

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

name

string

השם של הארטיפקט.

selectable

boolean

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

filterable

boolean

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

sortable

boolean

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

typeUrl

string

כתובת ה-URL של ה-proto שמתאר את סוג הנתונים של הארטיפקט.

isRepeated

boolean

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

SearchAds360FieldCategory

הקטגוריה של הארטיפקט.

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

SearchAds360FieldDataType

אלה הסוגים השונים של הארטיפקט SearchAds360Service.

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

המיפוי הוא אל google.protobuf.BoolValue

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

DATE

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

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

DOUBLE

ממופים ל-google.protobuf.DoubleValue

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

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

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