ActionPackage

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

ייצוג JSON 
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
שדות
manifest

object (Manifest)

פרטי האפליקציה. כאן נשמר הרישום של הספרייה וכן מזהים אחרים של האפליקציה, כמו displayName.
accountLinking

object (AccountLinking)

הפרטים של קישור חשבונות באפליקציה הזו.
actions[]

object (Action)

רשימת הפעולות שהאפליקציה יכולה לבצע.
types[]

object (Type)

רשימת סוגים בהגדרת המפתח.
conversations

map (key: string, value: object (ConversationFulfillment))

שיחות במפה שאפשר לשתף בין actions. לדוגמה, אפשר לראות את conversationName בFulfillment.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
locale

string

הלוקאל של חבילת הפעולות הזו. ערך זה מיוצג על ידי מחרוזות שפה מסוג BCP-47, כמו 'en', 'en-US', 'fr', 'fr-CA', 'sr-Latn', 'zh-Hans', 'zh-Hans-CN', 'zh-Hant', 'zh-Hant-HK' וכו'. נדרש אם האפליקציה תומכת ביותר משפה אחת. לכל לוקאל נתמך יש ActionPackage משלו. אם לא הוזן ערך, לוקאל ברירת המחדל של הסוכן יהיה משתמע.

מניפסט

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

  1. פעולות בדף הרישום של ספריית Google.
  2. זיהוי ייחודי של אפליקציה לצורך הפעלה מפורשת (displayName).
  3. תוכן של חלקים אחרים ב-ActionPackage (shortDescription משמש להצגה בAccountLinking, displayName משמש בactions כדי להציג את שם האפליקציה למשתמשים).

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

ייצוג JSON 
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
שדות
displayName

string

שם התצוגה המשמש כברירת מחדל עבור האפליקציה הזו (אם אין תרגום זמין), לדוגמה: "ארומה". משתמשים יכולים להשתמש בשיטה הזו גם כדי להפעיל את האפליקציה הזו (בנוסף ל-invocationName). השם המוצג חייב להיות ייחודי ודומה מאוד מבחינה פונטית ל-invocationName.
invocationName

string

זהו השם הייחודי של האפליקציה הזו כדי להפעיל אותה ישירות בהקשר של קול (דיבור). כללי המדיניות דורשים ששם ההפעלה יהיה דומה מאוד מבחינה פונטית לשדה displayName.
enabledRegions[]

string (int64 format)

מזהים של קריטריונים של AdWords לאזורים שבהם האפליקציה מותרת על סמך מיקום המשתמש של המשתמש. מידע נוסף זמין בכתובת https://developers.google.com/adwords/api/docs/appendix/geotargeting.
disabledRegions[]

string (int64 format)

מזהים של קריטריונים של AdWords לאזורים שבהם האפליקציה חסומה על סמך מיקום הנוכחות של המשתמש. מידע נוסף זמין בכתובת https://developers.google.com/adwords/api/docs/appendix/geotargeting.
shortDescription

string

התיאור הקצר שמוגדר כברירת מחדל עבור האפליקציה (אם אין תרגום זמין). מוגבל ל-80 תווים.
longDescription

string

התיאור הארוך שמוגדר כברירת מחדל עבור האפליקציה (אם אין תרגום זמין). מוגבל ל-4,000 תווים.
category

string

הקטגוריה של האפליקציה. הערך חייב להיות אחת מהקטגוריות המותרות לאפליקציות. כדאי לעיין בפעולות במסוף Google כדי להציג את רשימת הקטגוריות המותרות.
smallSquareLogoUrl

string

תמונה מרובעת קטנה. המידות חייבות להיות 192px על 192px.
largeLandscapeLogoUrl

string

תמונה גדולה לרוחב. הגודל יכול להיות 2208px על 1242px.
companyName

string

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

string

כתובת האימייל ליצירת קשר, שדרכה משתמשים יכולים לפנות אליך לגבי האפליקציה.
termsOfServiceUrl

string

כתובת ה-URL של התנאים וההגבלות (התנאים וההגבלות) של האפליקציה.
privacyUrl

string

כתובת ה-URL של מדיניות הפרטיות של האפליקציה.
sampleInvocation[]

string

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

string

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

string

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

string

שם הקול שבו צריך להשתמש. דוגמאות לערכים נתמכים: male_1, male_2, female_1, female_2.
externalVoiceName

string

השם של הקול החיצוני לנציג הזה. לא מכיל מידע על לוקאל.
voiceLocale

string

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

object (SurfaceRequirements)

קבוצת דרישות להצגת הלקוח של Google Assistant שצריך לעמוד בהן כדי שהאפליקציה תופעל.

SurfaceRequirements

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

ייצוג JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
שדות
minimumCapabilities[]

object (Capability)

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

פונקציה

שדה זה מייצג דרישה לגבי הזמינות של יכולת נתונה

ייצוג JSON 
{
  "name": string
}
שדות
name

string

שם היכולת, למשל actions.capability.AUDIO_OUTPUT

תיאור

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

ייצוג JSON 
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
שדות
name

string

השם של הסוג המותאם אישית, בפורמט type.
entities[]
(deprecated)

object (Entity)

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

boolean

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

ישות

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

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

string

מפתח ייחודי לפריט הזה.
synonyms[]

string

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