Scene

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

การแสดง YAML 
onEnter: 
  object (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
ช่อง
onEnter

object (EventHandler)

ตัวแฮนเดิลที่จะเรียกใช้เมื่อเปลี่ยนเข้าสู่ฉากนี้
intentEvents[]

object (IntentEvent)

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

object (ConditionalEvent)

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

object (Slot)

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

object (EventHandler)

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

สล็อต

การกำหนดค่าสำหรับช่องโฆษณา ช่องคือหน่วยข้อมูลเดี่ยวที่สามารถเติมผ่านภาษาธรรมชาติ (เช่น พารามิเตอร์ Intent), พารามิเตอร์เซสชัน และแหล่งที่มาอื่นๆ

การแสดง YAML 
name: string
type: 
  object (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
ช่อง
name

string

ต้องระบุ ชื่อของสล็อต
type

object (ClassReference)

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

boolean

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

object (PromptSettings)

ไม่บังคับ ลงทะเบียนพรอมต์สำหรับระยะต่างๆ ของการเติมช่องโฆษณา
commitBehavior

object (CommitBehavior)

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

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" }
defaultValue

object (DefaultValue)

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

PromptSettings

ตำแหน่งเดียวที่มีการกำหนดข้อความแจ้งของช่อง

การแสดง YAML 
initialPrompt: 
  object (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
ช่อง
initialPrompt

object (EventHandler)

แจ้งสำหรับค่าช่องโฆษณา ตัวอย่างเช่น "คุณต้องการขนาดใด"
noMatchPrompt1

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

ข้อความแจ้งให้แสดงเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งแรก เช่น "ขอโทษครับ ไม่ค่อยเข้าใจ"
noInputPrompt2

object (EventHandler)

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

object (EventHandler)

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

CommitBehavior

ข้อความที่อธิบายลักษณะการคอมมิตที่เชื่อมโยงกับช่องโฆษณาหลังจากกรอกเสร็จสมบูรณ์แล้ว

การแสดง YAML 
writeSessionParam: string
ช่อง
writeSessionParam

string

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

DefaultValue

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

การแสดง YAML 
sessionParam: string
constant: value
ช่อง
sessionParam

string

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

value (Value format)

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