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 ตามที่กำหนดไว้ใน 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": 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.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": 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

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

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)

ผู้ให้บริการของรายการโฆษณาหนึ่งๆ หากแตกต่างจากคำสั่งซื้อโดยรวม ตัวอย่าง: คำสั่งซื้อด้วย 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,
  "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 เปอร์เซ็นต์ติดลบหมายถึงเปอร์เซ็นต์ส่วนลด กำลังเลิกใช้งานช่องนี้ พิจารณาเพิ่มข้อมูลกลับคืนได้เมื่อต้องมีกรณีการใช้งานที่มั่นคง

{
  "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": number,
  "maxVersion": number
}

number

รหัสเวอร์ชันต่ำสุดหรือ 0 (รวม 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}" ในสตริงเทมเพลต และอีกสตริงที่ 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": 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)

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

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)

ข้อมูลเพิ่มเติมเกี่ยวกับวิธีเลือกคำสั่งซื้อ ช่องนี้จะใช้ได้ก็ต่อเมื่อประเภทการดำเนินการเป็น 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": 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

หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ มีประโยชน์หากไม่มีรหัสข้อเสนอใน 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": 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 ที่ใช้เสียงอย่างเดียวจะพูดชื่อวิธีการชำระเงินกับผู้ใช้ ตัวอย่างเช่น "วีซ่าที่ลงท้ายด้วย 1234" หรือ "การตรวจสอบบัญชีที่ลงท้ายด้วย 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)

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