- การแสดง JSON
- UserInfo
- PhoneNumber
- รูปภาพ
- ผู้ขาย
- ตำแหน่ง
- LatLng
- PostalAddress
- สารบัญ
- LineItem
- PriceAttribute
- ประเภท
- สถานะ
- ค่าเงิน
- การดำเนินการ
- ประเภท
- OpenUrlAction
- AndroidApp
- VersionFilter
- UrlTypeHint
- ActionMetadata
- การเปิดเผย
- DisclosureText
- TextLink
- DisclosurePresentationOptions
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- หน่วย
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- ประเภท
- เวลา
- PickupInfo
- PickupType
- CurbsideInfo
- CurbsideFulfillmentType
- ยานพาหนะ
- CheckInInfo
- CheckInType
- ItemOption
- ProductDetails
- ReservationItemExtension
- ReservationStatus
- ReservationType
- StaffFacilitator
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- PaymentType
- PaymentMethodProvenance
- โปรโมชัน
- PurchaseOrderExtension
- PurchaseLocationType
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- ประเภท
- EventCharacter
- ประเภท
รายการที่สั่งซื้อ หมายเหตุ: 1. สตริงทั้งหมดในทุกระดับต้องมีอักขระน้อยกว่า 1,000 ตัว เว้นแต่จะระบุไว้เป็นอย่างอื่น 2. ช่องที่ซ้ำทั้งหมดในทุกระดับต้องมีจำนวนน้อยกว่า 50 ช่อง ยกเว้นจะระบุไว้เป็นอย่างอื่น 3. การประทับเวลาทั้งหมดในทุกระดับต้องเป็นการประทับเวลาที่ถูกต้อง (หากระบุไว้)
การแสดง JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
ช่อง | ||
---|---|---|
googleOrderId |
รหัสคำสั่งซื้อที่ Google กำหนด |
|
merchantOrderId |
ต้องระบุ: รหัสคำสั่งซื้อภายในที่ผู้ขายกำหนด รหัสนี้ต้องไม่ซ้ำกันและจำเป็นสำหรับการดำเนินการอัปเดตคำสั่งซื้อครั้งต่อๆ ไป รหัสนี้อาจถูกกำหนดเป็น googleOrderId ที่ระบุหรือค่าเฉพาะอื่นๆ โปรดทราบว่ารหัสที่ปรากฏต่อผู้ใช้คือ uservisibleOrderId ซึ่งอาจเป็นค่าอื่นที่ใช้งานง่ายกว่า ความยาวสูงสุดคือ 128 อักขระ |
|
userVisibleOrderId |
รหัสสำหรับผู้ใช้ที่อ้างถึงลำดับปัจจุบัน รหัสนี้ควรสอดคล้องกับรหัสที่แสดงสำหรับคำสั่งซื้อนี้ในบริบทอื่นๆ รวมถึงเว็บไซต์ แอป และอีเมล |
|
userVisibleStateLabel |
เลิกใช้งานแล้ว: ใช้สถานะ Order Extensions แทน ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของคำสั่งซื้อนี้ |
|
buyerInfo |
ข้อมูลเกี่ยวกับผู้ซื้อ |
|
image |
รูปภาพที่เกี่ยวข้องกับคำสั่งซื้อ |
|
createTime |
ต้องระบุ: วันที่และเวลาที่สร้างคำสั่งซื้อ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
|
lastUpdateTime |
วันที่และเวลาอัปเดตคำสั่งซื้อครั้งล่าสุด จำเป็นสำหรับคำสั่งซื้ออัปเดต การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
|
transactionMerchant |
ผู้ขายที่อำนวยความสะดวกในการชำระเงิน ซึ่งอาจต่างจากผู้ให้บริการระดับรายการโฆษณา ตัวอย่าง: คำสั่งซื้อ Expedia ที่มีรายการโฆษณาจาก ANA |
|
contents |
ต้องระบุ: เนื้อหาคำสั่งซื้อซึ่งเป็นกลุ่มรายการโฆษณา |
|
priceAttributes[] |
ราคา ส่วนลด ภาษี และอื่นๆ |
|
followUpActions[] |
ติดตามผลที่ระดับคำสั่งซื้อ |
|
paymentData |
ข้อมูลที่เกี่ยวข้องกับการชำระเงินสำหรับคำสั่งซื้อ |
|
termsOfServiceUrl |
ลิงก์ไปยังข้อกำหนดในการให้บริการที่ใช้กับคำสั่งซื้อ/คำสั่งซื้อที่เสนอ |
|
note |
หมายเหตุที่แนบมากับคำสั่งซื้อ |
|
promotions[] |
โปรโมชันทั้งหมดที่เชื่อมโยงกับคำสั่งซื้อนี้ |
|
disclosures[] |
การเปิดเผยข้อมูลที่เกี่ยวข้องกับคำสั่งซื้อนี้ |
|
vertical |
เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน คุณสมบัติเหล่านี้จะใช้กับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา ค่าที่เป็นไปได้คือ ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
|
ฟิลด์การรวม verticals คุณสมบัติเหล่านี้จะใช้กับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา verticals ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
purchase |
ใบสั่งซื้อ |
|
ticket |
สั่งซื้อตั๋ว |
UserInfo
ข้อมูลเกี่ยวกับผู้ใช้ ใช้เพื่อแสดงถึงข้อมูลของผู้ใช้ที่เชื่อมโยงกับคำสั่งซื้อ
การแสดง JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
ช่อง | |
---|---|
email |
อีเมลของผู้ใช้ เช่น janedoe@gmail.com |
firstName |
ชื่อของผู้ใช้ |
lastName |
นามสกุลของผู้ใช้ |
displayName |
ชื่อที่แสดงของผู้ใช้อาจแตกต่างจากชื่อหรือนามสกุล |
phoneNumbers[] |
หมายเลขโทรศัพท์ของผู้ใช้ |
PhoneNumber
การแสดงหมายเลขโทรศัพท์มาตรฐาน
การแสดง JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
ช่อง | |
---|---|
e164PhoneNumber |
หมายเลขโทรศัพท์ในรูปแบบ E.164 ตามที่ระบุไว้ในสหภาพโทรคมนาคมระหว่างประเทศ (ITU) Recommendation E.164 ลิงก์ wiki: https://en.wikipedia.org/wiki/E.164 |
extension |
ส่วนขยายในคำแนะนำ ITU ไม่ได้ทำให้เป็นมาตรฐานเดียวกัน ยกเว้นที่กำหนดไว้เป็นชุดตัวเลขที่มีความยาวสูงสุด 40 หลัก สตริงนี้หมายถึงสตริงนี้เพื่อรองรับกรณีที่อาจมีการใช้เลข 0 นำหน้าในส่วนขยาย (องค์กรมีอิสระเต็มที่ในการทำเช่นนั้น เนื่องจากไม่มีการกำหนดมาตรฐานไว้) นอกเหนือจากตัวเลข ระบบอาจเก็บอักขระสำหรับโทรออกอื่นๆ เช่น "," (ระบุว่าต้องรอ) ไว้ที่นี่ ตัวอย่างเช่น ใน xxx-xxx-xxxx ต่อ 123, "123" คือส่วนขยาย |
preferredDomesticCarrierCode |
รหัสการเลือกผู้ให้บริการขนส่งที่จะใช้เมื่อโทรหาหมายเลขโทรศัพท์นี้ภายในประเทศ รวมถึงรหัสที่ต้องโทรในบางประเทศเมื่อโทรจากโทรศัพท์พื้นฐานไปยังมือถือ หรือในทางกลับกันด้วย ตัวอย่างเช่น ในโคลัมเบีย จะต้องกด "3" ก่อนหมายเลขเมื่อโทรจากโทรศัพท์มือถือไปยังโทรศัพท์พื้นฐานในประเทศ และในทางกลับกัน https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code โปรดทราบว่านี่คือโค้ด "แนะนำ" ซึ่งหมายความว่ารหัสอื่นๆ อาจสามารถใช้ได้เช่นกัน |
รูปภาพ
รูปภาพที่แสดงในการ์ด
การแสดง JSON | |
---|---|
{ "url": string, "accessibilityText": string, "height": number, "width": number } |
ช่อง | |
---|---|
url |
URL แหล่งที่มาของรูปภาพ รูปภาพต้องเป็น JPG, PNG และ GIF (เคลื่อนไหวและไม่เคลื่อนไหว) เช่น |
accessibilityText |
ข้อความอธิบายรูปภาพที่จะใช้สำหรับการช่วยเหลือพิเศษ เช่น โปรแกรมอ่านหน้าจอ ต้องระบุ |
height |
ความสูงของรูปภาพเป็นพิกเซล ไม่บังคับ |
width |
ความกว้างของรูปภาพเป็นพิกเซล ไม่บังคับ |
ผู้ขาย
ผู้ขายสำหรับรถเข็น/คำสั่งซื้อ/รายการโฆษณา
การแสดง JSON | |
---|---|
{ "id": string, "name": string, "image": { object ( |
ช่อง | |
---|---|
id |
รหัสที่ไม่บังคับที่กำหนดให้กับผู้ขาย หากมี |
name |
ชื่อผู้ขาย เช่น "Panera Bread" |
image |
รูปภาพที่เชื่อมโยงกับผู้ขาย |
phoneNumbers[] |
หมายเลขโทรศัพท์ของผู้ขาย |
address |
ที่อยู่ของผู้ขาย |
ตำแหน่ง
คอนเทนเนอร์ที่แสดงถึงสถานที่ตั้ง
การแสดง JSON | |
---|---|
{ "coordinates": { object ( |
ช่อง | |
---|---|
coordinates |
พิกัดทางภูมิศาสตร์ ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] |
formattedAddress |
ที่อยู่ที่แสดง เช่น "1600 Amphitheatre Pkwy, Mountain View, CA 94043" ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] |
zipCode |
รหัสไปรษณีย์ ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] |
city |
เมือง ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] |
postalAddress |
ที่อยู่ไปรษณีย์ ต้องมีสิทธิ์ [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] หรือ [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] |
name |
ชื่อสถานที่ |
phoneNumber |
หมายเลขโทรศัพท์ของสถานที่ตั้ง เช่น หมายเลขติดต่อของที่ตั้งธุรกิจ หรือหมายเลขโทรศัพท์ของสถานที่นำส่ง |
notes |
หมายเหตุเกี่ยวกับสถานที่ |
placeId |
PlaceId จะใช้กับ Places API เพื่อดึงรายละเอียดของสถานที่ โปรดดู https://developers.google.com/places/web-service/place-id |
LatLng
วัตถุที่แทนคู่ละติจูด/ลองจิจูด ค่านี้แสดงเป็นคู่ของคู่แทนค่าองศาละติจูดและองศาลองจิจูด โดยต้องเป็นไปตามมาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงมาตรฐาน
การแสดง JSON | |
---|---|
{ "latitude": number, "longitude": number } |
ช่อง | |
---|---|
latitude |
ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0] |
longitude |
ลองจิจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0] |
PostalAddress
แสดงที่อยู่ไปรษณีย์ เช่น ที่อยู่สำหรับการจัดส่งทางไปรษณีย์หรือที่อยู่การชำระเงิน เมื่อมีที่อยู่ไปรษณีย์ บริการไปรษณีย์จะสามารถส่งสินค้าไปยังสถานที่ตั้ง ตู้ ปณ. หรืออื่นๆ ที่คล้ายกัน แต่ไม่ได้มีไว้เพื่อสร้างแบบจำลองสถานที่ตั้งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)
ในการใช้งานโดยทั่วไป ที่อยู่จะสร้างผ่านข้อมูลจากผู้ใช้หรือจากการนำเข้าข้อมูลที่มีอยู่ โดยขึ้นอยู่กับประเภทของกระบวนการ
คำแนะนำเกี่ยวกับการป้อน / แก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่แบบ i18n เช่น https://github.com/google/libaddressinput) - ผู้ใช้ไม่ควรจะได้เห็นองค์ประกอบ UI สำหรับการป้อนข้อมูลหรือแก้ไขช่องที่ไม่ได้อยู่ในประเทศอื่นๆ ที่ใช้ช่องนั้น
ดูคำแนะนำเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478
การแสดง JSON | |
---|---|
{ "revision": number, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ช่อง | |
---|---|
revision |
การแก้ไขสคีมาของ การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับการแก้ไขเก่า |
regionCode |
ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ข้อมูลนี้จะไม่มีการอนุมานและขึ้นอยู่กับผู้ใช้ว่าค่าถูกต้องหรือไม่ ดูรายละเอียดได้ที่ http://cldr.unicode.org/ และ http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์ |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาของที่อยู่นี้ (หากทราบ) ซึ่งมักจะเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือคำทับศัพท์ที่เทียบเท่ากัน การตั้งค่านี้อาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่มีผลต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบความถูกต้องหรือการดำเนินการอื่นๆ ที่เกี่ยวข้องกับการจัดรูปแบบที่ไม่เกี่ยวข้อง หากไม่ทราบค่านี้ ควรละเว้นค่านี้ (แทนการระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง) ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจใช้หรือกำหนดให้รหัสไปรษณีย์แสดงอยู่ แต่มีการใช้รหัสไปรษณีย์ดังกล่าว อาจทำให้มีการตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบความถูกต้องของรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา) |
sortingCode |
ไม่บังคับ รหัสการจัดเรียงเพิ่มเติมเฉพาะสำหรับแต่ละประเทศ ไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ในกรณีที่ใช้ ค่าจะเป็นสตริง เช่น "CEDEX" ซึ่งอาจตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นตัวเลขเพียงอย่างเดียวก็ได้ ซึ่งแสดง "รหัสภาค" (จาเมกา) "ตัวบ่งชี้พื้นที่จัดส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น โกตดิวัวร์) |
administrativeArea |
ไม่บังคับ เขตปกครองที่สูงที่สุดที่ใช้สำหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด แคว้น หรือจังหวัด โดยเฉพาะอย่างยิ่ง สำหรับสเปน นี่คือจังหวัดนี้ไม่ใช่ชุมชนปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ใช้เขตบริหารในที่อยู่ไปรษณีย์ เช่น ในประเทศสวิตเซอร์แลนด์ ไม่ควรมีการใส่ข้อมูล |
locality |
ไม่บังคับ โดยทั่วไปจะหมายถึงส่วนของเมือง/จังหวัดของที่อยู่ ตัวอย่าง: เมืองในสหรัฐอเมริกา ชุมชนด้านไอที เมืองตามเขตไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคของโลกซึ่งมีการกำหนดย่านไม่ถูกต้องหรือไม่อยู่ในโครงสร้างนี้ ให้ปล่อยตำแหน่งว่างไว้และใช้ addressLines |
sublocality |
ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ซึ่งอาจเป็นย่านใกล้เคียง เขตเมือง เขต |
addressLines[] |
บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงที่อยู่ในระดับที่ต่ำกว่า เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") จึงจำเป็นต้องมีลำดับบรรทัดที่ชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับเอนเวโลป" สำหรับประเทศ/ภูมิภาคของที่อยู่ ซึ่งในที่ต่างๆ ที่อาจแตกต่างกัน (เช่น ญี่ปุ่น) address_language จะใช้เพื่อทำให้ชัดเจน (เช่น "ja" สำหรับลำดับจากขนาดใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับขนาดเล็กไปใหญ่) วิธีนี้จะทำให้บรรทัดของที่อยู่ที่เฉพาะเจาะจงมากที่สุดสามารถเลือกตามภาษาได้ การแสดงโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วยรหัสภูมิภาคพร้อมข้อมูลที่เหลืออยู่ทั้งหมดในบรรทัดที่อยู่ คุณอาจจะสามารถจัดรูปแบบที่อยู่ดังกล่าวได้อย่างคร่าวๆ โดยไม่ต้องมีการระบุพิกัดทางภูมิศาสตร์ แต่จะไม่สามารถให้เหตุผลเชิงความหมายเกี่ยวกับองค์ประกอบของที่อยู่ใดๆ ได้จนกว่าอย่างน้อยการแก้ไขจะได้รับการแก้ไขเป็นบางส่วน การสร้างที่อยู่มีเฉพาะรหัสภูมิภาคและบรรทัดที่อยู่ จากนั้นระบุพิกัดทางภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสิ้นเชิง (แทนการเดาว่าส่วนใดของที่อยู่ควรเป็นย่านหรือเขตบริหาร) |
recipients[] |
ไม่บังคับ ผู้รับที่ที่อยู่ ในบางกรณี ฟิลด์นี้อาจมีข้อมูลหลายบรรทัด ตัวอย่างเช่น อาจมีข้อมูล "การดูแล" |
organization |
ไม่บังคับ ชื่อขององค์กรตามที่อยู่ |
เนื้อหา
Wrapper สำหรับรายการโฆษณา
การแสดง JSON | |
---|---|
{
"lineItems": [
{
object ( |
ช่อง | |
---|---|
lineItems[] |
รายชื่อรายการโฆษณาของคำสั่งซื้อ ต้องมี line_item อย่างน้อย 1 บรรทัดและอนุญาตให้มีได้อย่างน้อย 50 รายการ รายการโฆษณาทั้งหมดต้องอยู่ในประเภทธุรกิจเดียวกัน |
LineItem
รายการโฆษณา 1 รายการมีประเภทธุรกิจ 1 รายการ คำสั่งซื้อหรือรถเข็นรายการหนึ่งสามารถมีรายการโฆษณาประเภทเดียวกันได้หลายรายการ ควรกำหนดรายการโฆษณาย่อย/ส่วนเสริมและอื่นๆ ในโปรโตคอลแนวตั้งโดยขึ้นอยู่กับกรณีการใช้งาน หมายเหตุ: 1. สตริงทั้งหมดในทุกระดับต้องมีอักขระน้อยกว่า 1,000 ตัว เว้นแต่จะระบุไว้เป็นอย่างอื่น 2. ช่องที่ซ้ำทั้งหมดในทุกระดับต้องมีจำนวนน้อยกว่า 50 ช่อง ยกเว้นจะระบุไว้เป็นอย่างอื่น 3. การประทับเวลาทั้งหมดในทุกระดับต้องเป็นการประทับเวลาที่ถูกต้อง (หากระบุไว้)
การแสดง JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
ช่อง | ||
---|---|---|
id |
ต้องระบุ: ตัวระบุที่ผู้ขายกำหนดสำหรับรายการโฆษณา ใช้เพื่อระบุรายการโฆษณาที่มีอยู่ในการใช้การอัปเดตบางส่วน ความยาวสูงสุดที่กำหนดไว้คือ 64 อักขระ |
|
name |
ชื่อของรายการโฆษณาตามที่แสดงในใบเสร็จ ความยาวสูงสุดที่อนุญาตคือ 100 อักขระ |
|
userVisibleStateLabel |
เลิกใช้งานแล้ว โปรดใช้สถานะระดับแนวตั้งแทน ตัวอย่างเช่น สำหรับการซื้อ ให้ใช้ PurchaseOrderExtension.status ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของรายการโฆษณานี้ |
|
provider |
ผู้ให้บริการรายการโฆษณาหนึ่งๆ หากแตกต่างจากคำสั่งซื้อโดยรวม เช่น คำสั่งซื้อ Expedia ที่ทำร่วมกับผู้ให้บริการรายการโฆษณา ANA |
|
priceAttributes[] |
ราคาและการปรับค่าใช้จ่ายระดับรายการโฆษณา |
|
followUpActions[] |
ติดตามผลที่รายการโฆษณา |
|
recipients[] |
ลูกค้าระดับรายการโฆษณา ซึ่งอาจแตกต่างจากผู้ซื้อระดับคำสั่งซื้อ ตัวอย่าง: ผู้ใช้ ก จองร้านอาหารภายใต้ชื่อผู้ใช้ ข |
|
image |
รูปภาพขนาดเล็กที่เชื่อมโยงกับรายการนี้ หากมี |
|
description |
คำอธิบายรายการโฆษณา |
|
notes[] |
หมายเหตุเพิ่มเติมที่เกี่ยวข้องกับรายการโฆษณานี้ เช่น นโยบายการยกเลิก |
|
disclosures[] |
การเปิดเผยข้อมูลที่เกี่ยวข้องกับรายการโฆษณานี้ |
|
vertical |
เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน จำเป็น: เนื้อหาเชิงความหมายของรายการโฆษณาโดยอิงตามประเภท/ประเภทธุรกิจ ประเภทธุรกิจทั้งหมดควรมีรายละเอียดการดําเนินการของตนเอง ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
|
ฟิลด์การรวม verticals จำเป็น: เนื้อหาเชิงความหมายของรายการโฆษณาโดยอิงตามประเภท/ประเภทธุรกิจ ประเภทธุรกิจทั้งหมดควรมีรายละเอียดการดําเนินการของตนเอง verticals ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
purchase |
ใบสั่งซื้อ เช่น สินค้า อาหาร ฯลฯ |
|
reservation |
คำสั่งซื้อการจอง เช่น ร้านอาหาร บริการตัดผม ฯลฯ |
PriceAttribute
แอตทริบิวต์ราคาของคำสั่งซื้อหรือรายการโฆษณา
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | ||
---|---|---|
type |
ต้องระบุ: แอตทริบิวต์ประเภทเงิน |
|
name |
ต้องระบุ: สตริงที่ผู้ใช้แสดงของแอตทริบิวต์ราคา ผู้ขายจะเป็นผู้ส่งและแปลเนื้อหานี้ |
|
state |
จำเป็น: สถานะของราคา: ค่าประมาณเทียบกับราคาจริง |
|
taxIncluded |
เป็นราคารวมภาษีหรือไม่ |
|
ฟิลด์การรวม spec แสดงจำนวนเงินหรือมิลลิเปอร์เซ็นต์ spec ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
amount |
จำนวนเงิน |
|
amountMillipercentage |
เปอร์เซ็นต์ข้อกำหนดถึง 1/1000 ของเปอร์เซ็นต์ เช่น 8.750% จะแทน 8750 ส่วนค่าเปอร์เซ็นต์ติดลบหมายถึงเปอร์เซ็นต์ส่วนลด กำลังเลิกใช้งานช่องนี้ พิจารณาเพิ่มกลับเข้าไปได้เมื่อจำเป็นต้องใช้ Use Case ที่มั่นคง |
Type
แสดงประเภทของเงิน
Enum | |
---|---|
TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภท ลูกค้าไม่ควรต้องตั้งค่านี้อย่างชัดแจ้ง |
REGULAR |
ราคาที่แสดงปกติ ก่อนที่จะใช้ส่วนลด ฯลฯ |
DISCOUNT |
จะถูกหักออกจากผลรวมย่อย |
TAX |
จะเพิ่มในผลรวมย่อย |
DELIVERY |
จะเพิ่มในผลรวมย่อย |
SUBTOTAL |
ยอดรวมย่อยก่อนอาจมีค่าธรรมเนียม |
FEE |
ค่าธรรมเนียมเพิ่มเติม |
GRATUITY |
จะเพิ่มในผลรวมย่อย |
TOTAL |
ราคาที่แสดงของคำสั่งซื้อหรือรายการโฆษณา |
รัฐ
แสดงสถานะราคา
Enum | |
---|---|
STATE_UNSPECIFIED |
ไม่ได้ระบุ |
ESTIMATE |
ราคานี้เป็นเพียงค่าประมาณ |
ACTUAL |
ราคาจริงที่จะเรียกเก็บจากผู้ใช้ |
สกุลเงิน
แสดงจำนวนเงินพร้อมประเภทสกุลเงิน
การแสดง JSON | |
---|---|
{ "currencyCode": string, "amountInMicros": string } |
ช่อง | |
---|---|
currencyCode |
รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217 |
amountInMicros |
จำนวนในหน่วยไมโคร เช่น ควรตั้งค่าช่องนี้เป็น 1990000 สำหรับ $1.99 |
การดำเนินการ
การดำเนินการติดตามผลที่เชื่อมโยงกับคำสั่งซื้อหรือรายการโฆษณา
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ: ประเภทการทำงาน |
title |
ชื่อหรือป้ายกำกับของการดำเนินการที่แสดงต่อผู้ใช้ ความยาวสูงสุดที่อนุญาตคือ 100 อักขระ |
openUrlAction |
สิ่งที่ต้องทำ |
actionMetadata |
ข้อมูลเมตาที่เชื่อมโยงกับการดำเนินการ |
Type
การดำเนินการเพื่อติดตามผลที่เป็นไปได้
Enum | |
---|---|
TYPE_UNSPECIFIED |
การดำเนินการที่ไม่ได้ระบุ |
VIEW_DETAILS |
ดูการทํางานของรายละเอียดคําสั่งซื้อ |
MODIFY |
แก้ไขการดำเนินการคำสั่งซื้อ |
CANCEL |
ยกเลิกการดำเนินการสั่งซื้อ |
RETURN |
การดำเนินการคืนสินค้า |
EXCHANGE |
การดำเนินการสั่งซื้อ Exchange |
EMAIL |
การทำงานของอีเมล เลิกใช้งานประเภทอีเมลและ CALL แล้ว คุณสามารถใช้ openUrlAction.url เป็นหมายเลขโทรศัพท์หรืออีเมลได้ |
CALL |
การเรียกร้องให้ดำเนินการ |
REORDER |
เรียงลำดับการดำเนินการใหม่ |
REVIEW |
ตรวจสอบการดำเนินการสั่งซื้อ |
CUSTOMER_SERVICE |
โปรดติดต่อฝ่ายบริการลูกค้า |
FIX_ISSUE |
นำไปยังเว็บไซต์หรือแอปของผู้ขายเพื่อแก้ไขปัญหา |
DIRECTION |
ลิงก์เส้นทาง |
OpenUrlAction
เปิด URL ที่ระบุ
การแสดง JSON | |
---|---|
{ "url": string, "androidApp": { object ( |
ช่อง | |
---|---|
url |
ฟิลด์ URL ซึ่งอาจเป็นรายการใดรายการหนึ่งต่อไปนี้: - http/https urls สำหรับการเปิดแอปหรือหน้าเว็บที่ลิงก์ไปยังแอป |
androidApp |
ข้อมูลเกี่ยวกับแอป Android หากคาดว่า URL นั้นจะมีการเติมเต็มโดยแอป Android |
urlTypeHint |
ระบุคำแนะนำสำหรับประเภท URL |
AndroidApp
ข้อกําหนดของแอป Android สําหรับข้อจํากัดด้านการดําเนินการตามคําสั่งซื้อ
การแสดง JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
ช่อง | |
---|---|
packageName |
ต้องระบุชื่อแพ็กเกจเมื่อระบุ Android Fulfillment |
versions[] |
เมื่อมีการระบุตัวกรองหลายรายการ การจับคู่กับตัวกรองใดๆ จะทริกเกอร์แอป |
VersionFilter
คุณควรรวม VersionFilter หากต้องใช้แอปเฉพาะบางเวอร์ชัน
การแสดง JSON | |
---|---|
{ "minVersion": number, "maxVersion": number } |
ช่อง | |
---|---|
minVersion |
รหัสเวอร์ชันต่ำสุดหรือ 0 รวมเลขตัวแรกและตัวสุดท้าย |
maxVersion |
รวมรหัสเวอร์ชันสูงสุด ช่วงที่ถือว่าเป็น [minVersion:maxVersion] ช่วงค่า Null หมายถึงเวอร์ชันใดๆ ตัวอย่าง: หากต้องการระบุเวอร์ชันเดียว ให้ใช้ [target_version:target_version] หากต้องการระบุเวอร์ชันใดก็ตาม ไม่ต้องระบุ minVersion และ maxVersion หากต้องการระบุทุกเวอร์ชันจนถึง maxVersion ให้ปล่อย minVersion ว่างไว้ หากต้องการระบุทุกเวอร์ชันจาก minVersion ไม่ต้องระบุ maxVersion |
UrlTypeHint
คำแนะนำ URL ประเภทต่างๆ
Enum | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
ไม่ระบุ |
AMP_CONTENT |
URL ที่ชี้ไปยังเนื้อหา AMP โดยตรง หรือไปยัง Canonical URL ที่อ้างถึงเนื้อหา AMP ผ่านทาง <link rel="amphtml"> |
ActionMetadata
ข้อมูลเมตาที่เกี่ยวข้องต่อการดำเนินการ
การแสดง JSON | |
---|---|
{ "expireTime": string } |
ช่อง | |
---|---|
expireTime |
เวลาที่การดำเนินการนี้จะหมดอายุ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
การเปิดเผย
การเปิดเผยผลิตภัณฑ์ บริการ หรือนโยบายที่อาจแสดงต่อผู้ใช้
การแสดง JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
ช่อง | |
---|---|
title |
ชื่อของการเปิดเผย ตัวอย่างเช่น "ข้อมูลด้านความปลอดภัย" |
disclosureText |
เนื้อหาของการเปิดเผยข้อมูล อนุญาตให้ใช้เว็บลิงก์ |
presentationOptions |
ตัวเลือกการนำเสนอสำหรับการเปิดเผย |
DisclosureText
แสดงข้อความธรรมดาที่มีลิงก์เว็บ
การแสดง JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
ช่อง | |
---|---|
template |
ข้อความที่จะแสดง ซึ่งมีตัวยึดตำแหน่งเช่น "{0}" และ "{1}" สำหรับแต่ละลิงก์ข้อความที่ควรแทรก ตัวอย่าง: "คำเตือน: ผลิตภัณฑ์นี้สามารถสัมผัสสารเคมีที่รัฐแคลิฟอร์เนียทราบว่าก่อให้เกิดมะเร็ง สำหรับข้อมูลเพิ่มเติม โปรดไปที่ {0}" ข้อความการเปิดเผยนี้ต้องไม่มีเนื้อหาส่งเสริมการขายหรือเนื้อหาที่คล้ายโฆษณา |
textLinks[] |
ลิงก์ข้อความที่ควรแทนที่ด้วยเทมเพลต รายการแรกจะแทนที่ด้วย "{0}" ในสตริงเทมเพลต และสตริงที่สองแทน "{1}" เป็นต้น |
TextLink
ลิงก์ข้อความที่ควรแทนที่ด้วยเทมเพลต
การแสดง JSON | |
---|---|
{ "displayText": string, "url": string } |
ช่อง | |
---|---|
displayText |
ข้อความที่ควรแสดงต่อผู้ใช้ |
url |
URL ที่ผู้ใช้ควรถูกนำไปเมื่อเปิดใช้งานลิงก์ |
DisclosurePresentationOptions
ตัวเลือกสำหรับการนำเสนอการเปิดเผยข้อมูล
การแสดง JSON | |
---|---|
{
"presentationRequirement": enum ( |
ช่อง | |
---|---|
presentationRequirement |
ข้อกําหนดในการนำเสนอการเปิดเผยข้อมูล |
initiallyExpanded |
ควรขยายเนื้อหาของการเปิดเผยข้อมูลตั้งแต่แรกหรือไม่ โดยค่าเริ่มต้น จะยุบไว้ในตอนแรก |
PresentationRequirement
ข้อกำหนดสำหรับการนำเสนอการเปิดเผยข้อมูล
Enum | |
---|---|
REQUIREMENT_UNSPECIFIED |
ไม่ได้ระบุข้อกำหนด ไม่ควรตั้งค่านี้อย่างชัดแจ้ง |
REQUIREMENT_OPTIONAL |
คุณจะเปิดเผยข้อมูลนี้หรือไม่ก็ได้ สามารถข้ามได้หากอุปกรณ์ไม่รองรับการแสดงการเปิดเผย |
REQUIREMENT_REQUIRED |
ต้องมีการเปิดเผยข้อมูล การสนทนาจะส่งไปยังโทรศัพท์หากอุปกรณ์ไม่รองรับการแสดงการเปิดเผย |
PurchaseItemExtension
เนื้อหารายการโฆษณาของประเภทธุรกิจการซื้อ
การแสดง JSON | |
---|---|
{ "status": enum ( |
ช่อง | |
---|---|
status |
จำเป็น: สถานะระดับรายการโฆษณา |
userVisibleStatusLabel |
จำเป็น: ป้ายกำกับ/สตริงที่ผู้ใช้มองเห็นได้สำหรับสถานะ ความยาวสูงสุดที่อนุญาตคือ 50 อักขระ |
type |
ต้องระบุ: ประเภทของการซื้อ |
productId |
รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้ |
quantity |
จํานวนสินค้า |
unitMeasure |
หน่วยวัด ระบุขนาดของรายการในหน่วยที่เลือก ระบบจะใช้ขนาดร่วมกับราคาที่ใช้งานอยู่ในการกำหนดราคาต่อหน่วย |
returnsInfo |
แสดงข้อมูลสำหรับรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับข้อมูลการคืนสินค้าระดับคำสั่งซื้อ |
fulfillmentInfo |
ข้อมูลการดำเนินการตามคำสั่งซื้อของรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับข้อมูลการดำเนินการระดับคำสั่งซื้อ |
itemOptions[] |
ส่วนเสริมหรือรายการย่อยเพิ่มเติม |
extension |
ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
productDetails |
รายละเอียดเกี่ยวกับผลิตภัณฑ์ |
PurchaseStatus
สถานะการซื้อที่เชื่อมโยงกับใบสั่งซื้อหรือรายการโฆษณาหนึ่งๆ
Enum | |
---|---|
PURCHASE_STATUS_UNSPECIFIED |
ไม่ได้ระบุสถานะ |
READY_FOR_PICKUP |
พร้อมให้มารับแล้ว |
SHIPPED |
จัดส่งแล้ว |
DELIVERED |
นำส่งแล้ว |
OUT_OF_STOCK |
สินค้าหมด |
IN_PREPARATION |
"IN_PREPARATION" อาจมีความหมายต่างกันในบริบทที่ต่างกัน สำหรับการสั่งอาหาร อาจเป็นการจัดเตรียมอาหาร สำหรับค้าปลีก อาจเป็นสินค้าที่อยู่ระหว่างบรรจุหีบห่อ |
CREATED |
สร้างคำสั่งซื้อแล้ว |
CONFIRMED |
ผู้ขายยืนยันคำสั่งซื้อแล้ว |
REJECTED |
ผู้ขายปฏิเสธคำสั่งซื้อหรือรายการโฆษณา |
RETURNED |
ผู้ใช้ส่งคืนสินค้า |
CANCELLED |
ผู้ใช้ยกเลิกคำสั่งซื้อหรือรายการโฆษณาแล้ว |
CHANGE_REQUESTED |
ผู้ใช้ได้ขอเปลี่ยนแปลงคำสั่งซื้อและผู้รวมระบบกำลังดำเนินการการเปลี่ยนแปลงนี้ ควรย้ายคำสั่งซื้อไปยังสถานะอื่นหลังจากจัดการคำขอแล้ว |
PurchaseType
หมวดหมู่การซื้อ
Enum | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
ค่าที่ไม่รู้จัก |
RETAIL |
ซึ่งรวมถึงการซื้อสินค้าต่างๆ เช่น สินค้าที่จับต้องได้ |
FOOD |
ซึ่งรวมถึงการซื้ออาหารด้วย |
GROCERY |
การซื้อของชำ |
MOBILE_RECHARGE |
การซื้อแบบเติมเงินมือถือ |
MerchantUnitMeasure
มาตรวัดราคาต่อหน่วยของผู้ขาย
การแสดง JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
ช่อง | |
---|---|
measure |
ค่า: ตัวอย่าง 1.2 |
unit |
หน่วย: ตัวอย่าง POUND, GRAM |
หน่วย
Enum | |
---|---|
UNIT_UNSPECIFIED |
ไม่ได้ระบุหน่วย |
MILLIGRAM |
มิลลิกรัม |
GRAM |
กรัม |
KILOGRAM |
กิโลกรัม |
OUNCE |
ออนซ์ |
POUND |
ปอนด์ |
PurchaseReturnsInfo
แสดงผลข้อมูลที่เชื่อมโยงกับคำสั่งซื้อหรือรายการโฆษณาที่เฉพาะเจาะจง
การแสดง JSON | |
---|---|
{ "isReturnable": boolean, "daysToReturn": number, "policyUrl": string } |
ช่อง | |
---|---|
isReturnable |
หากเป็น "จริง" ระบบจะอนุญาตให้ "แสดงผล" ได้ |
daysToReturn |
ซึ่งอนุญาตให้คืนสินค้าได้ภายในหลายวัน |
policyUrl |
ลิงก์ไปยังนโยบายคืนสินค้า |
PurchaseFulfillmentInfo
ข้อมูลการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับใบสั่งซื้อหรือรายการโฆษณาที่เฉพาะเจาะจง
การแสดง JSON | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
ช่อง | |
---|---|
id |
ตัวระบุที่ไม่ซ้ำกันสำหรับตัวเลือกบริการนี้ |
fulfillmentType |
ต้องระบุ: ประเภทของ Fulfillment |
expectedFulfillmentTime |
กรอบเวลาถ้ามีการระบุช่วงเวลา หรือเวลาถึงโดยประมาณถ้าระบุเวลาเดียว เวลานำส่งหรือรับสินค้าที่คาดไว้ |
expectedPreparationTime |
กรอบเวลาถ้ามีการระบุช่วงเวลา หรือเวลาถึงโดยประมาณถ้าระบุเวลาเดียว เวลาที่คาดว่าจะเตรียมอาหาร แนะนำให้ใช้ครั้งเดียว |
location |
สถานที่รับหรือจัดส่งสินค้า |
expireTime |
เวลาที่ตัวเลือกการดำเนินการตามคำสั่งซื้อนี้หมดอายุ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
price |
ค่าใช้จ่ายของตัวเลือกนี้ |
fulfillmentContact |
ข้อมูลติดต่อของผู้ใช้สำหรับการดำเนินการตามคำสั่งซื้อนี้ |
shippingMethodName |
ชื่อวิธีการจัดส่งที่ผู้ใช้เลือก |
storeCode |
รหัสร้านค้าของตำแหน่ง ตัวอย่างเช่น Walmart เป็นผู้ขาย และ storeCode คือร้าน Walmart ที่มีการจำหน่ายที่ https://support.google.com/business/answer/3370250?ref_topic=4596653 |
pickupInfo |
ข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเลือกคำสั่งซื้อ ช่องนี้จะใช้ได้เฉพาะเมื่อประเภทการดำเนินการตามคำสั่งซื้อคือ "รับสินค้า" เท่านั้น |
Type
ประเภทการดำเนินการตามคำสั่งซื้อ
Enum | |
---|---|
TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภท |
DELIVERY |
คำสั่งซื้อนี้จะถูกจัดส่ง |
PICKUP |
ต้องไปรับคำสั่งซื้อนี้ |
เวลา
โครงสร้างเวลาเพื่อแสดงเวลาของเหตุการณ์ที่จะใช้เมื่อแสดงคำสั่งซื้อให้แก่ผู้ใช้
การแสดง JSON | |
---|---|
{ "timeIso8601": string } |
ช่อง | |
---|---|
timeIso8601 |
แสดงเวลาเหตุการณ์คำสั่งซื้อ เช่น เวลาจอง เวลานำส่ง และอื่นๆ อาจเป็นระยะเวลา (เวลาเริ่มต้นและสิ้นสุด) ได้เฉพาะวันที่ วันที่และเวลา ฯลฯ ดูรูปแบบที่รองรับทั้งหมดได้ที่ https://en.wikipedia.org/wiki/ISO_8601 |
PickupInfo
รายละเอียดเกี่ยวกับวิธีรับสินค้า ซึ่งจะมีรายละเอียดต่างๆ เช่น ประเภทการรับสินค้าและข้อมูลเมตาเพิ่มเติมที่แนบมากับแต่ละประเภท (หากมี)
การแสดง JSON | |
---|---|
{ "pickupType": enum ( |
ช่อง | |
---|---|
pickupType |
วิธีรับสินค้า เช่น INSTORE, CURBSIDE ฯลฯ |
curbsideInfo |
รายละเอียดเฉพาะสำหรับข้อมูลโดยไม่ต้องลงจากรถ หาก pickupType ไม่ใช่ "CURBSIDE" ระบบจะไม่สนใจช่องนี้ |
checkInInfo[] |
รายการวิธีการต่างๆ ที่พาร์ทเนอร์รองรับเพื่อรองรับการเช็คอิน |
PickupType
รายการประเภทการรับสินค้าที่รองรับ
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุประเภทการรับสินค้า |
INSTORE |
รับอาหารในร้าน |
CURBSIDE |
จอดรถในจุดที่กำหนดไว้นอกร้านอาหาร แล้วคนจะนำอาหารมาส่ง |
CurbsideInfo
รายละเอียดเกี่ยวกับวิธีอำนวยความสะดวกให้ลูกค้าโดยไม่ต้องลงจากรถ
การแสดง JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
ช่อง | |
---|---|
curbsideFulfillmentType |
พาร์ทเนอร์ต้องการข้อมูลเพิ่มเติมเพื่ออำนวยความสะดวกให้คำสั่งซื้อแบบไปรับเองโดยไม่ต้องลงจากรถ ระบบจะรวบรวมรายละเอียดที่เกี่ยวข้องจากผู้ใช้ ทั้งนี้ขึ้นอยู่กับประเภทการดำเนินการตามคำสั่งซื้อที่เลือก |
userVehicle |
รายละเอียดยานพาหนะของผู้ใช้สั่งซื้อ |
CurbsideFulfillmentType
ค่าที่เป็นไปได้ของประเภท Fulfillment โดยไม่ต้องลงจากรถ
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุประเภท Fulfillment ริมทาง |
VEHICLE_DETAIL |
ต้องมีรายละเอียดของยานพาหนะเพื่อช่วยในการรับสินค้าโดยไม่ต้องลงจากรถ |
ยานพาหนะ
รายละเอียดเกี่ยวกับยานพาหนะ
การแสดง JSON | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
ช่อง | |
---|---|
make |
ยี่ห้อยานพาหนะ (เช่น "Honda") ซึ่งจะแสดงให้ผู้ใช้เห็นและต้องแปลเป็นภาษาท้องถิ่น ต้องระบุ |
model |
รุ่นของยานพาหนะ (เช่น "Grom") ซึ่งจะแสดงให้ผู้ใช้เห็นและต้องแปลเป็นภาษาท้องถิ่น ต้องระบุ |
licensePlate |
หมายเลขป้ายทะเบียนรถ (เช่น "1ABC234") ต้องระบุ |
colorName |
ชื่อสียานพาหนะ เช่น สีดำ (ไม่บังคับ) |
image |
URL ไปยังรูปภาพของยานพาหนะ รูปภาพจะแสดงที่ขนาดประมาณ 256x256 พิกเซล ต้องเป็น jpg หรือ png ไม่บังคับ |
CheckInInfo
พาร์ทเนอร์ต้องมีข้อมูลเมตาเพื่อรองรับวิธีการเช็คอิน
การแสดง JSON | |
---|---|
{
"checkInType": enum ( |
ช่อง | |
---|---|
checkInType |
วิธีที่ใช้ส่งวิธีการเช็คอิน |
CheckInType
วิธีการต่างๆ ที่ใช้ส่งวิธีการเช็คอิน
Enum | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
ค่าที่ไม่รู้จัก |
EMAIL |
ระบบจะส่งข้อมูลการเช็คอินทางอีเมล |
SMS |
ระบบจะส่งข้อมูลการเช็คอินทาง SMS |
ItemOption
หมายถึงส่วนเสริมหรือรายการย่อย
การแสดง JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
ช่อง | |
---|---|
id |
สำหรับตัวเลือกที่เป็นสินค้า รหัสสินค้าที่ไม่ซ้ำกัน |
name |
ชื่อตัวเลือก |
prices[] |
ราคารวมตัวเลือก |
note |
หมายเหตุที่เกี่ยวข้องกับตัวเลือก |
quantity |
สำหรับตัวเลือกที่เป็น "สินค้า" หรือ "จำนวน" |
productId |
รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับตัวเลือกนี้ |
subOptions[] |
เพื่อกำหนดตัวเลือกย่อยอื่นๆ ที่ฝังอยู่ |
ProductDetails
รายละเอียดเกี่ยวกับผลิตภัณฑ์
การแสดง JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
ช่อง | |
---|---|
productId |
รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้ |
gtin |
หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ มีประโยชน์หากไม่มี OfferId ใน Merchant Center ไม่บังคับ |
plu |
รหัสค้นหาราคาซึ่งมักเรียกว่ารหัส PLU, หมายเลข PLU, PLU, รหัสสำหรับผลิต หรือฉลากผลผลิต เป็นระบบตัวเลขที่ระบุผลิตภัณฑ์แบบจำนวนมากที่ขายในร้านขายของชำและซูเปอร์มาร์เก็ตได้อย่างแน่ชัด |
productType |
หมวดหมู่ผลิตภัณฑ์ที่ผู้ขายกำหนด เช่น "หน้าแรก > ของชำ > นมและไข่ > นม > นมไขมันเต็ม" |
productAttributes |
รายละเอียดผลิตภัณฑ์ที่ผู้ขายระบุ เช่น { "allergen": "peanut" } ซึ่งจะเป็นประโยชน์ในกรณีที่ไม่มี OfferId ไว้ใน Merchant Center ไม่บังคับ ออบเจ็กต์ที่มีรายการคู่ |
ReservationItemExtension
เนื้อหาบรรทัดรายการสำหรับคำสั่งซื้อแบบจอง เช่น ร้านอาหาร การตัดผม ฯลฯ รหัสถัดไป: 15
การแสดง JSON | |
---|---|
{ "status": enum ( |
ช่อง | |
---|---|
status |
ต้องระบุ: สถานะการจอง |
userVisibleStatusLabel |
จำเป็น: ป้ายกำกับ/สตริงที่ผู้ใช้มองเห็นได้สำหรับสถานะ ความยาวสูงสุดที่อนุญาตคือ 50 อักขระ |
type |
ประเภทการจอง อาจยกเลิกการตั้งค่าหากไม่มีตัวเลือกประเภทใดเลย |
reservationTime |
เวลาที่มีการกำหนดเวลาบริการ/กิจกรรมไว้ ซึ่งอาจเป็นช่วงเวลา วันที่ หรือวันที่และเวลาที่แน่นอนก็ได้ |
userAcceptableTimeRange |
ช่วงเวลาที่ผู้ใช้ยอมรับ |
confirmationCode |
รหัสยืนยันสำหรับการจองนี้ |
partySize |
จำนวนคน |
staffFacilitators[] |
เจ้าหน้าที่อำนวยความสะดวกที่จะให้บริการการจอง เช่น ช่างทำผม |
location |
ตำแหน่งของบริการ/เหตุการณ์ |
extension |
ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
ReservationStatus
สถานะการจอง
Enum | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
สถานะที่ไม่ได้ระบุ |
PENDING |
การจองอยู่ระหว่างรอดำเนินการ |
CONFIRMED |
ยืนยันการจองแล้ว |
CANCELLED |
ผู้ใช้ยกเลิกการจอง |
FULFILLED |
ดำเนินการจองแล้ว |
CHANGE_REQUESTED |
ต้องระบุการเปลี่ยนแปลงการจอง |
REJECTED |
การจองหมดอายุหรือถูกปฏิเสธโดยผู้ผสานการทำงาน |
ReservationType
ประเภทการจอง
Enum | |
---|---|
RESERVATION_TYPE_UNSPECIFIED |
ไม่ระบุประเภท |
RESTAURANT |
การจองร้านอาหาร |
HAIRDRESSER |
การจองสำหรับช่างทำผม |
StaffFacilitator
ข้อมูลเกี่ยวกับผู้รับบริการ
การแสดง JSON | |
---|---|
{
"name": string,
"image": {
object ( |
ช่อง | |
---|---|
name |
ชื่อวิทยากรเจ้าหน้าที่ เช่น "สมชาย สกุลดี" |
image |
รูปภาพของผู้แสดง |
PaymentData
ข้อมูลการชำระเงินที่เกี่ยวข้องกับคำสั่งซื้อ
การแสดง JSON | |
---|---|
{ "paymentResult": { object ( |
ช่อง | |
---|---|
paymentResult |
ผลการชำระเงินที่ผู้รวมระบบใช้ในการทำธุรกรรมให้เสร็จสมบูรณ์ Actions on Google จะป้อนข้อมูลในช่องนี้ หากประสบการณ์การชำระเงินได้รับการจัดการโดย Actions-on-Google |
paymentInfo |
ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่เป็นประโยชน์สำหรับการโต้ตอบที่ผู้ใช้เห็น |
PaymentResult
ผู้รวมบริการใช้ผลการชำระเงินสำหรับการทำธุรกรรมให้เสร็จสมบูรณ์
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม result มีการระบุข้อมูลการชำระเงินด้วยบริการของ Google หรือวิธีการชำระเงินของผู้ขาย result ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
googlePaymentData |
ข้อมูลวิธีการชำระเงินที่ Google ให้ไว้ หากผู้ประมวลผลการชำระเงินของคุณอยู่ในรายการผู้ประมวลผลการชำระเงินที่ Google รองรับ โปรดดูที่ https://developers.google.com/pay/api/ ไปที่ผู้ประมวลผลการชำระเงินผ่านลิงก์เพื่อดูรายละเอียดเพิ่มเติม หรือดูรายละเอียดเปย์โหลดในเอกสารประกอบต่อไปนี้ https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
วิธีการชำระเงินที่ผู้ขาย/การดำเนินการที่ผู้ใช้เลือก |
PaymentInfo
ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่ดำเนินการ โปรโตคอลนี้บันทึกข้อมูลที่เป็นประโยชน์สำหรับการโต้ตอบที่แสดงต่อผู้ใช้
การแสดง JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
ช่อง | |
---|---|
paymentMethodDisplayInfo |
ข้อมูลที่แสดงของวิธีการชำระเงินที่ใช้ทำธุรกรรม |
paymentMethodProvenance |
แหล่งที่มาของวิธีการชำระเงินที่ใช้ทำธุรกรรม ผู้ใช้อาจลงทะเบียนวิธีการชำระเงินเดียวกันทั้งกับ Google และผู้ขาย |
PaymentMethodDisplayInfo
ผู้รวมบริการใช้ผลการชำระเงินสำหรับการทำธุรกรรมให้เสร็จสมบูรณ์
การแสดง JSON | |
---|---|
{
"paymentType": enum ( |
ช่อง | |
---|---|
paymentType |
ประเภทของการชำระเงิน |
paymentMethodDisplayName |
ชื่อวิธีการชำระเงินที่แสดงต่อผู้ใช้ เช่น VISA **** 1234 บัญชีกระแสรายวัน **** 5678 |
paymentMethodVoiceName |
ชื่อวิธีการชำระเงินที่จะพูดอธิบายผู้ใช้สำหรับอุปกรณ์ Assistant แบบใช้เสียงเท่านั้น เช่น "วีซ่าที่ลงท้ายด้วย 1-234" หรือ "กำลังตรวจสอบบัญชีที่ลงท้ายด้วย 5678" หมายเหตุ: นี่คือสตริงที่เพิ่มประสิทธิภาพด้วยเสียงที่จะใช้แทน paymentMethodDisplayName สำหรับอุปกรณ์ Assistant แบบเสียงเท่านั้น หากไม่ได้ตั้งค่าสตริงนี้ ระบบจะบอกผู้ใช้ paymentMethodDisplayName แทน |
PaymentType
PaymentType จะระบุรูปแบบการชำระเงินที่ใช้สำหรับวิธีการชำระเงินที่ผู้ขายระบุ การดำเนินการต้องระบุชื่อที่แสดงของวิธีการชำระเงินด้วย
Enum | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทการชำระเงิน |
PAYMENT_CARD |
บัตรเครดิต/เดบิตหรือบัตรชำระเงินล่วงหน้า |
BANK |
วิธีการชำระเงินคือบัญชีธนาคาร |
LOYALTY_PROGRAM |
วิธีการชำระเงินเป็นโปรแกรมสะสมคะแนน |
CASH |
วิธีการชำระเงินคือเงินสด |
GIFT_CARD |
วิธีการชำระเงินคือบัตรของขวัญ |
WALLET |
กระเป๋าเงินของบุคคลที่สาม เช่น PayPal |
PaymentMethodProvenance
แสดงแหล่งที่มาของวิธีการชำระเงินที่ใช้สำหรับธุรกรรม
Enum | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
ไม่ได้ระบุแหล่งที่มา |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
แหล่งที่มาคือ Google |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
หลักฐานเป็นผู้ขาย |
โปรโมชัน
โปรโมชัน/ข้อเสนอที่เพิ่มลงในรถเข็น
การแสดง JSON | |
---|---|
{ "coupon": string } |
ช่อง | |
---|---|
coupon |
ต้องระบุ: รหัสคูปองที่ใช้กับข้อเสนอนี้ |
PurchaseOrderExtension
ส่วนขยายคำสั่งซื้อสำหรับประเภทธุรกิจการซื้อ คุณสมบัติเหล่านี้ใช้ได้กับรายการโฆษณาทั้งหมดในคำสั่งซื้อ เว้นแต่จะมีการลบล้างในรายการโฆษณา
การแสดง JSON | |
---|---|
{ "status": enum ( |
ช่อง | |
---|---|
status |
ต้องระบุ: สถานะโดยรวมของคำสั่งซื้อ |
userVisibleStatusLabel |
ป้ายกำกับ/สตริงที่ผู้ใช้มองเห็นสำหรับสถานะ ความยาวสูงสุดที่อนุญาตคือ 50 อักขระ |
type |
ต้องระบุ: ประเภทของการซื้อ |
returnsInfo |
ข้อมูลการคืนสินค้าสำหรับคำสั่งซื้อ |
fulfillmentInfo |
ข้อมูลการดำเนินการตามคำสั่งซื้อ |
extension |
ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
purchaseLocationType |
สถานที่ซื้อ (ที่ร้านค้า / ออนไลน์) |
errors[] |
ไม่บังคับ: ข้อผิดพลาดเนื่องจากคำสั่งซื้อนี้ถูกปฏิเสธ |
PurchaseLocationType
ประเภทสถานที่ของการซื้อ
Enum | |
---|---|
UNSPECIFIED_LOCATION |
ค่าที่ไม่รู้จัก |
ONLINE_PURCHASE |
การซื้อทั้งหมดซื้อออนไลน์ |
INSTORE_PURCHASE |
การซื้อที่ร้านทั้งหมด |
PurchaseError
ข้อผิดพลาดที่อาจปฏิเสธใบสั่งซื้อได้
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ: ข้อมูลนี้แสดงเหตุผลที่ผู้ขายปฏิเสธคำสั่งซื้อแบบละเอียด |
description |
คำอธิบายข้อผิดพลาดเพิ่มเติม |
entityId |
รหัสเอนทิตีที่ตรงกับข้อผิดพลาด ตัวอย่างซึ่งสามารถสอดคล้องกับ LineItemId / ItemOptionId |
updatedPrice |
มีความเกี่ยวข้องในกรณีที่มีข้อผิดพลาดประเภท PRICE_CHANGED / INCORRECT_PRICE |
availableQuantity |
มีสินค้าพร้อมจำหน่ายแล้ว ใช้ได้ในกรณี AVAILABILITY_CHANGED |
ErrorType
ประเภทข้อผิดพลาดที่เป็นไปได้
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED |
ข้อผิดพลาดที่ไม่รู้จัก |
NOT_FOUND |
ไม่พบเอนทิตี ซึ่งอาจเป็นรายการ, FulfillmentOption, โปรโมชัน ต้องระบุรหัสเอนทิตี |
INVALID |
ข้อมูลเอนทิตีไม่ถูกต้อง อาจเป็นสินค้า, FulfillmentOption, โปรโมชัน ต้องระบุรหัสเอนทิตี |
AVAILABILITY_CHANGED |
สินค้าไม่พร้อมจำหน่ายหรือมีสินค้าที่ไม่เพียงพอที่จะดำเนินการตามคำขอ ต้องระบุรหัสเอนทิตี |
PRICE_CHANGED |
ราคาของรายการแตกต่างจากราคาในเอนทิตีรายการ ต้องระบุรหัสเอนทิตีและราคาที่อัปเดต |
INCORRECT_PRICE |
ข้อผิดพลาดด้านราคาเป็นสกุลเงินค่าธรรมเนียม ยอดรวม ต้องระบุรหัสเอนทิตีและราคาที่อัปเดต |
REQUIREMENTS_NOT_MET |
ไม่เป็นไปตามข้อจำกัดในการรับคำสั่งซื้อ เช่น ขนาดตะกร้าขั้นต่ำ ฯลฯ |
TOO_LATE |
FulfillmentOption หมดอายุแล้ว |
NO_CAPACITY |
ไม่มีความจุของบริการที่ใช้ได้ |
INELIGIBLE |
ผู้ใช้ไม่มีสิทธิ์สั่งซื้อ (อยู่ในบัญชีดำ) |
OUT_OF_SERVICE_AREA |
นำส่งไปยังที่อยู่ที่ขอไม่ได้เนื่องจากมีกฎเกณฑ์ ฯลฯ |
CLOSED |
ร้านอาหารปิดให้บริการในช่วงเวลาสั่งอาหาร |
PROMO_NOT_APPLICABLE |
รหัสข้อผิดพลาดทั่วไปซึ่งจะตรวจจับความผิดพลาดในการใช้รหัสโปรโมชันได้ทุกกรณี หากไม่มีข้อใดที่ด้านล่างนี้เหมาะสม เพิ่มรหัสโปรโมชันเป็นรหัสเอนทิตี |
PROMO_NOT_RECOGNIZED |
พาร์ทเนอร์ไม่รู้จักรหัสคูปองนี้ เพิ่มรหัสโปรโมชันเป็นรหัสเอนทิตี |
PROMO_EXPIRED |
ใช้ไม่ได้เนื่องจากโปรโมชันหมดอายุแล้ว เพิ่มรหัสโปรโมชันเป็นรหัสเอนทิตี |
PROMO_USER_INELIGIBLE |
ผู้ใช้ปัจจุบันไม่มีสิทธิ์รับคูปองนี้ เพิ่มรหัสโปรโมชันเป็นรหัสเอนทิตี |
PROMO_ORDER_INELIGIBLE |
คำสั่งซื้อปัจจุบันไม่มีสิทธิ์ในการใช้คูปองนี้ เพิ่มรหัสโปรโมชันเป็นรหัสเอนทิตี |
UNAVAILABLE_SLOT |
ช่วงเวลารับการสั่งล่วงหน้าไม่พร้อมใช้งาน |
FAILED_PRECONDITION |
ไม่เป็นไปตามข้อจำกัดในการรับคำสั่งซื้อ เช่น ขนาดตะกร้าขั้นต่ำ ฯลฯ |
PAYMENT_DECLINED |
การชำระเงินไม่ถูกต้อง |
MERCHANT_UNREACHABLE |
ติดต่อผู้ขายไม่ได้ วิธีนี้จะมีประโยชน์เมื่อพาร์ทเนอร์เป็นผู้รวบรวมข้อมูลและเข้าถึงผู้ขายไม่ได้ |
TicketOrderExtension
เนื้อหาการสั่งซื้อสำหรับการสั่งซื้อตั๋ว เช่น ภาพยนตร์ กีฬา ฯลฯ
การแสดง JSON | |
---|---|
{
"ticketEvent": {
object ( |
ช่อง | |
---|---|
ticketEvent |
เหตุการณ์นี้จะใช้กับตั๋วของรายการโฆษณาทั้งหมด |
TicketEvent
แสดงกิจกรรมเดียว
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ: ประเภทตั๋วกิจกรรม เช่น ภาพยนตร์ คอนเสิร์ต |
name |
ต้องระบุ: ชื่อเหตุการณ์ ตัวอย่างเช่น หากกิจกรรมเป็นภาพยนตร์ ควรเป็นชื่อภาพยนตร์ |
description |
คำอธิบายกิจกรรม |
url |
URL ไปยังข้อมูลกิจกรรม |
location |
สถานที่จัดกิจกรรมหรือองค์กร |
eventCharacters[] |
ตัวละครที่เกี่ยวข้องกับกิจกรรมนี้ อาจเป็นผู้กำกับการแสดงภาพยนตร์ หรือผู้แสดงคอนเสิร์ต ฯลฯ |
startDate |
เวลาเริ่มต้น |
endDate |
เวลาสิ้นสุด |
doorTime |
เวลาเข้างาน ซึ่งอาจต่างจากเวลาเริ่มต้นกิจกรรม เช่น กิจกรรมเริ่มเวลา 9:00 น. แต่เวลาเข้าคือ 8:30 น. |
Type
ประเภทของเหตุการณ์
Enum | |
---|---|
EVENT_TYPE_UNKNOWN |
ประเภทเหตุการณ์ที่ไม่รู้จัก |
MOVIE |
ภาพยนตร์ |
CONCERT |
คอนเสิร์ต |
SPORTS |
กีฬา |
EventCharacter
ตัวละครในเหตุการณ์ 1 ตัว เช่น ผู้จัด นักแสดง เป็นต้น
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทตัวละครในกิจกรรม เช่น นักแสดงหรือผู้กำกับ |
name |
ชื่อตัวละคร |
image |
ภาพของตัวละคร |
Type
ประเภทตัวละคร
Enum | |
---|---|
TYPE_UNKNOWN |
ประเภทที่ไม่รู้จัก |
ACTOR |
ผู้ดำเนินการ |
PERFORMER |
ผู้แสดง |
DIRECTOR |
ผู้กำกับ |
ORGANIZER |
ผู้จัด |