Package google.maps.booking.v1alpha

ดัชนี

AdsAccountLinkingService

บริการสําหรับจัดการการลิงก์บัญชีระหว่าง Google Ads กับศูนย์พาร์ทเนอร์

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

EventMetadata

ข้อมูลเพิ่มเติมเกี่ยวกับลิงก์การดำเนินการซึ่งมีเฉพาะในหมวดหมู่กิจกรรม

ช่อง
surface

Surface

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

แพลตฟอร์ม

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

Enum
SURFACE_UNSPECIFIED ไม่ได้ระบุพื้นผิว
SURFACE_YOUTUBE ลิงก์การดำเนินการคือการจองตั๋วเข้างานใน YouTube
SURFACE_ADS ลิงก์การดำเนินการคือการคลิกโฆษณาสำหรับกิจกรรม

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 Ads

Enum
STATE_UNSPECIFIED สถานะที่ไม่รู้จัก
LINKED บัญชีลิงก์ระหว่างศูนย์พาร์ทเนอร์กับพอร์ทัลโฆษณา
PENDING บัญชีกำลังรอการอนุมัติในศูนย์พาร์ทเนอร์หรือพอร์ทัลโฆษณา
DELETED ระบบจะลบลิงก์บัญชี
REJECTED คำขอลิงก์บัญชีถูกปฏิเสธโดยศูนย์พาร์ทเนอร์หรือพอร์ทัลโฆษณา

การให้คำปรึกษา

คำแนะนำที่แสดงต่อผู้ใช้เมื่อจองผ่านฟีเจอร์จองกับ 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

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

prepayment

Prepayment

ไม่บังคับ ข้อมูลการชำระเงินล่วงหน้าสำหรับความพร้อมนี้ (ไม่บังคับ)

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: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

หากต้องการแสดงพื้นที่โฆษณาในช่วงวันธรรมดา ให้ทำดังนี้ 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

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

confirmation_mode

ConfirmationMode

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

linkout_required_reason

LinkoutRequiredReason

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

ConfirmationMode

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

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

DurationRequirement

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

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

LinkoutRequiredReason

เหตุผลที่ช่องมีประสบการณ์การลิงก์ออก

Enum
LINKOUT_REQUIRED_REASON_UNSPECIFIED ค่าเริ่มต้น: ไม่ใช้ เทียบเท่ากับไม่ทราบ
PAYMENT_REQUIRED ต้องชำระเงินในแพลตฟอร์มพาร์ทเนอร์เพื่อจองช่วงเวลา

การเกิดซ้ำ

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

ข้อกำหนด

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

Timestamp

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

repeat_every

Duration

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

ตัวอย่าง: ความพร้อมที่มีระยะเวลา 20 นาที, repeat_every 30 นาที, เวลาเริ่มต้น 09:00 น. และ repeat_until 11:00 น. จะทำให้เกิดช่วงเวลาที่ 09:00-09:20 น., 09:30-09:50 น., 10:00-10:20 น., 10:30-10:50 น. และ 11:00-11:20 น. (ต้องระบุ)

ScheduleException

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

ช่อง
time_range

TimeRange

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

ตัวอย่าง: หากการเกิดซ้ำระบุระยะเวลา 20 นาที, repeat_every 30 นาที, start_time 9:00 น. และ repeat_until 11:00 น. แล้ว ScheduleException ที่มี time_range 9:45 น.-11:00 น. จะทำให้ช่วงเวลาที่ 9:30-9:50 น., 10-10:20 น. และ 10:30-10:50 น. ไม่พร้อมใช้งาน

โปรดทราบว่าเนื่องจากช่วงเวลาเป็นแบบปิด-เปิด จึงไม่มีผลต่อช่วงเวลาที่เริ่มเวลา 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

หากตั้งค่าไว้ เวลาล่าสุด (เป็นวินาทีตั้งแต่ Unix Epoch) ที่จะยกเลิกช่วงเวลาที่สะดวกสำหรับนัดหมายที่เฉพาะเจาะจงนี้ผ่านฟีเจอร์จองกับ 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 เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ต้องระบุประเภทบัตรเครดิตใน rejected_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

คำขอการตรวจสอบสิทธิ์การชำระเงิน หากระบุไว้ ระบบจะโพสต์ไปยังแบบฟอร์ม ACSUrl

transaction_id

string

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

md_merchant_data

string

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

BookingStatus

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

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

CallMerchant

ประเภทนี้ไม่มีฟิลด์

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

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

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

CreateAdsAccountLinkRequest

ข้อความคำขอสำหรับ AdsAccountLinkingService.CreateAdsAccountLink

ช่อง
parent

string

ต้องระบุ แหล่งข้อมูลหลักที่จะสร้างลิงก์บัญชี Google Ads นี้ ซึ่งเหมือนกับรหัสบัญชีศูนย์พาร์ทเนอร์ รูปแบบ: partners/{partner}

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

DeleteAdsAccountLinkRequest

ข้อความคำขอสำหรับ AdsAccountLinkingService.DeleteAdsAccountLink

ช่อง
name

string

ต้องระบุ ชื่อของ AdsAccountLink ที่จะลบ รูปแบบ: partners/{partner}/adsAccountLinks/{ads_account_link}

DeleteMerchantRequest

คำขอให้ลบ Merchant

ช่อง
name

string

ชื่อทรัพยากรของผู้ขายที่จะลบ ในรูปแบบ partners/{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

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

EconomicOperator

ข้อมูลผู้ประกอบการทางเศรษฐกิจสำหรับผู้รวบรวมข้อมูล

ช่อง
text

Text

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

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

หากตั้งค่าข้อความ resources_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

การตั้งค่า resources_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

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

ฟิลด์ Union 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 ตัวอย่าง * ค่าธรรมเนียมคงที่: 0 THB (ไม่มีค่าธรรมเนียม), 15 THB * ช่วงค่าธรรมเนียมคงที่: 10 THB (ขั้นต่ำ), 30 THB (สูงสุด), 50-60 THB * เปอร์เซ็นต์ของขนาดรถเข็น: 15.5%, 10%-20%, 10% (ขั้นต่ำ), 15% (สูงสุด) * การรวมช่วงและเปอร์เซ็นต์: 25.5% และ 25 THB (ขั้นต่ำ), 25.5% และ 45 THB (สูงสุด), 10% และ 15-25 THB, 10.5%-20% และ 25-35 THB

ช่อง
cart_percentage

QuantitativeValue

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

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

Money

จำนวนเงินที่กำหนด เช่น 35 THB

amount_range

MoneyRange

ช่วงของจำนวนเงิน ตัวอย่าง * 35 THB ถึง 55 THB * อย่างน้อย 35 THB * อย่างมาก 55 THB

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 น. ของวันเดียวกันจึงจะได้รับสินค้าในวันที่ 2020-08-10 ค่า last_ordering_time เป็น 2020-08-08 20:00 หมายความว่าลูกค้าต้องสั่งซื้อภายใน 20:00 น. ของวันที่ 8 สิงหาคม 2020 จึงจะได้รับสินค้าในวันที่ 10 สิงหาคม 2020

FeeDetails

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

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

NoFee

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

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

FixedFee

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

ช่อง
amount

Price

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

FulfillmentType

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

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

MinimumFee

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

ช่อง
base_fee_amount

Price

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

NoFee

ประเภทนี้ไม่มีฟิลด์

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

GenericDeleteRecord

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

ช่อง
delete_time

Timestamp

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

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

bytes

สำหรับฟีดที่ไม่ได้อิงตาม Proto

proto_record

Any

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

GenericRecord

บันทึกประเภทฟีดที่ระบุในคำขอ URL

ช่อง
generation_timestamp

Timestamp

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

ฟิลด์ Union record_type แคปซูลฟีดประเภทต่างๆ (ndjson, อิงตาม Proto ฯลฯ) record_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
data_record

bytes

สำหรับฟีดที่ไม่ได้อิงตาม Proto

proto_record

Any

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

GeoCoordinates

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

ช่อง
latitude

double

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

longitude

double

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

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

PostalAddress

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

unstructured_address

string

นอกจากนี้ยังระบุที่อยู่ที่ไม่มีโครงสร้างเป็นข้อมูลสำรองได้ด้วย เช่น "1600 amphitheatre parkway mountain view, ca 94043"

GetAdsAccountLinkRequest

ข้อความคำขอสำหรับ AdsAccountLinkingService.GetAdsAccountLink

ช่อง
name

string

ต้องระบุ ชื่อของลิงก์บัญชี Google Ads ที่จะดึงข้อมูล รูปแบบ: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

คำขอรับ MerchantStatus

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรในรูปแบบ partners/{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

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

LinkoutTemplate

เทมเพลตที่ระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ของพาร์ทเนอร์

ช่อง
uri_template

string

เทมเพลต URI ต้องเป็นไปตาม RFC 6570 ดู https://datatracker.ietf.org/doc/html/rfc6570 รองรับเทมเพลตระดับ 1 และเทมเพลตผสมระดับ 4 ทั้งหมด เช่น http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

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 ที่แสดงผลจากคำขอ List ก่อนหน้า (หากมี)

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, telephone, 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

อัตราภาษีของผู้ขายในหน่วย Basis Point (1/100 ของ 1 เปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 7.5% คุณควรตั้งค่าช่องนี้เป็น 750

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

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

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

tax_rate
(deprecated)

TaxRate

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

payment_restrictions
(deprecated)

PaymentRestrictions

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

payment_option[]
(deprecated)

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config
(deprecated)

TokenizationConfig

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

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

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

reservation_linkout_template[]

LinkoutTemplate

ไม่บังคับ เทมเพลตลิงก์ออกที่ระบุวิธีที่ Google ควรสร้าง URL ของพาร์ทเนอร์เพื่อจองโต๊ะบนแพลตฟอร์มของพาร์ทเนอร์

โปรดทราบว่าปัจจุบันระบบจะใช้เฉพาะรายการแรกเท่านั้นหากมีการระบุหลายรายการ

เทมเพลต URI รองรับฟิลด์ที่จะได้รับการป้อนข้อมูลตามตัวเลือกการจองของผู้ใช้ โดยคุณต้องระบุฟิลด์ที่จำเป็นทั้งหมดเพื่อสร้าง URL การจองให้สำเร็จ * (ต้องระบุ) party_size, int: ขนาดของกลุ่มที่ผู้ใช้ขอจอง * (ต้องระบุ) selected_date_time, วันที่และเวลา ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): เวลาที่ผู้ใช้ขอจอง * (ไม่บังคับ) merchant_id, สตริง: รหัสผู้ขายที่ผู้ใช้ขอทำการจอง ไม่จำเป็นหากเทมเพลตมีรหัสระบุผู้ขายอยู่แล้ว * (ไม่บังคับ) room_id, สตริง: รหัสของห้องที่ผู้ใช้ขอจอง

waitlist_advisement

Advisement

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

economic_operator

EconomicOperator

ไม่บังคับ ข้อมูลผู้ประกอบการทางเศรษฐกิจที่เชื่อมโยงกับผู้ขายรายนี้ซึ่งจำเป็นต่อการปฏิบัติตามกฎระเบียบ (ไม่บังคับ)

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 ของสถานที่นี้ ใช้เพื่อสร้าง 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 และ activation_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

ค่าธรรมเนียมที่ต้องชำระครั้งเดียวต่อคำสั่งซื้อ ไม่ว่าจะมีตั๋วกี่ใบก็ตาม

ช่อง
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" (ต้องระบุ)

การชำระเงินล่วงหน้า

การชำระเงินที่ระบบอาจเรียกเก็บจากผู้ใช้เมื่อจอง

ช่อง
price_info

PriceInfo

ที่เก็บรายละเอียดราคา

PrepaymentStatus

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

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

ราคา

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

ช่อง
price_micros

int64

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

currency_code

string

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

pricing_option_tag

string

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

PriceInfo

ที่เก็บรายละเอียดราคา

ช่อง
price_type

PriceType

กำหนดวิธีใช้ราคาหรือช่วงราคา (ต่อคนหรือคงที่)

ฟิลด์ Union price_options ตัวเลือกราคาคือการระบุราคาที่แน่นอนหรือช่วงราคา price_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
price

Price

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

price_range

PriceRange

ขอบเขตบนและ/หรือขอบเขตล่างของบริการหรือค่าธรรมเนียม

PriceInterpretation

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

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

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

ตัวอย่าง: 600 บาทสำหรับคลาสโยคะ 450 บาทสำหรับการตัดผมเด็ก

STARTS_AT

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

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

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

NOT_DISPLAYED

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

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

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

PriceRange

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

ช่อง
min_price

Price

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

max_price

Price

จำนวนเงินสูงสุด ควรมากกว่า min_price เสมอ

PriceType

กำหนดวิธีคำนวณราคารวมจากจำนวนห้องว่าง

Enum
FIXED_RATE_DEFAULT

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

ตัวอย่าง: มัดจำ 500 บาทเพื่อจองโต๊ะ ค่าธรรมเนียมการไม่แสดงตัว 200 บาทสำหรับชั้นเรียนโยคะ

PER_PERSON

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

ตัวอย่าง: $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}

ช่อง
ฟิลด์ Union 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 จะทำการ 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

การแจงนับเพื่อระบุประเภทของแหล่งที่มาของสื่อนี้ รองรับเฉพาะรูปภาพ โปรดติดต่อทีมจองกับ 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

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

staff_name

string

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

room_id

string

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

room_name

string

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

party_size

int32

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

room_description

Text

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

SchedulingRules

กฎการจัดเวลาสำหรับบริการ

ช่อง
min_advance_online_canceling

int64

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

late_cancellation_fee
(deprecated)

Price

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

noshow_fee
(deprecated)

Price

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

admission_policy

AdmissionPolicy

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

cancellation_policy

CancellationPolicy

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

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

หากตั้งค่า "min_advance_booking" ไว้ ระบบจะคำนวณเวลาที่จองได้ล่าสุดเป็น (<เวลาเริ่มต้นของสล็อต> - "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 * ทัวร์ที่เริ่มเวลา 09: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> ส่วนเด็กคนอื่นๆ จะถูกทิ้งไว้ นอกจากนี้ ระบบจะไม่สนใจแท็ก แอตทริบิวต์ และสไตล์ใดๆ ที่อยู่ภายใน โดยจะเก็บเฉพาะเนื้อหาที่เป็นข้อความล้วน

แท็ก Division: <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

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

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

uri_template

UriTemplate

ไม่บังคับ เทมเพลตที่ไม่บังคับซึ่งระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ภายนอก

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

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

ช่อง
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

หากตั้งค่าข้อความ resources_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

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

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

price_display_type

PriceDisplayType

ไม่บังคับ ประเภทการแสดงราคาที่กำหนดไว้ล่วงหน้าของตั๋วประเภทนี้

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: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

ตัวอย่างที่ 2: การเช่าเรือคายัคหลายชั่วโมงพร้อมส่วนเสริมถุงกันน้ำ (ไม่บังคับ) คำอธิบายแบบสั้นอาจเป็น "3 ชั่วโมง" และคำอธิบายตัวเลือกอาจเป็น "มีถุงกันน้ำ" หรือ "ไม่มีถุงกันน้ำ" - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

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

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

inventory_type

InventoryType

ไม่บังคับ ประเภทพื้นที่โฆษณาที่กำหนดไว้ล่วงหน้าของตั๋วประเภทนี้ 1 ใบ

InventoryType

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

Enum
INVENTORY_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทพื้นที่โฆษณา
INVENTORY_TYPE_PRIMARY พื้นที่โฆษณาหลัก
INVENTORY_TYPE_VERIFIED_RESALE สินค้าคงคลังที่ยืนยันแล้วสำหรับการขายต่อ
INVENTORY_TYPE_RESALE พื้นที่โฆษณาที่ขายต่อ
INVENTORY_TYPE_AGGREGATOR พื้นที่โฆษณาของผู้รวบรวมข้อมูล ผู้รวบรวมข้อมูล (เช่น www.bandsintown.com) หมายถึงพาร์ทเนอร์ที่ให้ข้อมูลกิจกรรมและตั๋ว แต่พาร์ทเนอร์ไม่ได้จำหน่ายตั๋วโดยตรง ผู้ขายตั๋วที่แท้จริงอาจเป็นผู้ขายหลัก ผู้ขายต่อที่ได้รับการยืนยัน หรือผู้ขายต่อ ตอนนี้เราจะแยกความแตกต่างเฉพาะประเภทพื้นที่โฆษณาของพาร์ทเนอร์ระดับบนสุด และไม่สนใจประเภทพื้นที่โฆษณาของผู้ขายตั๋วที่แท้จริงภายในผู้รวบรวมข้อมูล

PriceDisplayType

ระบุรูปแบบราคาที่แสดงในหน้า Landing Page

ระบบจะละเว้นช่องนี้สำหรับพื้นที่โฆษณาที่ไม่ได้ลิงก์ออก

ฟิลด์นี้ช่วยให้แพลตฟอร์มของ Google แสดงรูปแบบราคาเดียวกันกับที่หน้า Landing Page ของบริการใช้ รูปแบบราคาที่สอดคล้องกันจะช่วยปรับปรุงอัตรา Conversion และลดความสับสน

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทการแสดงราคา Google จะเป็นผู้กำหนดรูปแบบที่จะแสดง
PRICE_DISPLAY_TYPE_BASE ราคาที่แสดงในหน้า Landing Page คือราคาฐาน
PRICE_DISPLAY_TYPE_ALL_IN ราคาที่แสดงในหน้า Landing Page รวมค่าธรรมเนียมและภาษีทั้งหมดแล้ว

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

ไม่บังคับ สถานะของเหตุการณ์

brand_name

Text

ไม่บังคับ ชื่อแบรนด์ที่แปลแล้ว

event_creator

EventCreator

ไม่บังคับ ข้อมูลเกี่ยวกับผู้สร้างกิจกรรม

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 เอนทิตีแสดงถึงศิลปินหรือกลุ่มที่แสดงในคอนเสิร์ตหรือรายการ ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น CONCERT หรือ THEATRE
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 เวิร์กช็อปและชั้นเรียน

EventCreator

ข้อมูลเกี่ยวกับผู้สร้างกิจกรรม เกี่ยวข้องเฉพาะกับแพลตฟอร์มที่มีเหตุการณ์เนื้อหาที่ผู้ใช้สร้างขึ้น

ช่อง
name

string

ไม่บังคับ ชื่อผู้สร้างกิจกรรม ไม่มีข้อจำกัดด้านอักขระ

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>

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

พารามิเตอร์ที่เหลือจะขึ้นอยู่กับโปรเซสเซอร์ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ 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:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

ตัวอย่าง Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

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

billing_information_format

BillingInformationFormat

รวมข้อมูลสำหรับการเรียกเก็บเงินของผู้ใช้ตามที่ป้อนลงใน Google Pay ด้วย FOP (ดูด้านบน) ไว้ในโทเค็นการชำระเงิน การเว้นช่องว่างไว้จะเทียบเท่ากับการระบุ 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

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

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

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

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

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

ช่อง
highlights[]

Text

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

inclusions[]

Text

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

exclusions[]

Text

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

must_know[]

Text

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

UnsupportedPartySizeOption

ตัวเลือกสำหรับบุคคลที่อยู่นอกช่วง

ช่อง
ฟิลด์ Union kind ตัวเลือกที่มีสำหรับบุคคลที่อยู่นอกช่วง kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
call_merchant

CallMerchant

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

UpdateAdsAccountLinkRequest

ข้อความคำขอสำหรับ AdsAccountLinkingService.UpdateAdsAccountLink

ช่อง
update_mask

FieldMask

ไม่บังคับ รายการฟิลด์ที่จะอัปเดต

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

ฟิลด์ที่เฉพาะเจาะจงซึ่งต้องอัปเดตสำหรับบริการ

UriTemplate

เทมเพลตที่ระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ภายนอก

ช่อง
uri_template

string

ไม่บังคับ เทมเพลต URI ต้องเป็นไปตาม RFC6570 ดู https://datatracker.ietf.org/doc/html/rfc6570 รองรับเทมเพลตระดับ 2 ระบบจะแปลงพารามิเตอร์เหล่านี้เป็นค่าที่ระบุไว้ในเอนทิตีที่เกี่ยวข้อง

พารามิเตอร์ที่ใช้ได้สำหรับลิงก์การจองร้านอาหาร: 1) (ต้องระบุ) {availability_slot_start_seconds} :: สร้างจากฟิลด์ start_sec ในฟีดความพร้อม 2) (ต้องระบุ) {resources_party_size} :: สร้างจากฟิลด์ party_size ในฟีดความพร้อม 3) (ไม่บังคับ) {availability_slot_duration_seconds} :: สร้างจากฟิลด์ duration_sec ในฟีดความพร้อม 4) (ไม่บังคับ) {availability_slot_availability_tag} :: สร้างจากฟิลด์ availability_tag ในฟีดความพร้อม

ตัวอย่างการใช้งาน: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

โดยมี * start_sec = 123456 * party_size = 2

https://example.com/book/restaurant?start=123456&num_guests=2

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 ที่ตั้งไว้ ปล่อยว่างไว้หากไม่ควรให้ตัวเลือกอื่นแก่กลุ่มที่มีจำนวนคนมากกว่าสำหรับการเข้าร่วมคิวรอ