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

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

การแสดง JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
ช่อง
minimumCapabilities[]

object (Capability)

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

ความสามารถ

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

การแสดง JSON 
{
  "name": string
}
ช่อง
name

string

ชื่อของความสามารถ เช่น actions.capability.AUDIO_OUTPUT

Type

ประเภทที่อ้างอิงถึงภายในการดำเนินการได้ ประเภทเหล่านี้อาจเป็นประเภทที่กำหนดเองซึ่งไม่ซ้ำกันสำหรับการดำเนินการ หรือประเภททั่วไปที่ 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

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