ב-ActionPackage נמצא התוכן של הטיוטה של האפליקציה ושל כל גרסה שנפרסה. המידע הזה כולל פרטים על דף האפליקציה בספרייה, הגדרות שיחה וקישור חשבונות.
ייצוג JSON | |
---|---|
{ "manifest": { object ( |
שדות | |
---|---|
manifest |
פרטי האפליקציה. כאן נשמר הרישום של הספרייה וכן מזהים אחרים של האפליקציה, כמו displayName. |
accountLinking |
הפרטים של קישור חשבונות באפליקציה הזו. |
actions[] |
רשימת הפעולות שהאפליקציה יכולה לבצע. |
types[] |
רשימת סוגים בהגדרת המפתח. |
conversations |
שיחות במפה שאפשר לשתף בין אובייקט שמכיל רשימה של |
locale |
הלוקאל של חבילת הפעולות הזו. ערך זה מיוצג על ידי מחרוזות שפה מסוג BCP-47, כמו 'en', 'en-US', 'fr', 'fr-CA', 'sr-Latn', 'zh-Hans', 'zh-Hans-CN', 'zh-Hant', 'zh-Hant-HK' וכו'. נדרש אם האפליקציה תומכת ביותר משפה אחת. לכל לוקאל נתמך יש ActionPackage משלו. אם לא הוזן ערך, לוקאל ברירת המחדל של הסוכן יהיה משתמע. |
מניפסט
קבוצת המטא-נתונים של האפליקציה. תוכן ההודעה הזו משמש בהקשרים מרובים:
- פעולות בדף הרישום של ספריית Google.
- זיהוי ייחודי של אפליקציה לצורך הפעלה מפורשת (
displayName
). - תוכן של חלקים אחרים ב-
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 ( |
שדות | |
---|---|
displayName |
שם התצוגה המשמש כברירת מחדל עבור האפליקציה הזו (אם אין תרגום זמין), לדוגמה: "ארומה". משתמשים יכולים להשתמש בשיטה הזו גם כדי להפעיל את האפליקציה הזו (בנוסף ל- |
invocationName |
זהו השם הייחודי של האפליקציה הזו כדי להפעיל אותה ישירות בהקשר של קול (דיבור). כללי המדיניות דורשים ששם ההפעלה יהיה דומה מאוד מבחינה פונטית לשדה |
enabledRegions[] |
מזהים של קריטריונים של AdWords לאזורים שבהם האפליקציה מותרת על סמך מיקום המשתמש של המשתמש. מידע נוסף זמין בכתובת https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
disabledRegions[] |
מזהים של קריטריונים של AdWords לאזורים שבהם האפליקציה חסומה על סמך מיקום הנוכחות של המשתמש. מידע נוסף זמין בכתובת https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
shortDescription |
התיאור הקצר שמוגדר כברירת מחדל עבור האפליקציה (אם אין תרגום זמין). מוגבל ל-80 תווים. |
longDescription |
התיאור הארוך שמוגדר כברירת מחדל עבור האפליקציה (אם אין תרגום זמין). מוגבל ל-4,000 תווים. |
category |
הקטגוריה של האפליקציה. הערך חייב להיות אחת מהקטגוריות המותרות לאפליקציות. כדאי לעיין בפעולות במסוף Google כדי להציג את רשימת הקטגוריות המותרות. |
smallSquareLogoUrl |
תמונה מרובעת קטנה. המידות חייבות להיות 192px על 192px. |
largeLandscapeLogoUrl |
תמונה גדולה לרוחב. הגודל יכול להיות 2208px על 1242px. |
companyName |
שם החברה שאליה האפליקציה משויכת. |
contactEmail |
כתובת האימייל ליצירת קשר, שדרכה משתמשים יכולים לפנות אליך לגבי האפליקציה. |
termsOfServiceUrl |
כתובת ה-URL של התנאים וההגבלות (התנאים וההגבלות) של האפליקציה. |
privacyUrl |
כתובת ה-URL של מדיניות הפרטיות של האפליקציה. |
sampleInvocation[] |
ביטוי הפעלה לדוגמה שמוצג כחלק מתיאור האפליקציה בספרייה של כל האפליקציות. אפשר לתת רק 5 ערכים. |
introduction |
סיכום של מה שאפליקציה יכולה לעשות. משמש לצורך הצגת האפליקציה למשתמשים. השם צריך להיות ביטוי פועל שמשלים משפט כמו "אפשר להשתמש באפליקציה הזו כדי..." |
testingInstructions |
הוראות לבודק האפליקציה לבדיקה בפריסה גמישה. |
voiceName |
שם הקול שבו צריך להשתמש. דוגמאות לערכים נתמכים: |
externalVoiceName |
השם של הקול החיצוני לנציג הזה. לא מכיל מידע על לוקאל. |
voiceLocale |
לוקאל של הנציג. אם היא מוגדרת למחרוזת ריקה, היא תזוהה ללוקאל של המשתמש בזמן הריצה. |
surfaceRequirements |
קבוצת דרישות להצגת הלקוח של Google Assistant שצריך לעמוד בהן כדי שהאפליקציה תופעל. |
SurfaceRequirements
כוללת קבוצת דרישות לפלטפורמת הלקוח שחייבות להתקיים כדי שהנציג יופעל. אם אחת מהדרישות שמפורטות כאן לא מתקיימת, הנציג לא יופעל.
ייצוג JSON | |
---|---|
{
"minimumCapabilities": [
{
object ( |
שדות | |
---|---|
minimumCapabilities[] |
מערך היכולות המינימלי שנדרש לנציג. אם במשטח חסר אחד מהפרטים האלה, הסוכן לא יופעל. |
פונקציה
שדה זה מייצג דרישה לגבי הזמינות של יכולת נתונה
ייצוג JSON | |
---|---|
{ "name": string } |
שדות | |
---|---|
name |
שם היכולת, למשל actions.capability.AUDIO_OUTPUT |
תיאור
סוג שניתן להפנות אליו בתוך פעולה. אלה יכולים להיות סוגים מותאמים אישית ייחודיים לפעולה או סוגים נפוצים שהוגדרו על ידי Google ושמתבצעת אליהם הפניה בפעולה.
ייצוג JSON | |
---|---|
{
"name": string,
"entities": [
{
object ( |
שדות | |
---|---|
name |
השם של הסוג המותאם אישית, בפורמט |
entities[] |
רשימת ישויות עבור הסוג הזה. כל אחד מהם כולל מפתח ורשימה של מילים נרדפות. |
isUserDefined |
האם הישויות מוגדרות על ידי המשתמש (שונות עבור כל משתמש). |
ישות
כל ישות מתאימה לסוג זה. המפתח צריך להיות ייחודי, ורשימת המילים הנרדפות משמשת להפעלה.
ייצוג JSON | |
---|---|
{ "key": string, "synonyms": [ string ] } |
שדות | |
---|---|
key |
מפתח ייחודי לפריט הזה. |
synonyms[] |
רשימת מילים נרדפות שבהן ניתן להשתמש כדי להתייחס לפריט הזה. |