Order

{
  "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 ตามที่ระบุไว้ในสหภาพโทรคมนาคมระหว่างประเทศ (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": number,
  "width": number
}

string

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

string

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

number

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

number

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

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

string

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

string

ชื่อผู้ขาย เช่น "Panera Bread"

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.Permission.DEVICE_PRECISE_LOCATION]

string

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

string

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

string

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

object (PostalAddress)

ที่อยู่ไปรษณีย์ ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.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": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

number

การแก้ไขสคีมาของ 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

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

string

ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ซึ่งอาจเป็นย่านใกล้เคียง เขตเมือง เขต

string

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

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

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

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

string

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

string

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

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

object (LineItem)

รายชื่อรายการโฆษณาของคำสั่งซื้อ ต้องมี line_item อย่างน้อย 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)

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

object (PriceAttribute)

ราคาและการปรับค่าใช้จ่ายระดับรายการโฆษณา

object (Action)

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

object (UserInfo)

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

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,
  "state": enum (State),
  "taxIncluded": boolean,

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

enum (Type)

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

string

ต้องระบุ: สตริงที่ผู้ใช้แสดงของแอตทริบิวต์ราคา ผู้ขายจะเป็นผู้ส่งและแปลเนื้อหานี้

enum (State)

จำเป็น: สถานะของราคา: ค่าประมาณเทียบกับราคาจริง

boolean

เป็นราคารวมภาษีหรือไม่

object (Money)

จำนวนเงิน

number

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

{
  "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 ซึ่งอาจเป็นรายการใดรายการหนึ่งต่อไปนี้: - http/https urls สำหรับการเปิดแอปหรือหน้าเว็บที่ลิงก์ไปยังแอป

object (AndroidApp)

ข้อมูลเกี่ยวกับแอป Android หากคาดว่า URL นั้นจะมีการเติมเต็มโดยแอป Android

enum (UrlTypeHint)

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

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

string

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

object (VersionFilter)

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

{
  "minVersion": number,
  "maxVersion": number
}

number

รหัสเวอร์ชันต่ำสุดหรือ 0 รวมเลขตัวแรกและตัวสุดท้าย

number

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

{
  "expireTime": string
}

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "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}" ในสตริงเทมเพลต และสตริงที่สองแทน "{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": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}

enum (PurchaseStatus)

จำเป็น: สถานะระดับรายการโฆษณา

string

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

enum (PurchaseType)

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

string

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

number

จํานวนสินค้า

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object (ItemOption)

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

object

ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google

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

object (ProductDetails)

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

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

number

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

enum (Unit)

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

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

boolean

หากเป็น "จริง" ระบบจะอนุญาตให้ "แสดงผล" ได้

number

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

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)

ต้องระบุ: ประเภทของ Fulfillment

object (Time)

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

object (Time)

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

object (Location)

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

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "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)

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

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

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

string

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

string

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

string

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

object (Image)

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

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

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

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

string

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

string

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

object (PriceAttribute)

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

string

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

number

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

string

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

object (ItemOption)

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

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

string

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

string

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

string

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

string

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

map (key: string, value: string)

รายละเอียดผลิตภัณฑ์ที่ผู้ขายระบุ เช่น { "allergen": "peanut" } ซึ่งจะเป็นประโยชน์ในกรณีที่ไม่มี OfferId ไว้ใน 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": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (ReservationStatus)

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

string

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

enum (ReservationType)

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

object (Time)

เวลาที่มีการกำหนดเวลาบริการ/กิจกรรมไว้ ซึ่งอาจเป็นช่วงเวลา วันที่ หรือวันที่และเวลาที่แน่นอนก็ได้

object (Time)

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

string

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

number

จำนวนคน

object (StaffFacilitator)

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

object (Location)

ตำแหน่งของบริการ/เหตุการณ์

object

ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google

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

{
  "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 แบบใช้เสียงเท่านั้น เช่น "วีซ่าที่ลงท้ายด้วย 1-234" หรือ "กำลังตรวจสอบบัญชีที่ลงท้ายด้วย 5678" หมายเหตุ: นี่คือสตริงที่เพิ่มประสิทธิภาพด้วยเสียงที่จะใช้แทน paymentMethodDisplayName สำหรับอุปกรณ์ Assistant แบบเสียงเท่านั้น หากไม่ได้ตั้งค่าสตริงนี้ ระบบจะบอกผู้ใช้ paymentMethodDisplayName แทน

{
  "coupon": string
}

string

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

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

enum (PurchaseStatus)

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

string

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

enum (PurchaseType)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object

ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google

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

enum (PurchaseLocationType)

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

object (PurchaseError)

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

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

enum (ErrorType)

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

string

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

string

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

object (PriceAttribute)

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

number

มีสินค้าพร้อมจำหน่ายแล้ว ใช้ได้ในกรณี 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)

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