Method: fulfill

{
  "name": string
}

string

ไม่บังคับ ชื่อของเครื่องจัดการ

{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}

string

ต้องระบุ ชื่อของความตั้งใจที่ตรงกันล่าสุด

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

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

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

string

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

{
  "original": string,
  "resolved": value
}

string

ต้องระบุ ค่าข้อความต้นฉบับที่ดึงมาจากคำพูดของผู้ใช้

value (Value format)

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

{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}

string

ต้องระบุ ชื่อของฉากปัจจุบัน

enum (SlotFillingStatus)

ต้องระบุ สถานะปัจจุบันของการเติมช่อง ช่องนี้เป็นแบบอ่านอย่างเดียว

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

สล็อตที่เชื่อมโยงกับฉากปัจจุบัน คำตอบของเครื่องจัดการไม่สามารถแสดงผลสล็อตที่ไม่ได้ส่งในคำขอ

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

object (NextScene)

ไม่บังคับ ข้อมูลในฉากที่ต้องดำเนินการเป็นลำดับถัดไป

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

โหมดของช่อง (จำเป็นหรือไม่บังคับ) ตั้งค่าได้โดยนักพัฒนาซอฟต์แวร์

enum (SlotStatus)

สถานะของช่องโฆษณา

value (Value format)

มูลค่าของช่อง การเปลี่ยนค่านี้ในคำตอบจะเป็นการแก้ไขค่าในการเติมช่องโฆษณา

boolean

ระบุว่ามีการรวบรวมค่าช่องโฆษณาในการเลี้ยวล่าสุดหรือไม่ ช่องนี้เป็นแบบอ่านอย่างเดียว

object (Prompt)

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

{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}

boolean

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

object (Simple)

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

object (Content)

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

object (Simple)

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

object (Suggestion)

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

object (Link)

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

object (Canvas)

ไม่บังคับ แสดงการตอบกลับ Interactive Canvas ที่จะส่งไปให้ผู้ใช้

object (OrderUpdate)

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

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

string

ไม่บังคับ หมายถึงคำพูดที่ผู้ใช้พูด อาจเป็น SSML หรือการอ่านออกเสียงข้อความ หากปุ่ม "ลบล้าง" ในช่องพรอมต์ที่มี "true" เสียงพูดที่ระบุไว้ในช่องนี้จะแทนที่เสียงพูดของพรอมต์แบบง่ายก่อนหน้า โปรดดู https://developers.google.com/assistant/conversational/ssml

string

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

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}

object (Card)

บัตรพื้นฐาน

object (Image)

รูปภาพ

object (Table)

การ์ดตาราง

object (Media)

การตอบกลับที่ระบุชุดสื่อที่จะเล่น

object (Collection)

การ์ดแสดงชุดตัวเลือกที่มีให้เลือก

object (List)

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

object (CollectionBrowse)

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

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

string

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

string

ไม่บังคับ

string

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

object (Image)

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

enum (ImageFill)

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

object (Link)

ปุ่มที่มีลิงก์ขาออก ไม่บังคับ

{
  "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

ชื่อของลิงก์ อักขระสูงสุด 20 ตัว

object (OpenUrl)

สิ่งที่จะเกิดขึ้นเมื่อผู้ใช้เปิดลิงก์

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

string

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

enum (UrlHint)

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

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

string

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

string

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

object (Image)

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

object (TableColumn)

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

object (TableRow)

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

object (Link)

ปุ่ม

{
  "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),
  "firstMediaObjectIndex": integer
}

enum (MediaType)

string (Duration format)

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

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

enum (OptionalMediaControls)

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

object (MediaObject)

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

enum (RepeatMode)

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

integer

ดัชนีแบบ 0 ของ Media Object แรกใน mediaObjects ที่จะเล่น หากไม่ระบุ ค่าเป็น 0 หรืออยู่นอกขอบเขต การเล่นจะเริ่มต้นที่ออบเจ็กต์สื่อแรกใน mediaObjects

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

string

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

string

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

string

URL ที่ชี้ไปยังเนื้อหาสื่อ ไฟล์ MP3 ต้องโฮสต์บนเว็บเซิร์ฟเวอร์และเข้าถึงได้แบบสาธารณะผ่าน HTTPS URL สตรีมมิงแบบสดรองรับเฉพาะรูปแบบ MP3 เท่านั้น

object (MediaImage)

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

{

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

object (Image)

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

object (Image)

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

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

string

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

string

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

object (CollectionItem)

รายการข้อมูล โดยมีค่าต่ำสุดเป็น 2 และไม่เกิน 10 รายการ

enum (ImageFill)

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

{
  "key": string
}

string

ต้องระบุ คีย์ NLU ที่ตรงกับชื่อคีย์รายการในประเภทที่เชื่อมโยง

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

string

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

string

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

object (ListItem)

รายการข้อมูล โดยมีค่าต่ำสุดเป็น 2 และไม่เกิน 30 รายการ

{
  "key": string
}

string

ต้องระบุ คีย์ NLU ที่ตรงกับชื่อคีย์รายการในประเภทที่เชื่อมโยง

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

object (Item)

รายการข้อมูล โดยมีค่าต่ำสุดเป็น 2 และไม่เกิน 10 รายการ

enum (ImageFill)

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

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

string

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

string

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

string

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

object (Image)

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

object (OpenUrl)

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

{
  "title": string
}

string

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

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}

string

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

value (Value format)

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

boolean

ไม่บังคับ ค่าเริ่มต้น: false

object (ContinuousMatchConfig)

การกำหนดค่าที่ใช้เพื่อเริ่มโหมดการจับคู่แบบต่อเนื่อง

{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}

object (ExpectedPhrase)

วลีที่คาดหวังทั้งหมดที่เป็นไปได้ในเซสชันโหมดการจับคู่แบบต่อเนื่องนี้

integer

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

{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}

string

วลีที่จะจับคู่ระหว่างเซสชันโหมดการจับคู่แบบต่อเนื่อง

string

บางวลีอาจจดจำคำพูดไม่ถูกต้องแม้ว่าจะมีการให้น้ำหนักพิเศษในการพูดก็ตาม วิธีนี้ช่วยให้นักพัฒนาซอฟต์แวร์ระบุทริกเกอร์อื่นๆ สำหรับคำพ้องความหมายได้

{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}

enum (Type)

เลิกใช้งานแล้ว: ใช้ OrderUpdate.update_mask แทน หากประเภท = SNAPSHOT นั้น OrderUpdate.order ควรเป็นคำสั่งซื้อทั้งหมด หากประเภท = ORDER_STATUS นี่เป็นการเปลี่ยนแปลงสถานะระดับการสั่งซื้อ ระบบจะเลือกเฉพาะ order.last_update_time และสถานะประเภทธุรกิจนี้ หมายเหตุ: type.ORDER_STATUS สนับสนุนเฉพาะการอัปเดตสถานะ PurcahaseOrderExtension และไม่มีแผนที่จะขยายการสนับสนุนนี้ แต่เราขอแนะนำให้ใช้ updateMask แทน เนื่องจากมีความแพร่หลาย ขยายการใช้งานได้ และใช้ได้กับธุรกิจทุกประเภท

object (Order)

string (FieldMask format)

หมายเหตุ: มีข้อควรพิจารณา/คำแนะนำต่อไปนี้สำหรับช่องพิเศษต่อไปนี้ 1. order.last_update_time จะอัปเดตเป็นส่วนหนึ่งของคำขออัปเดตเสมอ 2. order.create_time, order.google_order_id และ order.merchant_order_id จะถูกละเว้นถ้าระบุไว้เป็นส่วนหนึ่งของ updateMask

ซึ่งเป็นรายการชื่อที่ตรงตามเกณฑ์ทั้งหมดของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

object (UserNotification)

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

string

เหตุผลในการเปลี่ยนแปลง/อัปเดต

{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}

string

รหัสคำสั่งซื้อที่ Google กำหนด

string

ต้องระบุ: รหัสคำสั่งซื้อภายในที่ผู้ขายกำหนด รหัสนี้ต้องไม่ซ้ำกัน และจำเป็นสำหรับการดำเนินการอัปเดตคำสั่งซื้อในครั้งต่อๆ ไป โดยอาจกำหนดเป็น googleOrderId ที่ระบุ หรือค่าที่ไม่ซ้ำกันอื่นๆ โปรดทราบว่ารหัสที่แสดงแก่ผู้ใช้คือ userVisibleOrderId ซึ่งอาจจะเป็นค่าอื่นที่ใช้งานง่ายกว่า ความยาวสูงสุดคือ 128 อักขระ

string

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

string

เลิกใช้งานแล้ว: ใช้สถานะ Orderชิ้นงานแทน ป้ายกำกับที่ปรากฏต่อผู้ใช้สำหรับสถานะของคำสั่งซื้อนี้

object (UserInfo)

ข้อมูลเกี่ยวกับผู้ซื้อ

object (Image)

รูปภาพที่เชื่อมโยงกับคำสั่งซื้อ

string (Timestamp format)

ต้องระบุ: วันที่และเวลาที่สร้างคำสั่งซื้อ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

string (Timestamp format)

วันที่และเวลาอัปเดตคำสั่งซื้อครั้งล่าสุด จำเป็นสำหรับการอัปเดตคำสั่งซื้อ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

object (Merchant)

ผู้ขายที่อำนวยความสะดวกในการชำระเงิน ซึ่งอาจแตกต่างจากผู้ให้บริการระดับรายการโฆษณา ตัวอย่าง: คำสั่งซื้อ Expedia พร้อมรายการโฆษณาจาก ANA

object (Contents)

ต้องระบุ: สั่งซื้อเนื้อหาที่เป็นกลุ่มรายการโฆษณา

object (PriceAttribute)

ราคา ส่วนลด ภาษี และอื่นๆ

object (Action)

ติดตามผลที่ระดับคำสั่งซื้อ

object (PaymentData)

ข้อมูลที่เกี่ยวข้องกับการชำระเงินสำหรับคำสั่งซื้อ

string

ลิงก์ไปยังข้อกำหนดในการให้บริการที่ใช้กับคำสั่งซื้อ/คำสั่งซื้อที่เสนอ

string

แนบโน้ตไปกับคำสั่งซื้อแล้ว

object (Promotion)

โปรโมชันทั้งหมดที่เชื่อมโยงกับคำสั่งซื้อนี้

object (Disclosure)

การเปิดเผยข้อมูลที่เชื่อมโยงกับคำสั่งซื้อนี้

object

เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน พร็อพเพอร์ตี้เหล่านี้จะมีผลกับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา ค่าที่เป็นไปได้: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

object (PurchaseOrderExtension)

ใบสั่งซื้อ

object (TicketOrderExtension)

ลำดับตั๋ว

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

อีเมลของผู้ใช้ เช่น janedoe@gmail.com

string

ชื่อของผู้ใช้

string

นามสกุลของผู้ใช้

string

ชื่อที่แสดงของผู้ใช้อาจต่างจากชื่อหรือนามสกุล

object (PhoneNumber)

หมายเลขโทรศัพท์ของผู้ใช้

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

string

หมายเลขโทรศัพท์ในรูปแบบ E.164 ตามที่กำหนดไว้ใน International Telecommunication Union (ITU) Recommendation E.164 ลิงก์ wiki: https://en.wikipedia.org/wiki/E.164

string

ส่วนขยายไม่มีการกำหนดมาตรฐานในคำแนะนำของ ITU ยกเว้นการกำหนดเป็นชุดตัวเลขโดยมีความยาวได้สูงสุด 40 หลัก พารามิเตอร์ได้รับการกำหนดให้เป็นสตริงนี้เพื่อรองรับการใช้เลข 0 นำหน้าในส่วนขยาย (องค์กรมีอิสระเต็มที่ในการทำเช่นนั้น เนื่องจากไม่มีการกำหนดมาตรฐาน) นอกเหนือจากตัวเลขแล้ว อักขระโทรออกอื่นๆ เช่น "," (แจ้งว่ากำลังรอ) อาจจัดเก็บไว้ที่นี่ เช่น ในชิ้นงาน xxx-xxx-xxxx 123, "123" เป็นส่วนขยาย

string

รหัสการเลือกผู้ให้บริการที่ต้องใช้เมื่อโทรหาหมายเลขโทรศัพท์นี้ภายในประเทศ ซึ่งรวมถึงรหัสที่ต้องโทรในบางประเทศเมื่อโทรจากโทรศัพท์บ้านไปยังโทรศัพท์มือถือ หรือกลับกัน เช่น ในโคลัมเบีย เครื่องหมาย "3" จะต้องกดหมายเลขก่อนหมายเลขโทรศัพท์เมื่อโทรจากโทรศัพท์มือถือไปยังโทรศัพท์บ้านในประเทศหรือในทางกลับกัน https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

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

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

string

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

string

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

integer

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

integer

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

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

รหัสที่ไม่บังคับซึ่งกำหนดให้กับผู้ขาย (หากมี)

string

ชื่อผู้ขาย เช่น "ขนมปัง Panera"

object (Image)

รูปภาพที่เชื่อมโยงกับผู้ขาย

object (PhoneNumber)

หมายเลขโทรศัพท์ของผู้ขาย

object (Location)

ที่อยู่ของผู้ขาย

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object (LatLng)

พิกัดทางภูมิศาสตร์ ต้องมี [DEVICE_PRECISE_LOCATION] สิทธิ์ [google.actions.v2.Permissions.DEVICE_PRECISE_LOCATION]

string

ที่อยู่ที่แสดง เช่น "1600 Amphitheatre Pkwy, Mountain View, CA 94043" ต้องมี [DEVICE_PRECISE_LOCATION] สิทธิ์ [google.actions.v2.Permissions.DEVICE_PRECISE_LOCATION]

string

รหัสไปรษณีย์ ต้องมี [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permissions.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] สิทธิ์ [google.actions.v2.Permissions.DEVICE_COARSE_LOCATION]

string

เมือง ต้องมี [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permissions.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] สิทธิ์ [google.actions.v2.Permissions.DEVICE_COARSE_LOCATION]

object (PostalAddress)

ที่อยู่ทางไปรษณีย์ ต้องมี [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permissions.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] สิทธิ์ [google.actions.v2.Permissions.DEVICE_COARSE_LOCATION]

string

ชื่อสถานที่

string

หมายเลขโทรศัพท์ของสถานที่ตั้ง เช่น หมายเลขติดต่อของที่ตั้งธุรกิจ หรือหมายเลขโทรศัพท์สำหรับสถานที่จัดส่ง

string

หมายเหตุเกี่ยวกับสถานที่

string

PlaceId จะใช้กับ Places API เพื่อดึงข้อมูลรายละเอียดของสถานที่ โปรดดู https://developers.google.com/places/web-service/place-id

{
  "latitude": number,
  "longitude": number
}

number

ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]

number

ลองจิจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

การแก้ไขสคีมาของ PostalAddress โดยต้องตั้งค่าเป็น 0 ซึ่งเป็นรุ่นล่าสุด

การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับการแก้ไขเก่า

string

ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ข้อมูลนี้ไม่ได้มีการอนุมานแต่อย่างใด และขึ้นอยู่กับผู้ใช้ที่จะตรวจสอบว่าค่าถูกต้อง ดูรายละเอียดได้ที่ http://cldr.unicode.org/ และ http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์

string

ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาในที่อยู่นี้ (หากทราบ) ซึ่งมักเป็นภาษา UI ของแบบฟอร์มอินพุต หรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในที่อยู่ ประเทศ/ภูมิภาค หรือคำทับศัพท์ที่เทียบเท่า ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบความถูกต้องหรือการดำเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ

หากไม่ทราบค่านี้ ก็ควรละเว้น (แทนที่จะระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง)

เช่น "zh-Hant", "ja", "ja-Latn", "en"

string

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

string

ไม่บังคับ รหัสการจัดเรียงเพิ่มเติม รหัสเฉพาะประเทศ ซึ่งไม่มีใช้ในภูมิภาคส่วนใหญ่ ในที่ที่ใช้ ค่าอาจเป็นสตริง เช่น "CEDEX" ซึ่งอาจจะตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นเพียงตัวเลขเพียงอย่างเดียวซึ่งเป็นตัวแทนของ "รหัสเซกเตอร์" (จาเมกา), "ดัชนีพื้นที่นำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น โกตดิวัวร์)

string

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

string

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

string

ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ตัวอย่างเช่น ย่านใกล้เคียง เขตเมือง เขตต่างๆ

string

บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงระดับที่ต่ำกว่าของที่อยู่

เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") ดังนั้นจึงจำเป็นที่การเรียงลำดับบรรทัดจะต้องชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับซองจดหมาย" สำหรับประเทศ/ภูมิภาคของที่อยู่ ในพื้นที่ที่อาจแตกต่างกันไป (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อทำให้ชัดเจน (เช่น "ja" สำหรับการสั่งซื้อจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับเล็กไปใหญ่) วิธีนี้จะช่วยให้เลือกบรรทัดของที่อยู่ที่เจาะจงที่สุดตามภาษาได้

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

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

string

ไม่บังคับ ผู้รับในที่อยู่ ในบางกรณี ช่องนี้อาจมีข้อมูลหลายบรรทัด เช่น อาจมีคำว่า "ดูแล"

string

ไม่บังคับ ชื่อขององค์กรตามที่อยู่

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

object (LineItem)

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

{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}

string

ต้องระบุ: ตัวระบุที่ผู้ขายกำหนดสำหรับรายการโฆษณา ใช้เพื่อระบุรายการโฆษณาที่มีอยู่ในการนำการอัปเดตบางส่วนไปใช้ ความยาวสูงสุดคือ 64 อักขระ

string

ชื่อบรรทัดรายการตามที่แสดงในใบเสร็จ ความยาวสูงสุดคือ 100 อักขระ

string

เลิกใช้งานแล้ว โปรดใช้สถานะระดับแนวตั้งแทน เช่น ใช้ PurchaseOrderExtension.status สำหรับการซื้อ ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของรายการโฆษณานี้

object (Merchant)

ผู้ให้บริการของรายการโฆษณาหนึ่งๆ หากแตกต่างจากคำสั่งซื้อโดยรวม ตัวอย่าง: คำสั่งซื้อด้วย ANA ผู้ให้บริการรายการโฆษณาของ Expedia

object (PriceAttribute)

ราคาและการปรับระดับรายการโฆษณา

object (Action)

ติดตามผลการดำเนินการที่รายการโฆษณา

object (UserInfo)

ลูกค้าระดับรายการโฆษณา ซึ่งไม่ใช่ผู้ซื้อระดับคำสั่งซื้อ ตัวอย่าง: ผู้ใช้ X จองร้านอาหารโดยใช้ชื่อผู้ใช้ ข

object (Image)

รูปภาพขนาดเล็กที่เชื่อมโยงกับรายการนี้ (หากมี)

string

คำอธิบายรายการโฆษณา

string

หมายเหตุเพิ่มเติมที่เกี่ยวข้องกับรายการโฆษณานี้ เช่น นโยบายการยกเลิก

object (Disclosure)

การเปิดเผยข้อมูลที่เชื่อมโยงกับรายการโฆษณานี้

object

เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน ต้องระบุ: เนื้อหาเชิงความหมายของรายการโฆษณาตามประเภท/ประเภทธุรกิจ ธุรกิจทุกประเภทควรมีรายละเอียดการดำเนินการตามคำสั่งซื้อของตัวเอง ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

object (PurchaseItemExtension)

คำสั่งซื้อ เช่น สินค้า อาหาร ฯลฯ

object (ReservationItemExtension)

การสั่งจอง เช่น ร้านอาหาร ตัดผม ฯลฯ

{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}

enum (Type)

ต้องระบุ: แอตทริบิวต์ประเภทเงิน

string

ต้องระบุ: สตริงแอตทริบิวต์ราคาที่ผู้ใช้แสดง ซึ่งผู้ขายส่งและแปลข้อมูลนี้

string

ไม่บังคับ: รหัสของรายการโฆษณาที่เกี่ยวข้องกับราคานี้

enum (State)

ต้องระบุ: สถานะของราคา: ราคาโดยประมาณเทียบกับราคาจริง

boolean

ราคารวมภาษีหรือไม่

object (Money)

จำนวนเงิน

integer

ข้อกำหนดเปอร์เซ็นต์ไปจนถึง 1/1000 ของเปอร์เซ็นต์ เช่น 8.750% จะแสดงเป็น 8750 เปอร์เซ็นต์ติดลบหมายถึงเปอร์เซ็นต์ส่วนลด กำลังเลิกใช้งานช่องนี้ พิจารณาเพิ่มข้อมูลกลับคืนได้เมื่อต้องมีกรณีการใช้งานที่มั่นคง

{
  "currencyCode": string,
  "amountInMicros": string
}

string

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217

string (int64 format)

จำนวนเงินในหน่วยไมโคร ตัวอย่างเช่น ควรตั้งค่าช่องนี้เป็น 1990000 สำหรับ $1.99

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum (Type)

จำเป็น: ประเภทการทำงาน

string

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

object (OpenUrlAction)

สิ่งที่ต้องดำเนินการ

object (ActionMetadata)

ข้อมูลเมตาที่เชื่อมโยงกับการดำเนินการ

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

string

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

object (AndroidApp)

ข้อมูลเกี่ยวกับแอป Android ในกรณีที่ URL คาดว่าจะมาจากแอป Android

enum (UrlTypeHint)

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

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

string

ต้องระบุชื่อแพ็กเกจชื่อแพ็กเกจเมื่อระบุ Android Fulfillment

object (VersionFilter)

เมื่อระบุตัวกรองหลายรายการ การจับคู่ตัวกรองใดก็ตามจะทริกเกอร์แอป

{
  "minVersion": integer,
  "maxVersion": integer
}

integer

รหัสเวอร์ชันต่ำสุดหรือ 0 (รวม 0 ด้วย)

integer

รวมรหัสเวอร์ชันสูงสุด ช่วงที่นำมาพิจารณาคือ [minVersion:maxVersion] ช่วง Null หมายถึงเวอร์ชันใดก็ตาม ตัวอย่าง: หากต้องการระบุการใช้เวอร์ชันเดียว: [target_version:target_version] หากต้องการระบุเวอร์ชัน ไม่ต้องระบุ minVersion และ maxVersion หากต้องการระบุทุกเวอร์ชันจนถึง maxVersion ไม่ต้องระบุ minVersion หากต้องการระบุทุกเวอร์ชันจาก minVersion ไม่ต้องระบุ maxVersion

{
  "expireTime": string
}

string (Timestamp format)

เวลาที่การกระทำนี้จะหมดอายุ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

ชื่อเอกสารการเปิดเผยข้อมูล ตัวอย่างเช่น "ข้อมูลด้านความปลอดภัย"

object (DisclosureText)

เนื้อหาของการเปิดเผยข้อมูล อนุญาตให้ใช้เว็บลิงก์

object (DisclosurePresentationOptions)

ตัวเลือกการนำเสนอสำหรับการเปิดเผยข้อมูล

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

string

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

object (TextLink)

ลิงก์ข้อความที่ควรแทนที่ด้วยเทมเพลต รายการแรกจะถูกแทนที่ด้วย "{0}" ในสตริงเทมเพลต และอีกสตริงที่ 2 สำหรับ "{1}" เป็นต้น

{
  "displayText": string,
  "url": string
}

string

ข้อความที่ควรแสดงต่อผู้ใช้

string

URL ที่ผู้ใช้ควรถูกนำไปเมื่อเปิดใช้งานลิงก์

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum (PresentationRequirement)

ข้อกำหนดในการแสดงการเปิดเผยข้อมูล

boolean

ควรขยายเนื้อหาของการเปิดเผยข้อมูลในตอนแรกหรือไม่ ซึ่งจะมีการยุบไว้โดยค่าเริ่มต้น

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

ต้องระบุ: สถานะระดับรายการโฆษณา

string

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

enum (PurchaseType)

ต้องระบุ: ประเภทของการซื้อ

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้

integer

จำนวนสินค้า

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

แสดงข้อมูลสำหรับรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับค่าข้อมูลการคืนสินค้าระดับคำสั่งซื้อ

object (PurchaseFulfillmentInfo)

ข้อมูลการดำเนินการตามรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับค่าข้อมูลการดำเนินการตามคำสั่งซื้อระดับคำสั่งซื้อ

object (ItemOption)

ส่วนเสริมหรือรายการย่อยเพิ่มเติม

object (ProductDetails)

รายละเอียดเกี่ยวกับผลิตภัณฑ์

object

ฟิลด์พิเศษใดๆ ที่แลกเปลี่ยนระหว่างผู้ขายกับ Google หมายเหตุ: เราไม่แนะนำให้ใช้ส่วนขยายนี้ พิจารณาข้อใดข้อหนึ่งต่อไปนี้ตามกรณีการใช้งาน/สถานการณ์ 1. กำหนดช่องใน PurchaseItemExtension หากสามารถนำไปใช้สำหรับกรณีการใช้งานอื่นๆ (เช่น ความสามารถ/ฟังก์ชันการทำงานทั่วไป) 2. ใช้ vertical_extension หากเฉพาะเจาะจงสําหรับกรณีการใช้งาน/ฟีเจอร์ที่กําหนดเองซึ่งไม่ใช่ทั่วไป

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

{
  "measure": number,
  "unit": enum (Unit)
}

number

ค่า: ตัวอย่าง 1.2

enum (Unit)

หน่วย: ตัวอย่าง POUND, GRAM

{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}

boolean

หากเป็น "จริง" อนุญาตให้คืนสินค้าได้

integer

อนุญาตให้คืนสินค้าได้ภายในหลายวัน

string

ลิงก์ไปยังนโยบายคืนสินค้า

{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}

string

ตัวระบุที่ไม่ซ้ำกันสำหรับตัวเลือกบริการนี้

enum (Type)

ต้องระบุ: ประเภทของการดำเนินการตามคำสั่งซื้อ

object (Time)

กรอบเวลาหากมีการระบุช่วงเวลา หรือเวลาถึงโดยประมาณหากระบุช่วงเวลาเดียว เวลานำส่งหรือเวลาไปรับที่คาดไว้

object (Time)

กรอบเวลาหากมีการระบุช่วงเวลา หรือเวลาถึงโดยประมาณหากระบุช่วงเวลาเดียว ถึงเวลาเตรียมอาหารแล้ว แนะนำให้ทำแบบครั้งเดียว

object (Location)

สถานที่รับสินค้าหรือจัดส่ง

string (Timestamp format)

เวลาที่ตัวเลือกการดำเนินการตามคำสั่งซื้อนี้จะหมดอายุ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

object (PriceAttribute)

ค่าใช้จ่ายของตัวเลือกนี้

object (UserInfo)

ข้อมูลติดต่อของผู้ใช้สำหรับการดำเนินการตามคำสั่งซื้อนี้

string

ชื่อของวิธีการจัดส่งที่ผู้ใช้เลือก

string

รหัสร้านค้าของสถานที่ตั้ง ตัวอย่างเช่น Walmart เป็นผู้ขายและ storeCode คือร้านค้า Walmart ที่มีการดำเนินการตามคำสั่งซื้อ https://support.google.com/business/answer/3370250?ref_topic=4596653.

object (PickupInfo)

ข้อมูลเพิ่มเติมเกี่ยวกับวิธีเลือกคำสั่งซื้อ ช่องนี้จะใช้ได้ก็ต่อเมื่อประเภทการดำเนินการเป็น PICKUP เท่านั้น

{
  "timeIso8601": string
}

string

แสดงเวลากิจกรรมการสั่งซื้อ เช่น เวลาจอง เวลานำส่ง และอื่นๆ อาจเป็นระยะเวลา (เวลาเริ่มต้นและเวลาสิ้นสุด) วันที่ วันที่และเวลา เป็นต้น โปรดดู https://en.wikipedia.org/wiki/ISO_8601 สำหรับรูปแบบทั้งหมดที่รองรับ

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum (PickupType)

วิธีรับสินค้า เช่น INSTORE, CURBSIDE ฯลฯ

object (CurbsideInfo)

รายละเอียดที่เกี่ยวข้องกับข้อมูลริมทางโดยเฉพาะ หากpickupType ไม่ใช่ "CURBSIDE" ระบบจะไม่สนใจช่องนี้

object (CheckInInfo)

รายการวิธีการต่างๆ ที่พาร์ทเนอร์รองรับเพื่อรองรับการเช็คอิน

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

enum (CurbsideFulfillmentType)

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

object (Vehicle)

รายละเอียดยานพาหนะของผู้ใช้ที่สั่งซื้อ

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

string

ยี่ห้อยานพาหนะ (เช่น "ฮอนด้า") ซึ่งจะแสดงต่อผู้ใช้และต้องแปลเป็นภาษาท้องถิ่น ต้องระบุ

string

รุ่นของยานพาหนะ (เช่น "Grom") ซึ่งจะแสดงต่อผู้ใช้และต้องแปลเป็นภาษาท้องถิ่น ต้องระบุ

string

หมายเลขป้ายทะเบียนยานพาหนะ (เช่น "1ABC234") ต้องระบุ

string

ชื่อสีของยานพาหนะ เช่น สีดำ (ไม่บังคับ)

object (Image)

URL ไปยังรูปภาพของยานพาหนะ รูปภาพจะแสดงขนาดประมาณ 256x256px ต้องเป็น jpg หรือ png ไม่บังคับ

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

เมธอดที่ใช้ส่งวิธีการเช็คอิน

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

สำหรับตัวเลือกที่เป็นสินค้า ให้ระบุรหัสสินค้าที่ไม่ซ้ำกัน

string

ชื่อตัวเลือก

object (PriceAttribute)

ราคารวมของตัวเลือก

string

หมายเหตุที่เกี่ยวข้องกับตัวเลือก

integer

สำหรับตัวเลือกที่เป็นสินค้า จำนวน

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับตัวเลือกนี้

object (ItemOption)

เพื่อกำหนดตัวเลือกย่อยอื่นๆ ที่ฝังอยู่

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้

string

หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ มีประโยชน์หากไม่มีรหัสข้อเสนอใน Merchant Center ไม่บังคับ

string

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

string

หมวดหมู่ผลิตภัณฑ์ที่กำหนดโดยผู้ขาย เช่น "หน้าแรก > ร้านขายของชำ > ผลิตภัณฑ์จากนมและ ไข่ > นม > นมเต็ม"

map (key: string, value: string)

รายละเอียดผลิตภัณฑ์ที่ผู้ขายระบุ เช่น { "allergen": "peanut" } มีประโยชน์หากไม่มีรหัสข้อเสนอใน Merchant Center ไม่บังคับ

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

{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}

enum (ReservationStatus)

ต้องระบุ: สถานะการจอง

string

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

enum (ReservationType)

ประเภทการจอง ยกเลิกการตั้งค่าหากไม่มีตัวเลือกประเภทที่เกี่ยวข้อง

object (Time)

เวลาที่กำหนดให้บริการ/เหตุการณ์เกิดขึ้น อาจเป็นช่วงเวลา วันที่ หรือวันที่และเวลาที่แน่นอน

object (Time)

ช่วงเวลาที่ผู้ใช้ยอมรับได้

string

รหัสยืนยันสำหรับการจองนี้

integer

จำนวนคน

object (StaffFacilitator)

ผู้อำนวยความสะดวกพนักงานที่จะให้บริการจอง เช่น ช่างทำผม

object (Location)

ตำแหน่งของบริการ/กิจกรรม

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

ชื่อวิทยากรของพนักงาน เช่น "จอห์น สมิธ"

object (Image)

รูปภาพของผู้แสดง

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

object (PaymentResult)

ผลลัพธ์การชำระเงินที่ผู้รวมระบบใช้เพื่อดำเนินการธุรกรรมให้เสร็จสมบูรณ์ Actions on Google จะป้อนข้อมูลในช่องนี้ หากการดำเนินการชำระเงินนั้นจัดการโดย Actions-on-Google

object (PaymentInfo)

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

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

string

ข้อมูลวิธีการชำระเงินที่ Google ระบุ หากผู้ประมวลผลการชำระเงินของคุณอยู่ในรายการผู้ประมวลผลการชำระเงินที่ Google รองรับที่นี่ https://developers.google.com/pay/api/ ไปที่ผู้ประมวลผลการชำระเงินผ่านลิงก์เพื่อดูรายละเอียดเพิ่มเติม หรือดูรายละเอียดเพย์โหลดในเอกสารประกอบต่อไปนี้ https://developers.google.com/pay/api/payment-data-cryptography

string

ผู้ขาย/การดำเนินการระบุวิธีการชำระเงินที่ผู้ใช้เลือก

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object (PaymentMethodDisplayInfo)

ข้อมูลที่แสดงของวิธีการชำระเงินที่ใช้สำหรับธุรกรรม

enum (PaymentMethodProvenance)

แหล่งที่มาของวิธีการชำระเงินที่ใช้สำหรับธุรกรรม ผู้ใช้อาจลงทะเบียนวิธีการชำระเงินเดียวกันกับทั้ง Google และผู้ขายแล้ว

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum (PaymentType)

ประเภทของการชำระเงิน

string

ชื่อวิธีการชำระเงินที่ผู้ใช้มองเห็นได้ เช่น VISA **** 1234 บัญชีกระแสรายวัน **** 5678

string

สำหรับอุปกรณ์ Assistant ที่ใช้เสียงเท่านั้น เพื่อพูดชื่อวิธีการชำระเงินให้ผู้ใช้ทราบ ตัวอย่างเช่น "วีซ่าที่ลงท้ายด้วย 1234" หรือ "การตรวจสอบบัญชีที่ลงท้ายด้วย 5678" หมายเหตุ: นี่คือสตริงที่เพิ่มประสิทธิภาพเสียงที่จะใช้แทน paymentMethodDisplayName สำหรับอุปกรณ์ Assistant แบบเสียงเท่านั้น หากไม่ได้ตั้งค่าสตริงไว้ ระบบจะพูดออกเสียง paymentMethodDisplayName กับผู้ใช้แทน

{
  "coupon": string
}

string

ต้องระบุ: รหัสคูปองที่ใช้กับข้อเสนอนี้

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

ต้องระบุ: สถานะโดยรวมสำหรับคำสั่งซื้อ

string

ป้ายกำกับ/สตริงที่ผู้ใช้เห็นสำหรับสถานะ ความยาวสูงสุดคือ 50 อักขระ

enum (PurchaseType)

ต้องระบุ: ประเภทของการซื้อ

object (PurchaseReturnsInfo)

ข้อมูลการคืนสินค้าสำหรับคำสั่งซื้อ

object (PurchaseFulfillmentInfo)

ข้อมูลการดำเนินการสำหรับคำสั่งซื้อ

enum (PurchaseLocationType)

สถานที่ซื้อ (ในร้าน / ออนไลน์)

object (PurchaseError)

ไม่บังคับ: ข้อผิดพลาดเนื่องจากคำสั่งซื้อนี้ถูกปฏิเสธ

object

ฟิลด์พิเศษใดๆ ที่แลกเปลี่ยนระหว่างผู้ขายกับ Google หมายเหตุ: เราไม่แนะนำให้ใช้ส่วนขยายนี้ พิจารณาข้อใดข้อหนึ่งต่อไปนี้ตามกรณีการใช้งาน/สถานการณ์ 1. กำหนดฟิลด์ใน PurchaseOrderExtension หากสามารถนำไปใช้สำหรับ Use Case อื่นๆ (เช่น ความสามารถ/ฟังก์ชันทั่วไป) 2. ใช้ vertical_extension หากเฉพาะเจาะจงสําหรับกรณีการใช้งาน/ฟีเจอร์ที่กําหนดเองซึ่งไม่ใช่ทั่วไป

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}

enum (ErrorType)

ต้องระบุ: ข้อมูลนี้เป็นเหตุผลอย่างละเอียดที่ผู้ขายปฏิเสธคำสั่งซื้อ

string

คำอธิบายข้อผิดพลาดเพิ่มเติม

string

รหัสเอนทิตีที่สอดคล้องกับข้อผิดพลาด ตัวอย่างนี้อาจสอดคล้องกับ LineItemId / ItemOptionId

object (PriceAttribute)

เกี่ยวข้องในกรณีของข้อผิดพลาดประเภท PRICE_CHANGED / INCORRECT_PRICE

integer

จำนวนสินค้าที่พร้อมจำหน่ายในขณะนี้ ใช้ได้ในกรณี AVAILABILITY_CHANGED

{
  "ticketEvent": {
    object (TicketEvent)
  }
}

object (TicketEvent)

มีการใช้เหตุการณ์กับตั๋วรายการโฆษณาทั้งหมด

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum (Type)

ต้องระบุ: ประเภทตั๋วกิจกรรม เช่น ภาพยนตร์ คอนเสิร์ต

string

ต้องระบุ: ชื่อเหตุการณ์ ตัวอย่างเช่น หากกิจกรรมเป็นภาพยนตร์ ก็ควรเป็นชื่อภาพยนตร์

string

คำอธิบายกิจกรรม

string

URL ไปยังข้อมูลกิจกรรม

object (Location)

สถานที่ที่จัดกิจกรรมหรือองค์กรอยู่

object (EventCharacter)

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

object (Time)

เวลาเริ่มต้น

object (Time)

เวลาสิ้นสุด

object (Time)

เวลาเริ่มงาน ซึ่งอาจต่างจากเวลาเริ่มต้นของกิจกรรม เช่น กิจกรรมเริ่มเวลา 9.00 น. แต่เริ่มงานเวลา 8.30 น.

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum (Type)

ประเภทอักขระของเหตุการณ์ เช่น นักแสดงหรือผู้กำกับ

string

ชื่อตัวละคร

object (Image)

รูปภาพของตัวละคร

{
  "title": string,
  "text": string
}

string

ชื่อการแจ้งเตือนผู้ใช้ ความยาวสูงสุดคือ 30 อักขระ

string

เนื้อหาของการแจ้งเตือน ความยาวสูงสุดคือ 100 อักขระ

{
  "name": string
}

string

ชื่อฉากที่จะดำเนินการถัดไป

{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}

string

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

map (key: string, value: value (Value format))

ต้องระบุ รายการพารามิเตอร์ทั้งหมดที่รวบรวมจากแบบฟอร์มและ Intent ระหว่างเซสชัน คีย์คือชื่อพารามิเตอร์ พารามิเตอร์ที่กำหนดไว้ที่นี่จะรวมเข้ากับพารามิเตอร์ที่กำหนดไว้แล้วในเซสชัน ระบบจะนำพารามิเตอร์ที่มีค่า Null ออกจากเซสชัน ดูเอกสารประกอบเกี่ยวกับพื้นที่เก็บข้อมูลเซสชันที่ https://developers.google.com/assistant/conversational/storage-session

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

object (TypeOverride)

ไม่บังคับ ประเภทที่กำหนดขอบเขตเฉพาะเซสชัน การกำหนดประเภทเซสชันเป็นส่วนเสริมหรือแทนที่ประเภทที่มีอยู่ได้ ชื่อประเภทต้องไม่ซ้ำกัน

string

ภาษาของเซสชันการสนทนาปัจจุบัน เป็นไปตามรหัสภาษา IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt ซึ่งอาจแตกต่างจากภาษาของผู้ใช้หากการดำเนินการใช้ฟีเจอร์หลายภาษา ตัวอย่างเช่น เมื่อมีการตั้งค่าเครื่องจัดการ_response.expected.language_code ระบบจะเปลี่ยนภาษาการสนทนาสำหรับการเลี้ยวทั้งหมดหลังจากนั้น ซึ่งจะแสดงในช่องนี้

{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}

string

ต้องระบุ ชื่อของประเภทที่จะเสริมหรือลบล้าง

enum (TypeOverrideMode)

ต้องระบุ วิธีผสานประเภทนี้กับค่าประเภทอื่น

object (SynonymType)

{
  "entries": [
    {
      object (Entry)
    }
  ]
}

object (Entry)

ต้องระบุ รายการรายการสำหรับประเภทคำพ้องความหมาย

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