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" ฯลฯ จำเป็นต้องใช้เมื่อแอปรองรับภาษามากกว่า 1 ภาษา ภาษาที่รองรับแต่ละภาษามี ActionPackage ของตนเอง หากไม่ได้ระบุค่าไว้ ภาษาเริ่มต้นของ Agent จะกล่าวเป็นนัย

ไฟล์ Manifest

ชุดข้อมูลเมตาสำหรับแอป มีการใช้เนื้อหาของข้อความนี้ในหลายบริบท เช่น

  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

ชื่อที่แสดงเริ่มต้นสำหรับแอปนี้ (หากไม่มีคำแปล) เช่น "Starbucks" นอกจากนี้ยังใช้เป็นวิธีการสำหรับผู้ใช้ในการเรียกใช้แอปนี้ (นอกเหนือจาก 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

รูปภาพสี่เหลี่ยมจัตุรัสเล็ก ขนาดต้องมีขนาด 192 x 192 พิกเซล
largeLandscapeLogoUrl

string

รูปภาพแนวนอนขนาดใหญ่ ขนาดต้องเท่ากับ 2208 x 1242 พิกเซล
companyName

string

ชื่อบริษัทที่เชื่อมโยงกับแอปนี้
contactEmail

string

อีเมลสำหรับติดต่อเพื่อให้ผู้ใช้ติดต่อเกี่ยวกับแอปได้
termsOfServiceUrl

string

URL ไปยังข้อกำหนดในการให้บริการ (ข้อกำหนดในการให้บริการ) ของแอป
privacyUrl

string

URL สำหรับนโยบายความเป็นส่วนตัวของแอป
sampleInvocation[]

string

ตัวอย่างวลีคำขอที่แสดงเป็นส่วนหนึ่งของคำอธิบายแอปในไดเรกทอรีของแอปทั้งหมด ระบุได้เพียง 5 ค่าเท่านั้น
introduction

string

สรุปสิ่งที่แอปทำได้ ใช้สำหรับแนะนำแอปให้แก่ผู้ใช้ ซึ่งควรเป็นวลีกริยาที่เติมประโยคสมบูรณ์แบบ เช่น "You can use this App to..."
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)

ชุดความสามารถขั้นต่ำที่จำเป็นต่อการทำงานของตัวแทน หากแพลตฟอร์มไม่มีรายการใดรายการหนึ่งเหล่านี้ ระบบจะไม่ทริกเกอร์ Agent

ความสามารถ

หมายถึงข้อกำหนดเกี่ยวกับความพร้อมใช้งานของความสามารถที่กำหนด

การแสดง 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

รายการคำพ้องความหมายที่ใช้เพื่ออ้างถึงรายการนี้ได้