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_options_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: "adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "ผู้ใหญ่วันหยุดสุดสัปดาห์"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_descriptions"}

วิธีเป็นตัวแทนของพื้นที่โฆษณาในช่วงวันธรรมดา 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: "adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

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

(ไม่บังคับ)

duration_requirement

DurationRequirement

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

scheduling_rule_overrides

SchedulingRuleOverrides

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

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:00 - 9:20 น., 9:30 - 9:50 น., 10-10:20 น., 10:30 - 10:50 น. (ต้องระบุ)

ScheduleException

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

ช่อง
time_range

TimeRange

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

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

โปรดทราบว่าเนื่องจากช่วงเวลานั้นปิดหรือเปิดอยู่ ระบบจึงไม่ส่งผลกระทบต่อช่วงเวลา 11:00 น.

SchedulingRuleOverrides

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

ช่อง
last_bookable_sec

int64

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

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 1 ครั้ง

BatchPushGenericRecordRequest

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

ช่อง
parent

string

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

records[]

GenericRecord

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

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

คำขอ Payment Authentication เพื่อโพสต์ไปยังแบบฟอร์ม 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

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

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

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

FeeAmount

FeeAmount ตัวอย่าง: * ค่าธรรมเนียมคงที่: USD 0 (ไม่มีค่าธรรมเนียม), USD 1.5 * ช่วงค่าธรรมเนียมคงที่: USD 1.0 (ขั้นต่ำ), USD 3.0 (สูงสุด), USD 5.0-6.0 * เปอร์เซ็นต์ของขนาดรถเข็น: 15.5%, 10%-20%, 10% (ขั้นต่ำ), 15% (สูงสุด) * ขั้นต่ำและเปอร์เซ็นต์: 2% -2%: USD 2.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 หมายความว่าลูกค้าต้องสั่งซื้อภายในวันที่ 10-08-2020 ลูกค้าจะต้องสั่งซื้อภายในเวลา 18:00 น. ของวันนั้น - ค่า last_ordering_time วันที่ 08-08-2020 เวลา 20:00 น. หมายความว่าลูกค้าต้องสั่งซื้อภายในวันที่ 10/08-2020 เวลา 20:00 น. 20:00 น. จึงจะรับสินค้าได้

FeeDetails

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

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

NoFee

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

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

FixedFee

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

ช่อง
amount

Price

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

FulfillmentType

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

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

MinimumFee

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

ช่อง
base_fee_amount

Price

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

NoFee

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

GenericDeleteRecord

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

ช่อง
delete_time

Timestamp

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

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

bytes

สำหรับฟีดที่ไม่ใช่โปรโตคอล

proto_record

Any

สำหรับฟีดที่ใช้โปรโต

GenericRecord

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

ช่อง
generation_timestamp

Timestamp

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

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

bytes

สำหรับฟีดที่ไม่ใช่โปรโตคอล

proto_record

Any

สำหรับฟีดที่ใช้โปรโต

GeoCoordinates

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

ช่อง
latitude

double

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

longitude

double

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

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

PostalAddress

ที่อยู่ทางไปรษณีย์ของสถานที่ตั้งที่ต้องการ

unstructured_address

string

ที่อยู่ที่ไม่มีโครงสร้างอาจระบุเป็นที่อยู่สำรองได้ เช่น "1600 amphitheatre centerway city view, ca 94043"

GetMerchantStatusRequest

คำขอรับMerchantStatus

ช่อง
name

string

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

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 ตั้งแต่ Epoch ของ Unix

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, phone, url, และ geo จะใช้เพื่อรองรับการจับคู่พื้นที่โฆษณาของพาร์ทเนอร์กับผู้ขายที่แสดงใน Google Maps อยู่แล้ว ข้อมูลนี้จะไม่แสดง

ชื่อผู้ขาย

telephone

string

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

url

string

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

geo

GeoCoordinates

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

category

string

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

num_bookings_30d
(deprecated)

int64

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

tax_rate_basis_points
(deprecated)

uint32

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

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

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

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

tax_rate

TaxRate

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

payment_restrictions

PaymentRestrictions

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

payment_option[]

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config

TokenizationConfig

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

terms

Terms

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

brand_id

string

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

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

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

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

หากไม่มีแบรนด์ที่แสดงต่อผู้บริโภคหลายแบรนด์ --> ละเว้นช่องนี้

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

  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_status เป็น 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 ที่มีอยู่ในผู้ขายหรือบริการ ส่วนข้อความที่ว่างเปล่า (เช่น 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

ย่าน เช่น "สุขุมวิท" (ต้องระบุ)

address_region

string

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

postal_code

string

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

street_address

string

ที่อยู่ เช่น "123 ถนนสุขุมวิท" (ต้องระบุ)

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

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

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

ตัวอย่างเช่น 900 บาทสำหรับการตัดแต่งขนสุนัข แต่ผู้บริโภคเพิ่มเติมอาจขึ้นราคา

NOT_DISPLAYED

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

โปรดทราบว่าบริการใดๆ ที่ใช้ PriceSharedation นี้ต้องใช้ 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

ค่าสูงสุด

การจัดประเภท

กำหนดการให้คะแนนสำหรับเอนทิตี

ช่อง
value

double

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

number_of_ratings

uint64

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

RelatedMedia

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

ช่อง
url

string

URL ของแหล่งที่มาของสื่อนี้ Google จะทำการ Crawl สื่อที่โฮสต์ที่ 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 กำหนดให้ใช้บัตรเครดิตสำหรับการจองหากเป็นไปตามเงื่อนไขต่อไปนี้ * การแสดงราคาห้องพักมีการระบุราคา และประเภทการชำระเงินล่วงหน้าเป็น "กำหนด" ค่าธรรมเนียม no_show_fee * กำหนดช่องเงินฝากแล้ว
REQUIRE_CREDIT_CARD_ALWAYS ต้องใช้บัตรเครดิตในการจองห้องว่างนี้เสมอ โดยไม่ต้องคำนึงถึงค่าในช่องอื่นๆ

แหล่งข้อมูล

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

ช่อง
staff_id

string

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

staff_name

string

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

ตัวอย่าง

  • ตัดผมที่ต้องจองอย่างน้อย 1 ชั่วโมงก่อนเวลาเริ่มต้น '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>
สามารถใช้แท็ก <ul> กับแท็ก <li> เพื่อแสดงรายการที่ไม่เรียงลำดับ และแท็ก <ol> สามารถใช้กับ <li> เพื่อแสดงรายการที่เรียงลำดับ วิธีนี้เป็นวิธีที่ดีในการแสดงรายการตรวจสอบ กำหนดการ หรือรายการอื่นๆ ที่เหมาะกับกรณีการใช้งานของคุณ
ตัวอย่าง: หากต้องการแสดงรายการสถานที่ท่องเที่ยวบนเรือสำราญ
<ol>
<li>วิวทะเลสุดวิเศษและโอกาสที่จะได้เล่นกับสัตว์ป่า</li>
<li>การจัดการและบริการด้านการเดินทางที่ออกแบบอย่างระมัดระวัง</li>
<li>รับประกันราคาต่ำสุด</li>
</ol>
โปรดทราบว่ามีเฉพาะ <li> แท็กเด็กที่มีอายุต่ำกว่า <ul> หรือ <ol> เท่านั้นที่จะได้รับการแปลง ส่วนบุตรหลานอื่นๆ ทั้งหมดจะหายไป นอกจากนี้ ระบบจะไม่สนใจแท็ก แอตทริบิวต์ และสไตล์ภายในทั้งหมด โดยเราจะเก็บไว้เฉพาะเนื้อหาที่เป็นข้อความเท่านั้น

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

แท็กวลี: <br>, <strong>, <em>:
รองรับเฉพาะแท็ก 3 แบบที่กล่าวถึงข้างต้นเท่านั้น <br> สามารถใช้เพื่อแบ่งบรรทัดในย่อหน้า และ <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

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

payment_option_id[]

string

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

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

type

ServiceType

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

ticket_type[]

TicketType

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

related_media[]

RelatedMedia

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

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 และบริการไม่ฟรี หรือไม่ได้ตั้งค่า 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 การสั่งอาหารอาจเป็นแบบจัดส่งอาหารหรือสั่งกลับบ้าน หรือทั้งคู่
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

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

ช่อง
attribute_id

string

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

attribute_name

string

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

value[]

Value

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

ค่า

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

ช่อง
value_id

string

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

value_name

string

ชื่อค่าที่ผู้ใช้มองเห็นได้ เช่น "ส่วนบุคคล"

ServiceAttributeValueId

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

ช่อง
attribute_id

string

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

value_id

string

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

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" ในช่อง "location" เพื่อระบุค่าสถานที่ตั้ง

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 ช่องป้อนข้อความแบบบรรทัดเดียว
PARAGRAPH ช่องป้อนข้อความแบบหลายบรรทัด
MULTIPLE_CHOICE ชุดปุ่มตัวเลือกที่ต้องใช้ตัวเลือกเดียวจากหลายตัวเลือก
CHECKBOXES รายการที่มีช่องทำเครื่องหมายแบบแจกแจงอย่างน้อย 1 รายการ
DROPDOWN ตัวเลือกจากเมนูแบบเลื่อนลง
BOOLEAN ปุ่มใช่/ไม่ใช่

TaxRate

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

ช่อง
micro_percent

int32

อัตราภาษีในหน่วยล้านของ 1 เปอร์เซ็นต์ ให้ทศนิยม 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 ใช้เพื่อแยกความแตกต่างระหว่างตั๋วที่มีราคาและ/หรือความพร้อมใช้งานแตกต่างกัน เนื่องจากประเภทผู้ใช้ แอตทริบิวต์บริการ หรือตัวเลือก/ส่วนเสริมแตกต่างกัน

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

ช่อง
ticket_type_id

string

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

short_description

string

คำอธิบายสั้นๆ ของ TicketType นี้

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

localized_short_description

Text

คำอธิบายสั้นๆ ของ TicketType นี้ที่รองรับ i18n

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

price

Price

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

per_ticket_fee

PerTicketFee

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

option_description

string

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

localized_option_description

Text

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

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

ตัวอย่างที่ 1: ค่าตั๋วเข้าชมที่มีประเภทที่แตกต่างกัน 'adult', 'child' and language as an additional option, รายการตั๋วที่คาดไว้จะเป็น: - {ticket_type_id: "ticket_type_1" localized_short_description {value: "adult"" } localized_option_description {value: "english" } {short_description} {short_description}"

ตัวอย่างที่ 2: บริการเช่าเรือคายัคแบบหลายชั่วโมง: ค่าเข้าชมแบบลดถุงที่มีตัวเลือก [Dryry Bag add-on, the short_description} เป็น "3 ชั่วโมง" และ "ค่าตั๋วท้องถิ่น" [local_type] {local_title: "local_type" {local_type" {localized_ticket value: localized_ticket" google localized_type: localized_ticket value: localized_ticket value: localized_ticket value: localized_ticket value: localized_ticket value : localized_ticket value : google localized_type {ตั๋ว จำกัด คำอธิบาย} {นาม _ คำอธิบาย} {คำอธิบาย} ภาษาไทย {รายละเอียด_description}

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

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

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 สาธารณะอื่นๆ ของเอนทิตี ให้ใช้ relevant_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 เอนทิตีแสดงถึงศิลปินหรือกลุ่มที่แสดงในคอนเสิร์ตหรือการแสดง ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็นคอนเสิร์ตหรือโรงภาพยนตร์
ENTITY_TYPE_PLAYER เอนทิตีหมายถึงทีมกีฬาหรือผู้เล่นในการแข่งขัน ใช้เมื่อหมวดหมู่กิจกรรมคือกีฬาเท่านั้น
ENTITY_TYPE_CONCERT_TOUR เอนทิตีแสดงถึงทัวร์ชมที่มีกิจกรรมนี้ ใช้ได้เมื่อหมวดหมู่กิจกรรมเป็น CONCERT เท่านั้น
ENTITY_TYPE_SPORTS_SERIES เอนทิตีแสดงถึงการแข่งขันกีฬาที่มีกิจกรรมนี้ ใช้เมื่อหมวดหมู่กิจกรรมคือกีฬาเท่านั้น
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 สาธารณะของหน้าเว็บใดๆ ที่มีไว้สำหรับหัวข้อเท่านั้น ซึ่งอาจรวมถึงเว็บไซต์อย่างเป็นทางการ, ดิสโก้, แพลตฟอร์มโซเชียลมีเดีย, หน้า 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>

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

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

ตัวอย่าง Braintree: "Tokenization_parameter" { key: "gateway" value: "braintree" }Tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter" { key: “braintree:merchant_defyyy value}

ตัวอย่าง Stripe: พารามิเตอร์โทเค็น { คีย์: ค่า "เกตเวย์": "stripe" } พารามิเตอร์โทเค็น { คีย์: "สตริป:เวอร์ชัน" ค่า: "2018-02-28" } พารามิเตอร์เหตุการณ์ { คีย์: "สตรอป:เผยแพร่ได้คีย์" ค่า: "pk_1234" }

ตัวอย่าง Adyen: tokenization_parameter { key: "gateway" value: "adyen" } audioization_parameter { key: "gatewayMerchantId" value: "yourId" }

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 ที่สนับสนุน:

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

แท็กและสไตล์ที่กำหนดเองอื่นๆ ทั้งหมดไม่ได้รับอนุญาตและจะถูกนำออก 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 ของ Zoom ล่วงหน้า 30 นาทีก่อนเวลาเรียน" (แนะนำ)

session_requirements

Text

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

virtual_platform_info

VirtualPlatformInfo

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

is_session_prerecorded

bool

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

VirtualPlatformInfo

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

ช่อง
platform

Platform

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

other_platform_name

Text

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

แพลตฟอร์ม

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

Enum
PLATFORM_UNSPECIFIED ไม่ได้ใช้
FLEXIBLE ผู้ขายสามารถใช้แพลตฟอร์มวิดีโอได้ตามต้องการ
GOOGLE_HANGOUTS ผลิตภัณฑ์ Google Hangouts
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 ที่กำหนดไว้ เว้นว่างไว้หากกลุ่มขนาดใหญ่ไม่ควรมีตัวเลือกอื่นในการเข้าร่วมคิวรอ