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

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

SearchAds360Fields/{name}

category

enum (SearchAds360FieldCategory)

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

selectableWith[]

string

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

attributeResources[]

string

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

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

metrics[]

string

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

segments[]

string

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

enumValues[]

string

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

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

dataType

enum (SearchAds360FieldDataType)

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

name

string

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

selectable

boolean

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

filterable

boolean

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

sortable

boolean

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

typeUrl

string

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

isRepeated

boolean

אם הארטיפקט של השדה חוזר על עצמו.

SearchAds360FieldCategory

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

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

SearchAds360FieldDataType

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

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

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

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

DATE

ממופים ל-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

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