Files

{
  "configFiles": [
    {
      object (ConfigFile)
    }
  ]
}

object (ConfigFile)

ไฟล์การกำหนดค่าหลายไฟล์

{
  "filePath": string,

  // Union field file can be only one of the following:
  "manifest": {
    object (Manifest)
  },
  "actions": {
    object (Actions)
  },
  "settings": {
    object (Settings)
  },
  "webhook": {
    object (Webhook)
  },
  "intent": {
    object (Intent)
  },
  "type": {
    object (Type)
  },
  "entitySet": {
    object (EntitySet)
  },
  "globalIntentEvent": {
    object (GlobalIntentEvent)
  },
  "scene": {
    object (Scene)
  },
  "staticPrompt": {
    object (StaticPrompt)
  },
  "accountLinkingSecret": {
    object (AccountLinkingSecret)
  },
  "resourceBundle": {
    object
  }
  // End of list of possible types for union field file.
}

string

เส้นทางสัมพัทธ์ของไฟล์การกำหนดค่าจากรูทของโปรเจ็กต์ในโครงสร้างไฟล์ SDK ไฟล์แต่ละประเภทด้านล่างมีเส้นทางของไฟล์ที่อนุญาต เช่น settings/settings.yaml

object (Manifest)

ไฟล์ Manifest ไฟล์เดียว เส้นทางไฟล์ที่อนุญาต: manifest.yaml

object (Actions)

ไฟล์การดำเนินการเดียวที่กำหนดการดำเนินการทั้งหมดไว้ เส้นทางไฟล์ที่อนุญาต: actions/{language}?/actions.yaml

object (Settings)

ค่ากำหนดรายการเดียว ซึ่งรวมถึงการตั้งค่าที่ไม่สามารถแปลได้และการตั้งค่าสำหรับภาษาเริ่มต้นของโปรเจ็กต์ (หากระบุ) สำหรับไฟล์ลบล้างภาษา ระบบจะป้อนข้อมูลเฉพาะช่อง localizedSettings เส้นทางไฟล์ที่อนุญาต: settings/{language}?/settings.yaml โปรดทราบว่าไฟล์การตั้งค่าที่ไม่ใช่การแปลภาษา settings/settings.yaml ต้องมีอยู่ในคำขอขั้นตอนการเขียน

object (Webhook)

คำจำกัดความของเว็บฮุคเดียว เส้นทางไฟล์ที่อนุญาต: webhooks/{WebhookName}.yaml

object (Intent)

คำจำกัดความของความตั้งใจเดียว เส้นทางไฟล์ที่อนุญาต: custom/intents/{language}?/{IntentName}.yaml

object (Type)

คำจำกัดความประเภทเดียว เส้นทางไฟล์ที่อนุญาต: custom/types/{language}?/{TypeName}.yaml

object (EntitySet)

คำจำกัดความของชุดเอนทิตีเดียว เส้นทางไฟล์ที่อนุญาต: custom/entitySets/{language}?/{EntitySetName}.yaml

object (GlobalIntentEvent)

คำจำกัดความของเหตุการณ์ Intent ส่วนกลางรายการเดียว เส้นทางไฟล์ที่อนุญาต: custom/global/{GlobalIntentEventName}.yaml ชื่อไฟล์ (GlobalIntentEventName) ควรเป็นชื่อของ Intent ที่เหตุการณ์ Intent แบบโกลบอลนี้สอดคล้องกับ

object (Scene)

คำจำกัดความของฉากเดียว เส้นทางไฟล์ที่อนุญาต: custom/scenes/{SceneName}.yaml

object (StaticPrompt)

คำจำกัดความของข้อความแจ้งแบบคงที่รายการเดียว เส้นทางไฟล์ที่อนุญาต: custom/prompts/{language}?/{StaticPromptName}.yaml

object (AccountLinkingSecret)

ข้อมูลเมตาที่สอดคล้องกับรหัสลับไคลเอ็นต์ที่ใช้ในการลิงก์บัญชี เส้นทางไฟล์ที่อนุญาต: settings/accountLinkingSecret.yaml

object (Struct format)

กลุ่มทรัพยากรเดียว ซึ่งเป็นการจับคู่จากสตริงไปยังสตริงหรือรายการสตริง คุณใช้แพ็กเกจทรัพยากรเพื่อแปลสตริงในพรอมต์แบบคงที่ได้ เส้นทางไฟล์ที่อนุญาต: resources/strings/{language}?/{multiple directories}?/{BundleName}.yaml

{
  "version": string
}

string

เวอร์ชันของรูปแบบไฟล์ รูปแบบไฟล์เวอร์ชันปัจจุบันคือ 1.0 เช่น "1.0"

{
  "custom": {
    string: {
      object (CustomAction)
    },
    ...
  }
}

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

แมปจาก Intent ไปยังการดำเนินการที่กำหนดเองเพื่อกำหนดค่าการเรียกใช้สำหรับโปรเจ็กต์ โดย Intent ของคำขออาจเป็นระบบหรือ Intent แบบกำหนดเองที่กำหนดไว้ในแพ็กเกจ "custom/intent/" Intent ทั้งหมดที่ระบุไว้ที่นี่ (Intent ของระบบและ Intent ที่กำหนดเอง) ต้องมีไฟล์ Intent ที่เกี่ยวข้องในแพ็กเกจ "custom/Global/"

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

{
  "engagement": {
    object (Engagement)
  }
}

object (Engagement)

กลไกการมีส่วนร่วมที่เชื่อมโยงกับการดำเนินการเพื่อช่วยผู้ใช้ปลายทางสมัครรับข้อความ Push และการอัปเดตรายวัน โปรดทราบว่าชื่อ Intent ที่ระบุในการอัปเดตรายวัน/การกำหนดค่าช่องข้อความ Push ต้องตรงกับ Intent ที่สัมพันธ์กับการดำเนินการนี้เพื่อให้ผู้ใช้ปลายทางสมัครรับข้อมูลอัปเดตเหล่านี้

{
  "title": string,
  "pushNotification": {
    object (PushNotification)
  },
  "actionLink": {
    object (ActionLink)
  },
  "assistantLink": {
    object (AssistantLink)
  },
  "dailyUpdate": {
    object (DailyUpdate)
  }
}

string

ชื่อของการมีส่วนร่วมที่จะส่งไปยังผู้ใช้ปลายทางเพื่อขอสิทธิ์รับการอัปเดต ข้อความแจ้งที่ส่งถึงผู้ใช้ปลายทางเพื่อรับข้อมูลอัปเดตรายวันจะมีลักษณะเป็น "คุณต้องการให้ฉันส่ง {title}" รายวันในเวลาใด และสำหรับข้อความ Push จะมีลักษณะเป็น "ฉันส่งข้อความ Push สำหรับ {title}" ได้ไหม ช่องนี้แปลได้

object (PushNotification)

การตั้งค่าข้อความ Push ที่รองรับการมีส่วนร่วมนี้

object (ActionLink)

การกำหนดค่าลิงก์สำหรับการดำเนินการซึ่งกำหนดว่าจะเปิดใช้การแชร์ลิงก์อยู่หรือไม่ หากรองรับ จะมีชื่อที่แสดงที่ใช้ง่ายสำหรับลิงก์นั้น ActionLink เลิกใช้งานแล้ว ใช้ AssistantLink แทน

object (AssistantLink)

การกำหนดค่าลิงก์สำหรับการดำเนินการซึ่งกำหนดว่าจะเปิดใช้การแชร์ลิงก์อยู่หรือไม่ หากรองรับ จะมีชื่อที่แสดงที่ใช้ง่ายสำหรับลิงก์นั้น

object (DailyUpdate)

การตั้งค่าการอัปเดตรายวันที่การมีส่วนร่วมนี้รองรับ

{
  "title": string
}

string

ชื่อที่แสดงที่ใช้งานง่ายสำหรับลิงก์

{
  "title": string
}

string

ชื่อที่แสดงที่ใช้งานง่ายสำหรับลิงก์

{
  "projectId": string,
  "defaultLocale": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "category": enum (Category),
  "usesTransactionsApi": boolean,
  "usesDigitalPurchaseApi": boolean,
  "usesInteractiveCanvas": boolean,
  "usesHomeStorage": boolean,
  "designedForFamily": boolean,
  "containsAlcoholOrTobaccoContent": boolean,
  "keepsMicOpen": boolean,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  },
  "testingInstructions": string,
  "localizedSettings": {
    object (LocalizedSettings)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "selectedAndroidApps": [
    string
  ]
}

string

รหัสโปรเจ็กต์ Actions

string

ภาษาซึ่งเป็นค่าเริ่มต้นสำหรับโปรเจ็กต์ สำหรับไฟล์ทั้งหมดยกเว้นใน resources/ ที่ไม่มีภาษาในเส้นทาง ระบบจะระบุแหล่งที่มาของข้อมูลที่แปลแล้วว่ามาจาก defaultLocale นี้ สำหรับไฟล์ภายใต้ resources/ ไม่มีภาษาหมายความว่าทรัพยากรนั้นใช้ได้กับทุกภาษา

string

แสดงภูมิภาคที่ผู้ใช้เรียกใช้การดำเนินการของคุณได้ ซึ่งอิงตามสถานที่ที่ผู้ใช้มีอยู่ ไม่สามารถตั้งค่าได้ หากตั้งค่า disabledRegions ไว้ หากไม่ได้ระบุทั้ง enabledRegions และ disabledRegions ผู้ใช้จะเรียกใช้การดำเนินการของคุณในทุกภูมิภาคได้ แต่ละภูมิภาคจะแสดงโดยใช้ชื่อมาตรฐานของเป้าหมายตามภูมิศาสตร์ของ AdWords ดู https://developers.google.com/adwords/api/docs/appendix/geotargeting ตัวอย่างเช่น - "เยอรมนี" - "กานา" - "กรีซ" - "เกรเนดา" - "สหราชอาณาจักร" - "สหรัฐอเมริกา" - "หมู่เกาะขนาดเล็กรอบนอกของสหรัฐอเมริกา" - "อุรุกวัย"

string

แสดงภูมิภาคที่การดำเนินการของคุณถูกบล็อก โดยอิงตามสถานที่ที่ผู้ใช้อยู่ ไม่สามารถตั้งค่าได้ หากตั้งค่า enabledRegions ไว้ แต่ละภูมิภาคจะแสดงโดยใช้ชื่อมาตรฐานของเป้าหมายตามภูมิศาสตร์ของ AdWords ดู https://developers.google.com/adwords/api/docs/appendix/geotargeting ตัวอย่างเช่น - "เยอรมนี" - "กานา" - "กรีซ" - "เกรเนดา" - "สหราชอาณาจักร" - "สหรัฐอเมริกา" - "หมู่เกาะขนาดเล็กรอบนอกของสหรัฐอเมริกา" - "อุรุกวัย"

enum (Category)

หมวดหมู่สำหรับโปรเจ็กต์ Actions นี้

boolean

การดำเนินการใช้ธุรกรรมได้หรือไม่ (เช่น การจอง รับคำสั่งซื้อ ฯลฯ) หากเป็นเท็จ ระบบจะพยายามใช้ Transaction API ไม่สำเร็จ

boolean

การดำเนินการสามารถทำธุรกรรมสำหรับสินค้าดิจิทัลได้หรือไม่

boolean

กำหนดว่าการดำเนินการใช้ Canvas แบบอินเทอร์แอกทีฟหรือไม่

boolean

การดำเนินการใช้ฟีเจอร์พื้นที่เก็บข้อมูลในบ้านหรือไม่

boolean

เนื้อหาการดำเนินการออกแบบเพื่อครอบครัว (DFF) หรือไม่

boolean

การดําเนินการมีเนื้อหาเกี่ยวกับแอลกอฮอล์หรือยาสูบหรือไม่

boolean

การดำเนินการอาจเปิดไมค์ทิ้งไว้โดยไม่มีการแจ้งเตือนที่ชัดเจนในระหว่างการสนทนาหรือไม่

object (SurfaceRequirements)

ข้อกำหนดของแพลตฟอร์มที่แพลตฟอร์มไคลเอ็นต์ต้องรองรับเพื่อเรียกใช้ Actions ในโปรเจ็กต์นี้

string

วิธีการทดสอบรูปแบบอิสระสำหรับผู้ตรวจสอบการดำเนินการ (เช่น วิธีการลิงก์บัญชี)

object (LocalizedSettings)

การตั้งค่าที่แปลแล้วสำหรับภาษาเริ่มต้นของโปรเจ็กต์ ภาษาเพิ่มเติมทั้งหมดควรมีไฟล์การตั้งค่าของตัวเองในไดเรกทอรีของตัวเอง

object (AccountLinking)

อนุญาตให้ผู้ใช้สร้างหรือลิงก์บัญชีผ่านการลงชื่อเข้าใช้ Google และ/หรือบริการ OAuth ของคุณเอง

string

แอป Android ที่เลือกให้เข้าถึงการซื้อใน Google Play สำหรับธุรกรรม รายการนี้เป็นตัวเลือกจากแอป Android ที่เชื่อมต่อกับโปรเจ็กต์การดำเนินการเพื่อยืนยันการเป็นเจ้าของแบรนด์และเปิดใช้ฟีเจอร์เพิ่มเติม ดูข้อมูลเพิ่มเติมได้ที่ https://developers.google.com/assistant/console/brand-verification

{
  "minimumRequirements": [
    {
      object (CapabilityRequirement)
    }
  ]
}

object (CapabilityRequirement)

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

{
  "capability": enum (SurfaceCapability)
}

enum (SurfaceCapability)

ประเภทของความสามารถ

{
  "displayName": string,
  "pronunciation": string,
  "shortDescription": string,
  "fullDescription": string,
  "smallLogoImage": string,
  "largeBannerImage": string,
  "developerName": string,
  "developerEmail": string,
  "termsOfServiceUrl": string,
  "voice": string,
  "voiceLocale": string,
  "privacyPolicyUrl": string,
  "sampleInvocations": [
    string
  ],
  "themeCustomization": {
    object (ThemeCustomization)
  }
}

string

ต้องระบุ ชื่อที่แสดงเริ่มต้นของโปรเจ็กต์ Actions นี้ (หากไม่มีคําแปล)

string

ต้องระบุ การออกเสียงชื่อที่แสดงเพื่อเรียกภายในบริบทของเสียง (เสียงพูด)

string

ต้องระบุ คำอธิบายแบบย่อเริ่มต้นสำหรับโปรเจ็กต์ Actions (หากไม่มีคำแปล) จำนวนอักขระสูงสุด 80 อักขระ

string

ต้องระบุ คำอธิบายแบบยาวตามค่าเริ่มต้นสำหรับโปรเจ็กต์การดำเนินการ (หากไม่มีคำแปล) จำนวนอักขระสูงสุด 4,000 ตัว

string

ต้องระบุ รูปภาพสี่เหลี่ยมจัตุรัสเล็กขนาด 192 x 192 พิกเซล ควรระบุเป็นการอ้างอิงไปยังรูปภาพที่เกี่ยวข้องในไดเรกทอรี resources/images/ เช่น $resources.images.foo (ไม่มีส่วนขยาย) สำหรับรูปภาพใน resources/images/foo.jpg เมื่อทำงานกับโปรเจ็กต์ที่ดึงจากคอนโซล ระบบอาจใช้ URL ที่ Google จัดการ ไม่อนุญาตให้ใช้ URL จากแหล่งที่มาภายนอก

string

ไม่บังคับ รูปภาพแนวนอนขนาดใหญ่ขนาด 1920 x 1080 พิกเซล ควรระบุเป็นการอ้างอิงไปยังรูปภาพที่เกี่ยวข้องในไดเรกทอรี resources/images/ เช่น $resources.images.foo (ไม่มีส่วนขยาย) สำหรับรูปภาพใน resources/images/foo.jpg เมื่อทำงานกับโปรเจ็กต์ที่ดึงจากคอนโซล ระบบอาจใช้ URL ที่ Google จัดการ ไม่อนุญาตให้ใช้ URL จากแหล่งที่มาภายนอก

string

ต้องระบุ ชื่อของนักพัฒนาแอปที่จะแสดงต่อผู้ใช้

string

ต้องระบุ อีเมลสำหรับติดต่อของนักพัฒนาแอป

string

ไม่บังคับ URL ข้อกำหนดในการให้บริการ

string

ต้องระบุ ประเภทเสียงของ Google Assistant ที่ผู้ใช้ได้ยินเมื่อโต้ตอบกับ Actions ของคุณ ค่าที่รองรับคือ "ชาย_1", "ชาย_2", "หญิง_1" และ "หญิง_2"

string

ไม่บังคับ ภาษาสำหรับเสียงที่ระบุ หากไม่ได้ระบุ ระบบจะใช้ภาษาของ Assistant แก่ผู้ใช้ หากระบุไว้ ภาษาเสียงต้องมีภาษาหลักเหมือนกับภาษาที่ระบุใน LocalizedSettings

string

ต้องระบุ URL ของนโยบายความเป็นส่วนตัว

string

ไม่บังคับ ตัวอย่างวลีคำขอที่แสดงเป็นส่วนหนึ่งของคำอธิบายโปรเจ็กต์ Actions ในไดเรกทอรี Assistant วิธีนี้จะช่วยให้ผู้ใช้ทราบวิธีใช้งาน

object (ThemeCustomization)

ไม่บังคับ การปรับแต่งธีมสำหรับคอมโพเนนต์ภาพของการดำเนินการของคุณ

{
  "backgroundColor": string,
  "primaryColor": string,
  "fontFamily": string,
  "imageCornerStyle": enum (ImageCornerStyle),
  "landscapeBackgroundImage": string,
  "portraitBackgroundImage": string
}

string

สีพื้นหลังของการ์ด ทำหน้าที่เป็นโฆษณาสำรองหากนักพัฒนาแอปไม่ได้ให้ background_image หรือ background_image ไม่เหมาะกับบางแพลตฟอร์ม ตัวอย่างการใช้: #FAFAFA

string

ระบบจะใช้สีธีมหลักของการดำเนินการเพื่อกำหนดสีข้อความของชื่อ สีพื้นหลังของรายการการทำงานสำหรับการ์ด Actions on Google ตัวอย่างการใช้: #FAFAFA

string

ชุดแบบอักษรที่จะใช้เป็นชื่อของการ์ด แบบอักษรที่รองรับ: - Sans Serif - Sans Serif Medium - Sans Serif Bold - Sans Serif Black - Sans Serif Condensed - Sans Serif Condensed Medium - Serif - Serif Bold - Monospace - Cursive - Sans Serif ขนาดเล็ก

enum (ImageCornerStyle)

รูปแบบเส้นขอบของรูปภาพเบื้องหน้าของการ์ด เช่น ใช้ได้กับรูปภาพเบื้องหน้าของการ์ดพื้นฐานหรือการ์ดภาพสไลด์

string

โหมดแนวนอน (ขั้นต่ำ 1920x1200 พิกเซล) ควรระบุเป็นการอ้างอิงไปยังรูปภาพที่เกี่ยวข้องในไดเรกทอรี resources/images/ เช่น $resources.images.foo (ไม่มีส่วนขยาย) สำหรับรูปภาพใน resources/images/foo.jpg เมื่อทำงานกับโปรเจ็กต์ที่ดึงจากคอนโซล จะสามารถใช้ URL ที่ Google จัดการได้

string

โหมดแนวตั้ง (ขั้นต่ำ 1200x1920 พิกเซล) ควรระบุเป็นการอ้างอิงไปยังรูปภาพที่เกี่ยวข้องในไดเรกทอรี resources/images/ เช่น $resources.images.foo (ไม่มีส่วนขยาย) สำหรับรูปภาพใน resources/images/foo.jpg เมื่อทำงานกับโปรเจ็กต์ที่ดึงจากคอนโซล จะสามารถใช้ URL ที่ Google จัดการได้

{
  "enableAccountCreation": boolean,
  "linkingType": enum (LinkingType),
  "authGrantType": enum (AuthGrantType),
  "appClientId": string,
  "authorizationUrl": string,
  "tokenUrl": string,
  "scopes": [
    string
  ],
  "learnMoreUrl": string,
  "useBasicAuthHeader": boolean
}

boolean

ต้องระบุ หากเป็น true ผู้ใช้จะได้รับอนุญาตให้ลงชื่อสมัครใช้บัญชีใหม่ผ่านเสียง หากเป็น false คุณจะสร้างบัญชีได้เฉพาะในเว็บไซต์ของคุณเท่านั้น เลือกตัวเลือกนี้หากคุณต้องการแสดงข้อกำหนดในการให้บริการหรือขอความยินยอมจากผู้ใช้ระหว่างการลงชื่อสมัครใช้ LinkType จะเป็น GOOGLE_SIGN_IN ไม่ได้หากเป็น false linkType จะเป็น OAUTH ไม่ได้เมื่อเป็น true

enum (LinkingType)

ต้องระบุ ประเภทการลิงก์ที่จะใช้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทการลิงก์ได้ที่ https://developers.google.com/assistant/identity

enum (AuthGrantType)

ไม่บังคับ ระบุประเภทการตรวจสอบสิทธิ์สำหรับ OAUTH LinkingType

string

ไม่บังคับ รหัสไคลเอ็นต์ที่แอปออกให้ Google นี่คือรหัสไคลเอ็นต์ OAuth2 ที่ระบุ Google สำหรับบริการของคุณ ตั้งค่าเมื่อใช้ OAuth เท่านั้น

string

ไม่บังคับ ปลายทางสำหรับหน้าเว็บการลงชื่อเข้าใช้ที่รองรับรหัส OAuth2 หรือขั้นตอนโดยปริยาย URL ต้องใช้ HTTPS ตั้งค่าเมื่อใช้ OAuth เท่านั้น

string

ไม่บังคับ ปลายทาง OAuth2 สำหรับการแลกเปลี่ยนโทเค็น URL ต้องใช้ HTTPS หากไม่ได้ตั้งค่าไว้เมื่อใช้ OAuth ที่มีการให้สิทธิ์ IMPLICIT เป็นประเภทการลิงก์เท่านั้น ตั้งค่าเมื่อใช้ OAuth เท่านั้น

string

ไม่บังคับ รายการสิทธิ์ที่ผู้ใช้ต้องให้ความยินยอมเพื่อใช้บริการ ตั้งค่าเมื่อใช้ OAuth เท่านั้น ตรวจสอบว่าได้ระบุข้อกำหนดในการให้บริการในส่วน LocalizedSettings.terms_of_service_url หากระบุช่องนี้

string

ไม่บังคับ นี่คือหน้าเว็บในบริการของคุณซึ่งอธิบายสิทธิ์ที่ผู้ใช้ให้กับ Google ตั้งค่าเมื่อใช้ OAuth และ Google Sign-In เท่านั้น ตรวจสอบว่าได้ระบุข้อกำหนดในการให้บริการในส่วน LocalizedSettings.terms_of_service_url หากระบุช่องนี้

boolean

ไม่บังคับ หากเป็นค่าจริง อนุญาตให้ Google ส่งรหัสไคลเอ็นต์และข้อมูลลับผ่านส่วนหัวการตรวจสอบสิทธิ์พื้นฐานของ HTTP มิฉะนั้น Google จะใช้รหัสไคลเอ็นต์และข้อมูลลับภายในเนื้อหาของโพสต์ ตั้งค่าเมื่อใช้ OAuth เท่านั้น ตรวจสอบว่าได้ระบุข้อกำหนดในการให้บริการในส่วน LocalizedSettings.terms_of_service_url หากระบุช่องนี้

{
  "handlers": [
    {
      object (Handler)
    }
  ],

  // Union field webhook_type can be only one of the following:
  "httpsEndpoint": {
    object (HttpsEndpoint)
  },
  "inlineCloudFunction": {
    object (InlineCloudFunction)
  }
  // End of list of possible types for union field webhook_type.
}

object (Handler)

รายการเครื่องจัดการสำหรับเว็บฮุคนี้

object (HttpsEndpoint)

ปลายทาง HTTPS ของเว็บฮุคที่กำหนดเอง

object (InlineCloudFunction)

ข้อมูลเมตาสำหรับ Cloud Function ที่ทำให้ใช้งานได้จากโค้ดในโฟลเดอร์เว็บฮุค

{
  "name": string
}

string

ต้องระบุ ชื่อของเครื่องจัดการ ต้องไม่ซ้ำกันในเครื่องจัดการทั้งหมดในโปรเจ็กต์ Actions คุณตรวจสอบชื่อของเครื่องจัดการนี้เพื่อเรียกใช้ฟังก์ชันที่ถูกต้องในซอร์สโค้ด Fulfillment

{
  "baseUrl": string,
  "httpHeaders": {
    string: string,
    ...
  },
  "endpointApiVersion": integer
}

string

URL ฐาน HTTPS สำหรับปลายทาง Fulfillment (ไม่รองรับ HTTP) ชื่อเครื่องจัดการจะต่อท้ายเส้นทาง URL ฐานหลังเครื่องหมายโคลอน (ทำตามคู่มือสไตล์ใน https://cloud.google.com/apis/design/custom_methods) เช่น URL ฐาน "https://gactions.service.com/api" จะได้รับคำขอที่มี URL "https://gactions.service.com/api:{method}"

map (key: string, value: string)

แมปของพารามิเตอร์ HTTP ที่จะรวมไว้ในคำขอ POST

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

integer

เวอร์ชันของโปรโตคอลที่ปลายทางใช้ นี่คือโปรโตคอลที่ใช้ร่วมกันตามประเภท Fulfillment ทั้งหมดและใช้กับ Fulfillment ประเภท Google เท่านั้น

{
  "executeFunction": string
}

string

ชื่อของจุดแรกเข้าของ Cloud Function ค่าของช่องนี้ควรตรงกับชื่อของเมธอดที่ส่งออกจากซอร์สโค้ด

{
  "parameters": [
    {
      object (IntentParameter)
    }
  ],
  "trainingPhrases": [
    string
  ]
}

object (IntentParameter)

รายการพารามิเตอร์ภายในวลีการฝึก ต้องกำหนดพารามิเตอร์ทั้งหมดที่นี่เพื่อใช้ในวลีการฝึก

string

วลีการฝึกช่วยให้ NLU ของ Google จับคู่ Intent กับข้อมูลที่ผู้ใช้ป้อนได้โดยอัตโนมัติ ยิ่งมีวลีที่ไม่ซ้ำกันมาก ก็ยิ่งมีโอกาสจับคู่ความตั้งใจนี้มากขึ้น ต่อไปนี้เป็นรูปแบบของส่วนวลีที่ใช้ฝึกซึ่งมีคำอธิบายประกอบ โปรดทราบว่าช่อง auto เป็นช่องที่ไม่บังคับและลักษณะการทำงานเริ่มต้นเมื่อไม่ได้ระบุ auto จะเทียบเท่ากับ auto=false ($<paramName> '<sample text>' auto=<true or false>) auto = true หมายความว่าส่วนได้รับการใส่คำอธิบายประกอบอัตโนมัติโดย NLU auto = false หมายความว่าส่วนที่มีคำอธิบายประกอบโดยผู้ใช้ โดยจะเป็นค่าเริ่มต้นเมื่อไม่ได้ระบุอัตโนมัติ เช่น "จองเที่ยวบินจาก ($source 'San Francisco' auto=false) ไป ($dest 'Vancouver')"

{
  "name": string,

  // Union field parameter_type can be only one of the following:
  "type": {
    object (ClassReference)
  },
  "entitySetReferences": {
    object (EntitySetReferences)
  }
  // End of list of possible types for union field parameter_type.
}

string

ต้องระบุ ชื่อที่ไม่ซ้ำกันของพารามิเตอร์ Intent ใช้ได้ในเงื่อนไขและการตอบสนองต่อพารามิเตอร์ Intent ในการอ้างอิงที่ NLU ดึงข้อมูลด้วย $intent.params.[name].resolved

object (ClassReference)

ไม่บังคับ ประกาศประเภทข้อมูลของพารามิเตอร์นี้ ไม่ควรตั้งค่านี้สำหรับ Intent ในตัว

object (EntitySetReferences)

ไม่บังคับ การอ้างอิงชุดของเอนทิตีที่อนุญาตสำหรับพารามิเตอร์ Intent นี้ ใช้ได้เฉพาะกับพารามิเตอร์ของ Intent ในตัว การอ้างอิงเหล่านี้จะชี้ไปยังชุดเอนทิตีในไดเรกทอรี "custom/entitySets"

{
  "name": string,
  "list": boolean
}

string

ต้องระบุ ชื่อประเภทในตัวหรือประเภทที่กำหนดเองของพารามิเตอร์ ตัวอย่าง: PizzaToppings, actions.type.Number

boolean

ไม่บังคับ ระบุว่าประเภทข้อมูลแสดงรายการค่าหรือไม่

{
  "entitySetReferences": [
    {
      object (EntitySetReference)
    }
  ]
}

object (EntitySetReference)

ต้องระบุ การอ้างอิงชุดเอนทิตีสำหรับพารามิเตอร์ Intent

{
  "entitySet": string
}

string

ต้องระบุ ระบุการรวบรวมเอนทิตีที่เฉพาะเจาะจงเพื่อพิจารณาสำหรับพารามิเตอร์ที่ระบุ คำจำกัดความชุดเอนทิตีที่เกี่ยวข้องควรแสดงอยู่ในไดเรกทอรี custom/entitySets/

{
  "exclusions": [
    string
  ],

  // Union field sub_type can be only one of the following:
  "synonym": {
    object (SynonymType)
  },
  "regularExpression": {
    object (RegularExpressionType)
  },
  "freeText": {
    object (FreeTextType)
  }
  // End of list of possible types for union field sub_type.
}

string

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

object (SynonymType)

ประเภทคำพ้องความหมาย ซึ่งเป็น enum โดยพื้นฐานแล้ว

object (RegularExpressionType)

ประเภทนิพจน์ทั่วไป อนุญาตการจับคู่นิพจน์ทั่วไป

object (FreeTextType)

ประเภท FreeText

{
  "matchType": enum (MatchType),
  "acceptUnknownValues": boolean,
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}

enum (MatchType)

ไม่บังคับ ประเภทการทำงานของคีย์เวิร์ดสำหรับคำพ้องความหมาย

boolean

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

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

ต้องระบุ แมปที่มีชื่อของเอนทิตีคำพ้องความหมาย

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

{
  "display": {
    object (EntityDisplay)
  },
  "synonyms": [
    string
  ]
}

object (EntityDisplay)

ไม่บังคับ เอนทิตีจะแสดงรายละเอียด

string

ไม่บังคับ รายการคำพ้องความหมายสำหรับเอนทิตี ช่องนี้แปลได้

{
  "iconTitle": string,
  "iconUrl": string
}

string

ไม่บังคับ ชื่อไอคอน

string

ต้องระบุ URL ของไอคอน

{
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}

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

ต้องระบุ แมปชื่อของเอนทิตีที่แต่ละรายการมีสตริงนิพจน์ทั่วไป

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

{
  "display": {
    object (EntityDisplay)
  },
  "regularExpressions": [
    string
  ]
}

object (EntityDisplay)

ไม่บังคับ องค์ประกอบที่จะแสดงบนผืนผ้าใบเมื่อแยกเอนทิตีออกจากการค้นหาแล้ว เกี่ยวข้องกับแอปที่เปิดใช้ Canvas เท่านั้น

string

ต้องระบุ ใช้ไวยากรณ์นิพจน์ทั่วไป RE2 (ดูรายละเอียดเพิ่มเติมได้ที่ https://github.com/google/re2/wiki/Syntax)

{
  "display": {
    object (EntityDisplay)
  }
}

object (EntityDisplay)

ไม่บังคับ องค์ประกอบที่จะแสดงบนผืนผ้าใบเมื่อแยกเอนทิตีออกจากการค้นหาแล้ว เกี่ยวข้องกับแอปที่เปิดใช้ Canvas เท่านั้น

{
  "entities": [
    {
      object (Entity)
    }
  ]
}

object (Entity)

ต้องระบุ รายการเอนทิตีที่ชุดเอนทิตีนี้รองรับ

{
  "id": string
}

string

ต้องระบุ รหัสของเอนทิตี ดูรายการพารามิเตอร์ Intent ในตัวและเอนทิตีที่รองรับได้ที่ https://developers.google.com/assistant/conversational/build/built-in-intents

{
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}

string

ไม่บังคับ ฉากปลายทางที่การสนทนาควรข้ามไป สถานะของฉากปัจจุบันจะถูกทำลายเมื่อเปลี่ยน

object (EventHandler)

ไม่บังคับ ตัวแฮนเดิลเหตุการณ์ซึ่งจะทำงานเมื่อตรงกับ Intent ควรดำเนินการก่อนเปลี่ยนเป็นฉากปลายทาง มีประโยชน์ในการสร้างข้อความแจ้งเพื่อตอบสนองต่อเหตุการณ์

{
  "webhookHandler": string,

  // Union field prompt can be only one of the following:
  "staticPrompt": {
    object (StaticPrompt)
  },
  "staticPromptName": string
  // End of list of possible types for union field prompt.
}

string

ชื่อเครื่องจัดการเว็บฮุคที่จะเรียกใช้

object (StaticPrompt)

ข้อความแจ้งแบบคงที่ในบรรทัด อาจมีการอ้างอิงไปยังทรัพยากรสตริงในกลุ่ม

string

ชื่อของข้อความแจ้งแบบคงที่ที่จะเรียกใช้

{
  "candidates": [
    {
      object (StaticPromptCandidate)
    }
  ]
}

object (StaticPromptCandidate)

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

{
  "selector": {
    object (Selector)
  },
  "promptResponse": {
    object (StaticPromptResponse)
  }
}

object (Selector)

ไม่บังคับ เกณฑ์ที่ระบุว่าข้อความแจ้งนี้ตรงกับคำขอหรือไม่ หากตัวเลือกว่างเปล่า ระบบจะทริกเกอร์ข้อความแจ้งนี้เสมอ

object (StaticPromptResponse)

การตอบกลับพรอมต์ที่เชื่อมโยงกับตัวเลือก

{
  "surfaceCapabilities": {
    object (SurfaceCapabilities)
  }
}

object (SurfaceCapabilities)

ชุดความสามารถของพื้นผิวที่ต้องการ

{
  "capabilities": [
    enum (Capability)
  ]
}

enum (Capability)

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

{
  "firstSimple": {
    object (StaticSimplePrompt)
  },
  "content": {
    object (StaticContentPrompt)
  },
  "lastSimple": {
    object (StaticSimplePrompt)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (StaticLinkPrompt)
  },
  "override": boolean,
  "canvas": {
    object (StaticCanvasPrompt)
  }
}

object (StaticSimplePrompt)

ไม่บังคับ คำตอบแรกที่เป็นเสียงและข้อความเท่านั้น

object (StaticContentPrompt)

ไม่บังคับ เนื้อหา เช่น การ์ด รายการ หรือสื่อที่จะแสดงให้ผู้ใช้เห็น

object (StaticSimplePrompt)

ไม่บังคับ คำตอบสุดท้ายด้วยเสียงและข้อความเท่านั้น

object (Suggestion)

ไม่บังคับ คำแนะนำที่จะแสดงแก่ผู้ใช้ ซึ่งจะปรากฏที่ตอนท้ายของคำตอบเสมอ หากช่อง append ในพรอมต์ที่มีคือ true ระบบจะเพิ่มชื่อที่กำหนดในช่องนี้ไปยังชื่อที่กำหนดไว้ในพรอมต์คำแนะนำที่กำหนดไว้ก่อนหน้าและระบบจะนำค่าที่ซ้ำออก

object (StaticLinkPrompt)

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

boolean

ไม่บังคับ โหมดสำหรับวิธีการรวมข้อความนี้กับข้อความที่กำหนดไว้ก่อนหน้า true จะล้างข้อความที่กำหนดไว้ก่อนหน้าทั้งหมด (ข้อความแรกและที่เรียบง่ายสุดท้าย เนื้อหา ลิงก์คำแนะนำ และ Canvas) แล้วเพิ่มข้อความที่กำหนดไว้ในพรอมต์นี้ false จะเพิ่มข้อความที่กำหนดไว้ในข้อความแจ้งนี้ลงในข้อความที่กำหนดไว้ในคำตอบก่อนหน้า การตั้งค่าช่องนี้เป็น false จะเปิดใช้การต่อท้ายบางช่องใน "พรอมต์อย่างง่าย", ข้อความแจ้งคำแนะนำ และข้อความแจ้งของ Canvas (ส่วนหนึ่งของพรอมต์เนื้อหา) ด้วย ข้อความเนื้อหาและลิงก์จะถูกเขียนทับเสมอหากกำหนดไว้ในพรอมต์ ค่าเริ่มต้นคือ false

object (StaticCanvasPrompt)

คำตอบที่จะใช้สำหรับประสบการณ์การใช้งาน Canvas แบบอินเทอร์แอกทีฟ

{
  "variants": [
    {
      object (Variant)
    }
  ]
}

object (Variant)

รายการตัวแปรที่เป็นไปได้

{
  "speech": string,
  "text": string
}

string

ไม่บังคับ แสดงคำพูดที่จะพูดกับผู้ใช้ โดยอาจเป็น SSML หรือการอ่านออกเสียงข้อความ โดยค่าเริ่มต้น คำพูดจะต่อท้ายคำพูดของข้อความแจ้งแบบง่ายก่อนหน้า หากช่อง override ในพรอมต์ที่มีคือ true คำพูดที่กำหนดในช่องนี้จะลบล้างเสียงพูดของข้อความแจ้งแบบง่ายก่อนหน้า

string

ไม่บังคับ ข้อความที่จะแสดงในลูกโป่งแชท ไม่เช่นนั้นจะใช้การแสดงผลของช่องคำพูดด้านบน จำกัดอักขระไม่เกิน 640 ตัว โดยค่าเริ่มต้น ระบบจะใส่ข้อความต่อท้ายข้อความในข้อความแจ้งแบบง่ายก่อนหน้า หากช่อง override ในพรอมต์ที่มีคือ true ข้อความที่กำหนดในช่องนี้จะลบล้างข้อความในข้อความแจ้งแบบง่ายก่อนหน้า

{

  // Union field content can be only one of the following:
  "card": {
    object (StaticCardPrompt)
  },
  "image": {
    object (StaticImagePrompt)
  },
  "table": {
    object (StaticTablePrompt)
  },
  "media": {
    object (StaticMediaPrompt)
  },
  "list": {
    object (StaticListPrompt)
  },
  "collection": {
    object (StaticCollectionPrompt)
  },
  "collectionBrowse": {
    object (StaticCollectionBrowsePrompt)
  }
  // End of list of possible types for union field content.
}

object (StaticCardPrompt)

บัตรพื้นฐาน

object (StaticImagePrompt)

รูปภาพ

object (StaticTablePrompt)

การ์ดตาราง

object (StaticMediaPrompt)

คำตอบที่ระบุชุดสื่อที่จะเล่น

object (StaticListPrompt)

การ์ดสำหรับนำเสนอรายการตัวเลือกที่มี

object (StaticCollectionPrompt)

การ์ดที่แสดงรายการตัวเลือก

object (StaticCollectionBrowsePrompt)

การ์ดที่แสดงคอลเล็กชันหน้าเว็บเพื่อเปิด

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (StaticImagePrompt)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (StaticLinkPrompt)
  }
}

string

ไม่บังคับ ชื่อโดยรวมของการ์ด

string

ไม่บังคับ คำบรรยายของการ์ด

string

ต้องระบุ ข้อความส่วนเนื้อหาของการ์ดที่ต้องใช้ เว้นแต่จะมีรูปภาพ รองรับไวยากรณ์มาร์กดาวน์บางส่วนสำหรับการจัดรูปแบบ

object (StaticImagePrompt)

ไม่บังคับ รูปภาพหลักของการ์ด ความสูงกำหนดตายตัวที่ 192dp

enum (ImageFill)

ไม่บังคับ วิธีการเติมสีพื้นหลังรูปภาพ

object (StaticLinkPrompt)

ไม่บังคับ ปุ่มที่คลิกได้ที่จะแสดงในการ์ด

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

ต้องระบุ URL แหล่งที่มาของรูปภาพ รูปภาพต้องเป็น JPG, PNG และ GIF (เคลื่อนไหวและไม่เคลื่อนไหว) เช่น https://www.agentx.com/logo.png

string

ต้องระบุ ข้อความอธิบายรูปภาพที่จะใช้สำหรับการช่วยเหลือพิเศษ เช่น โปรแกรมอ่านหน้าจอ

integer

ไม่บังคับ ความสูงของรูปภาพเป็นพิกเซล

integer

ไม่บังคับ ความกว้างของรูปภาพเป็นพิกเซล

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

ชื่อของลิงก์

object (OpenUrl)

กำหนดพฤติกรรมเมื่อผู้ใช้เปิดลิงก์

{
  "url": string,
  "hint": enum (UrlHint)
}

string

ฟิลด์ URL ซึ่งอาจเป็นรายการใดรายการหนึ่งต่อไปนี้: - http/https urls สำหรับการเปิดแอปหรือหน้าเว็บที่ลิงก์ไปยังแอป

enum (UrlHint)

ระบุคำแนะนำสำหรับประเภท URL

{
  "title": string,
  "subtitle": string,
  "image": {
    object (StaticImagePrompt)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (StaticLinkPrompt)
  }
}

string

ไม่บังคับ ชื่อโดยรวมของตาราง ต้องตั้งค่าหากมีการตั้งค่าคำบรรยาย

string

ไม่บังคับ ชื่อรองของตาราง

object (StaticImagePrompt)

ไม่บังคับ รูปภาพที่เชื่อมโยงกับตาราง

object (TableColumn)

ไม่บังคับ ส่วนหัวและการจัดคอลัมน์

object (TableRow)

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

object (StaticLinkPrompt)

ไม่บังคับ ปุ่ม

{
  "header": string,
  "align": enum (HorizontalAlignment)
}

string

ข้อความส่วนหัวของคอลัมน์

enum (HorizontalAlignment)

การจัดข้อความแนวนอนของคอลัมน์เนื้อหา หากไม่ระบุ เนื้อหาจะอยู่ในแนวเดียวกับขอบที่ด้านหน้า

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

เซลล์ในแถวนี้ ระบบรับประกันว่าเซลล์ 3 เซลล์แรกจะแสดง แต่เซลล์อื่นอาจถูกตัดในบางพื้นผิว โปรดทดสอบด้วยเครื่องมือจำลองเพื่อดูว่าเซลล์ใดจะแสดงสำหรับพื้นผิวที่ระบุ

boolean

ระบุว่าควรมีตัวแบ่งหลังแต่ละแถวหรือไม่

{
  "text": string
}

string

เนื้อหาข้อความของเซลล์

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode)
}

enum (MediaType)

ประเภทสื่อของคําตอบนี้

string (Duration format)

ออฟเซ็ตเริ่มต้นของออบเจ็กต์สื่อแรก

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"

enum (OptionalMediaControls)

ประเภทตัวควบคุมสื่อที่ไม่บังคับซึ่งเซสชันการตอบสนองของสื่อนี้รองรับได้ หากตั้งค่าไว้ ระบบจะส่งคำขอไปที่ 3p เมื่อเกิดเหตุการณ์สื่อบางอย่างขึ้น หากไม่ได้ตั้งค่าไว้ 3p ยังต้องจัดการประเภทการควบคุมเริ่มต้น 2 ประเภท ได้แก่ FINISHED และ FAILED

object (MediaObject)

รายการออบเจ็กต์สื่อ

enum (RepeatMode)

โหมดเล่นซ้ำสำหรับรายการออบเจ็กต์สื่อ

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

ชื่อของออบเจ็กต์สื่อนี้

string

คำอธิบายของออบเจ็กต์สื่อนี้

string

URL ที่ชี้ไปยังเนื้อหาสื่อ

object (MediaImage)

รูปภาพที่จะแสดงกับการ์ดสื่อ

{

  // Union field image can be only one of the following:
  "large": {
    object (StaticImagePrompt)
  },
  "icon": {
    object (StaticImagePrompt)
  }
  // End of list of possible types for union field image.
}

object (StaticImagePrompt)

ภาพขนาดใหญ่ เช่น ปกอัลบั้ม ฯลฯ

object (StaticImagePrompt)

ไอคอนรูปภาพขนาดเล็กที่แสดงทางด้านขวาจากชื่อ มีขนาด 36x36 dp

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

ไม่บังคับ ชื่อของรายการ

string

ไม่บังคับ คำบรรยายของรายการ

object (ListItem)

ต้องระบุ รายการ

{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}

string

ต้องระบุ คีย์ NLU ที่ตรงกับชื่อคีย์เข้าถึงในประเภทที่เชื่อมโยง เมื่อแตะรายการแล้ว คีย์นี้จะถูกโพสต์กลับไปเป็นพารามิเตอร์ตัวเลือกตัวเลือก

string

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

string

ไม่บังคับ ข้อความส่วนเนื้อหาของสินค้า

object (StaticImagePrompt)

ไม่บังคับ รูปภาพสินค้า

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

ไม่บังคับ ชื่อคอลเล็กชัน

string

ไม่บังคับ ชื่อรองของคอลเล็กชัน

object (CollectionItem)

ต้องระบุ รายการคอลเล็กชัน

enum (ImageFill)

ไม่บังคับ ประเภทตัวเลือกการแสดงรูปภาพ

{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}

string

ต้องระบุ คีย์ NLU ที่ตรงกับชื่อคีย์เข้าถึงใน Type ที่เกี่ยวข้อง เมื่อแตะรายการแล้ว คีย์นี้จะถูกโพสต์กลับไปเป็นพารามิเตอร์ตัวเลือกตัวเลือก

string

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

string

ไม่บังคับ ข้อความส่วนเนื้อหาของสินค้า

object (StaticImagePrompt)

ไม่บังคับ รูปภาพสินค้า

{
  "items": [
    {
      object (CollectionBrowseItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

object (CollectionBrowseItem)

รายการในคอลเล็กชันการเรียกดู ขนาดรายการควรอยู่ในช่วง [2, 10]

enum (ImageFill)

ตัวเลือกการแสดงรูปภาพสำหรับรูปภาพในคอลเล็กชัน

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (StaticImagePrompt)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}

string

ต้องระบุ ชื่อของรายการคอลเล็กชัน

string

คำอธิบายของรายการคอลเล็กชัน

string

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

object (StaticImagePrompt)

รูปภาพสำหรับรายการคอลเล็กชัน

object (OpenUrl)

ต้องระบุ URI ที่จะเปิดหากรายการที่เลือก

{
  "title": string
}

string

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

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "sendStateDataToCanvasApp": boolean,
  "enableFullScreen": boolean
}

string

ต้องระบุ URL ของมุมมองเว็บที่จะโหลด

value (Value format)

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

boolean

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

boolean

ไม่บังคับ หากตั้งค่าเป็น true ระบบจะรวมข้อมูลเมตาที่เกี่ยวข้องกับการสนทนาและกลับไปยังแอปพลิเคชัน Canvas

boolean

ไม่บังคับ หาก true แอปพลิเคชัน Canvas จะใช้พื้นที่เต็มหน้าจอและไม่มีส่วนหัวที่ด้านบน ข้อความโทสต์จะแสดงในหน้าจอการโหลดที่มีชื่อที่แสดงของการดำเนินการ ชื่อนักพัฒนาซอฟต์แวร์ และวิธีการออกจากการดำเนินการด้วย ค่าเริ่มต้นคือ false

{
  "onEnter": {
    object (EventHandler)
  },
  "intentEvents": [
    {
      object (IntentEvent)
    }
  ],
  "conditionalEvents": [
    {
      object (ConditionalEvent)
    }
  ],
  "slots": [
    {
      object (Slot)
    }
  ],
  "onSlotUpdated": {
    object (EventHandler)
  }
}

object (EventHandler)

เครื่องจัดการที่จะเรียกใช้เมื่อเปลี่ยนเข้าสู่โหมดนี้

object (IntentEvent)

รายการเหตุการณ์ที่ทริกเกอร์โดยอิงตาม Intent เหตุการณ์เหล่านี้สามารถทริกเกอร์ได้ทุกเมื่อหลังจากมีการเรียก on_load Handler แล้ว สำคัญ - เหตุการณ์เหล่านี้จะกำหนดชุดของ Intent ที่กำหนดขอบเขตไว้ที่โหมดนี้และจะมีลำดับความสำคัญเหนือกว่าเหตุการณ์ที่กำหนดไว้ทั่วโลกซึ่งมี Intent เดียวกันหรือวลีสำหรับทริกเกอร์ ชื่อ Intent ภายในฉากต้องไม่ซ้ำกัน

object (ConditionalEvent)

รายการเหตุการณ์ที่จะเรียกโดยอิงตามคำสั่งแบบมีเงื่อนไข ระบบจะประเมินสิ่งเหล่านี้หลังจากกรอกแบบฟอร์มแล้วหรือทันทีหลังจาก on_load หากไม่มีแบบฟอร์ม (ประเมินเพียงครั้งเดียว) ระบบจะเรียกเฉพาะเหตุการณ์ที่ตรงกันรายการแรกเท่านั้น

object (Slot)

รายการสล็อตที่เรียงลำดับ แต่ละช่องจะกำหนดประเภทของข้อมูลที่จะแก้ไขและกำหนดค่าเพื่อปรับแต่งประสบการณ์ของความละเอียดนี้ (เช่น ข้อความแจ้ง)

object (EventHandler)

มีการเรียกตัวแฮนเดิลเมื่อมีการเปลี่ยนสถานะของช่องที่ไม่ได้เกิดจากการอัปเดตภายในเครื่องจัดการอื่น ซึ่งจะทำให้สล็อตใช้งานไม่ได้ ฉากใช้งานไม่ได้ หรือมีการเปลี่ยนแปลงสถานะฉากแบบอื่นๆ

{
  "intent": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}

string

ต้องระบุ Intent ทริกเกอร์เหตุการณ์

string

ไม่บังคับ ฉากปลายทางที่การสนทนาควรข้ามไป สถานะของฉากปัจจุบันจะถูกทำลายเมื่อเปลี่ยน

object (EventHandler)

ไม่บังคับ ตัวแฮนเดิลเหตุการณ์ซึ่งจะทำงานเมื่อตรงกับ Intent ควรดำเนินการก่อนเปลี่ยนเป็นฉากปลายทาง มีประโยชน์ในการสร้างข้อความแจ้งเพื่อตอบสนองต่อเหตุการณ์

{
  "condition": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}

string

ต้องระบุ เงื่อนไขตัวกรองสำหรับเหตุการณ์นี้ที่จะทริกเกอร์ หากมีการประเมินเงื่อนไขเป็น "จริง" จะมีการทริกเกอร์ handler ที่เกี่ยวข้อง ระบบรองรับการอ้างอิงตัวแปรต่อไปนี้ $session - ใช้อ้างอิงข้อมูลในพื้นที่เก็บข้อมูลเซสชัน $user - ใช้อ้างอิงข้อมูลในพื้นที่เก็บข้อมูลของผู้ใช้ ระบบรองรับโอเปอเรเตอร์บูลีนต่อไปนี้ (พร้อมตัวอย่าง) && - session.params.counter > 0 && session.params.counter < 100 || - session.params.foo == "John" || session.params.counter == "Adam" ! - !(session.params.counter == 5) รองรับการเปรียบเทียบ ==, !=, <, >, <=, >= ระบบรองรับโอเปอเรเตอร์รายการและสตริงต่อไปนี้ (พร้อมตัวอย่าง): in - "Watermelon" ใน session.params.fruitList size - size(session.params.fruitList) > 2 - substringsession.params.fullName.contains("John")

string

ไม่บังคับ โหมดปลายทางที่การสนทนาควรข้ามไปเมื่อประเมินเงื่อนไขที่เกี่ยวข้องเป็นจริง สถานะของฉากปัจจุบันจะถูกทำลายเมื่อเปลี่ยน

object (EventHandler)

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

{
  "name": string,
  "type": {
    object (ClassReference)
  },
  "required": boolean,
  "promptSettings": {
    object (PromptSettings)
  },
  "commitBehavior": {
    object (CommitBehavior)
  },
  "config": value,
  "defaultValue": {
    object (DefaultValue)
  }
}

string

ต้องระบุ ชื่อของช่องโฆษณา

object (ClassReference)

ต้องระบุ ประกาศประเภทข้อมูลของช่องนี้

boolean

ไม่บังคับ ระบุว่าต้องเติมช่องโฆษณาก่อนที่จะเลื่อนไปยังช่องอื่นหรือไม่ ช่องโฆษณาที่จำเป็นที่ไม่ได้รับการเติมโฆษณาจะทริกเกอร์ข้อความแจ้งที่ปรับแต่งได้ให้แก่ผู้ใช้

object (PromptSettings)

ไม่บังคับ ลงทะเบียน แจ้งเตือนสำหรับการใส่ข้อมูลในช่องระยะต่างๆ

object (CommitBehavior)

ไม่บังคับ ลักษณะการทำงานของคอมมิตที่เชื่อมโยงกับช่องโฆษณา

value (Value format)

ไม่บังคับ การกำหนดค่าเพิ่มเติมที่เชื่อมโยงกับช่องโฆษณาซึ่งใช้สำหรับเติมช่องโฆษณา รูปแบบของการกำหนดค่าจะเฉพาะเจาะจงสำหรับประเภทสล็อต เพิ่มการอ้างอิงทรัพยากรไปยังผู้ใช้หรือพารามิเตอร์เซสชันลงในการกำหนดค่านี้ได้ ซึ่งจำเป็นต้องใช้การกำหนดค่านี้สำหรับการเติมเต็มช่องที่เกี่ยวข้องกับธุรกรรมและการมีส่วนร่วมของผู้ใช้

ตัวอย่างเช่น สำหรับสล็อตประเภท actions.type.CompletePurchaseValue การกำหนดค่าต่อไปนี้ให้คำสั่งซื้อสินค้าดิจิทัลที่มีการอ้างอิงไปยังพารามิเตอร์เซสชัน userSelectedSkuId ที่ลูกค้ากำหนด

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }

object (DefaultValue)

ไม่บังคับ กำหนดค่าเพื่อเติมค่าเริ่มต้นสำหรับช่องนี้

{
  "initialPrompt": {
    object (EventHandler)
  },
  "noMatchPrompt1": {
    object (EventHandler)
  },
  "noMatchPrompt2": {
    object (EventHandler)
  },
  "noMatchFinalPrompt": {
    object (EventHandler)
  },
  "noInputPrompt1": {
    object (EventHandler)
  },
  "noInputPrompt2": {
    object (EventHandler)
  },
  "noInputFinalPrompt": {
    object (EventHandler)
  }
}

object (EventHandler)

พร้อมท์สำหรับค่าของช่องโฆษณา เช่น "ขนาดที่ต้องการ"

object (EventHandler)

แจ้งให้ระบุเมื่อข้อมูลของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องโฆษณาเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ"

object (EventHandler)

แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ"

object (EventHandler)

แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องสำหรับครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ"

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ"

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ"

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลในครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ"

{
  "writeSessionParam": string
}

string

พารามิเตอร์เซสชันที่จะเขียนค่าช่องโฆษณาหลังจากเติมค่าแล้ว โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน "$$" ใช้ในการเขียนค่าของสล็อตลงในพารามิเตอร์เซสชันโดยใช้ชื่อเดียวกับช่องโฆษณา เช่น WriteSessionParam = "fruit" จะสอดคล้องกับ "$session.params.fruit" writeSessionParam = "ticket" จะสอดคล้องกับ "$session.params.ticket"

{
  "sessionParam": string,
  "constant": value
}

string

ไม่บังคับ พารามิเตอร์เซสชันที่จะใช้เริ่มต้นค่าของสล็อต ถ้ามีค่าที่ไม่ว่างเปล่า ประเภทของค่าต้องตรงกับประเภทของช่องโฆษณา โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน เช่น sessionParam = "fruit" สอดคล้องกับ $session.params.fruit sessionParam = "ticket" สอดคล้องกับ $session.params.ticket

value (Value format)

ไม่บังคับ ค่าเริ่มต้นคงที่สำหรับช่อง ตัวเลือกนี้จะใช้ก็ต่อเมื่อไม่ได้ป้อนข้อมูลค่าสำหรับช่องนี้ผ่าน sessionParam เท่านั้น ประเภทของค่านี้ต้องตรงกับประเภทของช่องโฆษณา

{
  "dataFiles": [
    {
      object (DataFile)
    }
  ]
}

object (DataFile)

ไฟล์ข้อมูลหลายไฟล์

{
  "filePath": string,
  "contentType": string,
  "payload": string
}

string

เส้นทางที่เกี่ยวข้องของไฟล์ข้อมูลจากรูทของโปรเจ็กต์ในโครงสร้างไฟล์ SDK เส้นทางไฟล์ที่อนุญาต: - รูปภาพ: resources/images/{multiple directories}?/{ImageName}.{extension} - เสียง: resources/audio/{multiple directories}?/{AudioFileName}.{extension} - รหัสฟังก์ชันระบบคลาวด์แบบแทรกในบรรทัด: webhooks/{WebhookName}.zip ส่วนขยายที่อนุญาต: - รูปภาพ: png, jpg, jpeg - เสียง: mp3, mpeg - ฟังก์ชันระบบคลาวด์แบบแทรกในบรรทัด: zip

string

ต้องระบุ ประเภทเนื้อหาของเนื้อหานี้ ตัวอย่าง: text/html ประเภทเนื้อหาต้องเป็นไปตามข้อกำหนด (http://www.w3.org/Protocols/rfc1341/4_Content-Type.html) ฟังก์ชันระบบคลาวด์ต้องอยู่ในรูปแบบ ZIP และประเภทเนื้อหาควรเป็น application/zip;zip_type=cloud_function พารามิเตอร์ zip_type ระบุว่าไฟล์ zip มีไว้สำหรับ Cloud Function

string (bytes format)

เนื้อหาของไฟล์ข้อมูล เช่น ไบต์ดิบของรูปภาพ ไฟล์เสียง หรือรูปแบบ ZIP ของ Cloud Function ขนาดเพย์โหลดมีขีดจำกัดสูงสุด 10 MB

สตริงที่เข้ารหัสแบบ Base64