Package google.maps.booking.v1alpha

ดัชนี

BookingNotification

รับการแจ้งเตือนสำหรับการนัดหมายจากพาร์ทเนอร์การกำหนดเวลาภายนอก พาร์ทเนอร์ควรเรียกใช้ UpdateBooking หรือ UpdateOrder ขึ้นอยู่กับว่าพาร์ทเนอร์ใช้ RPC ตามการจอง เช่น CreateBooking และ CheckAvailability หรือ RPC พื้นฐานของคำสั่งซื้อ เช่น CreateOrder และ CheckOrderFulfillability

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

อัปเดต Booking ที่มีอยู่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

อัปเดต Order ที่มีอยู่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

ฟีด

เรียกดูสถานะการประมวลผลของฟีดที่อัปโหลดโดยพาร์ทเนอร์ผู้รวบรวมข้อมูลภายนอก

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

เรียกข้อมูล Status ของฟีดที่อัปโหลดก่อนหน้านี้โดยผู้รวบรวมข้อมูลที่ระบุ และแสดงผลฟีดดังกล่าว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

เรียกข้อมูล Status ของฟีดผู้ขาย บริการ หรือความพร้อมจำหน่ายสินค้าที่อัปโหลดไปก่อนหน้านี้หลายรายการโดยผู้รวบรวมข้อมูลที่ระบุ และแสดงผลฟีดดังกล่าว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

InvalidationService

รับคำขอเกี่ยวกับโมฆะทรัพยากรจากพาร์ทเนอร์ภายนอก

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

ทำให้ทรัพยากรที่มีอยู่เป็นโมฆะ

ระบบจะไม่สนใจคำขอหากทรัพยากรที่ขอไม่ได้สมัครใช้บริการของ Google

ประเภททรัพยากรที่รองรับ: - รับสินค้า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

ดึงข้อมูลสินค้าคงคลังและสถานะการจับคู่ของผู้ขายที่อัปโหลด

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

รับ MerchantStatus ของ Merchant

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

แสดงรายการ MerchantStatus ทั้งหมดของพาร์ทเนอร์ที่ตรงตามเงื่อนไขตัวกรอง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

รับการอัปเดตสินค้าคงคลังจากผู้รวบรวมข้อมูลภายนอก

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

แทนที่ Availability ของ Services ที่มีอยู่ การเรียกใช้แบบกลุ่มนี้ไม่ได้รับประกันการเข้าถึงที่น้อยลง ระบบจะแสดงเฉพาะช่วงเวลาว่างที่อัปเดตเรียบร้อยแล้วเท่านั้น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

สร้าง Merchant ใหม่ที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุและส่งคืน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService(CreateServiceRequest) returns (Service)

สร้าง Service ใหม่ของผู้ขายที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งคืนผู้ขายดังกล่าว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Empty)

ลบ Service ที่มีอยู่ของผู้ขายซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ ระบบจะลบความพร้อมทั้งหมดของบริการด้วย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

แทนที่ Availability ของ Service ที่มีอยู่ของผู้ขายซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งคืน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

อัปเดตMerchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งข้อมูลดังกล่าวกลับมา

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Service)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

ประเภทการดำเนินการที่กำหนดไว้ล่วงหน้าซึ่งเชื่อมโยงกับลิงก์การดำเนินการ

Enum

ActionPlatform

แพลตฟอร์มที่มีการดำเนินการ เว็บแอปพลิเคชันเป็นแอปพลิเคชันสำรองทั่วไป เราขอแนะนำให้คุณมี ActionLink อย่างน้อย 1 รายการที่มี ACTION_PLATFORM_WEB_APPLICATION ลิงก์ที่ใช้แพลตฟอร์ม Android และ iOS จะใช้ในระบบที่เกี่ยวข้องเท่านั้น

Enum
ACTION_PLATFORM_UNSPECIFIED ไม่ได้ระบุแพลตฟอร์ม
ACTION_PLATFORM_WEB_APPLICATION แพลตฟอร์มสำหรับการดำเนินการโดยทั่วไปจะเป็นเว็บ
ACTION_PLATFORM_MOBILE_WEB แพลตฟอร์มการดำเนินการคือเว็บบนอุปกรณ์เคลื่อนที่
ACTION_PLATFORM_ANDROID แพลตฟอร์มการดำเนินการคือระบบปฏิบัติการ Android
ACTION_PLATFORM_IOS แพลตฟอร์มการดำเนินการคือ iOS

คำแนะนำ

คำแนะนำที่แสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google"

ช่อง
text

Text

ข้อความที่กำหนดเองที่จะแสดงแก่ผู้ใช้เมื่อจองผ่าน "จองกับ Google"

ความพร้อมใช้งาน

ช่วงเวลาที่พร้อมให้บริการของผู้ขาย ซึ่งระบุเวลาและจำนวนตำแหน่ง

ช่อง
start_time

Timestamp

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

duration

Duration

ระยะเวลาของช่วงการนัดหมาย

spots_total

int64

จำนวนตำแหน่งทั้งหมดและจำนวนตำแหน่งที่ว่างอยู่นี้ ตัวอย่าง

  • คลาสโยคะ 10 ที่ที่มีการจอง 3 คน: availability {spots_total: 10, spots_open: 7 ...}
  • เซสชันนวดเก้าอี้ซึ่งมีการจองเต็มแล้ว: availability {spots_total: 1, spots_open: 0 ...}

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

  • การเกิดซ้ำหมายถึง spots_total=1 และ spots_open=1
  • ScheduleException หมายถึง spots_total=1 และ spots_open=0
spots_open

int64

จำนวนที่ว่าง

availability_tag

string

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

resources

Resources

ทรัพยากรที่ไม่บังคับซึ่งใช้เพื่อแยกเวลาว่างนี้ออกจากคนอื่นๆ เมื่อมีพนักงานหลายคนหรือห้องอื่นๆ เป็นส่วนหนึ่งของบริการ

เช่น ชั้นเรียนโยคะเดียวกันกับผู้สอน 2 คน ได้แก่

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_option_id[]

string

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

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

recurrence

Recurrence

ข้อมูลการเกิดซ้ำสำหรับเวลาว่าง ซึ่งแสดงเวลาเริ่มต้นมากกว่า 1 ครั้ง การเกิดซ้ำควรมีการนัดหมายเป็นเวลา 1 วันทำการ

schedule_exception[]

ScheduleException

เวลาที่กําหนดให้บริการนี้ไม่ได้ หากต้องการจำกัดจำนวนข้อความ schedule_exception ให้พิจารณาเข้าร่วมข้อยกเว้นที่อยู่ติดกัน

deposit

Deposit

เงินมัดจำที่ไม่บังคับสำหรับความพร้อมจำหน่ายสินค้านี้ ลบล้างเงินฝากบริการหากมีการระบุไว้

no_show_fee

NoShowFee

ค่าธรรมเนียมการไม่แสดงตัว (ไม่บังคับ) สำหรับความพร้อมจำหน่ายสินค้านี้ ลบล้างค่าธรรมเนียมการไม่แสดงงานหากมีการระบุไว้

require_credit_card

RequireCreditCard

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

ticket_type_id[]

string

ระบุรายการประเภทตั๋วที่รองรับสําหรับช่วงเวลาที่พร้อมให้บริการนี้ หากไม่ได้ตั้งค่า ประเภทตั๋วทั้งหมดในบริการหลักจะพร้อมใช้งานสำหรับช่วงเวลานี้ โปรดทราบว่าค่าของช่องนี้ต้องกำหนดไว้ในบริการระดับบนสุด ตัวอย่าง

  • บริการที่มีตั๋ว 4 ประเภท ได้แก่ TicketType {ticket_type_id: "adult_1" Short_description: "ผู้ใหญ่ในวันธรรมดา"} ประเภทตั๋ว {ticket_type_id: "adult_2" Short_description: "ผู้ใหญ่ในช่วงสุดสัปดาห์"} ประเภทตั๋ว {ticket_type_id: "youth_1" Short_description: "Youth weekdays"} ประเภทตั๋ว {ticket_type_id: "youth_2" Short_description: "วันสุดสัปดาห์สำหรับเยาวชน"}

หากต้องการแสดงสินค้าคงคลังในช่วงวันธรรมดา: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} หากต้องการนำเสนอสินค้าคงคลังในช่วงวันหยุด: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}

  • บริการที่มีตั๋ว 3 ประเภท ได้แก่ TicketType {ticket_type_id: "adult" Short_description: "ผู้ใหญ่"} ประเภทตั๋ว {ticket_type_id: "เยาวชน" Short_description: "Youth"} ประเภทตั๋ว {ticket_type_id: "senior" Short_description: "อาวุโส"}

หากต้องการระบุว่าตั๋วทั้ง 3 ประเภทพร้อมให้บริการสำหรับช่วงเวลานี้ ให้ใช้ availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} หรือ "ความพร้อมจำหน่ายสินค้า {...}" (โปรดอย่าตั้งค่า Ticket_type_id ในช่องนี้)

(ไม่บังคับ)

duration_requirement

DurationRequirement

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

scheduling_rule_overrides

SchedulingRuleOverrides

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

confirmation_mode

ConfirmationMode

โหมดการยืนยันที่จะใช้เมื่อจองห้องว่างนี้ การพยายามสร้างการจองสำหรับความพร้อมด้วยโหมดการยืนยัน CONFIRMATION_MODE_SYNCHRONOUS จะต้องได้รับการยืนยันหรือปฏิเสธทันที การพยายามสร้างการจองสำหรับความพร้อมด้วยโหมดการยืนยัน CONFIRMATION_MODE_ASYNCHRONOUS ต้องถูกปฏิเสธทันทีหรือสร้างขึ้นโดยมีสถานะรอดำเนินการ

ConfirmationMode

โหมดการยืนยันที่ใช้เมื่อจองความพร้อม

Enum
CONFIRMATION_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการยืนยัน ระบบจะใช้การยืนยันแบบซิงโครนัส
CONFIRMATION_MODE_SYNCHRONOUS ระบบจะยืนยันการจองสำหรับความพร้อมให้บริการนี้แบบพร้อมกัน
CONFIRMATION_MODE_ASYNCHRONOUS ระบบจะยืนยันการจองสำหรับความพร้อมให้บริการนี้แบบไม่พร้อมกัน

DurationRequirement

Enum นี้ระบุข้อกำหนดเพื่อให้ผู้ใช้รับทราบหรือดูระยะเวลา/เวลาสิ้นสุดของสล็อตที่ขอ

Enum
DURATION_REQUIREMENT_UNSPECIFIED ไม่ได้ระบุเวลาสิ้นสุดดำเนินการ โดยตัวเลือกนี้คือค่าเริ่มต้น
DO_NOT_SHOW_DURATION เวลาสิ้นสุดไม่แสดงให้ผู้ใช้เห็น
MUST_SHOW_DURATION จะต้องแสดงเวลาสิ้นสุดต่อผู้ใช้ก่อนจึงจะนัดหมายได้

การเกิดซ้ำ

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

ข้อกำหนด

  1. การขยายช่วงเวลาว่างหรือการเกิดซ้ำจะต้องไม่สร้างช่วงเวลาที่เหมือนกัน หากรหัส, start_time, ระยะเวลา และทรัพยากรตรงกัน ระบบจะถือว่าช่วงเวลาเหมือนกัน
  2. อย่ารวมรูปแบบความพร้อมใช้งานมาตรฐานและการเกิดซ้ำในช่องของบริการเดียว การเกิดซ้ำมีประโยชน์ต่อผู้ขาย/บริการที่มีการนัดหมาย รูปแบบมาตรฐานจะมุ่งเน้นไปที่ผู้ขาย/บริการที่มีชั้นเรียนตามกำหนดการเป็นประจำ
  3. การเกิดซ้ำไม่ควรนานเกิน 24 ชั่วโมง
ช่อง
repeat_until

Timestamp

การประทับเวลา UTC สูงสุดโดยรวมที่ความพร้อมใช้งานจะเกิดซ้ำจนถึง

repeat_every

Duration

กำหนดเวลาระหว่างช่วงเวลาที่ว่างติดต่อกัน

ตัวอย่างเช่น ความพร้อมใช้งานที่มีระยะเวลา 20 นาที การทำซ้ำ_ทุก 30 นาที เวลาเริ่มต้น_9.00 น. และช่วงเวลาซ้ำ_จนถึง 11.00 น. จะแสดงช่วงเวลาในเวลา 9.30-9.20 น., 9.30-9.50 น., 10.30-10.20 น., 10.30-10.50 น. (ต้องระบุ)

ScheduleException

ข้อความ ScheduleException แสดงช่วงเวลาที่จองไว้/ไม่ว่างภายในวันทำงาน ซึ่งเป็นข้อยกเว้นสำหรับการเกิดซ้ำที่อธิบายไว้ข้างต้น เมื่อมีการจองช่วงเวลาแล้ว คุณควรอัปเดตรายการข้อยกเว้นเพื่อให้สอดคล้องกับช่วงเวลาใหม่ที่ไม่พร้อมใช้งาน ไม่ควรแก้ไขการเกิดซ้ำ

ช่อง
time_range

TimeRange

ช่วงเวลาของข้อยกเว้น ช่วงเวลาใดๆ ที่มีการอธิบายด้วยการเกิดซ้ำซึ่งทับซ้อนกับช่วงเวลาปิดทำการนี้จะถือว่าไม่พร้อมให้บริการ

ตัวอย่าง: หากการเกิดซ้ำระบุระยะเวลาเป็น 20 นาที, การทำซ้ำ_ทุก 30 นาที, เวลาเริ่ม 9:00 น. และ เวลาซ้ำจนถึง 11:00 น. เวลา 9.45 น. - 11.00 น. จะทำให้ช่วงเวลาว่างในเวลา 9:30-9:10 น. และ 10:00 น. และ 20:10 น.

โปรดทราบว่าเนื่องจากช่วงเวลาปิดทำการ ช่วงเวลาที่เริ่มต้นเวลา 11.00 น. จะไม่ได้รับผลกระทบ

SchedulingRuleOverrides

กฎการตั้งเวลาระดับความพร้อมใช้งาน

ช่อง
last_bookable_sec

int64

เวลาล่าสุด (เป็นวินาที) ที่ช่วงเวลานี้จองได้ การประทับเวลานี้ต้องอยู่ก่อน start_sec ของสล็อต (หากผู้ใช้ควรจองได้หลังจากเวลาเริ่มต้น ให้ใช้ SchedulingRules.min_booking_before_end_time ระดับบริการ) หากมี จะลบล้างสิ่งที่ระบุไว้ใน min_booking_buffer ของ SchedulingRules ของบริการที่เกี่ยวข้อง

first_bookable_sec

int64

ครั้งแรก (เป็นวินาที) ที่จองช่วงเวลานี้ได้ การประทับเวลานี้ต้องอยู่ก่อน start_sec ของช่อง หรือ last_bookable_sec หากระบุ

last_online_cancellable_sec

int64

หากตั้งค่าไว้ เวลาล่าสุด (เป็นวินาทีนับตั้งแต่ Epoch ของ Unix) ที่ช่วงเวลาที่สะดวกสำหรับนัดหมายนี้จะยกเลิกได้ผ่านฟีเจอร์จองกับ Google ช่องนี้จะลบล้างกฎการยกเลิกระดับบริการ (ไม่บังคับ)

BatchDeleteGenericRecordsRequest

คำขอเป็นกลุ่มเพื่อลบระเบียนประเภทฟีดที่ระบุ

ช่อง
parent

string

ชื่อทรัพยากร ซึ่งมีรูปแบบ - partners/{partner_id}/feeds/{feed_name}

records[]

GenericDeleteRecord

ระเบียนที่จะถูกลบ อนุญาตระเบียนไม่เกิน 1,000 รายการในการเรียก API หนึ่งครั้ง

BatchPushGenericRecordRequest

คำขอแบบกลุ่มเพื่อแทรกและ/หรืออัปเดตระเบียนประเภทฟีดที่ระบุใน URL คำขอ

ช่อง
parent

string

ชื่อทรัพยากร ซึ่งมีรูปแบบ - partners/{partner_id}/feeds/{feed_name}

records[]

GenericRecord

ระเบียนที่จะแทรกและ/หรืออัปเดต อนุญาตระเบียนไม่เกิน 1,000 รายการในการเรียก API หนึ่งครั้ง

BatchReplaceServiceAvailabilityRequest

คำขอแบบกลุ่มที่จะแทนที่สล็อตเวลาว่างของ Service หลายช่อง

ช่อง
parent

string

รูปแบบของ partners/{partner_id}

extended_service_availability[]

ExtendedServiceAvailability

ความพร้อมใช้งานของบริการเสริมซึ่งใช้แทนที่สล็อตความพร้อมใช้งานที่มีอยู่

BatchReplaceServiceAvailabilityResponse

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

ช่อง
extended_service_availability[]

ExtendedServiceAvailability

ข้อความความพร้อมใช้งานของบริการเสริมที่อัปเดตเรียบร้อยแล้ว ซึ่งใช้ในการแทนที่สล็อตความพร้อมใช้งานที่มีอยู่

การจอง

การจองช่องพื้นที่โฆษณา

ช่อง
name

string

ชื่อทรัพยากรของการจอง: partners/{partner ID}/bookings/{booking ID}

merchant_id

string

รหัสของผู้ขายสำหรับช่อง

service_id

string

รหัสของบริการของผู้ขาย

start_time

Timestamp

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

duration

Duration

ระยะเวลาของช่วงการนัดหมาย

client_information

ClientInformation

ข้อมูลส่วนบุคคลของลูกค้าที่ทำการนัดหมาย

status

BookingStatus

สถานะการจอง

payment_information

PaymentInformation

ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับการจอง

party_size

int64

จำนวนแขกที่จอง

BookingFailure

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

ช่อง
cause

Cause

สาเหตุที่การจองล้มเหลว (ต้องระบุ)

rejected_card_type

CreditCardType

(จำเป็นเฉพาะในกรณีที่สาเหตุคือ PAYMENT_ERROR_CARD_TYPE_REJECTED )

description

string

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

payment_failure

PaymentFailureInformation

ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ

สาเหตุ

การแจงนับสาเหตุของความล้มเหลว

Enum
CAUSE_UNSPECIFIED ค่าเริ่มต้น: โปรดอย่าใช้ ทำให้เกิด "ข้อผิดพลาดที่ไม่ทราบสาเหตุ"
SLOT_UNAVAILABLE สล็อตความพร้อมจำหน่ายสินค้าที่อ้างอิงอยู่ไม่สามารถใช้ได้แล้ว
SLOT_ALREADY_BOOKED_BY_USER ผู้ใช้ได้จองการนัดหมายสำหรับช่วงเวลาว่างที่อ้างอิงแล้ว
LEASE_EXPIRED สัญญาเช่า (หากระบุ) หมดอายุแล้วและไม่สามารถนำมาใช้เพื่อทำการจองให้เสร็จสมบูรณ์ได้อีกต่อไป
OUTSIDE_CANCELLATION_WINDOW ไม่สามารถดำเนินการยกเลิกตามที่ขอได้ในขณะนี้ เนื่องจากข้อจำกัดด้านเวลาในนโยบายการยกเลิกของผู้ขาย
PAYMENT_ERROR_CARD_TYPE_REJECTED เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ประเภทบัตรเครดิตจะต้องระบุใน declined_card_type
PAYMENT_ERROR_CARD_DECLINED เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากบัตรเครดิตที่ระบุถูกปฏิเสธ
PAYMENT_OPTION_NOT_VALID พบข้อผิดพลาดเกี่ยวกับแพ็กเกจ/การเป็นสมาชิกที่ใช้ชำระค่าจอง ไม่มีการใช้งานที่ถูกต้องเหลืออยู่แล้ว อาจหมดอายุแล้ว ฯลฯ
PAYMENT_ERROR เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินสำหรับการจองนี้ ใช้ค่านี้เพื่อระบุข้อผิดพลาดทั่วไปเกี่ยวกับการชำระเงินในกรณีที่ข้อผิดพลาดไม่ตรงกับข้อผิดพลาดการชำระเงินที่เฉพาะเจาะจงข้างต้นเท่านั้น
USER_CANNOT_USE_PAYMENT_OPTION ผู้ใช้ไม่สามารถใช้ตัวเลือกการชำระเงินที่ระบุ (เช่น ผู้ใช้พยายามใช้ราคาครั้งแรกเป็นครั้งที่ 2)
BOOKING_ALREADY_CANCELLED การจองที่ผู้ใช้พยายามยกเลิกถูกยกเลิกแล้ว
BOOKING_NOT_CANCELLABLE การจองที่ผู้ใช้พยายามยกเลิกจะยกเลิกไม่ได้
OVERLAPPING_RESERVATION ผู้ใช้มีการจองที่ใกล้กับเวลานี้มากเกินไป
USER_OVER_BOOKING_LIMIT จองไม่สําเร็จเนื่องจากผู้ใช้มีการจองต่อผู้ใช้เกินขีดจํากัด
PAYMENT_REQUIRES_3DS1

กำหนดเมื่อการชำระเงินถูกปฏิเสธเนื่องจากคุณขอให้ลองทำธุรกรรมอีกครั้ง แต่ครั้งนี้หลังจากดำเนินการทดสอบ/ตอบกลับ 3DS1 โปรดทราบว่าสถานะการดำเนินการไม่สำเร็จของธุรกรรมปัจจุบันจะยังคงล้มเหลวต่อไป ทั้งนี้ การลองใหม่จะแยกจากกันโดยสิ้นเชิง

หากนี่เป็นเหตุผลที่ล้มเหลว ต้องตั้งค่า payment_failure.3DS1_parameters หากไม่เป็นเช่นนั้น สาเหตุปัจจุบันจะถือเป็น PAYMENT_ERROR

PaymentFailureInformation

ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ

ช่อง
threeds1_parameters

ThreeDS1Parameters

พารามิเตอร์ที่ผู้รวบรวมข้อมูล RwG ใช้เพื่อเริ่มต้นโปรโตคอลการตรวจสอบสิทธิ์ 3DS1 กับผู้ใช้ จะถูกละเว้นเว้นแต่ตั้งค่า BookingFailure.cause เป็น PAYMENT_REQUIRES_3DS1

ThreeDS1Parameters

พารามิเตอร์ที่ขอให้ RwG ดำเนินการทดสอบ 3DS1

พารามิเตอร์กำหนดตามคำอธิบายโปรโตคอล 3DS1 ของ EMVCo

ช่อง
acs_url

string

URL ที่จะใช้โหลดฟอร์มเพื่อนำเสนอแก่ผู้ใช้สำหรับการตรวจสอบสิทธิ์

pa_req

string

คำขอ PaymentAuthentication โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี

transaction_id

string

ตัวระบุที่ผู้ให้บริการ ACS ใช้ โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี

md_merchant_data

string

ข้อมูลผู้ขาย โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี

BookingStatus

สถานะการจอง

Enum
BOOKING_STATUS_UNSPECIFIED ไม่ได้ระบุ
CONFIRMED ยืนยันการจองแล้ว
PENDING_MERCHANT_CONFIRMATION การจองกำลังรอการยืนยันจากผู้ขายก่อนที่จะเปลี่ยนสถานะเป็น "ยืนยันแล้ว" (ยังไม่รองรับในขณะนี้)
PENDING_CLIENT_CONFIRMATION การจองกำลังรอการยืนยันจากลูกค้าก่อนจึงจะเปลี่ยนสถานะเป็น "ยืนยันแล้ว" (ยังไม่รองรับในขณะนี้)
CANCELED ระบบยกเลิกการจองในนามของผู้ใช้แล้ว
NO_SHOW ลูกค้าไม่ได้แสดงสำหรับการนัดหมายนี้
NO_SHOW_PENALIZED ลูกค้าไม่ได้แสดงการนัดหมายเนื่องจากละเมิดนโยบายการยกเลิก
FAILED จองไม่สำเร็จเนื่องจากประมวลผลไม่สำเร็จ
DECLINED_BY_MERCHANT ผู้ขายปฏิเสธการจองแบบไม่พร้อมกัน

CallMerchant

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

CancellationPolicy

นโยบายการยกเลิกสำหรับบริการ

ช่อง
refund_condition[]

RefundCondition

ไม่มีเงื่อนไขการคืนเงินหรือมากกว่านั้นที่เกี่ยวข้องกับนโยบาย

RefundCondition

กำหนดเงื่อนไขการคืนเงินรายการเดียว สามารถใช้เงื่อนไขการคืนเงินหลายรายการร่วมกันเพื่ออธิบาย "ขั้นตอนการคืนเงิน" ได้ เป็นช่วงเวลาต่างๆ ก่อนเวลาเริ่มต้นบริการ

ช่อง
min_duration_before_start_time

Duration

ระยะเวลาก่อนเวลาเริ่มต้น จนถึงเวลาที่ลูกค้าขอเงินคืนสำหรับค่าบริการบางส่วนที่ระบุใน refund_percent ได้ เมื่อตั้งค่าเป็น 0 (ค่าเริ่มต้น) บริการยกเลิกได้ทุกเมื่อ

refund_percent

uint32

เปอร์เซ็นต์ที่คืนเงินได้ ตราบใดที่มีการยกเลิกการจองบริการอย่างน้อย min_duration_before_start_time ก่อนเวลาเริ่มต้นบริการ โดยอยู่ในช่วง [0, 100] เมื่อตั้งค่าเป็น 0 (ค่าเริ่มต้น) บริการจะขอเงินคืนไม่ได้ เมื่อตั้งค่าเป็น 100 คุณจะขอคืนเงินบริการนี้เต็มจำนวนได้

ClientInformation

ข้อมูลส่วนบุคคลเกี่ยวกับผู้ที่ทำการจอง

ช่อง
given_name

string

ชื่อของลูกค้า

family_name

string

นามสกุลของลูกค้า

address

PostalAddress

ที่อยู่ของลูกค้า

telephone

string

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

email

string

อีเมลของลูกค้า

CreateMerchantRequest

คำขอสร้าง Merchant

ช่อง
parent

string

ชื่อทรัพยากรระดับบนสุดสำหรับพาร์ทเนอร์ที่เป็นเจ้าของผู้ขายรายนี้ในรูปแบบ partners/{partner_id}

merchant_id

string

รหัสผู้ขายที่จะใช้สำหรับผู้ขายรายนี้

merchant

Merchant

ผู้ขายที่จะสร้าง

CreateServiceRequest

คำขอสร้าง Service ใหม่

ช่อง
parent

string

ชื่อทรัพยากรระดับบนสุดสำหรับผู้ขายที่เป็นเจ้าของบริการนี้ในรูปแบบ partners/{partner_id}/merchants/{merchant_id}

service_id

string

รหัสบริการที่จะใช้สำหรับบริการนี้

service

Service

บริการที่จะสร้าง

CreditCardRestrictions

ข้อจำกัดเกี่ยวกับประเภทบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ

ช่อง
credit_card_type[]

CreditCardType

รายการบัตรเครดิตที่รองรับ ไม่มีบัตรเครดิตที่รองรับหากไม่มีข้อมูล

CreditCardType

ประเภทบัตรเครดิต

Enum
CREDIT_CARD_TYPE_UNSPECIFIED ไม่ได้ใช้งาน
VISA บัตรเครดิต Visa
MASTERCARD บัตรเครดิต Mastercard
AMERICAN_EXPRESS บัตรเครดิต American Express
DISCOVER บัตรเครดิต Discover
JCB บัตรเครดิต JCB

DeleteMerchantRequest

คำขอลบ Merchant

ช่อง
name

string

ชื่อทรัพยากรของผู้ขายที่จะลบ ในรูปแบบของพาร์ทเนอร์/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

คำขอลบ Service

ช่อง
name

string

ชื่อทรัพยากรของบริการที่จะลบ ในรูปแบบ partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

เงินฝาก

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

ช่อง
deposit

Price

จำนวนเงินฝาก

min_advance_cancellation_sec

int64

การยกเลิกล่วงหน้าขั้นต่ำสำหรับการฝากเงิน

deposit_type

PriceType

กำหนดวิธีการระบุเงินฝากจากความพร้อมจำหน่ายสินค้า

DirectMerchantPayment

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

ช่อง
payment_methods[]

Text

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

DurationRange

Wrapper สำหรับช่วงระยะเวลาที่สามารถจำกัดขอบเขตหรือไม่มีขอบเขตได้ ต้องระบุระยะเวลา min_duration และ max_duration อย่างน้อย 1 รายการ

ช่อง
min_duration

Duration

ระยะเวลาขั้นต่ำ

max_duration

Duration

ระยะเวลาสูงสุด

ExtendedServiceAvailability

รายการเวลาว่างและบุคคลที่ควรใช้

ช่อง
merchant_id

string

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

service_id

string

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

start_time_restrict

Timestamp

หากมี เราจะถือว่าเอนทิตีความพร้อมจำหน่ายสินค้าที่ระบุเป็นภาพรวมที่สมบูรณ์ตั้งแต่ [start_time_restrict, end_time_restrict) ซึ่งหมายความว่าระบบจะลบความพร้อมจำหน่ายสินค้าที่มีอยู่ทั้งหมดออกหากเงื่อนไขต่อไปนี้เป็นจริง

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

หากมีการตั้งค่าข้อความระยะเวลา เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้

  availability.duration == duration_restrict

หากมีการตั้งค่าข้อความ resource_restrict เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

การตั้งค่า start_time_restrict ขณะไม่ตั้งค่า end_time_restrict จะตีความว่าหมายถึงเวลาทั้งหมดเริ่มต้นที่ start_time_restrict

end_time_restrict

Timestamp

ระบบจะตีความการตั้งค่า end_time_restrict ขณะไม่ตั้งค่า start_time_restrict ว่าเป็นการตั้งค่าตั้งแต่ต้นจนถึง end_time_restrict เลย

duration_restrict

Duration

การตั้งค่าระยะเวลายังจํากัดขอบเขตของการอัปเดตไว้ที่ความพร้อมใช้งานซึ่งมีระยะเวลาตรงกันเท่านั้น

resources_restrict

Resources

การตั้งค่า resource_restrict จะจำกัดขอบเขตของการอัปเดตเพิ่มเติมไว้สำหรับทรัพยากรชุดนี้เท่านั้น ช่องรหัสทั้งหมดของทรัพยากรต้องตรงกันทั้งหมด

availability[]

Availability

รายการความพร้อมใช้งานใหม่

FeedStatistics

สถิติที่ได้รับขณะประมวลผลฟีดที่อัปโหลด

ช่อง
new_items

int64

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

existing_items

int64

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

deleted_items

int64

สินค้าไม่แสดงในฟีดนี้แล้วและระบบได้นำออกไปแล้ว

FeedStatus

สถานะของฟีดที่อัปโหลดโดยแพลตฟอร์มของผู้รวบรวมข้อมูล

ช่อง
name

string

ชื่อทรัพยากรฟีด ซึ่งมีรูปแบบเป็น

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}
state

State

สถานะการประมวลผลของฟีดนี้

error_details

string

สตริงที่มนุษย์อ่านได้ซึ่งจะให้รายละเอียดเพิ่มเติมหากประมวลผลฟีดนี้ไม่สำเร็จ

statistics

FeedStatistics

สถิติเฉพาะสำหรับฟีดนี้

รัฐ

Enum เพื่อระบุสถานะการประมวลผลของฟีด

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น ไม่ได้ใช้งาน
IN_PROGRESS ระบบยังคงประมวลผลฟีดอยู่
SUCCESS ประมวลผลฟีดเรียบร้อยแล้ว
FAILURE เราพบข้อผิดพลาดขณะประมวลผลฟีด

FoodOrderingMetadata

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

ช่อง
fee_details[]

FeeDetails

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

advance_order_details

AdvanceOrderDetails

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

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

Duration

ระยะเวลาคงที่ เช่น 30 นาที

fulfillment_lead_time_duration_range

DurationRange

ช่วงของระยะเวลา ตัวอย่าง: * 30 ถึง 45 นาที * มากกว่า 30 นาที * น้อยกว่า 50 นาที

AdvanceOrderDetails

สำหรับการสนับสนุนการสั่งล่วงหน้า

ช่อง
is_supported

bool

เป็นจริงหากระบบรองรับ "คำสั่งซื้อล่วงหน้า" หรือที่เรียกว่า "สั่งล่วงหน้า" (ต้องระบุ)

FeeDetails

รายละเอียดค่าธรรมเนียม

ช่อง
type

FeeType

ประเภทค่าธรรมเนียม (ต้องระบุ)

fee_amount

FeeAmount

จำนวนเงินค่าธรรมเนียมในสกุลเงินของหน่วย เปอร์เซ็นต์ของมูลค่าในรถเข็น หรือทั้ง 2 อย่างรวมกัน (ต้องระบุ)

FeeAmount

FeeAmount ตัวอย่าง: * ค่าธรรมเนียมคงที่: USD 0 (ไม่มีค่าธรรมเนียม), USD 1.5 * ช่วงค่าธรรมเนียมคงที่: USD 1.0 (ขั้นต่ำ), USD 3.0 (สูงสุด), USD 5.0-6.0 * เปอร์เซ็นต์ของขนาดรถเข็น: 15.5%, 10%-20%, 10% (ขั้นต่ำ), 15% (สูงสุด) * 25% (สูงสุด) * 25% และเปอร์เซ็นต์รวมกัน USD 2.5 (ขั้นต่ำ), 25.5% และ USD 4.5 (สูงสุด), 10% และ USD 1.5-2.5, 10.5%-20% และ USD 2.5-3.5

ช่อง
cart_percentage

QuantitativeValue

ค่าธรรมเนียมเป็นเปอร์เซ็นต์ของมูลค่าในรถเข็น รองรับช่วง (แบบมีขอบเขตและไม่มีขอบเขต) หรือเปอร์เซ็นต์คงที่ ค่าควรอยู่ระหว่าง 0 ถึง 100 ตัวอย่าง: * คงที่ 5.5% * อย่างน้อย 5.5% * สูงสุด 5.5% * 4.5% ถึง 5.5%

ช่องการรวม amount_options ตัวเลือกในการระบุจำนวนเงิน amount_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
amount

Money

จำนวนเงินที่กำหนด เช่น USD 3.5

amount_range

MoneyRange

ช่วงของจำนวน ตัวอย่าง: * USD 3.5 ถึง USD 5.5 * อย่างน้อย USD 3.5 * สูงสุด USD 5.5

amount_unknown

bool

ไม่ทราบจำนวนเงิน

FeeType

ประเภทค่าธรรมเนียม

Enum
FEE_TYPE_UNSPECIFIED ยังไม่ระบุประเภทค่าธรรมเนียม
DELIVERY สำหรับค่าจัดส่ง
SERVICE สำหรับค่าบริการ

FulfillmentOption

ตัวเลือกการดำเนินการตามคำสั่งซื้อสำหรับลิงก์การดำเนินการสั่งซื้อออนไลน์

ช่อง
fulfillment_type

FulfillmentType

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

available_day[]

AvailableDay

ต้องระบุ รายการวันที่พร้อมใช้งานสำหรับวิธีการดำเนินการตามคำสั่งซื้อนี้ (แนะนำอย่างน้อย 2 วัน)

fee_details

FeeDetails

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

minimum_order

Price

ต้องระบุ คำสั่งซื้อขั้นต่ำสำหรับวิธีดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ

AvailableDay

ความพร้อมใช้งานระดับวัน

ช่อง
fulfillment_date

Date

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

last_ordering_time

Timestamp

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

ตัวอย่างเช่น หาก fulfillment_date เป็น 2020-08-10: - ค่า last_ordering_time เป็น 2020-08-10 18:00 หมายความว่า ลูกค้าจะต้องสั่งซื้อภายใน 18:00 น. ของวันเดียวกันจึงจะได้รับคำสั่งซื้อในวันที่ 10-08-2020 - ค่า last_ordering_time เท่ากับ 2020-08-08 20:00 หมายความว่าเพื่อให้ได้รับคำสั่งซื้อในวันที่ 10-08-2020 ลูกค้าจะต้องสั่งซื้อภายใน 20:00 น. ล่วงหน้า 2 วัน

FeeDetails

รายละเอียดค่าธรรมเนียมสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ

ช่อง
ช่องการรวม fee_details รูปแบบค่าธรรมเนียมสำหรับวิธีการดำเนินการตามคำสั่งซื้อ fee_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
no_fee

NoFee

ไม่มีค่าธรรมเนียมสำหรับวิธีการดำเนินการตามคำสั่งซื้อ

base_fee

MinimumFee

ค่าธรรมเนียมพื้นฐานที่เชื่อมโยงกับวิธีการดำเนินการตามคำสั่งซื้อ

fixed_fee

FixedFee

ค่าธรรมเนียมคงที่ที่เชื่อมโยงกับวิธีการดำเนินการตามคำสั่งซื้อ

FixedFee

ค่าธรรมเนียมคงที่ที่จำเป็นสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ

ช่อง
amount

Price

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

FulfillmentType

ประเภทการจำหน่ายที่เชื่อมโยงกับลิงก์การดำเนินการ

Enum
FULFILLMENT_TYPE_UNSPECIFIED ไม่มีการระบุประเภทการดำเนินการตามคำสั่งซื้อ
FULFILLMENT_TYPE_DELIVERY ประเภทการดำเนินการตามคำสั่งซื้อคือการนำส่ง
FULFILLMENT_TYPE_PICKUP ประเภทการดำเนินการตามคำสั่งซื้อคือการรับสินค้า

MinimumFee

ค่าธรรมเนียมขั้นต่ำที่จำเป็นสำหรับวิธีดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ

ช่อง
base_fee_amount

Price

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

NoFee

ไม่มีค่าธรรมเนียมสำหรับวิธีดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ

GenericDeleteRecord

บันทึกที่จะถูกลบของประเภทฟีดที่กล่าวถึงในคำขอ URL

ช่อง
delete_time

Timestamp

ต้องระบุ การประทับเวลานี้ใช้เพื่อกำหนดลำดับการลบไปยังพื้นที่โฆษณา

ช่องการรวม record_type รวมฟีดประเภทต่างๆ (ndjson, แบบ Proto ฯลฯ) พาร์ทเนอร์สามารถระบุระเบียนแบบเต็มในลักษณะเดียวกับการระบุระเบียนในฟีดหรือ BatchPush API นอกจากนี้ พาร์ทเนอร์ยังมีตัวเลือกในการใส่เฉพาะช่องที่จำเป็นของระเบียนซึ่งจำเป็นต่อการระบุช่องแบบไม่ซ้ำกัน record_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
data_record

bytes

สำหรับฟีดที่ไม่ได้สร้างโปรโต

proto_record

Any

สำหรับฟีดที่อิงตามโปรโต

GenericRecord

บันทึกของประเภทฟีดที่กล่าวถึงในคำขอ URL

ช่อง
generation_timestamp

Timestamp

ต้องระบุ การประทับเวลานี้ใช้เพื่อตรวจสอบลำดับการอัปเดตสินค้าคงคลังที่ถูกต้อง

ช่องการรวม record_type รวมฟีดประเภทต่างๆ (ndjson, แบบ Proto ฯลฯ) record_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
data_record

bytes

สำหรับฟีดที่ไม่ได้สร้างโปรโต

proto_record

Any

สำหรับฟีดที่อิงตามโปรโต

GeoCoordinates

ข้อมูลทางภูมิศาสตร์ของสถานที่ตั้ง เช่น ละติจูด ลองจิจูด และที่อยู่

ช่อง
latitude

double

ละติจูด หน่วยเป็นองศา (ไม่บังคับ)

longitude

double

ลองจิจูด เป็นองศา (ไม่บังคับ)

ช่องการรวม addresses ที่อยู่ของสถานที่ตั้งอาจเป็นแบบมีโครงสร้างหรือไม่มีโครงสร้าง addresses ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
address

PostalAddress

ที่อยู่ทางไปรษณีย์ของสถานที่ (แนะนำ)

unstructured_address

string

อาจมีที่อยู่ที่ไม่มีโครงสร้างไว้เป็นที่อยู่สำรองก็ได้ เช่น "1600 แอมฟิเธียเตอร์ พาร์คเวย์ เมาน์เทนวิว แคลิฟอร์เนีย 94043"

GetMerchantStatusRequest

คำขอเพื่อรับ MerchantStatus

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรในรูปแบบของพาร์ทเนอร์/{partner_id}/merchants/{merchant_id}/status

GetStatusRequest

คำขอเรียกข้อมูล Status สำหรับฟีดเฉพาะที่อัปโหลดโดยแพลตฟอร์มของผู้รวบรวมข้อมูล

ช่อง
name

string

ชื่อทรัพยากรฟีด ซึ่งมีรูปแบบเป็น

  • partners/{partner_id}/feeds/merchants/{file_name}
  • partners/{partner_id}/feeds/services/{file_name}
  • partners/{partner_id}/feeds/availability/{file_name}

HomeServiceData

ต้องระบุข้อมูลเพิ่มเติมสำหรับประเภทธุรกิจบริการเกี่ยวกับบ้าน

ช่อง
category_type

string

หมวดหมู่ระดับสูงที่มีบริการเกี่ยวกับบ้านนี้ เช่น ช่างประปา ไฟฟ้า ฯลฯ

job_type

string

ประเภทงานตามหมวดหมู่ที่มีบริการเกี่ยวกับบ้านนั้นๆ เช่น unclog_drain, install_faucet เป็นประเภทงานภายใต้หมวดหมู่ช่างประปา

IntegrationType

รองรับความลึกของการผสานรวม

Enum
INTEGRATION_TYPE_UNSPECIFIED ค่าเริ่มต้นคือ END_TO_END
INTEGRATION_TYPE_END_TO_END การผสานรวมครบวงจรที่ช่วยให้จองผ่าน Google ได้ตั้งแต่ต้นจนจบ
INTEGRATION_TYPE_INVENTORY_ONLY เซิร์ฟเวอร์การจองไม่จำเป็นต้องรองรับบริการนี้ คุณต้องส่งเฉพาะผู้ขาย บริการ และ (ไม่บังคับ) ข้อมูลความพร้อมจำหน่ายสินค้า

InvalidateResourceRequest

คำขอทำให้ทรัพยากรเป็นโมฆะ

ช่อง
resource_id

string

ชื่อของทรัพยากรที่จะใช้งานไม่ได้

ตัวอย่างเช่น ชื่อสำหรับแหล่งข้อมูลการรับสินค้าควรอยู่ในรูปแบบ partners/{partner_id}/pickups/{pickup_id} การใช้งานต้องนำทรัพยากรที่ระบุในเวอร์ชันที่แคชไว้ออก

LineItem

รายการเดียวในคำสั่งซื้อ ได้แก่ การจองบริการเดียวในช่วงเวลาเดียว

ช่อง
service_id

string

รหัสของบริการของผู้ขาย

start_sec

int64

เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมายในหน่วยวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch

duration_sec

int64

ระยะเวลาของช่วงการนัดหมายเป็นวินาที

tickets[]

OrderedTickets

จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว

price

Price

ราคารวม (ไม่รวมภาษี) ของรายการโฆษณานี้

status

BookingStatus

สถานะของรายการโฆษณา

OrderedTickets

จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว

ช่อง
ticket_id

string

รหัสประเภทตั๋ว

count

int32

จำนวนตั๋วที่สั่งซื้อสำหรับประเภทนี้

ListMerchantStatusesRequest

คำขอเรียกดูรายการ MerchantStatus

ช่อง
parent

string

ต้องระบุ ระดับบนสุดซึ่งเป็นเจ้าของคอลเล็กชันสถานะผู้ขายนี้ รูปแบบ: partners/{partner_id}/merchants

page_size

int32

ต้องระบุ จำนวนรายการสูงสุดที่จะแสดง โปรดทราบว่าเซิร์ฟเวอร์อาจลดขนาดหน้าเว็บ

page_token

string

ไม่บังคับ ค่า nextPageToken ที่แสดงผลจาก ListMerchantStatusResponse ก่อนหน้า หากมี

booking_inventory_status_restrict

BookingInventoryStatus

ไม่บังคับ ข้อจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะพื้นที่โฆษณาการจอง

waitlist_inventory_status_restrict

WaitlistInventoryStatus

ไม่บังคับ การจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะสินค้าคงคลังในคิวรอ

geo_match_restrict

GeoMatchingStatus

ไม่บังคับ ข้อจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะการจับคู่ทางภูมิศาสตร์

BookingInventoryStatus

สถานะพื้นที่โฆษณาการจองจากต้นทางถึงปลายทาง

Enum
BOOKING_INVENTORY_STATUS_UNSPECIFIED ไม่ได้ระบุ
NO_VALID_FUTURE_INVENTORY ผู้ขายไม่มีสินค้าคงคลังสำหรับการจองในอีก 30 วันข้างหน้า
HAS_VALID_FUTURE_INVENTORY ผู้ขายมีพื้นที่โฆษณาการจองในอีก 30 วันข้างหน้า

GeoMatchingStatus

สถานะการจับคู่ทางภูมิศาสตร์ของผู้ขาย

Enum
GEO_MATCHING_STATUS_UNSPECIFIED ไม่ได้ระบุ
GEO_UNMATCHED ผู้ขายไม่ตรงกับข้อมูลทางภูมิศาสตร์
GEO_MATCHED ผู้ขายมีการจับคู่ทางภูมิศาสตร์

WaitlistInventoryStatus

สถานะสินค้าคงคลังสำหรับคิวรอแบบครบวงจร

Enum
WAITLIST_INVENTORY_STATUS_UNSPECIFIED ไม่ได้ระบุ
NO_VALID_WAITLIST_SERVICE ผู้ขายไม่มีคิวรอที่รองรับบริการ
HAS_VALID_WAITLIST_SERVICE ผู้ขายมีคิวรอรองรับบริการ

ListMerchantStatusesResponse

การตอบกลับรายการ MerchantStatus

ช่อง
merchant_statuses[]

MerchantStatus

รายการสถานะผู้ขายที่ตรงตามเงื่อนไขตัวกรอง

next_page_token

string

โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป ไม่มีผลลัพธ์เพิ่มเติมในรายการหากไม่มีข้อมูล

ListStatusRequest

คำขอเรียกข้อมูล Status สำหรับฟีดหลายรายการที่อัปโหลดโดยแพลตฟอร์มของผู้รวบรวมข้อมูล

ช่อง
name

string

ชื่อทรัพยากรฟีด ซึ่งมีรูปแบบเป็น

  • partners/{partner_id}/feeds/merchants
  • partners/{partner_id}/feeds/services
  • partners/{partner_id}/feeds/availability
page_size

int32

จำนวนรายการสูงสุดที่จะแสดง

page_token

string

ค่า next_page_token ที่ส่งกลับมาจากคำขอรายการก่อนหน้า หากมี

state_restrict

State

จำกัดตัวเลือกเพื่อกรองผลลัพธ์ตามสถานะฟีด

time_range_restrict

TimeRange

เลือกจำกัดเพื่อกรองผลลัพธ์ตามขอบเขตบนและล่าง หากไม่ได้ตั้งค่า start_time ค่าเริ่มต้นจะเป็นเวลาเริ่มต้นของ Unix หากไม่ได้ตั้งค่า end_time ไว้ ระบบจะเลือกค่าเริ่มต้นเป็นตอนนี้

ListStatusResponse

คำขอเรียกข้อมูล Status สำหรับฟีดหลายรายการที่อัปโหลดโดยแพลตฟอร์มของผู้รวบรวมข้อมูล

ช่อง
status[]

FeedStatus

ย้อนกลับรายการสถานะสำหรับฟีดที่อัปโหลด จำนวนรายการสูงสุดที่แสดงผลได้ขึ้นอยู่กับช่อง page_size ในคำขอ

next_page_token

string

โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป ไม่มีผลลัพธ์เพิ่มเติมในรายการหากไม่มีข้อมูล

LocalizedString

อินสแตนซ์ของสตริงในภาษาหนึ่ง

ช่อง
locale

string

รหัสภาษา IETF BCP 47 เช่น "en", "mas", "zh-Hant", "de-CH-1901" โปรดดู http://www.w3.org/International/articles/language-tags/

value

string

ข้อความในภาษาด้านบน (UTF-8)

ตำแหน่ง

ข้อมูลทางภูมิศาสตร์เกี่ยวกับสถานที่ตั้ง

ช่อง
place_id

string

รหัสสถานที่ของสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id หากมีการระบุ Google จะจับคู่ตำแหน่งกับสถานที่นี้

name

string

ระบบจะใช้ชื่อตำแหน่ง, โทรศัพท์, URL และภูมิศาสตร์ของตำแหน่งเพื่อรองรับการจับคู่ตำแหน่งกับสถานที่ต่างๆ ที่มีอยู่แล้วใน Google Maps

ช่องนี้ไม่บังคับ แต่อาจต้องระบุในบางบริบท ตัวอย่างเช่น Service.location ที่ไม่มีชื่อจะไม่จับคู่กับองค์กรธุรกิจ แม้ว่าบริการดังกล่าวจะตั้งอยู่ที่ที่อยู่เดียวกันก็ตาม (ไม่บังคับ)

telephone

string

หมายเลขโทรศัพท์สาธารณะของสถานที่ตั้ง รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 (ไม่บังคับ)

url

string

URL เว็บไซต์สาธารณะของสถานที่นั้น (ไม่บังคับ)

geo

GeoCoordinates

ข้อมูลทางภูมิศาสตร์ของตำแหน่ง เช่น ละติจูด ลองจิจูด และที่อยู่ (ไม่บังคับ)

location_type

LocationType

ต้องระบุประเภทของตำแหน่งหากมีการให้ตำแหน่งนี้สำหรับบริการ

location_id

string

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

LocationType

ประเภทของสถานที่นี้

Enum
LOCATION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทสถานที่ตั้ง
VISITED_LOCATION ตำแหน่งที่บริการนี้เข้าชม
START_LOCATION ตำแหน่งที่บริการนี้เริ่มต้นยังแสดงเป็น MEETING_LOCATION ด้วย
END_LOCATION สถานที่ที่บริการนี้สิ้นสุดลง

ผู้ขาย

ข้อมูลเกี่ยวกับผู้ขายที่อยู่บนแพลตฟอร์มของผู้รวบรวมข้อมูล

ช่อง
name

string

ชื่อทรัพยากรผู้ขาย ซึ่งมีรูปแบบ partners/{partner_id}/merchants/{merchant_id}

merchant_name

string

ระบบใช้ Merchant_name, โทรศัพท์, URL และภูมิศาสตร์เพื่อรองรับการจับคู่สินค้าคงคลังของพาร์ทเนอร์กับผู้ขายที่มีอยู่ใน Google Maps อยู่แล้ว ข้อมูลนี้จะไม่แสดง

ชื่อผู้ขาย

telephone

string

หมายเลขโทรศัพท์สาธารณะของผู้ขาย รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234

url

string

URL ของเว็บไซต์สาธารณะของผู้ขาย

geo

GeoCoordinates

ข้อมูลทางภูมิศาสตร์ของผู้ขาย รวมถึงละติจูด ลองจิจูด และที่อยู่

category

string

หมวดหมู่ของธุรกิจในแพลตฟอร์มของผู้รวบรวมข้อมูล

num_bookings_30d
(deprecated)

int64

ช่องนี้เลิกใช้งานแล้ว

tax_rate_basis_points
(deprecated)

uint32

อัตราภาษีของผู้ขายเป็นคะแนนพื้นฐาน (100 ของเปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 7.5% ช่องนี้ควรตั้งค่าเป็น 750

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

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

ช่องนี้เลิกใช้งานแล้ว โปรดใช้tax_rate แทน

tax_rate

TaxRate

อัตราภาษีของผู้ขาย หากมีช่องนี้จะลบล้างช่อง Tax_rate_basis_points ที่เลิกใช้งานแล้ว ข้อความว่างเปล่า (เช่น อัตราภาษี { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0

payment_restrictions

PaymentRestrictions

ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ เราถือว่าไม่มีข้อจำกัดหากไม่ได้ตั้งค่าช่องนี้

payment_option[]

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config

TokenizationConfig

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

terms

Terms

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

brand_id

string

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

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

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

หากพาร์ทเนอร์...

หากไม่มีแบรนด์สำหรับผู้บริโภคหลายแบรนด์ --&gt; ละเว้นช่องนี้

มีแบรนด์หลายรายการที่กำหนดค่าไว้หรือไม่

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

หมายเหตุ: พาร์ทเนอร์ส่วนใหญ่ไม่จำเป็นต้องตั้งค่าช่องนี้ หากพาร์ทเนอร์ต้องการใช้ช่องนี้ พาร์ทเนอร์ต้องติดต่อเราก่อนเพื่อกำหนดค่าแบรนด์แยกกัน รวมถึงแบรนด์เริ่มต้น

matching_hints

MerchantMatchingHints

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

service_attribute[]

ServiceAttribute

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

waitlist_advisement

Advisement

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

MerchantMatchingHints

คำแนะนำที่ใช้เพื่อช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps

ช่อง
place_id

string

รหัสสถานที่ของสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id

MerchantStatus

สถานะผู้ขายในแพลตฟอร์ม "จองกับ Google"

ช่อง
name

string

ชื่อทรัพยากรสถานะผู้ขาย ซึ่งมีรูปแบบเป็น partners/{partner_id}/merchants/{merchant_id}/status

merchant_name

string

ชื่อผู้ขายที่พาร์ทเนอร์ระบุไว้

input_geo_info

GeoCoordinates

พาร์ทเนอร์ให้ข้อมูลทางภูมิศาสตร์ของผู้ขาย

processing_status

ProcessingStatus

สถานะการประมวลผลของผู้ขาย

booking_status

BookingStatus

สถานะที่เกี่ยวข้องกับการผสานรวมการจองจากต้นทางถึงปลายทาง

waitlist_status

WaitlistStatus

สถานะที่เกี่ยวข้องกับการผสานรวมคิวรอ

geo_match

PlaceInfo

สถานที่ตั้งทางภูมิศาสตร์ที่ตรงกันของผู้ขายรายนี้ เว้นว่างไว้หากผู้ขายไม่ตรงกับข้อมูลทางภูมิศาสตร์

local_services_match

LocalServicesMatchInfo

การจับคู่โฆษณาบริการในพื้นที่ของผู้ขายรายนี้ เว้นว่างไว้หากไม่ใช่ผู้ขายที่ให้บริการในพื้นที่หรือไม่ตรงกับผู้ให้บริการใดเลย

direct_urls[]

DirectUrl

รายการ URL สำหรับแสดงเนื้อหาของสินค้าคงคลังของผู้ขายปัจจุบัน โปรดทราบว่าไม่ได้หมายความว่าพื้นที่โฆษณากำลังแสดงอยู่จริง และ URL อาจแตกต่างจาก URL สาธารณะที่ปรากฏ

BookingStatus

สถานะที่เกี่ยวข้องกับการผสานรวมการจองจากต้นทางถึงปลายทาง

ช่อง
has_valid_future_inventory

bool

เป็นจริงหากผู้ขายมีสินค้าคงคลังภายใน 30 วันข้างหน้า ไม่ได้รับประกันว่าผู้ขายจะได้แสดงโฆษณาจริง

DirectUrl

URL ที่แสดงผู้ขาย

ช่อง
type

UrlType

ประเภทของ URL นี้

url

string

URL ที่อาจแสดงผู้ขายรายนี้

UrlType

ประเภทของ URL ที่แสดงขึ้น

Enum
URL_TYPE_UNSPECIFIED ไม่ได้ระบุ
BOOKING URL การจองจากต้นทางถึงปลายทาง
WAITLIST URL คิวรอตั้งแต่ต้นจนจบ
LOCAL_SERVICES URL ของบริการในพื้นที่ของ Google

LocalServicesMatchInfo

การจับคู่ข้อมูลบริการในพื้นที่ของ Google ที่ตรงกัน (ตั้งสำหรับผู้ขายบริการในพื้นที่เท่านั้น)

ช่อง
matched_providers[]

MatchedProvider

ผู้ให้บริการที่ตรงกัน ระบบจับคู่ผู้ขายกับผู้ให้บริการหลายรายได้

MatchedProvider

ผู้ให้บริการในพื้นที่

ช่อง
customer_id

int64

รหัสลูกค้าภายนอกของบริการในพื้นที่ของ Google

categories[]

string

หมวดหมู่บริการในพื้นที่ (ประเภทธุรกิจ) เช่น "ช่างประปา" และ "carpet_cleaning"

PlaceInfo

ข้อมูลของสถานที่ที่ตรงกัน

ช่อง
name

string

ชื่อสถานที่

formatted_address

string

ที่อยู่ที่จัดรูปแบบเป็นภาษาท้องถิ่น

place_id

string

รหัส Google Place ของสถานที่นี้ สามารถใช้เพื่อสร้าง URL ของ Google Maps หรือเรียกดูรายละเอียดเพิ่มเติมของสถานที่ ดูตัวอย่างการใช้งานได้ที่ https://developers.google.com/places/web-service/place-id

ProcessingStatus

สถานะการประมวลผลของผู้ขาย

Enum
PROCESSING_STATUS_UNSPECIFIED ไม่ระบุสถานะ
IN_PROGRESS Madden ได้รับผู้ขายแล้ว แต่ยังอยู่ระหว่างการดำเนินการ ผู้ขายที่อยู่ในสถานะนี้จะไม่มีการแสดงสถานะอื่นๆ
COMPLETED สถานะอื่นๆ ของผู้ขายได้รับการคำนวณ

WaitlistStatus

สถานะที่เกี่ยวข้องกับการผสานรวมคิวรอ

ช่อง
has_valid_waitlist_service

bool

เป็นจริงหากผู้ขายมีบริการคิวรอ ไม่ได้รับประกันว่าผู้ขายจะได้แสดงโฆษณาจริง

MoneyRange

Wrapper สำหรับช่วงจำนวนเงินที่ไม่ได้มีการควบคุมหรือไม่มีการควบคุม ต้องระบุ min_amount และ max_amount อย่างน้อย 1 รายการ

ช่อง
min_amount

Money

จำนวนเงินขั้นต่ำ

max_amount

Money

จำนวนสูงสุด

NoShowFee

ค่าธรรมเนียมที่ผู้ใช้อาจเรียกเก็บหากทำการจองแล้วแต่ไม่ปรากฏ

ช่อง
fee

Price

จำนวนเงินที่ผู้ใช้อาจเรียกเก็บหากพวกเขาไม่ปรากฏสำหรับการจอง

fee_type

PriceType

ระบุค่าธรรมเนียมที่เรียกเก็บจากความพร้อมจำหน่ายสินค้า

สั่งซื้อ

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

ช่อง
name

string

ชื่อแหล่งข้อมูลของคำสั่งซื้อ: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

ข้อมูลส่วนบุคคลของลูกค้าที่สั่งซื้อ

payment_information

PaymentInformation

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

merchant_id

string

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

item[]

LineItem

รายการโฆษณาในคำสั่งซื้อนี้

OrderOnlineMetadata

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

ช่อง
fulfillment_option[]

FulfillmentOption

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

PaymentInformation

รายละเอียดการชำระเงินที่เกี่ยวข้องกับการจอง

ช่อง
prepayment_status

PrepaymentStatus

สถานะการชำระเงินล่วงหน้าของการจอง หากการชำระล่วงหน้า_สถานะเป็น PREPAYMENT_PROVIDED หรือ PREPAYMENT_REFUNDED แล้ว payment_transaction_id จะมีรหัสธุรกรรมที่ไม่ซ้ำกันที่เกี่ยวข้อง

payment_transaction_id

string

ตัวระบุที่ไม่ซ้ำกันสำหรับธุรกรรมการชำระเงินที่เชื่อมโยงกับการจอง เว้นว่างไว้หากไม่เกี่ยวข้อง

PaymentOption

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

ช่อง
payment_option_id

string

รหัสนี้ใช้เพื่อระบุตัวเลือกการชำระเงินนี้

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

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

name

string

ชื่อของตัวเลือกการชำระเงิน โดยผู้ใช้จะมองเห็นสิ่งนี้ได้

description

string

คำอธิบายตัวเลือกการชำระเงิน โดยผู้ใช้จะมองเห็นสิ่งนี้ได้

price

Price

ราคาของตัวเลือกการชำระเงิน

tax_rate

TaxRate

อัตราภาษีสำหรับตัวเลือกการชำระเงินนี้ หากมีช่องนี้จะลบล้างช่องภาษี [tax_rate] ที่มีอยู่ในผู้ขายหรือบริการ ข้อความว่างเปล่า (เช่น อัตราภาษี { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0

payment_option_type

PaymentOptionType

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

session_count

int64

จำนวนเซสชันที่ใช้ได้สำหรับตัวเลือกการชำระเงินนี้ ใช้ได้กับหลายเซสชัน / แพ็กเท่านั้น ซึ่งควรมีค่า > 1.

purchase_interval

TimeRange

คุณสามารถซื้อตัวเลือกการชำระเงินได้ภายในช่วงเวลานี้

valid_interval

TimeRange

คุณสามารถใช้ตัวเลือกการชำระเงินภายในระยะเวลานี้ (เช่น ราคาพิเศษสำหรับเดือนมกราคม 2017) หากมี ค่านี้จะลบล้าง valid_duration และactivate_type

valid_duration

Duration

ระยะเวลาของตัวเลือกการชำระเงินที่ใช้ได้ (เช่น การเป็นสมาชิก 30 วัน)

activation_type

ActivationType

กำหนดวันที่เริ่มต้นที่ใช้งานได้สำหรับตัวเลือกการชำระเงินนี้

user_restriction

UserPurchaseRestriction

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

ActivationType

ระบุวิธีกำหนดวันที่เริ่มต้นความถูกต้อง

Enum
ACTIVATION_TYPE_UNSPECIFIED ไม่ได้ใช้งาน
ACTIVATION_ON_PURCHASE อายุการใช้งานจะเริ่ม ณ เวลาที่ซื้อ
ACTIVATION_ON_FIRST_USE อายุการใช้งานจะเริ่มเมื่อมีการใช้ตัวเลือกการชำระเงินเป็นครั้งแรก

PaymentOptionType

ประเภทของตัวเลือกการชำระเงิน

Enum
PAYMENT_OPTION_TYPE_UNSPECIFIED ไม่ได้ใช้งาน
PAYMENT_OPTION_SINGLE_USE ตัวเลือกการชำระเงินสามารถใช้ได้เพียงครั้งเดียว
PAYMENT_OPTION_MULTI_USE สามารถใช้ตัวเลือกการชำระเงินได้หากจำนวนเซสชัน > 0.
PAYMENT_OPTION_UNLIMITED สามารถใช้ตัวเลือกการชำระเงินได้ภายในช่วงเวลาที่ใช้งานได้ - จำนวนเซสชันไม่เกี่ยวข้อง

PaymentProcessorConfig

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

ช่อง
processor

Processor

กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่ใช้การกำหนดค่านี้

public_key

string

คีย์ที่ใช้ระบุผู้ขายรายนี้กับผู้ประมวลผลการชำระเงิน

สำหรับ Stripe โปรดไปที่ https://stripe.com/docs/dashboard#api-keys สำหรับ Braintree โปรดดู https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

หมายเลขเวอร์ชันของ API ที่ส่งไปยังผู้ประมวลผลการชำระเงินพร้อมกับคำขอการชำระเงิน

โปรเซสเซอร์

กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่เฉพาะเจาะจง

Enum
PROCESSOR_UNSPECIFIED ไม่ได้ใช้งาน
PROCESSOR_STRIPE การกำหนดค่าสำหรับการชำระเงินด้วย Stripe
PROCESSOR_BRAINTREE การกำหนดค่าสำหรับการชำระเงินด้วย Braintree

PaymentRestrictions

ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ

ช่อง
credit_card_restrictions

CreditCardRestrictions

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

PerOrderFee

ค่าธรรมเนียมที่ต้องชำระ 1 ครั้งต่อคำสั่งซื้อ โดยไม่คำนึงถึงจำนวนตั๋ว

ช่อง
delivery_fee

Price

ค่าธรรมเนียมที่อาจแตกต่างกันไปตามวิธีการจัดส่ง

processing_fee

Price

ค่าธรรมเนียมในการประมวลผลวิธีการชำระเงินของผู้ใช้

PerTicketFee

ค่าธรรมเนียมที่ต้องชำระสำหรับตั๋วแต่ละใบที่ผู้ใช้ซื้อ

ช่อง
service_charge

Price

มีการประเมินค่าใช้จ่ายเพิ่มเติมสำหรับบริการ

facility_fee

Price

ค่าธรรมเนียมสำหรับสถานที่/สิ่งอำนวยความสะดวก

taxes

Price

ต่อภาษีตั๋ว

PostalAddress

ที่อยู่ของลูกค้าหรือธุรกิจ

ช่อง
address_country

string

ประเทศที่ระบุโดยใช้รหัสประเทศ ISO 3166-1 alpha-2 เช่น "US" (ต้องระบุ)

address_locality

string

ย่าน เช่น "Mountain View" (ต้องระบุ)

address_region

string

ภูมิภาค เช่น "CA" ฟิลด์นี้ต้องระบุเฉพาะในประเทศที่ภูมิภาคมักเป็นส่วนหนึ่งของที่อยู่ (ไม่บังคับ)

postal_code

string

รหัสไปรษณีย์ เช่น "94043" (ต้องระบุ)

street_address

string

ที่อยู่ เช่น "1600 Amphitheatre Pkwy" (ต้องระบุ)

PrepaymentStatus

สถานะการชำระเงินล่วงหน้าของการจอง

Enum
PREPAYMENT_STATUS_UNSPECIFIED ไม่ได้ระบุ ค่าเริ่มต้นคือ PREPAYMENT_NOT_PROVIDED
PREPAYMENT_PROVIDED ระบบชำระค่าธรรมเนียมการจองล่วงหน้าแล้ว
PREPAYMENT_NOT_PROVIDED ไม่ได้ชำระค่าธรรมเนียมการจองล่วงหน้า
PREPAYMENT_REFUNDED ก่อนหน้านี้ค่าธรรมเนียมถูก PREPAYMENT_PROVIDED แต่มีการคืนเงินแล้ว

ราคา

ค่าบริการหรือค่าธรรมเนียม

ช่อง
price_micros

int64

ราคาในหน่วยไมโครของสกุลเงิน เศษส่วนของหน่วยสกุลเงินที่เล็กที่สุดจะได้รับการปัดเศษโดยใช้การปัดเศษทศนิยมที่ใกล้เคียงที่สุด (เช่น สำหรับ USD 2.5 เซ็นต์ที่ปัดเป็น 2 เซนต์ 3.5 เซนต์ปัดเป็น 4 เซนต์ 0.5 เซนต์ปัดเป็น 0 เซนต์ 2.51 เซ็นต์ปัดเป็น 3 เซนต์)

currency_code

string

สกุลเงินของราคาที่กำหนดไว้ใน ISO 4217

pricing_option_tag

string

สตริงที่ไม่บังคับและทึบแสงซึ่งระบุตัวเลือกการกำหนดราคาที่เชื่อมโยงกับราคาที่เพิ่มขึ้น

PriceInterpretation

อธิบายวิธีการตีความราคาและแสดงราคาต่อผู้ใช้

Enum
PRICE_INTERPRETATION_UNSPECIFIED ไม่ได้ระบุการตีความราคา มีค่าเริ่มต้นเป็น EXACT_AMOUNT
EXACT_AMOUNT

กรณีที่ควรตีความราคาเป็นค่าที่เฉพาะเจาะจง

ตัวอย่าง: $20 สำหรับชั้นเรียนโยคะ ตัดผมเด็ก $15

STARTS_AT

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

โปรดทราบว่าบริการที่ใช้การตีความราคานี้ต้องใช้ PrepaymentType NOT_SUPPORTED

ตัวอย่างเช่น ตัดแต่งขนสุนัข $30 แต่ตัวเลือกเพิ่มเติมของผู้บริโภคอาจขึ้นราคา

NOT_DISPLAYED

เมื่อราคาของบริการมีการเปลี่ยนแปลงได้และไม่มีการแสดงข้อมูลราคาให้ผู้บริโภคทราบล่วงหน้า

โปรดทราบว่าบริการที่ใช้การตีความราคานี้ต้องใช้ PrepaymentType NOT_SUPPORTED และราคาต้องว่างเปล่า

ตัวอย่างเช่น การให้คำปรึกษาสำหรับบริการเกี่ยวกับบ้าน

PriceType

ระบุวิธีการระบุราคารวมจากความพร้อมจำหน่ายสินค้า

Enum
FIXED_RATE_DEFAULT

ราคาเป็นจำนวนคงที่ ค่านี้เป็นค่าเริ่มต้นหากไม่ได้ตั้งค่าฟิลด์

เช่น ฝากเงิน $50 เพื่อจองโต๊ะ ค่าเข้าคลาสโยคะ $20

PER_PERSON

ราคาที่ระบุเป็นราคาต่อคน และคำนวณราคารวมตามจำนวนคนที่ระบุไว้ในทรัพยากรเป็น price_micros * party_size ราคา PER_PERSON ต้องมาพร้อมกับจำนวนคนในทรัพยากรความพร้อมใช้งาน ไม่เช่นนั้นจะใช้จำนวนคน

เช่น ค่าตั๋วเข้าชมพิพิธภัณฑ์เรื่องละ $10

QuantitativeValue

Wrapper สำหรับค่าตัวเลขที่อาจเป็นช่วงหรือค่าคงที่ QuantitativeValue ตัวอย่าง: * ค่าเอกพจน์: value: 10.5 * ช่วงที่มีขอบเขต: value_range {min_value: 5.5, max_value 10.5} * ขอบเขตล่าง: value_range {min_value: 5.5} * ขอบเขตบน: value_range {max_value: 10.5}

ช่อง
ช่องการรวม value_options (ต้องระบุ) value_options ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
value

double

ค่าเอกพจน์ เช่น 5.6

value_range

RangeValue

ช่วงของค่าที่อาจเป็นปลายเปิดหรือมีขอบเขตได้ด้วย ตัวอย่าง: * อย่างน้อย 5.5 * สูงสุด 5.5 * 5.5 ถึง 6.5

RangeValue

ช่วงของค่าที่ min_value < max_value ต้องใช้ min_value และ max_value อย่างน้อย 1 รายการ

ช่อง
min_value

double

ค่าต่ำสุด

max_value

double

ค่าสูงสุด

Rating

กำหนดการจัดประเภทสำหรับเอนทิตี

ช่อง
value

double

ค่าคะแนนเฉลี่ย (ต้องระบุเมื่อ number_of_ratings > 0) ค่าต้องอยู่ในช่วง [1, 5] และละเว้นได้เฉพาะในกรณีที่ number_of_ratings เป็น 0

number_of_ratings

uint64

จำนวนการให้คะแนนที่ใช้ในการคำนวณค่า (ต้องระบุ)

RelatedMedia

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

ช่อง
url

string

URL ของแหล่งที่มาของสื่อนี้ Google จะรวบรวมข้อมูลสื่อที่โฮสต์ที่ URL นี้

type

MediaType

ประเภทของแหล่งที่มาของสื่อนี้

localized_caption

Text

คำบรรยายภาพของสื่อที่รองรับ i18n รองรับเฉพาะข้อความธรรมดา คอมโพเนนต์ HTML จะถูกตัดออก (ไม่บังคับ)

attribution

Attribution

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

caption
(deprecated)

string

เลิกใช้งานแล้ว ต้องการใช้ localized_caption ต่อไป

การระบุแหล่งที่มา

ข้อมูลการระบุแหล่งที่มาของสื่อนี้

ช่อง
localized_text

Text

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

text
(deprecated)

string

เลิกใช้งานแล้ว ต้องการใช้ localized_text มากกว่า

MediaType

Enum เพื่อระบุประเภทของแหล่งที่มาของสื่อนี้ ระบบรองรับเฉพาะรูปภาพเท่านั้น โปรดติดต่อทีม "จองกับ Google" หากต้องการรองรับสื่ออื่นๆ นอกเหนือจากรูปภาพ

Enum
TYPE_UNSPECIFIED ไม่ได้ใช้งาน
PHOTO บ่งบอกว่าสื่อที่ได้จาก URL เป็นรูปภาพ

ReplaceServiceAvailabilityRequest

คำขอแทนที่ความพร้อมของ Service

ช่อง
service_availability

ServiceAvailability

ความพร้อมใช้งานของบริการที่ใช้แทนที่บริการที่มีอยู่

RequireCreditCard

กำหนดว่าต้องใช้บัตรเครดิตในการจองการนัดหมายหรือไม่

Enum
REQUIRE_CREDIT_CARD_UNSPECIFIED ไม่มีการระบุข้อกำหนดของบัตรเครดิตไว้อย่างชัดแจ้ง และมีลักษณะเหมือนกับข้อกำหนดที่ระบุไว้สำหรับ CONDITIONAL
REQUIRE_CREDIT_CARD_CONDITIONAL Google กำหนดให้ต้องมีบัตรเครดิตสำหรับการจองหากเป็นไปตามเงื่อนไขต่อไปนี้ * ความพร้อมจำหน่ายสินค้ามีราคาและต้องชำระเงินล่วงหน้าประเภท [prepayment_type] * ตั้งค่า no_show_fee * มีการกำหนดฟิลด์เงินฝาก
REQUIRE_CREDIT_CARD_ALWAYS ต้องระบุบัตรเครดิตเสมอเพื่อจองห้องว่างนี้ โดยไม่คํานึงถึงค่าในช่องอื่นๆ

แหล่งข้อมูล

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

ช่อง
staff_id

string

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

staff_name

string

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

room_id

string

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

room_name

string

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

party_size

int32

ใช้ได้กับร้านอาหารเท่านั้น: จำนวนคนที่รองรับในช่วงเวลานี้ ร้านอาหารสามารถเชื่อมโยงกับสล็อตหลายช่องในเวลาเดียวกันได้ โดยแต่ละห้องจะระบุ party_size ที่แตกต่างกันได้ หากมีที่นั่งสำหรับการจองเป็น 2, 3 หรือ 4 คน

SchedulingRules

กฎการตั้งเวลาสำหรับบริการ

ช่อง
min_advance_online_canceling

int64

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

late_cancellation_fee
(deprecated)

Price

ค่าธรรมเนียมสำหรับการยกเลิกภายในระยะเวลาประกาศแจ้งล่วงหน้าขั้นต่ำ

noshow_fee
(deprecated)

Price

ค่าธรรมเนียมสำหรับการไม่แสดงตัวโดยไม่ยกเลิก

admission_policy

AdmissionPolicy

นโยบายการรับเข้าศึกษาที่ใช้กับบริการนี้ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น TIME_STRICT (ไม่บังคับ)

cancellation_policy

CancellationPolicy

นโยบายการยกเลิกกฎการตั้งเวลา (ต้องระบุสำหรับกิจกรรมน่าสนใจ)

ช่องการรวม min_booking_buffer ระยะเวลา (เป็นวินาที) นับจากเวลาที่จองล่าสุดไปจนถึงเวลาที่ช่วงเวลาว่างเริ่มต้นหรือสิ้นสุด

หากเป็น "min_advance_booking" แล้ว เวลาที่จองได้ล่าสุดจะคำนวณเป็น (<slot start time> - "min_advance_booking") หากเป็น "min_booking_buffer_before_end_time" แล้ว เวลาที่จองได้ล่าสุดจะคำนวณเป็น (<ช่วงเวลาสิ้นสุดช่วงเวลา> - "min_booking_buffer_before_end_time") โปรดทราบว่าค่าของ "min_booking_buffer_before_end_time" ต้องเป็นค่าบวกหากตั้งค่าไว้ หากไม่ได้ตั้งค่าทั้งคู่ ระบบจะจองช่วงเวลาดังกล่าวจนถึงเวลาเริ่มต้นของช่วงเวลาดังกล่าว หากตั้งค่าทั้ง 2 ช่อง ระบบจะเลือกเพียงค่าเดียวและจะไม่สนใจค่าอื่นๆ ด้วย เราไม่สามารถคาดการณ์ได้อย่างน่าเชื่อถือว่าจะเลือกค่าใด

ตัวอย่าง

  • ตัดผมที่ต้องจองล่วงหน้าอย่างน้อย 1 ชั่วโมงก่อนเวลาเริ่มต้น &#39;scheduling_rules{ min_advance_booking: 3600 ...}`

  • พิพิธภัณฑ์ที่สามารถซื้อตั๋วใบสุดท้ายได้ 30 นาทีก่อนปิด: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • ต้องซื้อบัตรชมภาพยนตร์ก่อนเวลาเริ่มต้น 'scheduling_rules{ ...}' (ปล่อยช่องนี้ว่างไว้) (ไม่บังคับ) min_booking_buffer ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

min_advance_booking

int64

ระยะเวลา (เป็นวินาที) นับจากเวลาที่จองล่าสุดจนถึงเวลาที่ช่วงเวลาที่ห้องว่างเริ่มต้นได้

min_booking_buffer_before_end_time

int64

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

AdmissionPolicy

นโยบายการรับเข้าทำงานของบริการนี้

Enum
ADMISSION_POLICY_UNSPECIFIED ไม่ได้ใช้งาน
TIME_STRICT โดยลูกค้าจะต้องแสดงตัวในเวลาเริ่มต้นของช่วงเวลาที่พร้อมทำงาน และคาดว่าบริการจะเสร็จสิ้นเมื่อสิ้นสุดช่วงเวลาดังกล่าว ตัวอย่างของกรณีการใช้งาน TIME_STRICT: * การทัวร์ชมที่เริ่มต้นเวลา 9:00 น. ซึ่งกำหนดให้ผู้เข้าร่วมทุกคนต้องมาถึงในเวลาเริ่มต้น และจะกลับมาในเวลาประมาณ 12:00 น. * การจองเวลาตัดผมเวลา 15.00 น. วันเสาร์ โดยจะใช้เวลาประมาณ 30 นาที * คลาสฟิตเนสตั้งแต่เวลา 18:00 น. ถึง 20:00 น.
TIME_FLEXIBLE

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

ตัวอย่างกรณีการใช้งาน TIME_FLEXIBLE ได้แก่ * ตั๋วพิพิธภัณฑ์ที่ใช้ระหว่างวันได้ ณ วันที่ซื้อ * บัตรเข้าสวนสนุกช่วงบ่าย ใช้ได้ตั้งแต่เวลา 12:00 น. - 21:00 น.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

ลูกค้าต้องไปถึงผู้ขาย ณ เวลาที่เริ่มให้บริการตามเวลาที่พร้อมให้บริการ แต่สามารถออกเดินทางได้ทุกเมื่อตามต้องการ

เช่น ในกรณีตั๋วเข้าชมพิพิธภัณฑ์แบบกำหนดเวลา เวลา 10:00 น. จะต้องให้ผู้ใช้มาที่พิพิธภัณฑ์ในเวลา 10:00 น. เวลาเริ่มต้นของช่วงเวลาที่พร้อมให้บริการสำหรับบริการนี้แสดงถึงเวลาเข้าที่กำหนดไว้ อย่างไรก็ตาม เวลาสิ้นสุดจะใช้เป็นกุญแจสำคัญในการระบุช่วงเวลาที่พร้อมให้บริการสำหรับการจองเท่านั้น

บริการ

ข้อมูลเกี่ยวกับบริการที่ผู้ขายให้ไว้ เช่น ตัดผม

ช่อง
name

string

ชื่อทรัพยากรบริการ ซึ่งมีรูปแบบเป็น partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

service_name

string

ชื่อของบริการ เช่น "ตัดผมชาย" เลิกใช้งานแล้ว ให้ใช้ localized_service_name แทน

localized_service_name

Text

ชื่อของบริการ เช่น "ตัดผมชาย" โดยอาจอยู่ในหลายภาษา

description

string

คำอธิบายบริการที่ผู้ใช้มองเห็นได้ เลิกใช้งานแล้ว ให้ใช้ localized_description แทน

localized_description

Text

คำอธิบายบริการที่ผู้ใช้มองเห็นได้

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

แท็กการจัดรูปแบบที่คล้ายกับ HTML ที่สนับสนุน:

แท็กส่วนหัว: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
สามารถใช้แท็กส่วนหัวเพื่อแสดงชื่อและชื่อเรื่องย่อยได้ เช่น <h1>แผนการเดินทาง</h1> จะแสดงข้อความในบรรทัดเป็นส่วนหัวที่สำคัญที่สุดของส่วนดังกล่าว โปรดทราบว่าแท็ก รูปแบบ หรือแอตทริบิวต์ HTML ภายในจะถูกละเว้น เช่น <h1 style=".."> จะได้รับการปฏิบัติเช่นเดียวกับ <h1> มีเพียงข้อความล้วนเท่านั้นที่สามารถเก็บรักษาได้

แท็กย่อหน้า: <p>
แท็กย่อหน้าสามารถใช้เพื่อไฮไลต์ข้อความแนะนำหรือเนื้อหาโดยละเอียดได้ ระบบจะไม่สนใจแท็ก รูปแบบ หรือแอตทริบิวต์ภายในใดๆ โดยมีข้อยกเว้นบางประการ ได้แก่ <br>, <strong> และ <em> โปรดดูส่วนแท็กวลีด้านล่างสำหรับรายละเอียดเพิ่มเติม

แสดงรายการแท็ก: <ul>, <ol>, <li>
The <ul> สามารถใช้กับ <li> เพื่อแสดงรายการที่ไม่เรียงลำดับ และ <ol> สามารถใช้กับ <li> เพื่อแสดงรายการตามลำดับ ซึ่งเป็นวิธีที่ดีในการแสดงเช็กลิสต์ กำหนดการ หรือรายการอื่นๆ ที่เหมาะกับกรณีการใช้งานของคุณ
ตัวอย่าง: หากต้องการแสดงรายการลักษณะของเรือสำราญ:
<ol>
<li>วิวทะเลสุดอลังการพร้อมโอกาสเล่นกับสัตว์ป่า</li>
<li>ออกแบบการเดินทางและบริการอย่างพิถีพิถัน</li>
<li>รับประกันราคาที่ถูกที่สุด</li>
</ol>
โปรดทราบว่าเฉพาะ <li> เด็กอายุต่ำกว่า <ul> หรือ <ol> แท็กทั้งหมดจะถูกแปลง ผู้เผยแพร่โฆษณาย่อยอื่นๆ ทั้งหมดจะหายไป นอกจากนี้ แท็ก แอตทริบิวต์ และรูปแบบภายในจะถูกละเว้น เราจะเก็บรักษาเฉพาะเนื้อหาที่เป็นข้อความล้วน

แท็กส่วน: <div>
แท็กภายในที่รองรับทั้งหมดของ <div> แท็ก จะถูกแยกวิเคราะห์ด้วยกฎที่ระบุไว้ข้างต้น ระบุเป็นนัย <div> ไม่ได้หมายถึงการจัดกลุ่มหรือการเยื้องที่นี่ นอกจากนี้ ระบบจะไม่สนใจแอตทริบิวต์และรูปแบบภายใน

แท็กวลี: <br>, <strong>, <em>:
รองรับเฉพาะแท็ก 3 รายการข้างต้นเท่านั้น &lt;br&gt; สามารถใช้เพื่อแบ่งบรรทัดในย่อหน้า และ <strong>/<em> สามารถใช้เพื่อไฮไลต์ข้อความสำคัญ โดยระบบจะไม่สนใจแท็กวลีอื่นๆ

แท็กที่ไม่รองรับ:

  • <html>, <header> และ <body> และไม่อนุญาตให้ใช้แท็ก
  • ระบบไม่รองรับแท็กอื่นๆ ที่ไม่ได้กล่าวถึงข้างต้น (เช่น <table>, <td> ...)
    URL, โฆษณา Anchor และลิงก์ต่างๆ จะถูกตัดออกและจะไม่แสดงให้ผู้ใช้ปลายทางเห็น หากต้องการใช้รูปภาพเพื่อสร้างประสบการณ์ที่สมบูรณ์สำหรับผู้ใช้ โปรดใช้ "related_media" ด้านล่างเพื่อส่ง URL รูปภาพของคุณ

หมายเหตุสำคัญ

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

Price

ราคาของบริการ

price_interpretation

PriceInterpretation

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

rules

SchedulingRules

กฎในการจอง/ยกเลิกการนัดหมาย

prepayment_type

PrepaymentType

ไม่จำเป็นต้องชำระเงินล่วงหน้า ไม่บังคับ หรือไม่รองรับก็ได้

prepayment_terms

PrepaymentTerms

ข้อกำหนดในการชำระเงินล่วงหน้าเสร็จสมบูรณ์

form[]
(deprecated)

ServiceIntakeForm

เลิกใช้งานแล้ว โปรดใช้ intake_form และ per_ticket_intake_form

intake_form

ServiceIntakeForm

แบบฟอร์มที่ขอข้อมูลเพิ่มเติมจากผู้ใช้เมื่อจองบริการนี้ (ไม่บังคับ)

per_ticket_intake_form

ServiceIntakeForm

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

tax_rate

TaxRate

อัตราภาษีของบริการ หากมีช่องนี้จะลบล้างอัตราภาษีที่กำหนดที่ระดับผู้ขาย ข้อความว่างเปล่า (เช่น อัตราภาษี { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0

payment_option_id[]

string

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

ระบุว่าผู้ใช้ต้องให้ข้อมูลบัตรเครดิตเพื่อจองบริการนี้หรือไม่ คุณลบล้างช่องนี้ได้ในระดับความพร้อมใช้งาน (ไม่บังคับ)

type

ServiceType

ประเภทที่กำหนดไว้ล่วงหน้าของบริการนี้ (ไม่บังคับ)

ticket_type[]

TicketType

ประเภทของตั๋วที่จอง/ซื้อสำหรับบริการนี้ได้ หากระบบรองรับตั๋ว (ไม่บังคับ)

related_media[]

RelatedMedia

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

service_attribute_value_id[]

ServiceAttributeValueId

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

waitlist_rules

WaitlistRules

กฎในการเข้าร่วมคิวรอ

ticketing_vertical_specific_data

TicketingVerticalSpecificData

ข้อมูลเพิ่มเติมเฉพาะของประเภทธุรกิจจำหน่ายตั๋วเข้างาน (ไม่บังคับ)

integration_type

IntegrationType

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

per_order_fee

PerOrderFee

ค่าธรรมเนียมระดับคำสั่งซื้อสำหรับการซื้อบริการนี้ (ไม่บังคับ)

tours_and_activities_content

ToursAndActivitiesContent

ช่องเนื้อหาสำหรับทัวร์ชมและกิจกรรมโดยเฉพาะ

location[]

Location

ตำแหน่งที่เกี่ยวข้องกับบริการนี้ หมายเหตุสำคัญ: หากมีสถานที่ที่เข้าชมหลายแห่งที่เกี่ยวข้องกับบริการนี้ หรือ START_LOCATION แตกต่างจาก VISITED_LOCATION คุณต้องระบุ START_LOCATION ตัวอย่าง: - ทัวร์ปั่นจักรยานพร้อมคำแนะนำที่ไปยังสถานที่จัดงาน 3 แห่ง ต้องระบุสถานที่เริ่มต้น - จัดการประชุมรถบัสนำเที่ยวที่ล็อบบี้โรงแรม แล้วมุ่งหน้าไปยังสถานที่ที่เคยไปเยือน จำเป็นต้องระบุสถานที่ประชุม

rating

Rating

คะแนนที่ผู้ใช้ให้กับบริการนี้เป็นเมตริกรวมจากรีวิวทั้งหมด

home_service_data

HomeServiceData

ข้อมูลเพิ่มเติมเฉพาะของประเภทธุรกิจบริการเกี่ยวกับบ้าน (ไม่บังคับ)

virtual_session

VirtualSession

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

direct_merchant_payment

DirectMerchantPayment

ไม่บังคับ ข้อมูลเพิ่มเติมที่ต้องเพิ่มหากบริการกำหนดให้ผู้ใช้ชำระเงินให้กับผู้ขายโดยตรง หมายเหตุสำคัญ: RwG จะไม่มีส่วนเกี่ยวข้องกับธุรกรรมนี้ ซึ่งจำเป็นหากมีการกำหนดVirtual_session และบริการไม่ใช่ Free หรือ prepayment_type เป็น REQUIRED

PrepaymentTerms

ข้อมูลเฉพาะเกี่ยวกับเวลาที่การชำระล่วงหน้าเสร็จสมบูรณ์

ช่อง
charge_timing

ChargeTiming

เวลาที่จะมีการเรียกเก็บเงินซึ่งสัมพันธ์กับเวลาที่ซื้อ

charge_time_before_start_time_sec

int64

เวลาเป็นวินาทีก่อนเวลาเริ่มต้นบริการที่ผู้ใช้ถูกเรียกเก็บเงิน ควรตั้งค่าฟิลด์นี้เมื่อ ChargeTiming เป็น CHARGE_LATER เท่านั้น

ChargeTiming

Enum เพื่อระบุว่าจะมีการเรียกเก็บเงินเมื่อใดที่เกี่ยวข้องกับเวลาที่ซื้อ

Enum
CHARGE_TIMING_UNSPECIFIED ไม่ได้ใช้งาน
CHARGE_NOW ระบบจะเรียกเก็บเงินจากลูกค้าทันที
CHARGE_LATER จะมีการเรียกเก็บเงินลูกค้าในภายหลัง

PrepaymentType

Enum เพื่อระบุประเภทการชำระเงินล่วงหน้า

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

ServiceType

ประเภทบริการที่กำหนดไว้ล่วงหน้า

Enum
SERVICE_TYPE_UNSPECIFIED ไม่ได้ใช้งาน
SERVICE_TYPE_DINING_RESERVATION การจองร้านอาหาร
SERVICE_TYPE_FOOD_ORDERING การสั่งอาหารอาจเป็นการจัดส่งอาหารหรือสั่งกลับบ้าน หรือทั้ง 2 อย่างก็ได้
SERVICE_TYPE_FOOD_DELIVERY บริการจัดส่งอาหาร
SERVICE_TYPE_FOOD_TAKEOUT อาหารแบบสั่งกลับบ้าน
SERVICE_TYPE_EVENT_TICKET ตั๋วกิจกรรม
SERVICE_TYPE_TRIP_TOUR ทัวร์ชม
SERVICE_TYPE_APPOINTMENT บริการที่มีการนัดหมายหรือชั้นเรียน แนะนำสำหรับ (1) สุขภาพและการออกกำลังกาย (2) สปาและความงาม และ (3) บริการให้คำปรึกษาและประเมินด้านการเงิน โปรดดูประเภทบริการที่รองรับที่ https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT บริการที่มีการนัดหมายทางออนไลน์สำหรับชั้นเรียนหรือเซสชันต่างๆ ซึ่งจะเป็นแบบออนไลน์ทั้งหมด ต้องตั้งค่าหากเปิดใช้การจองบริการเสมือนจริง
SERVICE_TYPE_SHOPPING บริการที่ช่วยให้ผู้ใช้เลือกซื้อจากผู้ขายที่ระบุ โดยอาจเป็นบริการจัดส่งหรือไปรับที่ร้านก็ได้

ServiceAttribute

แอตทริบิวต์ของบริการคือหมวดหมู่ที่กำหนดโดยพาร์ทเนอร์ ซึ่งอธิบายถึงบริการสำหรับผู้ขาย ตัวอย่างเช่น ธนาคารอาจกำหนด "ประเภทบัญชี" แอตทริบิวต์บริการที่มีค่าที่เป็นไปได้เป็น "Personal" และ "ธุรกิจ" ในขณะที่ร้านทำผมอาจกำหนด "ประเภทบริการ" service [บริการ] ที่มีค่าที่เป็นไปได้เป็น "Haircut", "Color" และ "Style"

ช่อง
attribute_id

string

ตัวระบุที่ระบุแอตทริบิวต์บริการนี้โดยไม่ซ้ำกันสำหรับผู้ขายรายเดียวกัน เช่น "account-type"

attribute_name

string

ชื่อที่ผู้ใช้มองเห็นได้สำหรับแอตทริบิวต์นี้ เช่น "ประเภทบัญชี"

value[]

Value

ค่าที่เป็นไปได้ทั้งหมดสำหรับแอตทริบิวต์บริการนี้

ค่า

แสดงค่าที่เป็นไปได้สำหรับแอตทริบิวต์บริการที่เฉพาะเจาะจง

ช่อง
value_id

string

ตัวระบุที่ระบุค่านี้โดยไม่ซ้ำกันสำหรับแอตทริบิวต์บริการนี้ เช่น "ส่วนตัว"

value_name

string

ชื่อที่ผู้ใช้มองเห็นสำหรับค่าดังกล่าว เช่น "ส่วนตัว"

ServiceAttributeValueId

ระบุค่าเฉพาะของแอตทริบิวต์บริการที่จะใช้กับบริการ

ช่อง
attribute_id

string

รหัสของแอตทริบิวต์ตามที่ระบุไว้ใน Merchant.service_attribute เช่น "service-type"

value_id

string

รหัสของค่าสำหรับแอตทริบิวต์นี้ เช่น "การตัดผม" ต้องตรงกับ value_id ในคำจำกัดความของแอตทริบิวต์บริการ

ServiceAvailability

รายการเวลาว่างและบุคคลที่ควรใช้

ช่อง
name

string

ชื่อทรัพยากรของบริการที่จะใช้ข้อมูลนี้ ในรูปแบบ partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_time_restrict

Timestamp

หากมี เราจะถือว่าเอนทิตีความพร้อมจำหน่ายสินค้าที่ระบุเป็นภาพรวมที่สมบูรณ์ตั้งแต่ [start_time_restrict, end_time_restrict) ซึ่งหมายความว่าระบบจะลบความพร้อมจำหน่ายสินค้าที่มีอยู่ทั้งหมดออกหากเงื่อนไขต่อไปนี้เป็นจริง

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

หากมีการตั้งค่าข้อความระยะเวลา เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้

  availability.duration == duration_restrict

หากมีการตั้งค่าข้อความ resource_restrict เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

การตั้งค่า start_time_restrict ขณะไม่ตั้งค่า end_time_restrict จะตีความว่าหมายถึงเวลาทั้งหมดเริ่มต้นที่ start_time_restrict

end_time_restrict

Timestamp

ระบบจะตีความการตั้งค่า end_time_restrict ขณะไม่ตั้งค่า start_time_restrict ว่าเป็นการตั้งค่าตั้งแต่ต้นจนถึง end_time_restrict เลย

duration_restrict

Duration

การตั้งค่าระยะเวลายังจํากัดขอบเขตของการอัปเดตไว้ที่ความพร้อมใช้งานซึ่งมีระยะเวลาตรงกันเท่านั้น

resources_restrict

Resources

การตั้งค่า resource_restrict จะจำกัดขอบเขตของการอัปเดตเพิ่มเติมไว้สำหรับทรัพยากรชุดนี้เท่านั้น ช่องรหัสทั้งหมดของทรัพยากรต้องตรงกันทั้งหมด

availability[]

Availability

รายการความพร้อมใช้งานใหม่

ServiceIntakeForm

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

ช่อง
field[]

ServiceIntakeFormField

ช่องที่แสดงต่อผู้ใช้

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

หากจริง แบบฟอร์มนี้จะแสดงให้กับลูกค้าที่กลับมาซื้อซ้ำ เลิกใช้งานแล้ว แบบฟอร์มที่ใช้ไม่รองรับฟังก์ชันนี้

ServiceIntakeFormField

กำหนดฟิลด์ที่รวมอยู่ใน ServiceIntakeForm

ช่อง
id

string

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

type

FieldType

ประเภทของช่องนี้

label

string

ข้อความที่แสดงต่อผู้ใช้สำหรับช่องนี้ เลิกใช้งานแล้ว โปรดใช้ localized_label แทน

localized_label

Text

ข้อความที่แสดงต่อผู้ใช้สำหรับช่องนี้ ช่องนี้สามารถใส่ได้หลายภาษา (ต้องระบุ)

value[]

string

ตั้งค่าในกรณีที่ประเภทช่องคือ LOCATION_SEARCH โปรดใช้ "location_id" ใน "ตำแหน่ง" เพื่อระบุค่าตำแหน่ง

choice_text[]

Text

ตั้งค่าในกรณีที่ประเภทฟิลด์เป็น MULTIPLE_CHOICE, CHECKBOXES หรือ DROPDOWN เท่านั้น ใช้เพื่อแจกแจงตัวเลือกที่เป็นไปได้

is_required

bool

ระบุว่าผู้ใช้ต้องตอบคำถามในช่องนี้หรือไม่

allow_custom_answer

bool

ระบุว่าอนุญาตให้ใช้ค่าที่กำหนดเองเพิ่มเติมในคำตอบที่กำหนดไว้ล่วงหน้าหรือไม่ วิธีนี้ใช้ได้เฉพาะเมื่อประเภทฟิลด์คือ LOCATION_SEARCH (ไม่บังคับ)

additional_option[]

Text

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

ticket_type_restrict[]

string

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

hint

Text

ข้อความคำแนะนำสำหรับอินพุต ซึ่งแสดงเป็นตัวยึดตําแหน่งข้อความ กรณีนี้ใช้ได้เฉพาะเมื่อประเภทฟิลด์คือ SHORT_ANSWER หรือ PARAGRAPH (ไม่บังคับ)

FieldType

Enum เพื่อระบุประเภทของช่อง

Enum
FIELD_TYPE_UNSPECIFIED โดยจะไม่สนใจช่องประเภทที่ไม่ระบุหรือไม่รู้จัก
SHORT_ANSWER ช่องป้อนข้อมูลแบบ 1 บรรทัดสำหรับข้อความ
PARAGRAPH ช่องป้อนข้อมูลหลายบรรทัดสำหรับข้อความ
MULTIPLE_CHOICE ชุดปุ่มตัวเลือกที่ต้องใช้ 1 ตัวเลือกจากตัวเลือกที่มีอยู่หลายรายการ
CHECKBOXES รายการที่แจกแจงอย่างน้อย 1 รายการที่มีช่องทำเครื่องหมาย
DROPDOWN ตัวเลือกจากเมนูแบบเลื่อนลง
BOOLEAN ปุ่มใช่/ไม่ใช่

TaxRate

อัตราภาษีที่ใช้เมื่อเรียกเก็บเงินจากผู้ใช้สำหรับบริการ ซึ่งสามารถกำหนดเป็นอัตราต่อผู้ขายหรือต่อบริการ

ช่อง
micro_percent

int32

อัตราภาษีในหน่วยล้านของหนึ่งเปอร์เซ็นต์ ซึ่งให้ทศนิยม 6 ตำแหน่งได้อย่างแม่นยำ เช่น หากอัตราภาษีคือ 7.253% ช่องนี้ควรตั้งค่าเป็น 7253000

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

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

ข้อกำหนด

ชุดกฎและหลักเกณฑ์ที่แสดงต่อผู้ใช้เพื่อทำการจองผ่าน "จองกับ Google"

ช่อง
url

string

(ไม่บังคับ) URL ไปยังข้อกำหนดในการให้บริการ

text

string

ข้อความที่จะแสดงต่อผู้ใช้ ใช้ localized_text ด้านล่างสำหรับการผสานรวมใหม่

localized_text

Text

ข้อความที่แปลแล้วที่จะแสดงต่อผู้ใช้

ข้อความ

เพย์โหลดข้อความที่อาจแปล ช่องข้อความบางช่องอาจมีเนื้อหาที่มาร์กอัป

ช่อง
value

string

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

localized_value[]

LocalizedString

ค่าข้อความตามภาษา ไม่บังคับ

TicketType

TicketType ใช้เพื่อแยกความแตกต่างระหว่างตั๋วที่มีราคาและ/หรือความพร้อมที่แตกต่างกันเนื่องจากมีประเภทผู้ใช้ต่างกัน แอตทริบิวต์บริการที่แตกต่างกัน หรือตัวเลือก/ส่วนเสริมที่ต่างกัน

ตั๋วคือหน่วยที่จองน้อยที่สุดสำหรับบริการ เช่น จุดล่องแก่ง ค่าเข้าชมพิพิธภัณฑ์ บริการเช่าเรือคายัค 2 ชั้นทั้งวัน

ช่อง
ticket_type_id

string

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

short_description

string

คำอธิบายแบบย่อสำหรับ TicketType นี้

ค่านี้จะปรากฏให้ผู้ใช้เห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" ฯลฯ โดยตั๋วแต่ละประเภทควรมีคำอธิบายเพื่อให้ผู้ใช้มองเห็น เลิกใช้งานแล้ว ให้ใช้ localized_short_description แทน

localized_short_description

Text

คำอธิบายแบบย่อสำหรับ TicketType นี้พร้อมการรองรับ i18n

ค่านี้จะปรากฏให้ผู้ใช้เห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" ฯลฯ โดยตั๋วแต่ละประเภทควรมีคำอธิบายเพื่อให้ผู้ใช้มองเห็น อาจระบุค่าแยกต่างหากสำหรับแต่ละภาษา

price

Price

ราคาตั๋วเที่ยวเดียวประเภทนี้ ไม่รวมภาษี อัตราภาษีของบริการจะมีผลกับตั๋ว

per_ticket_fee

PerTicketFee

ค่าธรรมเนียมเพิ่มเติมสำหรับการซื้อตั๋วนี้ (ไม่บังคับ)

option_description

string

คำอธิบายของตัวเลือกเพิ่มเติมที่ตั๋วประเภทนี้นำเสนอ (หากมี) เลิกใช้งานแล้ว ให้ใช้ localized_option_description แทน

localized_option_description

Text

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

ตัวเลือกเพิ่มเติมจะมีประโยชน์เมื่อประเภทตั๋วแสดงมิติข้อมูลหลายรายการ

ตัวอย่างที่ 1: ตั๋วเข้าชมประเภท "ผู้ใหญ่" และ "เด็ก" และภาษาเป็นตัวเลือกเพิ่มเติม รายการ TicketType ที่คาดไว้จะเป็น - { Ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "ภาษาอังกฤษ" } } - { Ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { ค่า: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "ภาษาอังกฤษ" } } - { Ticket_type_id: "ticket_type_4" localized_short_description { value: &quot;child&quot; } localized_option_description { ค่า: "spanish" }

ตัวอย่างที่ 2: บริการเช่าเรือคายัคแบบหลายชั่วโมงพร้อมบริการเสริมกระเป๋าแห้ง แอตทริบิวต์ short_description อาจเป็น "3 ชั่วโมง" และ Option_description อาจเป็น "พร้อมถุงเก็บฝุ่น" อย่างใดอย่างหนึ่ง หรือ "ไม่มีถุงแห้ง": - { Ticket_type_id: "ticket_type_1" localized_short_description { ค่า: "2 ชั่วโมง" } localized_option_description { value: "ภาษาอังกฤษ" } } - { Ticket_type_id: "ticket_type_2" localized_short_description { ค่า: "2 ชั่วโมง" } localized_option_description { ค่า: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { ค่า: "3 ชั่วโมง" } localized_option_description { value: "ภาษาอังกฤษ" } } - { Ticket_type_id: "ticket_type_4" localized_short_description { ค่า: "3 ชั่วโมง" } localized_option_description { ค่า: "spanish" }

ไม่บังคับ แต่หากตั๋วประเภทใดก็ตามภายในบริการตั้งค่าช่องนี้ไว้ เราคาดหวังให้ตั๋วประเภทอื่นๆ ทั้งหมดตั้งค่าช่องนี้ไว้ด้วย (อาจใช้ Option_description ตามค่าเริ่มต้นได้) เช่น [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] ไม่ใช่รายการที่ถูกต้อง

สนับสนุนแท็กการจัดรูปแบบ HTML เพียงสองแท็กเท่านั้น: และ
โดยใช้สำหรับการระบุตัวเลือกที่มีทั้งชื่อและคำอธิบายโดยละเอียด เช่น "ที่นั่งแบบพรีเมียม
ตัวเลือกนี้มีที่นั่งในช่องส่วนตัว ซึ่งมีเบาะรองนั่งอย่างเต็มที่ ทีวีส่วนตัว บริการอาหารและเครื่องดื่ม ที่นั่งเหล่านี้มองเห็นวิวทุ่งอันงดงาม"

TicketingVerticalSpecificData

ข้อมูลเพิ่มเติมเฉพาะของประเภทธุรกิจจำหน่ายตั๋วเข้างาน

ช่อง
event_category

EventCategory

หมวดหมู่ของกิจกรรม ตั้งค่าเฉพาะเมื่อเหตุการณ์อยู่ในหมวดหมู่ที่กําหนดไว้ล่วงหน้า (ไม่บังคับ)

event_url

string

URL ของเหตุการณ์ในเว็บไซต์ของพาร์ทเนอร์ (ไม่บังคับ)

entity[]

Entity

รายการเอนทิตีที่เกี่ยวข้องกับเหตุการณ์ (ไม่บังคับ)

event_attendance_mode

AttendanceMode

ต้องระบุ ประเภทของการเข้าร่วมกิจกรรม

event_virtual_location_url[]

string

ไม่บังคับ URL ที่ดูกิจกรรมได้

event_organizer

Text

ไม่บังคับ ผู้จัดที่จัดกิจกรรม

event_organizer_url

string

ไม่บังคับ URL ของผู้จัดกิจกรรมที่จัดกิจกรรม

event_organizer_type

OrganizerType

ไม่บังคับ ประเภทของผู้จัด

event_source_url[]

string

ต้องระบุ URL ของหน้าเว็บที่มีข้อมูลหรือคำอธิบายกิจกรรม

event_state

EventState

ไม่บังคับ สถานะของกิจกรรม

AttendanceMode

ประเภทของการเข้าร่วมกิจกรรม

Enum
ATTENDANCE_MODE_UNSPECIFIED ไม่ได้ระบุ
ONLINE สำหรับกิจกรรมออนไลน์
PHYSICAL สำหรับกิจกรรมการเคลื่อนไหวร่างกาย
PHYSICAL_ONLINE_MIXED สำหรับกิจกรรมที่จัดขึ้นทั้งในสถานที่จริงและแบบออนไลน์

เอนทิตี

แสดงเอนทิตีที่เกี่ยวข้องกับเหตุการณ์

ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันของเอนทิตีในฐานข้อมูลของพาร์ทเนอร์ (ไม่บังคับ)

name

string

ชื่อเอนทิตี (ต้องระบุ)

url

string

URL ของหน้าเว็บที่อธิบายเอนทิตีอย่างชัดเจน นี่คือหน้าเว็บบนเว็บไซต์ของพาร์ทเนอร์สำหรับหน่วยงาน (หากมี) สำหรับ URL สาธารณะอื่นๆ ของเอนทิตี ให้ใช้ related_url ใน Public_identification_data (ไม่บังคับ)

entity_type

EntityType

ประเภทของเอนทิตี (ไม่บังคับ)

entity_role

EntityRole

บทบาทของเอนทิตีในเหตุการณ์ (ไม่บังคับ)

public_identification_data

PublicIdentificationData

การอ้างอิงสาธารณะของเอนทิตี (ไม่บังคับ)

EntityRole

บทบาทของเอนทิตีในเหตุการณ์

Enum
ENTITY_ROLE_UNSPECIFIED ไม่ได้ระบุ
ENTITY_ROLE_HEADLINER เอนทิตีแสดงถึงผู้นำเสนอข่าวหรือผู้แสดงนำในงาน
ENTITY_ROLE_SUPPORTER เอนทิตีแสดงถึงนักแสดงที่สนับสนุนในกิจกรรม
ENTITY_ROLE_HOME_TEAM เอนทิตีเป็นตัวแทนของทีมเจ้าบ้านในการแข่งขัน (กีฬา)
ENTITY_ROLE_AWAY_TEAM เอนทิตีเป็นตัวแทนของทีมเยือนในการแข่งขัน (กีฬา)

EntityType

ประเภทของเอนทิตี หมายเหตุ: ไม่ได้มีวัตถุประสงค์เพื่อให้เป็นวิธีการแบบออนโทโลยีสากล

Enum
ENTITY_TYPE_UNSPECIFIED ไม่ได้ระบุ โปรดอย่าใช้
ENTITY_TYPE_PERFORMER เอนทิตีแสดงถึงศิลปินหรือกลุ่มที่แสดงในคอนเสิร์ตหรือรายการ ใช้ได้เมื่อหมวดหมู่กิจกรรมเป็น CONCERT หรือ THEATRE เท่านั้น
ENTITY_TYPE_PLAYER นิติบุคคลเป็นตัวแทนของทีมกีฬาหรือผู้เล่นในเหตุการณ์ ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น SPORTS
ENTITY_TYPE_CONCERT_TOUR เอนทิตีแสดงถึงทัวร์ชมที่มีกิจกรรมนี้อยู่ ใช้ได้เมื่อหมวดหมู่กิจกรรมเป็น CONCERT เท่านั้น
ENTITY_TYPE_SPORTS_SERIES เอนทิตีแสดงถึงการแข่งขันกีฬาที่เป็นส่วนหนึ่งของกิจกรรมนี้ ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น SPORTS
ENTITY_TYPE_PLAY เอนทิตีแสดงถึงประเภทการเล่น (เช่น ละครเพลง ตลก บัลเลต์ ฯลฯ) ที่แสดงในกิจกรรม ใช้ได้เมื่อหมวดหมู่เหตุการณ์คือ THEATRE เท่านั้น

EventCategory

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

Enum
EVENT_CATEGORY_UNSPECIFIED ไม่ได้ระบุ โปรดอย่าใช้
EVENT_CATEGORY_CONCERT คอนเสิร์ต
EVENT_CATEGORY_SPORTS การแข่งขันกีฬา
EVENT_CATEGORY_THEATRE กิจกรรมโรงละคร
EVENT_CATEGORY_EXHIBITS การจัดแสดง
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES เวิร์กช็อปและชั้นเรียน

EventState

สถานะของกิจกรรม

Enum
EVENT_STATE_UNSPECIFIED ไม่ได้ระบุ
SCHEDULED กิจกรรมมีกำหนดการ
RESCHEDULED กิจกรรมมีกำหนดการใหม่
CANCELLED กิจกรรมถูกยกเลิก
POSTPONED กิจกรรมถูกเลื่อนออกไปแล้ว

OrganizerType

ประเภทของผู้จัด

Enum
ORGANIZER_TYPE_UNSPECIFIED ไม่ได้ระบุ
PERSON สําหรับผู้จัดที่เป็นบุคคล
ORGANIZATION สําหรับผู้จัดที่เป็นองค์กร

PublicIdentificationData

ตัวระบุ หน้าเว็บ หรือแหล่งที่มาสาธารณะอื่นๆ ที่อ้างอิงเอนทิตี

ช่อง
relevant_url[]

string

URL สาธารณะของหน้าเว็บใดๆ ที่สร้างขึ้นเฉพาะหัวข้อเท่านั้น ซึ่งอาจรวมถึงเว็บไซต์อย่างเป็นทางการ, Discogs, แพลตฟอร์มโซเชียลมีเดีย, หน้า Wikipedia หรือ imdb เช่น https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan (ไม่บังคับ)

musicbrainz_id

string

ตัวระบุ Musicbrainz แบบ 36 อักขระของศิลปินหรือหน่วยงานเพลงอื่นๆ หากมี ดู https://musicbrainz.org/doc/MusicBrainz_Identifier (ไม่บังคับ)

TimeRange

ช่วงเวลาที่ธุรกิจปิดทำการ เช่น [start_time, end_time)

ช่อง
start_time

Timestamp

ขอบเขตล่างของช่วงเวลา

end_time

Timestamp

ขอบเขตบนของช่วงเวลา

TokenizationConfig

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

ช่อง
tokenization_parameter

map<string, string>

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

พารามิเตอร์ที่เหลือจะขึ้นอยู่กับโปรเซสเซอร์ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Google Pay

ตัวอย่าง Braintree: Tokenization_parameter { key: "gateway" ค่า: "braintree" } tokenization_parameter { key: &quot;braintree:apiVersion&quot; ค่า: "v1" } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; ค่า: "2.30.0" }Tokenization_parameter { คีย์: "braintree:merchantId" ค่า: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; ค่า: "production_xxx_yyy" }

ตัวอย่าง Stripe: Tokenization_parameter { key: "gateway" ค่า: "แถบ" } tokenization_parameter { key: &quot;stripe:version&quot; value: "2018-02-28" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; ค่า: "pk_1234" }

ตัวอย่าง Adyen: Tokenization_parameter { key: "gateway" ค่า: "adyen" }Tokenization_parameter { คีย์: "gatewayMerchantId" value: "รหัสของคุณ" }

billing_information_format

BillingInformationFormat

ใส่ข้อมูลสำหรับการเรียกเก็บเงินของผู้ใช้ตามที่ป้อนใน Google Pay โดยใช้รูปแบบการชำระเงินในโทเค็นการชำระเงิน (ดูด้านบน) การเว้นช่องนี้ว่างไว้เทียบเท่ากับการระบุ MIN

BillingInformationFormat

ที่อยู่สำหรับการเรียกเก็บเงินที่ผู้ใช้ต้องระบุและรวมไว้ในโทเค็น ค่า enum สอดคล้องกับพารามิเตอร์ใน Google Pay API (ดู https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)

Enum
BILLING_INFORMATION_FORMAT_UNSPECIFIED ไม่ได้ระบุ ค่าเริ่มต้นคือ MIN
MIN ชื่อ รหัสประเทศ และรหัสไปรษณีย์ (การตั้งค่าเริ่มต้นของ Google Pay)
FULL ชื่อ, ที่อยู่, ย่าน, ภูมิภาค, รหัสประเทศ และรหัสไปรษณีย์

ToursAndActivitiesContent

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

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

แท็กวลี:
, , , : สนับสนุนเฉพาะแท็กสามรายการข้างต้นเท่านั้น คุณสามารถใช้
เพื่อแบ่งบรรทัดในย่อหน้า และ // ใช้เพื่อเน้นข้อความสำคัญ โดยระบบจะไม่สนใจแท็กวลีอื่นๆ

แท็กและรูปแบบที่กำหนดเองอื่นๆ ทั้งหมดไม่ได้รับอนุญาตและจะถูกนำออก URL, โฆษณา Anchor และลิงก์ต่างๆ จะถูกตัดออกและจะไม่แสดงให้ผู้ใช้ปลายทางเห็น

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

ช่อง
highlights[]

Text

รายการไฮไลต์ที่ผู้ใช้มองเห็นได้

inclusions[]

Text

รายการการรวมที่ผู้ใช้มองเห็นได้

exclusions[]

Text

รายการการยกเว้นที่ผู้ใช้มองเห็นได้

must_know[]

Text

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

UnsupportedPartySizeOption

ตัวเลือกสําหรับกลุ่มที่อยู่นอกช่วงสัญญาณ

ช่อง
call_merchant

CallMerchant

จำนวนคนที่อยู่นอกช่วงสามารถโทรหาธุรกิจได้ ข้อความที่กำหนดไว้ล่วงหน้าจะปรากฏต่อผู้ใช้ ตัวอย่างข้อความที่จะแสดง: "สำหรับกลุ่มที่มีขนาดใหญ่กว่า {waitlist_rules.max_party_size} โปรดโทรติดต่อร้านอาหารที่ {phone}" ต้องตั้งค่า CallMerchant แต่จะว่างเปล่า

UpdateBookingRequest

คำขออัปเดต google.maps.booking.v1alpha.Booking

ช่อง
update_mask

FieldMask

มาสก์ของช่องของฟิลด์การจองทั้งหมดที่จะอัปเดต

booking

Booking

การจองที่จะอัปเดต

booking_failure

BookingFailure

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

UpdateMerchantRequest

คำขออัปเดต Merchant

ช่อง
merchant

Merchant

ข้อมูลผู้ขายใหม่

update_mask

FieldMask

ช่องเฉพาะที่จะอัปเดตสำหรับผู้ขาย

UpdateOrderRequest

คำขออัปเดต google.maps.booking.v1alpha.Order

ช่อง
update_mask

FieldMask

มาสก์ของช่องของฟิลด์คำสั่งซื้อทั้งหมดที่จะอัปเดต

order

Order

คำสั่งซื้อที่จะอัปเดต

UpdateServiceRequest

คำขออัปเดต Service

ช่อง
service

Service

ข้อมูลบริการใหม่

update_mask

FieldMask

ช่องเฉพาะที่จะอัปเดตสำหรับบริการ

UserPurchaseRestriction

จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงิน

ช่อง
new_to_merchant

bool

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

new_to_payment_option

bool

ตัวเลือกการชำระเงินที่จะซื้อได้โดยผู้ใช้ที่ไม่เคยซื้อตัวเลือกการชำระเงินเดียวกันมาก่อนเท่านั้น

VirtualSession

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

ช่อง
session_instructions

Text

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

session_requirements

Text

ข้อกำหนดสำหรับเซสชันออนไลน์ที่ระบุ เช่น เสื่อโยคะ อุปกรณ์ทำอาหาร ฯลฯ (แนะนำ)

virtual_platform_info

VirtualPlatformInfo

ข้อมูลเกี่ยวกับแพลตฟอร์มเสมือนที่ใช้ในเซสชันนี้ (จำเป็นสำหรับการเปิดใช้บริการเสมือน)

is_session_prerecorded

bool

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

VirtualPlatformInfo

ข้อมูลเกี่ยวกับแพลตฟอร์มที่จะใช้สำหรับเซสชันเสมือนจริงนี้

ช่อง
platform

Platform

แพลตฟอร์มที่ใช้สําหรับเซสชันเสมือน

other_platform_name

Text

ชื่อแพลตฟอร์มหากตั้งค่าแพลตฟอร์มเป็น OTHER (ต้องระบุหากตั้งค่าแพลตฟอร์มเป็น OTHER)

แพลตฟอร์ม

Enum เพื่อระบุว่าผู้ขายจะใช้แพลตฟอร์มเสมือนใด

Enum
PLATFORM_UNSPECIFIED ไม่ได้ใช้งาน
FLEXIBLE ผู้ขายมีความยืดหยุ่นในการใช้งานแพลตฟอร์มวิดีโอ
GOOGLE_HANGOUTS ผลิตภัณฑ์ Google แฮงเอาท์
GOOGLE_MEET ผลิตภัณฑ์ Google Meet
ZOOM Zoom Video Communications
SKYPE Skype
YOUTUBE สตรีมมิงแบบสดใน YouTube
OTHER ควรตั้งค่าหากแพลตฟอร์มวิดีโอที่ใช้แตกต่างจากแพลตฟอร์มที่กล่าวถึงที่นี่

WaitlistRules

กฎที่เกี่ยวข้องกับการเข้าร่วมคิวรอ

ช่อง
min_party_size

int32

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

max_party_size

int32

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

supports_additional_request

bool

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

above_max_party_size_options[]

UnsupportedPartySizeOption

ตั้งค่าตัวเลือกสําหรับกลุ่มที่มีขนาดใหญ่กว่า max_party_size ที่กำหนดไว้ เว้นว่างไว้หากไม่ควรมีตัวเลือกอื่นในการเข้าคิวรอกลุ่มใหญ่