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 บัญชีกำลังรอการอนุมัติในศูนย์พาร์ทเนอร์หรือพอร์ทัล Google Ads
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: "ผู้ใหญ่ในวันธรรมดา"} ประเภทตั๋ว {ticket_type_id: "adult_2" Short_description: "ผู้ใหญ่ในช่วงสุดสัปดาห์"} ประเภทตั๋ว {ticket_type_id: "youth_1" Short_description: "Youth weekdays"} ประเภทตั๋ว {ticket_type_id: "youth_2" Short_description: "วันสุดสัปดาห์สำหรับเยาวชน"}

วิธีแสดงพื้นที่โฆษณาในช่วงวันธรรมดา: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...} วิธีแสดงพื้นที่โฆษณาในช่วงวันหยุด: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}

  • บริการที่มีตั๋ว 3 ประเภท ได้แก่ TicketType {ticket_type_id: "adult" short_description: "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 ต้องถูกปฏิเสธทันทีหรือสร้างด้วยสถานะ "รอดำเนินการ"

linkout_required_reason

LinkoutRequiredReason

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

ConfirmationMode

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

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

DurationRequirement

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

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

LinkoutRequiredReason

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

Enum
LINKOUT_REQUIRED_REASON_UNSPECIFIED ค่าเริ่มต้น: ไม่ใช้ จะหมายถึงไม่ทราบ
PAYMENT_REQUIRED สล็อตต้องชำระเงินในแพลตฟอร์มของพาร์ทเนอร์จึงจะจองได้

การเกิดซ้ำ

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

ข้อกำหนด

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

Timestamp

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

repeat_every

Duration

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

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

ScheduleException

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

ช่อง
time_range

TimeRange

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

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

โปรดทราบว่าเนื่องจากช่วงเวลาเป็นแบบปิด-เปิด ช่วงเวลาที่เริ่มต้นตอน 11:00 น. จะไม่ได้รับผลกระทบ

SchedulingRuleOverrides

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

ช่อง
last_bookable_sec

int64

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

first_bookable_sec

int64

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

last_online_cancellable_sec

int64

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

BatchDeleteGenericRecordsRequest

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

ช่อง
parent

string

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

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

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

ช่อง
parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

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

ช่อง
parent

string

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

extended_service_availability[]

ExtendedServiceAvailability

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

BatchReplaceServiceAvailabilityResponse

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

ช่อง
extended_service_availability[]

ExtendedServiceAvailability

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

การจอง

การจองสำหรับช่วงเวลาที่สะดวก

ช่อง
name

string

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

merchant_id

string

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

service_id

string

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

start_time

Timestamp

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

duration

Duration

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

client_information

ClientInformation

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

status

BookingStatus

สถานะการจอง

payment_information

PaymentInformation

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

party_size

int64

จํานวนผู้จอง

BookingFailure

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

ช่อง
cause

Cause

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

rejected_card_type

CreditCardType

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

description

string

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

payment_failure

PaymentFailureInformation

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

สาเหตุ

การแจกแจงสาเหตุของการไม่ผ่าน

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

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

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

PaymentFailureInformation

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

ช่อง
threeds1_parameters

ThreeDS1Parameters

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

ThreeDS1Parameters

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

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

ช่อง
acs_url

string

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

pa_req

string

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

transaction_id

string

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

md_merchant_data

string

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

BookingStatus

สถานะการจอง

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

CallMerchant

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

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

CancellationPolicy

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

ช่อง
refund_condition[]

RefundCondition

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

RefundCondition

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

ช่อง
min_duration_before_start_time

Duration

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

refund_percent

uint32

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

ClientInformation

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

ช่อง
given_name

string

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

family_name

string

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

address

PostalAddress

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

telephone

string

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

email

string

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

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

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

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

ช่องการรวม 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%

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

Money

จำนวนเงินคงที่ เช่น USD 3.5

amount_range

MoneyRange

ช่วงของจำนวน ตัวอย่าง: * USD 3.5 ถึง USD 5.5 * อย่างน้อย USD 3.5 * ไม่เกิน USD 5.5

amount_unknown

bool

จํานวนเงินที่ไม่รู้จัก

FeeType

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

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

FulfillmentOption

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

ช่อง
fulfillment_type

FulfillmentType

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

available_day[]

AvailableDay

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

fee_details

FeeDetails

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

minimum_order

Price

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

AvailableDay

ห้องว่างระดับวัน

ช่อง
fulfillment_date

Date

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

last_ordering_time

Timestamp

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

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

FeeDetails

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

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

NoFee

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

base_fee

MinimumFee

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

fixed_fee

FixedFee

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

FixedFee

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

ช่อง
amount

Price

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

FulfillmentType

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

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

MinimumFee

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

ช่อง
base_fee_amount

Price

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

NoFee

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

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

GenericDeleteRecord

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

ช่อง
delete_time

Timestamp

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

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

bytes

สําหรับฟีดที่ไม่ใช่โปรโต

proto_record

Any

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

GenericRecord

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

ช่อง
generation_timestamp

Timestamp

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

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

bytes

สําหรับฟีดที่ไม่ใช่โปรโต

proto_record

Any

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

GeoCoordinates

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

ช่อง
latitude

double

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

longitude

double

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

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

PostalAddress

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

unstructured_address

string

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

GetAdsAccountLinkRequest

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

ช่อง
name

string

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

GetMerchantStatusRequest

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

ช่อง
name

string

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

GetStatusRequest

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

ช่อง
name

string

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

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

HomeServiceData

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

ช่อง
category_type

string

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

job_type

string

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

IntegrationType

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

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

InvalidateResourceRequest

คำขอทำให้ทรัพยากรใช้งานไม่ได้

ช่อง
resource_id

string

ชื่อของทรัพยากรที่จะลบล้าง

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

LineItem

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

ช่อง
service_id

string

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

start_sec

int64

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

duration_sec

int64

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

tickets[]

OrderedTickets

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

price

Price

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

status

BookingStatus

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

OrderedTickets

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

ช่อง
ticket_id

string

รหัสของประเภทคำขอแจ้งปัญหา

count

int32

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

ListMerchantStatusesRequest

คำขอรับรายการ MerchantStatus

ช่อง
parent

string

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

page_size

int32

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

page_token

string

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

booking_inventory_status_restrict

BookingInventoryStatus

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

waitlist_inventory_status_restrict

WaitlistInventoryStatus

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

geo_match_restrict

GeoMatchingStatus

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

BookingInventoryStatus

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

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

GeoMatchingStatus

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

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

WaitlistInventoryStatus

สถานะสินค้าคงคลังในคิวรอจากต้นทางถึงปลายทาง

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

ListMerchantStatusesResponse

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

ช่อง
merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

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

ช่อง
name

string

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

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

int32

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

page_token

string

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

state_restrict

State

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

time_range_restrict

TimeRange

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

ListStatusResponse

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

ช่อง
status[]

FeedStatus

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

next_page_token

string

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

LocalizedString

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

ช่อง
locale

string

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

value

string

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

ตำแหน่ง

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

ช่อง
place_id

string

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

name

string

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

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

telephone

string

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

url

string

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

geo

GeoCoordinates

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

location_type

LocationType

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

location_id

string

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

LocationType

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

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

ผู้ขาย

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

ช่อง
name

string

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

merchant_name

string

ระบบจะใช้ merchant_name, 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

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

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

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

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

tax_rate

TaxRate

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

payment_restrictions

PaymentRestrictions

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

payment_option[]

PaymentOption

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

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config

TokenizationConfig

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

terms

Terms

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

brand_id

string

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

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

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

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

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

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

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

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

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

matching_hints

MerchantMatchingHints

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

service_attribute[]

ServiceAttribute

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

waitlist_advisement

Advisement

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

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

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

PlaceInfo

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

ช่อง
name

string

ชื่อสถานที่

formatted_address

string

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

place_id

string

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

ProcessingStatus

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

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

WaitlistStatus

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

ช่อง
has_valid_waitlist_service

bool

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

MoneyRange

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

ช่อง
min_amount

Money

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

max_amount

Money

จํานวนเงินสูงสุด

NoShowFee

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

ช่อง
fee

Price

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

fee_type

PriceType

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

สั่งซื้อ

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

ช่อง
name

string

ชื่อทรัพยากรของคำสั่งซื้อ: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

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

payment_information

PaymentInformation

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

merchant_id

string

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

item[]

LineItem

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

OrderOnlineMetadata

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

ช่อง
fulfillment_option[]

FulfillmentOption

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

PaymentInformation

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

ช่อง
prepayment_status

PrepaymentStatus

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

payment_transaction_id

string

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

PaymentOption

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

ช่อง
payment_option_id

string

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

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

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

name

string

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

description

string

คำอธิบายตัวเลือกการชำระเงิน ซึ่งผู้ใช้จะเห็น

price

Price

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

tax_rate

TaxRate

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

payment_option_type

PaymentOptionType

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

session_count

int64

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

purchase_interval

TimeRange

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

valid_interval

TimeRange

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

valid_duration

Duration

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

activation_type

ActivationType

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

user_restriction

UserPurchaseRestriction

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

ActivationType

กำหนดวิธีกำหนดวันที่เริ่มต้นของอายุการใช้งาน

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

PaymentOptionType

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

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

PaymentProcessorConfig

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

ช่อง
processor

Processor

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

public_key

string

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

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

version

string

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

โปรเซสเซอร์

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

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

PaymentRestrictions

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

ช่อง
credit_card_restrictions

CreditCardRestrictions

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

PerOrderFee

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

ช่อง
delivery_fee

Price

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

processing_fee

Price

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

PerTicketFee

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

ช่อง
service_charge

Price

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

facility_fee

Price

ค่าธรรมเนียมที่ชำระให้กับสถานที่จัดงาน/สถานที่

taxes

Price

ภาษีต่อตั๋ว

PostalAddress

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

ช่อง
address_country

string

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

address_locality

string

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

address_region

string

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

postal_code

string

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

street_address

string

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

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

การชำระเงินที่ระบบอาจเรียกเก็บจากผู้ใช้เป็นส่วนหนึ่งของการจอง

ช่อง
price_info

PriceInfo

คอนเทนเนอร์สำหรับรายละเอียดราคา

PrepaymentStatus

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

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

ราคา

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

ช่อง
price_micros

int64

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

currency_code

string

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

pricing_option_tag

string

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

PriceInfo

คอนเทนเนอร์สําหรับรายละเอียดราคา

ช่อง
price_type

PriceType

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

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

Price

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

price_range

PriceRange

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

PriceInterpretation

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

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

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

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

STARTS_AT

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

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

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

NOT_DISPLAYED

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

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

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

PriceRange

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

ช่อง
min_price

Price

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

max_price

Price

จํานวนเงินสูงสุด ควรเป็นค่าที่มากกว่า min_price เสมอ

PriceType

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

Enum
FIXED_RATE_DEFAULT

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

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

PER_PERSON

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

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

QuantitativeValue

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

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

double

ค่าเดี่ยว เช่น 5.6

value_range

RangeValue

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

RangeValue

ช่วงของค่าที่ min_value < max_value ต้องระบุ min_value หรือ max_value อย่างน้อย 1 รายการ

ช่อง
min_value

double

ค่าต่ำสุด

max_value

double

ค่าสูงสุด

Rating

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

ช่อง
value

double

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

number_of_ratings

uint64

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

RelatedMedia

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

ช่อง
url

string

URL ของแหล่งที่มาของสื่อนี้ Google จะทำการ Crawl สื่อที่โฮสต์ใน URL นี้

type

MediaType

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

localized_caption

Text

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

attribution

Attribution

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

caption
(deprecated)

string

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

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

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

ช่อง
localized_text

Text

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

text
(deprecated)

string

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

MediaType

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

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

ReplaceServiceAvailabilityRequest

คำขอเปลี่ยนความพร้อมให้บริการของ Service

ช่อง
service_availability

ServiceAvailability

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

RequireCreditCard

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

Enum
REQUIRE_CREDIT_CARD_UNSPECIFIED ไม่ได้ระบุข้อกำหนดของบัตรเครดิตอย่างชัดเจนและลักษณะการทำงานจะเหมือนกับที่ระบุไว้สำหรับ CONDITIONAL
REQUIRE_CREDIT_CARD_CONDITIONAL Google จะกำหนดให้ใช้บัตรเครดิตสำหรับการจองหากเป็นไปตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้ * ความพร้อมให้บริการมีราคาและจำเป็นต้องระบุ 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

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

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

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

ตัวอย่าง

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

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

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

min_advance_booking

int64

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

min_booking_buffer_before_end_time

int64

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

AdmissionPolicy

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

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

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

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

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

ลูกค้าต้องมาถึงผู้ขายตามเวลาเริ่มต้นของช่วงเวลาที่สะดวก แต่สามารถออกจากร้านได้ทุกเมื่อที่ต้องการ

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

บริการ

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

ช่อง
name

string

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

service_name

string

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

localized_service_name

Text

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

description

string

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

localized_description

Text

คําอธิบายบริการที่แสดงต่อผู้ใช้

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

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

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

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

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

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

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

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

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

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

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

Price

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

price_interpretation

PriceInterpretation

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

rules

SchedulingRules

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

prepayment_type

PrepaymentType

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

prepayment_terms

PrepaymentTerms

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

form[]
(deprecated)

ServiceIntakeForm

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

intake_form

ServiceIntakeForm

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

per_ticket_intake_form

ServiceIntakeForm

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

tax_rate

TaxRate

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

payment_option_id[]

string

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

deposit

Deposit

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

no_show_fee

NoShowFee

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

require_credit_card

RequireCreditCard

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

type

ServiceType

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

ticket_type[]

TicketType

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

related_media[]

RelatedMedia

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

service_attribute_value_id[]

ServiceAttributeValueId

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

waitlist_rules

WaitlistRules

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

ticketing_vertical_specific_data

TicketingVerticalSpecificData

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

integration_type

IntegrationType

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

per_order_fee

PerOrderFee

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

tours_and_activities_content

ToursAndActivitiesContent

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

location[]

Location

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

rating

Rating

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

home_service_data

HomeServiceData

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

virtual_session

VirtualSession

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

direct_merchant_payment

DirectMerchantPayment

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

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

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

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

ช่อง
ticket_type_id

string

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

short_description

string

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

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

localized_short_description

Text

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

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

price

Price

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

per_ticket_fee

PerTicketFee

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

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: &quot;adult&quot; } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_2&quot; localized_short_description { value: &quot;adult&quot; } localized_option_description { ค่า: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { value: "เด็ก" } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_4&quot; localized_short_description { value: "เด็ก" } localized_option_description { ค่า: "spanish" }

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

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

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

inventory_type

InventoryType

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

InventoryType

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

Enum
INVENTORY_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทพื้นที่โฆษณา
INVENTORY_TYPE_PRIMARY สินค้าคงคลังหลัก
INVENTORY_TYPE_VERIFIED_RESALE สินค้าคงคลังที่เป็นตัวแทนจำหน่ายที่ได้รับการยืนยัน
INVENTORY_TYPE_RESALE พื้นที่โฆษณาสำหรับการขายต่อ
INVENTORY_TYPE_AGGREGATOR พื้นที่โฆษณาของผู้รวบรวมข้อมูล

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 เอนทิตีแสดงถึงทัวร์ที่เหตุการณ์นี้อยู่ มีผลเฉพาะเมื่อหมวดหมู่กิจกรรมคือ "คอนเสิร์ต"
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 1 รายการที่มีคีย์เป็น "gateway" และค่าคือชื่อของโปรแกรมประมวลผล

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

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

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

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

billing_information_format

BillingInformationFormat

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

BillingInformationFormat

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

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

ToursAndActivitiesContent

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

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

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

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

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

ช่อง
highlights[]

Text

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

inclusions[]

Text

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

exclusions[]

Text

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

must_know[]

Text

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

UnsupportedPartySizeOption

ตัวเลือกสำหรับบุคคลที่อยู่นอกระยะสัญญาณ

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

มี 5 พารามิเตอร์ที่ใช้ได้ 5 รายการสำหรับลิงก์การจองร้านอาหารเพื่อการจองร้านอาหาร ได้คือ 1) (จำเป็น) {availability_slot_start_seconds} :: ป้อนข้อมูลจาก 5 พารามิเตอร์ 5 จุด

ตัวอย่างการใช้งาน: 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

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

แพลตฟอร์ม

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