REST Resource: projects.locations.collections.dataStores.controls

משאב: קבוצת בקרה

הגדרת התנהגות מותנית שתופעל במהלך הצגת המודעה. כדי שההנחה תהיה זמינה בזמן הצגת המודעה, היא צריכה להיות משויכת לServingConfig. הפעולות המותרות תלויות ב-SolutionType.

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "associatedServingConfigIds": [
    string
  ],
  "solutionType": enum (SolutionType),
  "useCases": [
    enum (SearchUseCase)
  ],
  "conditions": [
    {
      object (Condition)
    }
  ],

  // Union field action can be only one of the following:
  "boostAction": {
    object (BoostAction)
  },
  "filterAction": {
    object (FilterAction)
  },
  "redirectAction": {
    object (RedirectAction)
  },
  "synonymsAction": {
    object (SynonymsAction)
  },
  "promoteAction": {
    object (PromoteAction)
  }
  // End of list of possible types for union field action.
}
שדות
name

string

אי אפשר לשנות. שם ייחודי מלא projects/*/locations/global/dataStore/*/controls/*
displayName

string

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

מחרוזת בקידוד UTF-8. האורך המרבי הוא 128 תווים. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.
associatedServingConfigIds[]

string

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

enum (SolutionType)

חובה. אי אפשר לשנות. הפתרון שאליו שייך אמצעי הבקרה.

הערך צריך להיות תואם לקטגוריית הישויות (vertical) של המשאב. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.
useCases[]

enum (SearchUseCase)

מציינת את תרחיש השימוש של אמצעי הבקרה. משפיע על שדות התנאים שאפשר להגדיר. רלוונטי רק ל-SOLUTION_TYPE_SEARCH. בשלב הזה, אפשר להגדיר רק תרחיש שימוש אחד לכל אמצעי בקרה. חובה להגדיר את הערך הזה כש-solutionType הוא SolutionType.SOLUTION_TYPE_SEARCH.
conditions[]

object (Condition)

ההגדרה הזו קובעת מתי תופעל הפעולה המשויכת.

אם לא מציינים כלום, הפעולה תמיד תתבצע. בשלב הזה אפשר לציין רק תנאי אחד. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.

שדה איחוד action. הפעולות מוגבלות לפי קטגוריה ופתרון

חובה. הערך action יכול להיות רק אחד מהבאים:
boostAction

object (BoostAction)

הגדרה של אמצעי בקרה מסוג הגברה
filterAction

object (FilterAction)

הגדרה של פקד מסוג filter-type. לא נתמך כרגע על ידי Recommendation
redirectAction

object (RedirectAction)

הגדרה של אמצעי בקרה מסוג הפניה אוטומטית.
synonymsAction

object (SynonymsAction)

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

object (PromoteAction)

קידום קישורים מסוימים על סמך שאילתות מפעילות מוגדרות מראש.

BoostAction

משנה את סדר המוצרים ברשימה שמוחזרת.

ייצוג ב-JSON 
{
  "boost": number,
  "filter": string,
  "dataStore": string,

  // Union field boost_spec can be only one of the following:
  "fixedBoost": number,
  "interpolationBoostSpec": {
    object (InterpolationBoostSpec)
  }
  // End of list of possible types for union field boost_spec.
}
שדות
boost
(deprecated)

number

עוצמת ההגברה, שצריכה להיות בטווח [‎-1, 1]. הגברה שלילית משמעותה הורדה בדרגה. ברירת המחדל היא 0.0 (ללא פעולה).
filter

string

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

אם לא מציינים מסנן, כל המוצרים יקבלו דחיפה (No-op). מסמכי תחביר: https://cloud.google.com/retail/docs/filter-and-order האורך המקסימלי הוא 5,000 תווים. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.
dataStore

string

חובה. מציין את מסמכי מאגר הנתונים שאפשר להגביר את הדירוג שלהם באמצעות הרכיב הזה. השם המלא של מאגר הנתונים, לדוגמה: projects/123/locations/global/collections/default_collection/dataStores/default_data_store
שדה איחוד boost_spec. הגדרות של הגדלת ערך קבוע או הגדלת ערך מותאם אישית לדירוג. הערך boost_spec יכול להיות רק אחד מהבאים:
fixedBoost

number

זה שינוי אופציונלי. עוצמת ההגברה, שצריכה להיות בטווח [‎-1, 1]. הגברה שלילית משמעותה הורדה בדרגה. ברירת המחדל היא 0.0 (ללא פעולה).
interpolationBoostSpec

object (InterpolationBoostSpec)

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

InterpolationBoostSpec

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

ייצוג ב-JSON 
{
  "fieldName": string,
  "attributeType": enum (AttributeType),
  "interpolationType": enum (InterpolationType),
  "controlPoints": [
    {
      object (ControlPoint)
    }
  ]
}
שדות
fieldName

string

זה שינוי אופציונלי. השם של השדה שהערך שלו ישמש לקביעת סכום ההגדלה.
attributeType

enum (AttributeType)

זה שינוי אופציונלי. סוג המאפיין שמשמש לקביעת סכום ההגדלה. אפשר לגזור את ערך המאפיין מערך השדה של fieldName שצוין. במקרה של ערך מספרי, זה פשוט: attributeValue = numerical_field_value. במקרה של טריות, לעומת זאת, attributeValue = (time.now() - datetime_field_value).
interpolationType

enum (InterpolationType)

זה שינוי אופציונלי. סוג האינטרפולציה שיש להחיל כדי לחבר את נקודות הבקרה שמפורטות בהמשך.
controlPoints[]

object (ControlPoint)

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

AttributeType

המאפיין(או הפונקציה) שעליו יחול הדירוג המותאם אישית.

טיפוסים בני מנייה (enum)
ATTRIBUTE_TYPE_UNSPECIFIED סוג מאפיין לא מזוהה.
NUMERICAL הערך של השדה המספרי ישמש לעדכון דינמי של סכום ההגדלה. במקרה הזה, attributeValue (הערך x) של נקודת הבקרה יהיה הערך בפועל של השדה המספרי שעבורו צוין boostAmount.
FRESHNESS בתרחיש לדוגמה של רעננות, ערך המאפיין יהיה משך הזמן שחלף בין השעה הנוכחית לבין התאריך בשדה של התאריך והשעה שצוינו. הערך צריך להיות בפורמט של ערך XSD dayTimeDuration (קבוצת משנה מוגבלת של ערך משך זמן לפי תקן ISO 8601). הדוגמה לכך היא: [nD][T[nH][nM][nS]]. לדוגמה, 5D, ‏ 3DT12H30M, ‏ T24H.

InterpolationType

סוג האינטרפולציה שרוצים להחיל. ברירת המחדל תהיה לינארית (Piecewise Linear).

טיפוסים בני מנייה (enum)
INTERPOLATION_TYPE_UNSPECIFIED לא צוין סוג האינטרפולציה. במקרה כזה, ברירת המחדל היא לינארית.
LINEAR תופעל אינטרפולציה ליניארית מקטעית.

ControlPoint

נקודות הבקרה שמשמשות להגדרת העקומה. העקומה שמוגדרת באמצעות נקודות הבקרה האלה יכולה להיות רק עולה או יורדת(ערכים קבועים הם אפשריים).

ייצוג ב-JSON 
{
  "attributeValue": string,
  "boostAmount": number
}
שדות
attributeValue

string

זה שינוי אופציונלי. יכול להיות אחד מהערכים הבאים: 1. הערך המספרי של השדה. 2. מפרט משך הזמן של הטריות: הערך צריך להיות בפורמט של ערך XSD dayTimeDuration (קבוצת משנה מוגבלת של ערך משך זמן בפורמט ISO 8601). הדוגמה לכך היא: [nD][T[nH][nM][nS]].
boostAmount

number

זה שינוי אופציונלי. הערך בין -1 ל-1 שבו יש להגדיל את הניקוד אם הערך של attributeValue שווה לערך שצוין למעלה.

FilterAction

ציינתם אילו מוצרים יכולים להיכלל בתוצאות. משתמש באותו מסנן כמו בשיפור.

ייצוג ב-JSON 
{
  "filter": string,
  "dataStore": string
}
שדות
filter

string

חובה. מסנן להחלה על התוצאות של התנאי התואם.

מסמכי תחביר נדרשים: https://cloud.google.com/retail/docs/filter-and-order האורך המקסימלי הוא 5,000 תווים. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.
dataStore

string

חובה. מציינת את מסמכי מאגר הנתונים שאפשר לסנן באמצעות הרכיב הזה. השם המלא של מאגר הנתונים, לדוגמה: projects/123/locations/global/collections/default_collection/dataStores/default_data_store

RedirectAction

מפנה קונה לכתובת ה-URI שצוינה.

ייצוג ב-JSON 
{
  "redirectUri": string
}
שדות
redirectUri

string

חובה. ה-URI שאליו הקונה יופנה.

חובה. אורך ה-URI צריך להיות 2,000 תווים או פחות. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.

SynonymsAction

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

לדוגמה, המילה happy תיחשב גם כ-glad, והמילה glad תיחשב גם כ-happy.

ייצוג ב-JSON 
{
  "synonyms": [
    string
  ]
}
שדות
synonyms[]

string

מגדיר קבוצה של מילים נרדפות. אפשר לציין עד 100 מילים נרדפות. צריך לציין לפחות 2 מילים נרדפות. אחרת, מוצגת שגיאה מסוג INVALID ARGUMENT.

PromoteAction

לקדם קישורים מסוימים על סמך שאילתות טריגר מסוימות.

דוגמה: קידום קישור לחנות נעליים כשמחפשים את מילת המפתח shoe. הקישור יכול להיות מחוץ למאגר הנתונים המשויך.

ייצוג ב-JSON 
{
  "dataStore": string,
  "searchLinkPromotion": {
    object (SearchLinkPromotion)
  }
}
שדות
dataStore

string

חובה. מאגר הנתונים שאליו המבצע הזה משויך.

SearchLinkPromotion

פרוטוקול הקידום כולל URI ומידע נוסף שיעזור להציג את הקידום.

ייצוג ב-JSON 
{
  "title": string,
  "uri": string,
  "document": string,
  "imageUri": string,
  "description": string,
  "enabled": boolean
}
שדות
title

string

חובה. שם המבצע. האורך המקסימלי הוא 160 תווים.
uri

string

זה שינוי אופציונלי. כתובת ה-URL של הדף שהמשתמש רוצה לקדם. חובה להגדיר את הפרמטר הזה לחיפוש באתר. בקטגוריות אחרות, המאפיין הזה הוא אופציונלי.
document

string

זה שינוי אופציונלי. Document המשתמש שרוצים להעניק לו הרשאת אדמין. לחיפוש באתר, משאירים את השדה ללא הגדרה ומאכלסים רק את ה-URI. אפשר להגדיר אותו יחד עם uri.
imageUri

string

זה שינוי אופציונלי. כתובת ה-URL של התמונה הממוזערת של מבצע.
description

string

זה שינוי אופציונלי. תיאור המבצע. האורך המקסימלי הוא 200 תווים.
enabled

boolean

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

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

SearchUseCase

מגדיר חלוקה משנית של SolutionType. רלוונטי במיוחד ל-SOLUTION_TYPE_SEARCH.

טיפוסים בני מנייה (enum)
SEARCH_USE_CASE_UNSPECIFIED הערך שבו נעשה שימוש כשההגדרה לא מוגדרת. לא יקרה ב-CSS.
SEARCH_USE_CASE_BROWSE עיון בתרחיש לדוגמה. התנועה צריכה לכלול query ריק.

תנאי

הגדרה של נסיבות שצריך לבדוק לפני שמאפשרים התנהגות מסוימת

ייצוג ב-JSON 
{
  "queryTerms": [
    {
      object (QueryTerm)
    }
  ],
  "activeTimeRange": [
    {
      object (TimeRange)
    }
  ],
  "queryRegex": string
}
שדות
queryTerms[]

object (QueryTerm)

חיפוש רק ברשימת מונחים להתאמה לשאילתה. אי אפשר להגדיר את הערך הזה אם הערך של Condition.query_regex מוגדר.

אפשר להשתמש במקסימום 10 מונחי שאילתה.
activeTimeRange[]

object (TimeRange)

טווח הזמן שבו התנאי פעיל.

אפשר להגדיר עד 10 טווחי זמן.
queryRegex

string

זה שינוי אופציונלי. ביטוי רגולרי של שאילתה שתואם לשאילתת החיפוש כולה. אי אפשר להגדיר את הערך הזה אם הערך של Condition.query_terms מוגדר. התכונה נתמכת רק בבקרות של הצגת קידום מכירות בחיפוש אתרים בסיסי.

QueryTerm

כלי להתאמת שאילתות בבקשות לחיפוש

ייצוג ב-JSON 
{
  "value": string,
  "fullMatch": boolean
}
שדות
value

string

ערך השאילתה הספציפי שצריך להתאים לו

חייב להיות באותיות קטנות, חייב להיות בקידוד UTF-8. אם הפרמטר fullMatch הוא true, אפשר להשתמש ב-3 מונחים לכל היותר שמופרדים ברווחים. לא יכול להיות מחרוזת ריקה. אורך מקסימלי של 5,000 תווים.
fullMatch

boolean

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

TimeRange

משמשת לתנאים שתלויים בזמן.

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string
}
שדות
startTime

string (Timestamp format)

תחילת טווח הזמן.

הטווח כולל את הקצוות.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

סוף טווח הזמן.

הטווח כולל את הקצוות. התאריך חייב להיות בעתיד.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

Methods

create

 יוצר אמצעי בקרה.

delete

 מחיקת אמצעי בקרה.

get

 מקבל Control.

list

 רשימה של כל אמצעי הבקרה לפי ההורה שלהם DataStore.

patch

 עדכון של אמצעי בקרה.