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" เป็นต้น จำเป็นต้องมีค่านี้เมื่อแอปรองรับมากกว่า 1 ภาษา ภาษาที่รองรับแต่ละภาษามี ActionPackage ของตัวเอง หากไม่ได้ระบุค่า ระบบจะแสดงภาษาเริ่มต้นของ Agent |
ไฟล์ Manifest
ชุดของข้อมูลเมตาสำหรับแอป เนื้อหาของข้อความนี้ใช้ในหลายบริบท ได้แก่
- การดำเนินการในหน้ารายการไดเรกทอรีของ 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 |
ชื่อที่แสดงเริ่มต้นของแอปนี้ (หากไม่มีคำแปล) เช่น "Starbucks" ชื่อนี้ยังใช้เป็นวิธีที่ผู้ใช้เรียกใช้แอปนี้ด้วย (นอกเหนือจาก |
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 |
รูปภาพสี่เหลี่ยมจัตุรัสเล็ก ต้องมีขนาด 192 x 192 พิกเซล |
largeLandscapeLogoUrl |
รูปภาพแนวนอนขนาดใหญ่ ขนาดต้องเป็น 2208 x 1242 พิกเซล |
companyName |
ชื่อบริษัทที่เชื่อมโยงกับแอปนี้ |
contactEmail |
อีเมลติดต่อที่อนุญาตให้ผู้ใช้ติดต่อเกี่ยวกับแอป |
termsOfServiceUrl |
URL ไปยังข้อกำหนดในการให้บริการ (ข้อกำหนดในการให้บริการ) ของแอป |
privacyUrl |
URL นโยบายความเป็นส่วนตัวของแอป |
sampleInvocation[] |
ตัวอย่างวลีคำขอที่แสดงเป็นส่วนหนึ่งของคำอธิบายแอปในไดเรกทอรีของแอปทั้งหมด สามารถระบุค่าได้เพียง 5 ค่าเท่านั้น |
introduction |
ข้อมูลสรุปเกี่ยวกับสิ่งที่แอปสามารถทำได้ ใช้เพื่อแนะนำแอปให้แก่ผู้ใช้ ซึ่งควรเป็นวลีกริยาที่สมบูรณ์ในประโยค เช่น "You can use this App to..." |
testingInstructions |
วิธีการทดสอบรูปแบบอิสระสำหรับผู้ตรวจสอบแอป |
voiceName |
ชื่อเสียงที่จะใช้ ค่าตัวอย่างที่รองรับ ได้แก่ |
externalVoiceName |
ชื่อเสียงภายนอกสำหรับตัวแทนนี้ ไม่มีข้อมูลภาษา |
voiceLocale |
ภาษาของเสียงสำหรับตัวแทนนี้ หากตั้งค่าเป็นสตริงว่าง ระบบจะแปลค่าเป็นภาษาของผู้ใช้ระหว่างรันไทม์ |
surfaceRequirements |
ชุดข้อกำหนดสำหรับแพลตฟอร์มไคลเอ็นต์ Google Assistant ที่จะต้องปฏิบัติตามจึงจะทริกเกอร์แอปได้ |
SurfaceRequirements
มีชุดข้อกำหนดสำหรับแพลตฟอร์มไคลเอ็นต์ที่ต้องปฏิบัติตามเพื่อให้ Agent เริ่มทำงาน หากไม่เป็นไปตามข้อกำหนดใดๆ ที่ระบุไว้ที่นี่ ระบบจะไม่เรียกใช้ตัวแทน
การแสดง JSON | |
---|---|
{
"minimumCapabilities": [
{
object ( |
ช่อง | |
---|---|
minimumCapabilities[] |
ชุดความสามารถขั้นต่ำที่จำเป็นสำหรับการทำงานของ Agent หากแพลตฟอร์มไม่มีข้อมูลใดเหล่านี้เลย ระบบจะไม่ทริกเกอร์ Agent นั้น |
ความสามารถ
หมายถึงข้อกำหนดเกี่ยวกับความพร้อมใช้งานของความสามารถที่ระบุ
การแสดง JSON | |
---|---|
{ "name": string } |
ช่อง | |
---|---|
name |
ชื่อของความสามารถ เช่น actions.capability.AUDIO_OUTPUT |
Type
ประเภทที่อ้างอิงถึงภายในการดำเนินการได้ ประเภทเหล่านี้อาจเป็นประเภทที่กำหนดเองซึ่งไม่ซ้ำกันสำหรับการดำเนินการ หรือประเภททั่วไปที่ Google กำหนดและอ้างอิงภายในการดำเนินการ
การแสดง JSON | |
---|---|
{
"name": string,
"entities": [
{
object ( |
ช่อง | |
---|---|
name |
ชื่อของประเภทที่กำหนดเองในรูปแบบ |
entities[] |
รายการเอนทิตีสำหรับประเภทนี้ แต่ละคีย์จะมีคีย์และรายการคำพ้องความหมาย |
isUserDefined |
ระบุว่าเอนทิตีมีการกําหนดโดยผู้ใช้หรือไม่ (แตกต่างกันสําหรับผู้ใช้ทุกคน) |
เอนทิตี
เอนทิตีแต่ละรายการสอดคล้องกันเป็นค่าที่ไม่ซ้ำสำหรับประเภทนี้ คีย์ต้องไม่ซ้ำกันและจะใช้รายการคำพ้องความหมายในการทริกเกอร์
การแสดง JSON | |
---|---|
{ "key": string, "synonyms": [ string ] } |
ช่อง | |
---|---|
key |
คีย์ที่ไม่ซ้ำกันสำหรับรายการนี้ |
synonyms[] |
รายการคำพ้องความหมายที่ใช้อ้างถึงรายการนี้ได้ |