ดัชนี
AdsAccountLinkingService(อินเทอร์เฟซ)BookingNotification(อินเทอร์เฟซ)Feed(อินเทอร์เฟซ)InvalidationService(อินเทอร์เฟซ)InventoryStatus(อินเทอร์เฟซ)InventoryUpdate(อินเทอร์เฟซ)ActionLink(ข้อความ)ActionLink.ActionLinkType(enum)ActionLink.EventMetadata(ข้อความ)ActionLink.EventMetadata.Surface(enum)ActionPlatform(enum)AdsAccountLink(ข้อความ)AdsAccountLink.State(enum)Advisement(ข้อความ)Availability(ข้อความ)Availability.ConfirmationMode(enum)Availability.DurationRequirement(enum)Availability.LinkoutRequiredReason(enum)Availability.Recurrence(ข้อความ)Availability.ScheduleException(ข้อความ)Availability.SchedulingRuleOverrides(ข้อความ)BatchDeleteGenericRecordsRequest(ข้อความ)BatchPushGenericRecordRequest(ข้อความ)BatchReplaceServiceAvailabilityRequest(ข้อความ)BatchReplaceServiceAvailabilityResponse(ข้อความ)Booking(ข้อความ)BookingFailure(ข้อความ)BookingFailure.Cause(enum)BookingFailure.PaymentFailureInformation(ข้อความ)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters(ข้อความ)BookingStatus(enum)CallMerchant(ข้อความ)CancellationPolicy(ข้อความ)CancellationPolicy.RefundCondition(ข้อความ)ClientInformation(ข้อความ)CreateAdsAccountLinkRequest(ข้อความ)CreateMerchantRequest(ข้อความ)CreateServiceRequest(ข้อความ)CreditCardRestrictions(ข้อความ)CreditCardRestrictions.CreditCardType(enum)DeleteAdsAccountLinkRequest(ข้อความ)DeleteMerchantRequest(ข้อความ)DeleteServiceRequest(ข้อความ)Deposit(ข้อความ)DirectMerchantPayment(ข้อความ)DurationRange(ข้อความ)EconomicOperator(ข้อความ)ExtendedServiceAvailability(ข้อความ)FeedStatistics(ข้อความ)FeedStatus(ข้อความ)FeedStatus.State(enum)FoodOrderingMetadata(ข้อความ)FoodOrderingMetadata.AdvanceOrderDetails(ข้อความ)FoodOrderingMetadata.FeeDetails(ข้อความ)FoodOrderingMetadata.FeeDetails.FeeAmount(ข้อความ)FoodOrderingMetadata.FeeDetails.FeeType(enum)FulfillmentOption(ข้อความ)FulfillmentOption.AvailableDay(ข้อความ)FulfillmentOption.FeeDetails(ข้อความ)FulfillmentOption.FixedFee(ข้อความ)FulfillmentOption.FulfillmentType(enum)FulfillmentOption.MinimumFee(ข้อความ)FulfillmentOption.NoFee(ข้อความ)GenericDeleteRecord(ข้อความ)GenericRecord(ข้อความ)GeoCoordinates(ข้อความ)GetAdsAccountLinkRequest(ข้อความ)GetMerchantStatusRequest(ข้อความ)GetStatusRequest(ข้อความ)HomeServiceData(ข้อความ)IntegrationType(enum)InvalidateResourceRequest(ข้อความ)LineItem(ข้อความ)LineItem.OrderedTickets(ข้อความ)LinkoutTemplate(ข้อความ)ListMerchantStatusesRequest(ข้อความ)ListMerchantStatusesRequest.BookingInventoryStatus(enum)ListMerchantStatusesRequest.GeoMatchingStatus(enum)ListMerchantStatusesRequest.WaitlistInventoryStatus(enum)ListMerchantStatusesResponse(ข้อความ)ListStatusRequest(ข้อความ)ListStatusResponse(ข้อความ)LocalizedString(ข้อความ)Location(ข้อความ)LocationType(enum)Merchant(ข้อความ)MerchantMatchingHints(ข้อความ)MerchantStatus(ข้อความ)MerchantStatus.BookingStatus(ข้อความ)MerchantStatus.DirectUrl(ข้อความ)MerchantStatus.DirectUrl.UrlType(enum)MerchantStatus.LocalServicesMatchInfo(ข้อความ)MerchantStatus.LocalServicesMatchInfo.MatchedProvider(ข้อความ)MerchantStatus.PlaceInfo(ข้อความ)MerchantStatus.ProcessingStatus(enum)MerchantStatus.WaitlistStatus(ข้อความ)MoneyRange(ข้อความ)NoShowFee(ข้อความ)Order(ข้อความ)OrderOnlineMetadata(ข้อความ)PaymentInformation(ข้อความ)PaymentOption(ข้อความ)PaymentOption.ActivationType(enum)PaymentOption.PaymentOptionType(enum)PaymentProcessorConfig(ข้อความ)PaymentProcessorConfig.Processor(enum)PaymentRestrictions(ข้อความ)PerOrderFee(ข้อความ)PerTicketFee(ข้อความ)PostalAddress(ข้อความ)Prepayment(ข้อความ)PrepaymentStatus(enum)Price(ข้อความ)PriceInfo(ข้อความ)PriceInterpretation(enum)PriceRange(ข้อความ)PriceType(enum)QuantitativeValue(ข้อความ)QuantitativeValue.RangeValue(ข้อความ)Rating(ข้อความ)RelatedMedia(ข้อความ)RelatedMedia.Attribution(ข้อความ)RelatedMedia.MediaType(enum)ReplaceServiceAvailabilityRequest(ข้อความ)RequireCreditCard(enum)Resources(ข้อความ)SchedulingRules(ข้อความ)SchedulingRules.AdmissionPolicy(enum)Service(ข้อความ)Service.PrepaymentTerms(ข้อความ)Service.PrepaymentTerms.ChargeTiming(enum)Service.PrepaymentType(enum)Service.ServiceType(enum)ServiceAttribute(ข้อความ)ServiceAttribute.Value(ข้อความ)ServiceAttributeValueId(ข้อความ)ServiceAvailability(ข้อความ)ServiceIntakeForm(ข้อความ)ServiceIntakeFormField(ข้อความ)ServiceIntakeFormField.FieldType(enum)TaxRate(ข้อความ)Terms(ข้อความ)Text(ข้อความ)TicketType(ข้อความ)TicketType.InventoryType(enum)TicketType.PriceDisplayType(enum)TicketingVerticalSpecificData(ข้อความ)TicketingVerticalSpecificData.AttendanceMode(enum)TicketingVerticalSpecificData.Entity(ข้อความ)TicketingVerticalSpecificData.Entity.EntityRole(enum)TicketingVerticalSpecificData.Entity.EntityType(enum)TicketingVerticalSpecificData.EventCategory(enum)TicketingVerticalSpecificData.EventCreator(ข้อความ)TicketingVerticalSpecificData.EventState(enum)TicketingVerticalSpecificData.OrganizerType(enum)TicketingVerticalSpecificData.PublicIdentificationData(ข้อความ)TimeRange(ข้อความ)TokenizationConfig(ข้อความ)TokenizationConfig.BillingInformationFormat(enum)ToursAndActivitiesContent(ข้อความ)UnsupportedPartySizeOption(ข้อความ)UpdateAdsAccountLinkRequest(ข้อความ)UpdateBookingRequest(ข้อความ)UpdateMerchantRequest(ข้อความ)UpdateOrderRequest(ข้อความ)UpdateServiceRequest(ข้อความ)UriTemplate(ข้อความ)UserPurchaseRestriction(ข้อความ)VirtualSession(ข้อความ)VirtualSession.VirtualPlatformInfo(ข้อความ)VirtualSession.VirtualPlatformInfo.Platform(enum)WaitlistRules(ข้อความ)
AdsAccountLinkingService
บริการสําหรับจัดการการลิงก์บัญชีระหว่าง Google Ads กับศูนย์พาร์ทเนอร์
| CreateAdsAccountLink |
|---|
|
สร้างลิงก์บัญชี Google Ads ซึ่งจะเป็นการเริ่มลิงก์ระหว่างบัญชี Google Ads กับศูนย์พาร์ทเนอร์ ลิงก์จะอยู่ในสถานะ
|
| DeleteAdsAccountLink |
|---|
|
ลบลิงก์บัญชี Google Ads ซึ่งจะเป็นการยกเลิกการลิงก์บัญชี Google Ads กับบัญชีศูนย์พาร์ทเนอร์
|
| GetAdsAccountLink |
|---|
|
รับลิงก์บัญชี Google Ads
|
| UpdateAdsAccountLink |
|---|
|
อัปเดตลิงก์บัญชี Google Ads กับสินค้าคงคลัง ซึ่งจะอัปเดตลิงก์บัญชี Google Ads ด้วยรายการพื้นที่โฆษณาที่ระบุ
|
BookingNotification
รับการแจ้งเตือนการนัดหมายจากพาร์ทเนอร์การจัดกำหนดการภายนอก พาร์ทเนอร์ควรเรียกใช้ UpdateBooking หรือ UpdateOrder ขึ้นอยู่กับว่าพาร์ทเนอร์ใช้ RPC ที่อิงตามการจอง เช่น CreateBooking และ CheckAvailability หรือ RPC ที่อิงตามคำสั่งซื้อ เช่น CreateOrder และ CheckOrderFulfillability
| UpdateBooking |
|---|
|
อัปเดต
|
| UpdateOrder |
|---|
|
อัปเดต
|
ฟีด
ดึงข้อมูลสถานะการประมวลผลของฟีดที่อัปโหลดโดยพาร์ทเนอร์ผู้รวบรวมข้อมูลภายนอก
| GetStatus |
|---|
|
เรียกข้อมูล
|
| ListStatus |
|---|
|
เรียกข้อมูล
|
InvalidationService
รับคำขอการทำให้ทรัพยากรไม่ถูกต้องจากพาร์ทเนอร์ภายนอก
| InvalidateResource |
|---|
|
ทำให้ทรัพยากรที่มีอยู่ไม่ถูกต้อง ระบบจะไม่สนใจคำขอหากไม่ได้สมัครใช้บริการของ Google สำหรับแหล่งข้อมูลที่ขอ ประเภททรัพยากรที่รองรับ: - การรับสินค้า
|
InventoryStatus
ดึงข้อมูลสินค้าคงคลังและสถานะการจับคู่ของผู้ขายที่อัปโหลด
| GetMerchantStatus |
|---|
|
รับ
|
| ListMerchantStatuses |
|---|
|
แสดง
|
InventoryUpdate
รับข้อมูลอัปเดตพื้นที่โฆษณาจากผู้รวบรวมข้อมูลภายนอก
| BatchDeleteGenericRecords |
|---|
|
ลบบันทึกของฟีดประเภทที่ระบุ ดำเนินการตรวจสอบพื้นฐานเท่านั้น (เช่น คำขอที่มีรูปแบบไม่ถูกต้อง) หลังจากนั้นระบบจะส่งการตอบกลับที่เหมาะสมไปยังพาร์ทเนอร์ทันที Google จะตรวจสอบความถูกต้องของตรรกะทางธุรกิจในคำขอแบบไม่พร้อมกัน การเรียกใช้แบบกลุ่มนี้ไม่รับประกันความเป็นหน่วยย่อย
|
| BatchPushGenericRecord |
|---|
|
แทรกและ/หรืออัปเดตระเบียนของฟีดประเภทที่ระบุ ดำเนินการตรวจสอบพื้นฐานเท่านั้น (เช่น คำขอที่มีรูปแบบไม่ถูกต้อง) หลังจากนั้นระบบจะส่งการตอบกลับที่เหมาะสมไปยังพาร์ทเนอร์ทันที Google จะตรวจสอบความถูกต้องของตรรกะทางธุรกิจในคำขอแบบไม่พร้อมกัน การเรียกใช้แบบกลุ่มนี้ไม่รับประกันความเป็นหน่วยย่อย
|
| BatchReplaceServiceAvailability |
|---|
|
แทนที่
|
| CreateMerchant |
|---|
|
สร้าง
|
| CreateService |
|---|
|
สร้าง
|
| DeleteMerchant |
|---|
|
ลบ
|
| DeleteService |
|---|
|
ลบ
|
| ReplaceServiceAvailability |
|---|
|
แทนที่
|
| UpdateMerchant |
|---|
|
อัปเดต
|
| UpdateService |
|---|
|
อัปเดต
|
ActionLink
URL การดำเนินการพร้อมภาษาที่เชื่อมโยง รายชื่อประเทศที่ถูกจำกัด และแพลตฟอร์มที่ไม่บังคับซึ่งระบุแพลตฟอร์มที่ควรดำเนินการนี้
| ช่อง | |
|---|---|
url |
URL ของจุดแรกเข้าสำหรับลิงก์การดำเนินการนี้ |
language |
แท็กภาษา BCP-47 ที่ระบุภาษาที่เนื้อหาจาก URI นี้พร้อมใช้งาน |
restricted_country[] |
รหัสประเทศ ISO 3166-1 alpha-2 เว้นว่างไว้หากไม่ต้องการจำกัดระดับการมองเห็น |
platform |
แพลตฟอร์มที่ควรดำเนินการนี้ หากไม่ได้ตั้งค่าช่องนี้ ระบบจะใช้ ACTION_PLATFORM_WEB_APPLICATION เป็นตัวเลือกสำรอง |
action_link_type |
ประเภทการดำเนินการที่กำหนดไว้ล่วงหน้า |
order_online_metadata |
ข้อมูลเมตาสำหรับลิงก์สั่งซื้อออนไลน์ รองรับการดำเนินการที่มี ActionLinkType เป็น ACTION_LINK_TYPE_SHOP_ONLINE |
food_ordering_metadata |
ข้อมูลเมตาสำหรับลิงก์การสั่งอาหาร รองรับประเภทการดำเนินการต่อไปนี้ * |
event_metadata |
ข้อมูลเพิ่มเติมเกี่ยวกับลิงก์การดำเนินการซึ่งมีเฉพาะในหมวดหมู่กิจกรรม |
ActionLinkType
ประเภทการดำเนินการที่กำหนดไว้ล่วงหน้าซึ่งเชื่อมโยงกับลิงก์การดำเนินการ
| Enum | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทลิงก์การดำเนินการ |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
ประเภทลิงก์การดำเนินการคือการจองการนัดหมาย |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
ประเภทลิงก์การดำเนินการคือการจองการนัดหมายออนไลน์ |
ACTION_LINK_TYPE_ORDER_FOOD |
ประเภทลิงก์การดำเนินการคือการสั่งอาหารเพื่อจัดส่งหรือซื้อกลับบ้าน หรือทั้ง 2 อย่าง |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
ประเภทลิงก์การดำเนินการคือการสั่งอาหารเพื่อนำส่ง |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
ประเภทลิงก์การดำเนินการคือการสั่งอาหารสำหรับซื้อกลับบ้าน |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
ประเภทลิงก์การดำเนินการคือการจองร้านอาหาร |
ACTION_LINK_TYPE_SHOP_ONLINE |
ประเภทลิงก์การดำเนินการคือการสั่งซื้อสำหรับการช็อปปิ้ง ซึ่งอาจเป็นการนำส่ง การรับสินค้า หรือทั้ง 2 อย่าง |
EventMetadata
ข้อมูลเพิ่มเติมเกี่ยวกับลิงก์การดำเนินการซึ่งมีเฉพาะในหมวดหมู่กิจกรรม
| ช่อง | |
|---|---|
surface |
แพลตฟอร์มกิจกรรมที่กำหนดไว้ล่วงหน้าซึ่งเชื่อมโยงกับลิงก์การดำเนินการ โดยใช้สำหรับหมวดหมู่กิจกรรมเท่านั้น |
แพลตฟอร์ม
แพลตฟอร์มกิจกรรมที่กำหนดไว้ล่วงหน้าซึ่งเชื่อมโยงกับลิงก์การดำเนินการ โดยใช้สำหรับหมวดหมู่กิจกรรมเท่านั้น
| Enum | |
|---|---|
SURFACE_UNSPECIFIED |
ไม่ได้ระบุพื้นผิว |
SURFACE_SEARCH |
ลิงก์การดำเนินการคือการจองตั๋วเข้างานใน Search |
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 |
AdsAccountLink
AdsAccountLink คือลิงก์ระหว่างบัญชี Google Ads กับบัญชีศูนย์พาร์ทเนอร์ พร้อมกับสินค้าคงคลัง
| ช่อง | |
|---|---|
name |
ตัวระบุ ชื่อทรัพยากรของ AdsAccountLink รูปแบบ: |
item_ids[] |
ต้องระบุ รายการรหัสสินค้าคงคลังที่จะลิงก์กับบัญชี Google Ads |
state |
เอาต์พุตเท่านั้น สถานะของลิงก์บัญชี Google Ads |
รัฐ
สถานะของลิงก์บัญชี Google Ads
| Enum | |
|---|---|
STATE_UNSPECIFIED |
สถานะที่ไม่รู้จัก |
LINKED |
บัญชีลิงก์ระหว่างศูนย์พาร์ทเนอร์กับพอร์ทัลโฆษณา |
PENDING |
บัญชีกำลังรอการอนุมัติในศูนย์พาร์ทเนอร์หรือพอร์ทัลโฆษณา |
DELETED |
ระบบจะลบลิงก์บัญชี |
REJECTED |
คำขอลิงก์บัญชีถูกปฏิเสธโดยศูนย์พาร์ทเนอร์หรือพอร์ทัลโฆษณา |
การให้คำปรึกษา
คำแนะนำที่แสดงต่อผู้ใช้เมื่อจองผ่านฟีเจอร์จองกับ Google
| ช่อง | |
|---|---|
text |
ข้อความที่กำหนดเองซึ่งจะแสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google" |
ความพร้อมใช้งาน
ช่วงเวลาที่บริการของผู้ขายพร้อมให้บริการ ซึ่งระบุเวลาและจำนวนที่
| ช่อง | |
|---|---|
start_time |
เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมาย |
duration |
ระยะเวลาของช่วงเวลาที่สะดวกสำหรับนัดหมาย |
spots_total |
จำนวนตำแหน่งทั้งหมดและตำแหน่งที่ว่างของความพร้อมจำหน่ายนี้ ตัวอย่าง
หมายเหตุ: หากส่งคำขอโดยใช้รูปแบบการบีบอัดความพร้อมที่กำหนดไว้ด้านล่าง ระบบจะอนุมานฟิลด์ทั้ง 2 นี้
|
spots_open |
จำนวนตำแหน่งที่ว่าง |
availability_tag |
สตริงทึบแสงที่ไม่บังคับเพื่อระบุช่วงเวลาที่ว่างนี้ หากตั้งค่าไว้ ระบบจะรวมไว้ในคำขอที่จอง/อัปเดต/ยกเลิกการนัดหมาย |
resources |
ทรัพยากรที่ไม่บังคับซึ่งใช้เพื่อแยกความแตกต่างของช่วงเวลาที่ว่างนี้จากช่วงเวลาอื่นๆ เมื่อมีเจ้าหน้าที่หรือห้องที่แตกต่างกันเป็นส่วนหนึ่งของบริการ เช่น ชั้นเรียนโยคะเดียวกันที่มีผู้สอน 2 คน |
payment_option_id[] |
รายการรหัสที่อ้างอิงตัวเลือกการชำระเงินซึ่งใช้ชำระเงินสำหรับช่องนี้ได้ ตัวเลือกการชำระเงินจริงจะกำหนดไว้ที่ระดับผู้ขาย และยังใช้ร่วมกันในผู้ขายหลายรายได้ด้วย ฟิลด์นี้จะลบล้าง payment_option_ids ที่ระบุไว้ในข้อความบริการ ในทำนองเดียวกัน payment_option_ids ที่ระบุไว้ที่นี่ไม่จำเป็นต้องอยู่ในข้อความบริการ แต่ต้องกำหนดไว้ที่ระดับผู้ขาย |
recurrence |
ข้อมูลการเกิดซ้ำของความพร้อมให้บริการ ซึ่งแสดงเวลาเริ่มต้นมากกว่า 1 รายการ การเกิดซ้ำควรมีการนัดหมายสำหรับวันทำการ 1 วัน |
schedule_exception[] |
เวลาที่ไม่สามารถกำหนดเวลานัดหมายสำหรับบริการนี้ได้ หากต้องการจำกัดจำนวนข้อความ schedule_exception ให้พิจารณารวมข้อยกเว้นที่อยู่ติดกัน |
deposit |
เงินฝากที่ไม่บังคับสำหรับความพร้อมนี้ ลบล้างเงินฝากของบริการหากมีการระบุไว้ |
no_show_fee |
ค่าธรรมเนียมการไม่เข้าพักที่ไม่บังคับสำหรับความพร้อมนี้ ลบล้างค่าธรรมเนียมการไม่แสดงตัวของบริการหากมีการระบุไว้ |
prepayment |
ไม่บังคับ ข้อมูลการชำระเงินล่วงหน้าสำหรับความพร้อมนี้ (ไม่บังคับ) |
require_credit_card |
ระบุว่าผู้ใช้ต้องระบุบัตรเครดิตเพื่อจองช่วงเวลาที่ว่างนี้หรือไม่ หากไม่ได้ตั้งค่าไว้ ระบบจะรับค่าจากระดับบริการหากมีการตั้งค่าไว้ (ไม่บังคับ) |
ticket_type_id[] |
ระบุรายการประเภทตั๋วที่รองรับสำหรับช่วงเวลาที่ว่างนี้ หากไม่ได้ตั้งค่าไว้ ตั๋วทุกประเภทในบริการหลักจะพร้อมใช้งานสำหรับช่วงเวลานี้ โปรดทราบว่าต้องกำหนดค่าของฟิลด์นี้ในบริการหลัก ตัวอย่าง
หากต้องการแสดงพื้นที่โฆษณาในช่วงวันธรรมดา ให้ทำดังนี้
หากต้องการระบุว่าตั๋วทั้ง 3 ประเภทพร้อมจำหน่ายสำหรับช่วงเวลาที่ระบุ ให้ใช้ (ไม่บังคับ) |
duration_requirement |
ข้อกำหนดในการแสดงระยะเวลาและ/หรือเวลาสิ้นสุดของช่วงเวลา ระบบจะไม่สนใจฟิลด์นี้หากไม่มีช่อง ไม่ได้ใช้ในแนวตั้งกิจกรรมน่าสนใจ (ไม่บังคับ) |
scheduling_rule_overrides |
กฎการกำหนดเวลาความพร้อม หากมีการป้อนข้อมูลในช่อง ระบบจะลบล้างกฎการจัดเวลาที่เกี่ยวข้องใน SchedulingRules ระดับบริการ |
confirmation_mode |
โหมดการยืนยันที่จะใช้เมื่อจองความพร้อมนี้ ระบบต้องยืนยันหรือปฏิเสธความพยายามในการสร้างการจองสำหรับความพร้อมที่มีโหมดการยืนยันเป็น CONFIRMATION_MODE_SYNCHRONOUS ทันที ความพยายามในการสร้างการจองสำหรับความพร้อมที่มีโหมดการยืนยันเป็น CONFIRMATION_MODE_ASYNCHRONOUS ต้องถูกปฏิเสธทันทีหรือสร้างโดยมีสถานะเป็น PENDING |
linkout_required_reason |
ไม่บังคับ เหตุผลที่ต้องมีลิงก์ออกสำหรับช่องนี้ หากตั้งค่าไว้ ทรัพยากรผู้ขายสำหรับช่องนี้ต้องมี LinkoutTemplate ที่ถูกต้อง (ไม่บังคับ) |
ConfirmationMode
โหมดการยืนยันที่ใช้เมื่อจองความพร้อม
| Enum | |
|---|---|
CONFIRMATION_MODE_UNSPECIFIED |
ไม่ได้ระบุโหมดการยืนยัน ระบบจะถือว่าเป็นการยืนยันแบบซิงโครนัส |
CONFIRMATION_MODE_SYNCHRONOUS |
ระบบจะยืนยันการจองสำหรับห้องว่างนี้แบบพร้อมกัน |
CONFIRMATION_MODE_ASYNCHRONOUS |
ระบบจะยืนยันการจองสำหรับห้องว่างนี้แบบไม่พร้อมกัน |
DurationRequirement
การแจงนับนี้ระบุข้อกำหนดที่ผู้ใช้ต้องรับทราบหรือดูระยะเวลา/เวลาสิ้นสุดของช่วงเวลาที่ขอ
| Enum | |
|---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
ไม่ได้ระบุวิธีจัดการเวลาสิ้นสุด โดยตัวเลือกนี้คือค่าเริ่มต้น |
DO_NOT_SHOW_DURATION |
ระบบจะไม่แสดงเวลาสิ้นสุดต่อผู้ใช้ |
MUST_SHOW_DURATION |
ระบบต้องแสดงเวลาสิ้นสุดต่อผู้ใช้ก่อนจึงจะนัดหมายได้ |
LinkoutRequiredReason
เหตุผลที่ช่องมีประสบการณ์การลิงก์ออก
| Enum | |
|---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED |
ค่าเริ่มต้น: ไม่ใช้ เทียบเท่ากับไม่ทราบ |
PAYMENT_REQUIRED |
ต้องชำระเงินในแพลตฟอร์มพาร์ทเนอร์เพื่อจองช่วงเวลา |
การเกิดซ้ำ
ข้อความการเกิดซ้ำเป็นตัวเลือก แต่ช่วยให้แสดงช่วงเวลาที่พร้อมให้บริการซึ่งเกิดซ้ำอย่างสม่ำเสมอได้กระชับยิ่งขึ้น โดยปกติแล้วจะแสดงตารางการทำงานของวัน จากนั้นจะใช้ข้อความ ScheduleException เพื่อแสดงช่วงเวลาที่จองแล้ว/ไม่พร้อมให้บริการภายในวันทำการ
ข้อกำหนด
- การขยายช่วงเวลาที่ว่างหรือการเกิดซ้ำต้องไม่สร้างช่วงเวลาที่ว่างที่เหมือนกัน หากรหัส, start_time, duration และทรัพยากรตรงกัน ระบบจะถือว่าสล็อตเหมือนกัน
- อย่านำรูปแบบความพร้อมมาตรฐานและการเกิดซ้ำมาใช้ร่วมกันในช่องของบริการเดียว การเกิดซ้ำเป็นประโยชน์ต่อผู้ขาย/บริการที่เสนอการนัดหมาย รูปแบบมาตรฐานนี้เหมาะสำหรับผู้ขาย/บริการที่มีคลาสที่กำหนดเวลาไว้เป็นประจำ
- การเกิดซ้ำไม่ควรนานเกิน 24 ชั่วโมง
| ช่อง | |
|---|---|
repeat_until |
การประทับเวลา UTC สูงสุดแบบรวมที่ความพร้อมจะทำซ้ำจนถึง |
repeat_every |
กำหนดเวลาระหว่างช่วงเวลาที่ว่างต่อเนื่องกัน ตัวอย่าง: ความพร้อมที่มีระยะเวลา 20 นาที, repeat_every 30 นาที, เวลาเริ่มต้น 09:00 น. และ repeat_until 11:00 น. จะทำให้เกิดช่วงเวลาที่ 09:00-09:20 น., 09:30-09:50 น., 10:00-10:20 น., 10:30-10:50 น. และ 11:00-11:20 น. (ต้องระบุ) |
ScheduleException
ข้อความ ScheduleException แสดงช่วงเวลาที่จองแล้ว/ไม่พร้อมให้บริการภายในวันทำงาน ซึ่งเป็นข้อยกเว้นของการเกิดซ้ำที่อธิบายไว้ข้างต้น เมื่อมีการจองช่วงเวลา คุณควรอัปเดตรายการข้อยกเว้นเพื่อให้แสดงช่วงเวลาใหม่ที่ไม่พร้อมให้บริการ ไม่ควรแก้ไขการเกิดซ้ำ
| ช่อง | |
|---|---|
time_range |
ช่วงเวลาของข้อยกเว้น ช่วงเวลาที่อธิบายโดยการเกิดซ้ำซึ่งทับซ้อนกับช่วงเวลาที่ปิด-เปิดนี้จะถือว่าไม่พร้อมให้บริการ ตัวอย่าง: หากการเกิดซ้ำระบุระยะเวลา 20 นาที, repeat_every 30 นาที, start_time 9:00 น. และ repeat_until 11:00 น. แล้ว ScheduleException ที่มี time_range 9:45 น.-11:00 น. จะทำให้ช่วงเวลาที่ 9:30-9:50 น., 10-10:20 น. และ 10:30-10:50 น. ไม่พร้อมใช้งาน โปรดทราบว่าเนื่องจากช่วงเวลาเป็นแบบปิด-เปิด จึงไม่มีผลต่อช่วงเวลาที่เริ่มเวลา 11:00 น. |
SchedulingRuleOverrides
กฎการจัดตารางเวลาระดับความพร้อมใช้งาน
| ช่อง | |
|---|---|
last_bookable_sec |
เวลาล่าสุด (เป็นวินาที) ที่จองช่วงเวลานี้ได้ การประทับเวลานี้ต้องอยู่ก่อน start_sec ของช่วงเวลาจึงจะมีผล (หากผู้ใช้ควรจองได้หลังจากเวลาเริ่มต้น ให้ใช้ SchedulingRules.min_booking_before_end_time ระดับบริการ) หากมี จะลบล้างทุกอย่างที่ระบุไว้ใน min_booking_buffer ของ SchedulingRules ของบริการที่เกี่ยวข้อง |
first_bookable_sec |
เวลาแรก (เป็นวินาที) ที่จองช่วงเวลานี้ได้ การประทับเวลานี้ต้องอยู่ก่อน start_sec ของช่วงเวลา หรือ last_bookable_sec หากมีการระบุ |
last_online_cancellable_sec |
หากตั้งค่าไว้ เวลาล่าสุด (เป็นวินาทีตั้งแต่ Unix Epoch) ที่จะยกเลิกช่วงเวลาที่สะดวกสำหรับนัดหมายที่เฉพาะเจาะจงนี้ผ่านฟีเจอร์จองกับ Google ได้ ฟิลด์นี้จะลบล้างกฎการยกเลิกที่ระดับบริการ (ไม่บังคับ) |
BatchDeleteGenericRecordsRequest
คำขอแบบกลุ่มเพื่อลบระเบียนของฟีดประเภทที่ระบุ
| ช่อง | |
|---|---|
parent |
ชื่อทรัพยากรซึ่งมีรูปแบบเป็น - |
records[] |
ระเบียนที่จะถูกลบ อนุญาตให้มีระเบียนได้สูงสุด 1,000 รายการในการเรียก API 1 ครั้ง |
BatchPushGenericRecordRequest
คำขอแบบกลุ่มเพื่อแทรกและ/หรืออัปเดตระเบียนของประเภทฟีดที่ระบุใน URL ของคำขอ
| ช่อง | |
|---|---|
parent |
ชื่อทรัพยากรซึ่งมีรูปแบบเป็น - |
records[] |
ระเบียนที่จะแทรกและ/หรืออัปเดต อนุญาตให้มีระเบียนได้สูงสุด 1,000 รายการในการเรียก API 1 ครั้ง |
BatchReplaceServiceAvailabilityRequest
คำขอแบบกลุ่มเพื่อแทนที่ช่วงเวลาที่พร้อมให้บริการของ Service หลายรายการ
| ช่อง | |
|---|---|
parent |
รูปแบบของ |
extended_service_availability[] |
ความพร้อมให้บริการที่ขยายเวลาซึ่งใช้แทนช่วงเวลาที่พร้อมให้บริการที่มีอยู่ |
BatchReplaceServiceAvailabilityResponse
การตอบกลับแบบกลุ่มเพื่อแทนที่ช่องความพร้อมให้บริการของ Service หลายรายการ ระบบจะรวมเฉพาะช่องที่อัปเดตสำเร็จแล้วไว้ในข้อความนี้
| ช่อง | |
|---|---|
extended_service_availability[] |
ข้อความความพร้อมให้บริการของบริการเพิ่มเติมที่อัปเดตสำเร็จซึ่งใช้แทนช่วงเวลาที่พร้อมให้บริการที่มีอยู่ |
การจอง
การจองช่องสินค้าคงคลัง
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของการจอง: |
merchant_id |
รหัสผู้ขายสำหรับช่อง |
service_id |
รหัสของบริการผู้ขาย |
start_time |
เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมาย |
duration |
ระยะเวลาของช่วงเวลาที่สะดวกสำหรับนัดหมาย |
client_information |
ข้อมูลส่วนบุคคลของลูกค้าที่ทำการนัดหมาย |
status |
สถานะของการจอง |
payment_information |
ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับการจอง |
party_size |
จำนวนผู้ใช้บริการในการจอง |
BookingFailure
ข้อมูลสถานะที่สื่อให้เห็นว่าเหตุใดการประมวลผลการจองจึงล้มเหลวแบบไม่พร้อมกัน BookingFailure มีไว้เพื่อบันทึกข้อผิดพลาดทางตรรกะทางธุรกิจเป็นหลัก
| ช่อง | |
|---|---|
cause |
สาเหตุที่การจองล้มเหลว (ต้องระบุ) |
rejected_card_type |
(ต้องระบุเฉพาะในกรณีที่สาเหตุคือ PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
ฟิลด์ที่ไม่บังคับนี้ใช้เพื่อให้พาร์ทเนอร์ใส่ข้อมูลเพิ่มเติมเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องเท่านั้น (ไม่บังคับ) |
payment_failure |
ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ |
สาเหตุ
การแจงนับสาเหตุที่ทำให้เกิดข้อผิดพลาด
| Enum | |
|---|---|
CAUSE_UNSPECIFIED |
ค่าเริ่มต้น: ไม่ใช้; เท่ากับ "ข้อผิดพลาดที่ไม่รู้จัก" |
SLOT_UNAVAILABLE |
ช่วงเวลาที่ว่างที่อ้างอิงไม่ว่างแล้ว |
SLOT_ALREADY_BOOKED_BY_USER |
ผู้ใช้ได้จองการนัดหมายสำหรับช่วงเวลาที่ว่างที่อ้างอิงแล้ว |
LEASE_EXPIRED |
สัญญาเช่า (หากมี) หมดอายุแล้วและไม่สามารถใช้เพื่อทำการจองที่ขอให้เสร็จสมบูรณ์ได้อีกต่อไป |
OUTSIDE_CANCELLATION_WINDOW |
เราไม่สามารถยกเลิกตามคำขอได้ในขณะนี้เนื่องจากข้อจำกัดด้านเวลาในนโยบายการยกเลิกของผู้ขาย |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ต้องระบุประเภทบัตรเครดิตใน rejected_card_type |
PAYMENT_ERROR_CARD_DECLINED |
เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากบัตรเครดิตที่ระบุถูกปฏิเสธ |
PAYMENT_OPTION_NOT_VALID |
พบข้อผิดพลาดเกี่ยวกับแพ็กเกจ/การเป็นสมาชิกที่ใช้ชำระเงินสำหรับการจอง อาจไม่มีการใช้งานที่ถูกต้องเหลืออยู่ บัตรอาจหมดอายุแล้ว ฯลฯ |
PAYMENT_ERROR |
เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินสำหรับการจองนี้ ใช้ค่านี้เพื่อระบุข้อผิดพลาดทั่วไปที่เกี่ยวข้องกับการชำระเงิน เฉพาะในกรณีที่ข้อผิดพลาดไม่ตรงกับข้อผิดพลาดในการชำระเงินที่เฉพาะเจาะจงด้านบน |
USER_CANNOT_USE_PAYMENT_OPTION |
ผู้ใช้ไม่สามารถใช้ตัวเลือกการชำระเงินที่ระบุได้ (เช่น ผู้ใช้พยายามใช้ราคาสำหรับครั้งแรกเป็นครั้งที่ 2) |
BOOKING_ALREADY_CANCELLED |
การจองที่ผู้ใช้พยายามยกเลิกถูกยกเลิกไปแล้ว |
BOOKING_NOT_CANCELLABLE |
การจองที่ผู้ใช้พยายามยกเลิกจะยกเลิกไม่ได้ |
OVERLAPPING_RESERVATION |
ผู้ใช้มีการจองที่ใกล้กับเวลานี้มากเกินไป |
USER_OVER_BOOKING_LIMIT |
การจองล้มเหลวเนื่องจากผู้ใช้จองเกินขีดจำกัดการจองต่อผู้ใช้ของตัวรวบรวม |
PAYMENT_REQUIRES_3DS1 |
ตั้งค่าเมื่อการชำระเงินถูกปฏิเสธเนื่องจากคุณขอให้ลองทำธุรกรรมอีกครั้ง แต่ครั้งนี้หลังจากผ่านการตรวจสอบ/ตอบกลับ 3DS1 โปรดทราบว่าสถานะการทำธุรกรรมปัจจุบันจะยังคงเป็น "ไม่สำเร็จ" การลองอีกครั้งจะแยกกันโดยสิ้นเชิง เมื่อเหตุผลที่ทำให้การชำระเงินไม่สำเร็จเป็นกรณีนี้ คุณต้องตั้งค่า payment_failure.3DS1_parameters หากไม่ใช่ ระบบจะถือว่าสาเหตุปัจจุบันเป็น PAYMENT_ERROR |
PaymentFailureInformation
ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ
| ช่อง | |
|---|---|
threeds1_parameters |
พารามิเตอร์ที่ใช้โดยผู้รวบรวม RwG เพื่อเริ่มโปรโตคอลการตรวจสอบสิทธิ์ 3DS1 กับผู้ใช้ ระบบจะไม่สนใจเว้นแต่จะตั้งค่า BookingFailure.cause เป็น PAYMENT_REQUIRES_3DS1 |
ThreeDS1Parameters
พารามิเตอร์ที่ขอให้ RwG ดำเนินการตรวจสอบ 3DS1
พารามิเตอร์ได้รับการตั้งค่าตามคำอธิบายโปรโตคอล 3DS1 ของ EMVCo
| ช่อง | |
|---|---|
acs_url |
URL ที่จะโหลดแบบฟอร์มเพื่อแสดงต่อผู้ใช้สำหรับการตรวจสอบสิทธิ์ |
pa_req |
คำขอการตรวจสอบสิทธิ์การชำระเงิน หากระบุไว้ ระบบจะโพสต์ไปยังแบบฟอร์ม ACSUrl |
transaction_id |
ตัวระบุที่ผู้ให้บริการ ACS ใช้ หากระบุไว้ ระบบจะโพสต์ไปยังแบบฟอร์ม ACSUrl |
md_merchant_data |
ข้อมูลผู้ขาย หากระบุไว้ ระบบจะโพสต์ไปยังแบบฟอร์ม ACSUrl |
BookingStatus
สถานะของการจอง
| Enum | |
|---|---|
BOOKING_STATUS_UNSPECIFIED |
ไม่ได้ระบุ |
CONFIRMED |
ยืนยันการจองแล้ว |
PENDING_MERCHANT_CONFIRMATION |
การจองอยู่ระหว่างรอการยืนยันจากผู้ขายก่อนที่จะเปลี่ยนเป็นสถานะยืนยันแล้ว (ปัจจุบันระบบไม่รองรับ) |
PENDING_CLIENT_CONFIRMATION |
การจองกำลังรอการยืนยันจากลูกค้าก่อนที่จะเปลี่ยนเป็นสถานะ CONFIRMED ได้ (ปัจจุบันระบบยังไม่รองรับ) |
CANCELED |
มีการยกเลิกการจองในนามของผู้ใช้ |
NO_SHOW |
ลูกค้าไม่มาตามนัดหมาย |
NO_SHOW_PENALIZED |
ลูกค้าไม่มาตามนัดหมายซึ่งเป็นการละเมิดนโยบายการยกเลิก |
FAILED |
จองไม่สำเร็จเนื่องจากประมวลผลไม่สำเร็จ |
DECLINED_BY_MERCHANT |
ผู้ขายปฏิเสธการจองแบบไม่พร้อมกัน |
CallMerchant
ประเภทนี้ไม่มีฟิลด์
ข้อความว่างที่จะใช้ใน UnsupportedPartySizeOption การตั้งค่านี้จะแสดงตัวเลือกให้ผู้ใช้โทรหาธุรกิจเพื่อทำการจอง
CancellationPolicy
นโยบายการยกเลิกสำหรับบริการ
| ช่อง | |
|---|---|
refund_condition[] |
เงื่อนไขการคืนเงินที่เกี่ยวข้องกับนโยบายตั้งแต่ 0 รายการขึ้นไป |
RefundCondition
กำหนดเงื่อนไขการคืนเงินรายการเดียว คุณสามารถใช้เงื่อนไขการคืนเงินหลายรายการร่วมกันเพื่ออธิบาย "ขั้นตอนการคืนเงิน" เป็นระยะเวลาต่างๆ ก่อนเวลาเริ่มต้นของบริการ
| ช่อง | |
|---|---|
min_duration_before_start_time |
ระยะเวลาก่อนเวลาเริ่มต้น จนถึงเวลาที่ลูกค้าจะได้รับเงินคืนสำหรับค่าใช้จ่ายบางส่วนของบริการที่ระบุไว้ใน |
refund_percent |
เปอร์เซ็นต์ที่คืนเงินได้ ตราบใดที่ยกเลิกการจองบริการอย่างน้อย |
ClientInformation
ข้อมูลส่วนบุคคลของผู้ที่ทำการจอง
| ช่อง | |
|---|---|
given_name |
ชื่อของลูกค้า |
family_name |
นามสกุลของลูกค้า |
address |
ที่อยู่ของไคลเอ็นต์ |
telephone |
หมายเลขโทรศัพท์ของลูกค้า |
email |
อีเมลของลูกค้า |
CreateAdsAccountLinkRequest
ข้อความคำขอสำหรับ AdsAccountLinkingService.CreateAdsAccountLink
| ช่อง | |
|---|---|
parent |
ต้องระบุ แหล่งข้อมูลหลักที่จะสร้างลิงก์บัญชี Google Ads นี้ ซึ่งเหมือนกับรหัสบัญชีศูนย์พาร์ทเนอร์ รูปแบบ: partners/{partner} |
ads_account_link_id |
ต้องระบุ รหัสที่จะใช้สําหรับการลิงก์บัญชี Google Ads ซึ่งเหมือนกับรหัสลูกค้า Google Ads ดูรายละเอียดได้ที่ https://support.google.com/google-ads/answer/1704344 รูปแบบ : xxx-xxx-xxxx |
ads_account_link |
ต้องระบุ AdsAccountLink ที่จะสร้าง |
CreateMerchantRequest
คำขอสร้าง Merchant
| ช่อง | |
|---|---|
parent |
ชื่อทรัพยากรหลักสำหรับพาร์ทเนอร์ที่เป็นเจ้าของผู้ขายรายนี้ในรูปแบบ |
merchant_id |
รหัสผู้ขายที่จะใช้สำหรับผู้ขายรายนี้ |
merchant |
ผู้ขายที่จะสร้าง |
CreateServiceRequest
คำขอสร้าง Service ใหม่
| ช่อง | |
|---|---|
parent |
ชื่อทรัพยากรหลักสำหรับผู้ขายที่เป็นเจ้าของบริการนี้ในรูปแบบ |
service_id |
รหัสบริการที่จะใช้สำหรับบริการนี้ |
service |
บริการที่จะสร้าง |
CreditCardRestrictions
ข้อจำกัดเกี่ยวกับประเภทบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ
| ช่อง | |
|---|---|
credit_card_type[] |
รายการบัตรเครดิตที่รองรับ ระบบไม่รองรับบัตรเครดิตหากไม่มีข้อมูล |
CreditCardType
ประเภทบัตรเครดิต
| Enum | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
ไม่ได้ใช้ |
VISA |
บัตรเครดิต Visa |
MASTERCARD |
บัตรเครดิต Mastercard |
AMERICAN_EXPRESS |
บัตรเครดิต American Express |
DISCOVER |
บัตรเครดิต Discover |
JCB |
บัตรเครดิต JCB |
DeleteAdsAccountLinkRequest
ข้อความคำขอสำหรับ AdsAccountLinkingService.DeleteAdsAccountLink
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อของ AdsAccountLink ที่จะลบ รูปแบบ: partners/{partner}/adsAccountLinks/{ads_account_link} |
DeleteMerchantRequest
คำขอให้ลบ Merchant
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของผู้ขายที่จะลบ ในรูปแบบ partners/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
คำขอให้ลบ Service
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของบริการที่จะลบ ในรูปแบบ |
เงินฝาก
เงินฝากที่ระบบอาจเรียกเก็บจากผู้ใช้หรือระงับไว้ในบัตรเครดิต
| ช่อง | |
|---|---|
deposit |
จำนวนเงินฝาก |
min_advance_cancellation_sec |
การยกเลิกล่วงหน้าขั้นต่ำสำหรับการฝากเงิน |
deposit_type |
กำหนดวิธีพิจารณาเงินฝากจากความพร้อมจำหน่ายสินค้า |
DirectMerchantPayment
ข้อมูลเกี่ยวกับวิธีที่ผู้ใช้สามารถชำระเงินให้ผู้ขายโดยตรงแทนการชำระเงินล่วงหน้าสำหรับบริการผ่าน RwG
| ช่อง | |
|---|---|
payment_methods[] |
เราขอแนะนำให้ผู้ใช้ชำระเงินผ่านวิธีการชำระเงินที่ระบุไว้ด้านล่างเท่านั้น |
DurationRange
Wrapper สำหรับช่วงระยะเวลาที่อาจมีขอบเขตหรือไม่ก็ได้ ต้องระบุระยะเวลา min_duration และ max_duration อย่างน้อย 1 รายการ
| ช่อง | |
|---|---|
min_duration |
ระยะเวลาขั้นต่ำ |
max_duration |
ระยะเวลาสูงสุด |
EconomicOperator
ข้อมูลผู้ประกอบการทางเศรษฐกิจสำหรับผู้รวบรวมข้อมูล
| ช่อง | |
|---|---|
text |
ต้องระบุ ชื่อ ที่อยู่ หมายเลขโทรศัพท์ และอีเมลของผู้ประกอบการทางเศรษฐกิจ ซึ่งหมายถึงผู้ผลิต ตัวแทนที่ได้รับอนุญาต ผู้นำเข้า ผู้จัดจำหน่าย ผู้ให้บริการจัดการสินค้า หรือบุคคลธรรมดาหรือนิติบุคคลอื่นๆ ที่มีภาระหน้าที่เกี่ยวข้องกับการผลิตผลิตภัณฑ์ การทำให้ผลิตภัณฑ์พร้อมจำหน่าย หรือการนำผลิตภัณฑ์ไปใช้งาน การแสดงสตริงรูปแบบอิสระของ economic_operator ข้อมูลนี้อาจจัดรูปแบบโดยใช้ " " และ "\n" |
ExtendedServiceAvailability
รายการความพร้อมใช้งานและผู้ที่ควรใช้/เวลาที่ควรใช้
| ช่อง | |
|---|---|
merchant_id |
นี่คือฟิลด์ที่ต้องระบุเพื่อระบุว่าข้อความความพร้อมด้านล่างเป็นของผู้ขายรายใด |
service_id |
นี่คือฟิลด์ที่ต้องระบุเพื่อระบุว่าข้อความความพร้อมด้านล่างเป็นของบริการใด |
start_time_restrict |
หากระบุไว้ เราจะพิจารณาเอนทิตีความพร้อมที่ระบุว่าเป็นสแนปชอตที่สมบูรณ์จาก [start_time_restrict, end_time_restrict) กล่าวคือ ระบบจะลบความพร้อมที่มีอยู่ทั้งหมดหากเงื่อนไขต่อไปนี้เป็นจริง หากตั้งค่าข้อความระยะเวลาไว้ เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้ หากตั้งค่าข้อความ resources_restrict ระบบจะจำกัดเงื่อนไขเพิ่มเติมดังนี้ โดยปกติแล้วจะใช้ช่องเหล่านี้เพื่ออัปเดตความพร้อมอย่างสมบูรณ์ในช่วงเวลาที่กำหนด การตั้งค่า start_time_restrict ขณะที่ปล่อยให้ end_time_restrict ไม่ได้ตั้งค่าไว้จะถือว่าหมายถึงเวลาทั้งหมดที่เริ่มต้นที่ start_time_restrict |
end_time_restrict |
การตั้งค่า end_time_restrict ขณะที่ปล่อยให้ start_time_restrict ไม่ได้ตั้งค่าไว้จะถือว่าหมายถึงเวลาทั้งหมดจนถึง end_time_restrict |
duration_restrict |
การตั้งค่าระยะเวลาจะจำกัดขอบเขตของการอัปเดตให้เหลือเฉพาะความพร้อมที่มีระยะเวลาตรงกัน |
resources_restrict |
การตั้งค่า resources_restrict จะจำกัดขอบเขตของการอัปเดตให้เหลือเพียงชุดทรัพยากรนี้ ฟิลด์รหัสทั้งหมดของทรัพยากรต้องตรงกันทุกประการ |
availability[] |
รายการเวลาว่างใหม่ |
FeedStatistics
สถิติที่ได้ขณะประมวลผลฟีดที่อัปโหลด
| ช่อง | |
|---|---|
new_items |
รายการที่ฟีดนี้เพิ่มใหม่ รายการอาจเป็นผู้ขาย บริการ หรือช่วงเวลาที่พร้อมให้บริการ ทั้งนี้ขึ้นอยู่กับประเภทฟีด |
existing_items |
สินค้าที่มีอยู่ซึ่งอัปเดตตามความจำเป็นจากข้อมูลใหม่กว่าในฟีด |
deleted_items |
สินค้าที่ไม่มีอยู่ในฟีดนี้อีกต่อไปและถูกนำออกไปแล้ว |
FeedStatus
สถานะของฟีดที่แพลตฟอร์มของผู้รวบรวมอัปโหลด
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรฟีดซึ่งมีรูปแบบเป็น
|
state |
สถานะการประมวลผลของฟีดนี้ |
error_details |
สตริงที่มนุษย์อ่านได้ซึ่งให้รายละเอียดเพิ่มเติมในกรณีที่เราประมวลผลฟีดนี้ไม่สำเร็จ |
statistics |
สถิติเฉพาะสำหรับฟีดนี้ |
รัฐ
Enum เพื่อระบุสถานะการประมวลผลของฟีด
| Enum | |
|---|---|
STATE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้ |
IN_PROGRESS |
ระบบยังคงประมวลผลฟีดอยู่ |
SUCCESS |
ประมวลผลฟีดเรียบร้อยแล้ว |
FAILURE |
เราพบข้อผิดพลาดขณะประมวลผลฟีด |
FoodOrderingMetadata
ข้อมูลเมตาสำหรับลิงก์การดำเนินการสั่งอาหาร
| ช่อง | |
|---|---|
fee_details[] |
รายละเอียดค่าธรรมเนียมที่เรียกเก็บจากผู้ใช้เพิ่มเติมจากยอดรวมของสินค้า ทำซ้ำสำหรับค่าธรรมเนียมประเภทต่างๆ เช่น ค่าบริการ ค่าธรรมเนียมการนำส่ง ฯลฯ |
advance_order_details |
รายละเอียดเกี่ยวกับการรองรับการสั่งซื้อขั้นสูงหรือที่เรียกว่าการสั่งซื้อล่วงหน้า ซึ่งผู้ใช้สามารถสั่งซื้อเพื่อดำเนินการตามคำสั่งซื้อในภายหลังได้ |
ฟิลด์ Union fulfillment_duration_options ระยะเวลาในการดำเนินการตามคำสั่งซื้อนับจากการยืนยันคำสั่งซื้อ สำหรับคำสั่งซื้อแบบนำส่ง ระยะเวลาจนกว่าจะนำส่งอาหาร สำหรับคำสั่งซื้อแบบไปรับเอง ระยะเวลาจนกว่าอาหารจะพร้อมให้ไปรับ fulfillment_duration_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
fulfillment_lead_time_duration |
ระยะเวลาคงที่ เช่น 30 นาที |
fulfillment_lead_time_duration_range |
ช่วงระยะเวลา ตัวอย่าง: * 30-45 นาที * มากกว่า 30 นาที * น้อยกว่า 50 นาที |
AdvanceOrderDetails
สำหรับการสนับสนุนการสั่งล่วงหน้า
| ช่อง | |
|---|---|
is_supported |
เป็นจริงหากรองรับการสั่งซื้อล่วงหน้า หรือที่เรียกว่าการสั่งซื้อล่วงหน้า (ต้องระบุ) |
FeeDetails
รายละเอียดค่าธรรมเนียม
| ช่อง | |
|---|---|
type |
ประเภทค่าธรรมเนียม (ต้องระบุ) |
fee_amount |
จำนวนค่าธรรมเนียมในสกุลเงินหน่วย เปอร์เซ็นต์ของมูลค่ารถเข็น หรือทั้ง 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 |
ค่าธรรมเนียมในรูปของเปอร์เซ็นต์ของมูลค่ารถเข็น รองรับช่วง (มีขอบเขตและไม่มีขอบเขต) หรือเปอร์เซ็นต์คงที่ ค่าควรอยู่ระหว่าง 0 ถึง 100 ตัวอย่าง: * คงที่ 5.5% * อย่างน้อย 5.5% * อย่างมาก 5.5% * 4.5% ถึง 5.5% |
ฟิลด์ Union amount_options ตัวเลือกในการระบุจำนวนเงิน amount_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
amount |
จำนวนเงินที่กำหนด เช่น 35 THB |
amount_range |
ช่วงของจำนวนเงิน ตัวอย่าง * 35 THB ถึง 55 THB * อย่างน้อย 35 THB * อย่างมาก 55 THB |
amount_unknown |
จำนวนเงินที่ไม่รู้จัก |
FeeType
ประเภทค่าธรรมเนียม
| Enum | |
|---|---|
FEE_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทค่าธรรมเนียม |
DELIVERY |
สำหรับค่าจัดส่ง |
SERVICE |
สำหรับค่าบริการ |
FulfillmentOption
ตัวเลือกการดำเนินการตามคำสั่งซื้อสำหรับลิงก์การดำเนินการสั่งซื้อออนไลน์
| ช่อง | |
|---|---|
fulfillment_type |
ต้องระบุ ประเภทการดำเนินการตามคำสั่งซื้อ |
available_day[] |
ต้องระบุ รายการวันที่ที่มีเวลาว่างสำหรับวิธีการจัดการคำสั่งซื้อนี้ (ควรมีอย่างน้อย 2 วัน) |
fee_details |
ต้องระบุ รายละเอียดค่าธรรมเนียมสำหรับวิธีการจัดการคำสั่งซื้อ |
minimum_order |
ต้องระบุ คำสั่งซื้อขั้นต่ำสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ |
AvailableDay
ความพร้อมระดับวัน
| ช่อง | |
|---|---|
fulfillment_date |
ต้องระบุ วันที่ที่พร้อมให้บริการสำหรับวิธีการจัดการคำสั่งซื้อ ถือว่าอยู่ในเขตเวลาของผู้ขาย |
last_ordering_time |
ต้องระบุ การประทับเวลา Unix ครั้งสุดท้ายที่ผู้ใช้จะสั่งซื้อและรับสินค้าได้ภายในวันที่ ตัวอย่างเช่น หาก fulfillment_date คือ 2020-08-10 - ค่า last_ordering_time เป็น 2020-08-10 18:00 หมายความว่าลูกค้าต้องสั่งซื้อภายในเวลา 18:00 น. ของวันเดียวกันจึงจะได้รับสินค้าในวันที่ 2020-08-10 ค่า last_ordering_time เป็น 2020-08-08 20:00 หมายความว่าลูกค้าต้องสั่งซื้อภายใน 20:00 น. ของวันที่ 8 สิงหาคม 2020 จึงจะได้รับสินค้าในวันที่ 10 สิงหาคม 2020 |
FeeDetails
รายละเอียดค่าธรรมเนียมสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ
| ช่อง | |
|---|---|
ฟิลด์ Union fee_details รูปแบบค่าธรรมเนียมสำหรับวิธีการจัดการคำสั่งซื้อ fee_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
no_fee |
ไม่มีค่าธรรมเนียมสำหรับวิธีการปฏิบัติตามคำสั่งซื้อ |
base_fee |
ค่าธรรมเนียมพื้นฐานที่เชื่อมโยงกับวิธีการดำเนินการตามคำสั่งซื้อ |
fixed_fee |
ค่าธรรมเนียมคงที่ที่เชื่อมโยงกับวิธีการดำเนินการตามคำสั่งซื้อ |
FixedFee
ค่าธรรมเนียมคงที่ที่จำเป็นสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ
| ช่อง | |
|---|---|
amount |
ต้องระบุ จำนวนค่าธรรมเนียมคงที่สำหรับวิธีการจัดการคำสั่งซื้อ |
FulfillmentType
ประเภท Fulfillment ที่เชื่อมโยงกับลิงก์การดำเนินการ
| Enum | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทการดำเนินการตามคำสั่งซื้อ |
FULFILLMENT_TYPE_DELIVERY |
ประเภทการดำเนินการตามคำสั่งซื้อคือการนำส่ง |
FULFILLMENT_TYPE_PICKUP |
ประเภทการดำเนินการตามคำสั่งซื้อคือการรับสินค้า |
MinimumFee
ค่าธรรมเนียมขั้นต่ำที่จำเป็นสำหรับวิธีการดำเนินการตามคำสั่งซื้อที่เชื่อมโยงกับลิงก์การดำเนินการ
| ช่อง | |
|---|---|
base_fee_amount |
ต้องระบุ จำนวนค่าธรรมเนียมพื้นฐานสำหรับวิธีการจัดการคำสั่งซื้อ |
NoFee
ประเภทนี้ไม่มีฟิลด์
ไม่ต้องเสียค่าธรรมเนียมสำหรับวิธีการดำเนินการตามคำสั่งที่เชื่อมโยงกับลิงก์การดำเนินการ
GenericDeleteRecord
บันทึกที่จะลบของประเภทฟีดที่ระบุในคำขอ URL
| ช่อง | |
|---|---|
delete_time |
ต้องระบุ ระบบจะใช้การประทับเวลาเพื่อกำหนดลำดับที่จะใช้การลบกับพื้นที่โฆษณา |
ฟิลด์ Union record_type แคปซูลฟีดประเภทต่างๆ (ndjson, อิงตาม Proto ฯลฯ) พาร์ทเนอร์สามารถระบุระเบียนแบบเต็มได้ในลักษณะเดียวกับการระบุระเบียนในฟีดหรือ BatchPush API นอกจากนี้ พาร์ทเนอร์ยังมีตัวเลือกในการรวมเฉพาะฟิลด์ที่จำเป็นของระเบียนที่จำเป็นต่อการระบุระเบียนนั้นๆ โดยไม่ซ้ำกัน record_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
data_record |
สำหรับฟีดที่ไม่ได้อิงตาม Proto |
proto_record |
สำหรับฟีดที่อิงตาม Proto |
GenericRecord
บันทึกประเภทฟีดที่ระบุในคำขอ URL
| ช่อง | |
|---|---|
generation_timestamp |
ต้องระบุ ระบบใช้การประทับเวลานี้เพื่อให้มั่นใจว่าการอัปเดตสินค้าคงคลังจะเรียงตามลำดับที่ถูกต้อง |
ฟิลด์ Union record_type แคปซูลฟีดประเภทต่างๆ (ndjson, อิงตาม Proto ฯลฯ) record_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
data_record |
สำหรับฟีดที่ไม่ได้อิงตาม Proto |
proto_record |
สำหรับฟีดที่อิงตาม Proto |
GeoCoordinates
ข้อมูลทางภูมิศาสตร์ของสถานที่ ซึ่งรวมถึงละติจูด ลองจิจูด และที่อยู่
| ช่อง | |
|---|---|
latitude |
ละติจูดเป็นองศา (ไม่บังคับ) |
longitude |
ลองจิจูดเป็นองศา (ไม่บังคับ) |
ฟิลด์ Union addresses ที่อยู่ของสถานที่ตั้ง ซึ่งอาจมีโครงสร้างหรือไม่มีโครงสร้างก็ได้ addresses ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
address |
ที่อยู่ทางไปรษณีย์ของสถานที่ตั้ง (แนะนำ) |
unstructured_address |
นอกจากนี้ยังระบุที่อยู่ที่ไม่มีโครงสร้างเป็นข้อมูลสำรองได้ด้วย เช่น "1600 amphitheatre parkway mountain view, ca 94043" |
GetAdsAccountLinkRequest
ข้อความคำขอสำหรับ AdsAccountLinkingService.GetAdsAccountLink
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อของลิงก์บัญชี Google Ads ที่จะดึงข้อมูล รูปแบบ: |
GetMerchantStatusRequest
คำขอรับ MerchantStatus
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรในรูปแบบ partners/{partner_id}/merchants/{merchant_id}/status |
GetStatusRequest
คำขอเรียกข้อมูล Status สำหรับฟีดที่เฉพาะเจาะจงซึ่งแพลตฟอร์มของผู้รวบรวมอัปโหลด
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรฟีดซึ่งมีรูปแบบเป็น
|
HomeServiceData
ข้อมูลเพิ่มเติมที่ต้องระบุสำหรับหมวดหมู่บริการเกี่ยวกับบ้าน
| ช่อง | |
|---|---|
category_type |
หมวดหมู่ระดับสูงที่บริการในบ้านนี้สังกัดอยู่ เช่น ช่างประปา ช่างไฟฟ้า เป็นต้น |
job_type |
ประเภทงานภายใต้หมวดหมู่ที่บริการในบ้านที่ระบุเป็นของ เช่น 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 |
ชื่อของทรัพยากรที่จะทำให้ไม่ถูกต้อง เช่น สำหรับทรัพยากรการรับสินค้า ชื่อควรมีรูปแบบ |
LineItem
รายการเดียวในคำสั่งซื้อ ซึ่งก็คือการจองบริการเดียวในช่วงเวลาเดียว
| ช่อง | |
|---|---|
service_id |
รหัสของบริการผู้ขาย |
start_sec |
เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมายในหน่วยวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch |
duration_sec |
ระยะเวลาของช่วงเวลาที่สะดวกสำหรับนัดหมายเป็นวินาที |
tickets[] |
จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว |
price |
ราคารวม (ไม่รวมภาษี) ของรายการโฆษณานี้ |
status |
สถานะของรายการโฆษณา |
OrderedTickets
จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว
| ช่อง | |
|---|---|
ticket_id |
รหัสของประเภทตั๋ว |
count |
จำนวนตั๋วที่สั่งซื้อสำหรับประเภทนี้ |
LinkoutTemplate
เทมเพลตที่ระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ของพาร์ทเนอร์
| ช่อง | |
|---|---|
uri_template |
เทมเพลต URI ต้องเป็นไปตาม RFC 6570 ดู https://datatracker.ietf.org/doc/html/rfc6570 รองรับเทมเพลตระดับ 1 และเทมเพลตผสมระดับ 4 ทั้งหมด เช่น http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc |
ListMerchantStatusesRequest
คำขอรับรายการ MerchantStatus
| ช่อง | |
|---|---|
parent |
ต้องระบุ องค์กรหลักที่เป็นเจ้าของคอลเล็กชันสถานะผู้ขายนี้ รูปแบบ: |
page_size |
ต้องระบุ จำนวนสูงสุดของรายการที่จะแสดง โปรดทราบว่าเซิร์ฟเวอร์อาจลดขนาดหน้าเว็บ |
page_token |
ไม่บังคับ ค่า nextPageToken ที่แสดงผลจาก ListMerchantStatusResponse ก่อนหน้า (หากมี) |
booking_inventory_status_restrict |
ไม่บังคับ การจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะพื้นที่โฆษณาสำหรับการจอง |
waitlist_inventory_status_restrict |
ไม่บังคับ การจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะสินค้าคงคลังในรายการรอ |
geo_match_restrict |
ไม่บังคับ การจำกัดที่ไม่บังคับเพื่อกรองผลลัพธ์ตามสถานะการจับคู่ทางภูมิศาสตร์ |
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[] |
รายการสถานะผู้ขายที่ตรงตามเงื่อนไขตัวกรอง |
next_page_token |
โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไป ไม่มีผลการค้นหาเพิ่มเติมในรายการหากว่างเปล่า |
ListStatusRequest
คำขอเรียกข้อมูล Status สำหรับฟีดหลายรายการที่แพลตฟอร์มของผู้รวบรวมอัปโหลด
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรฟีดซึ่งมีรูปแบบเป็น
|
page_size |
จำนวนสูงสุดของรายการที่จะแสดง |
page_token |
ค่า next_page_token ที่แสดงผลจากคำขอ List ก่อนหน้า (หากมี) |
state_restrict |
ไม่บังคับ: จำกัดเพื่อกรองผลลัพธ์ตามสถานะฟีด |
time_range_restrict |
ไม่บังคับ: จำกัดเพื่อกรองผลลัพธ์ตามขอบเขตบนและล่าง หากไม่ได้ตั้งค่า start_time ระบบจะใช้ค่าเริ่มต้นเป็นจุดเริ่มต้นของเวลา Unix หากไม่ได้ตั้งค่า end_time ระบบจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น |
ListStatusResponse
คำขอเรียกข้อมูล Status สำหรับฟีดหลายรายการที่แพลตฟอร์มของผู้รวบรวมอัปโหลด
| ช่อง | |
|---|---|
status[] |
รายการสถานะของฟีดที่อัปโหลดตามลำดับเวลาแบบย้อนหลัง จำนวนรายการสูงสุดที่แสดงจะอิงตามฟิลด์ page_size ในคำขอ |
next_page_token |
โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไป ไม่มีผลการค้นหาเพิ่มเติมในรายการหากว่างเปล่า |
LocalizedString
อินสแตนซ์ของสตริงในภาษาเดียว
| ช่อง | |
|---|---|
locale |
รหัสภาษา IETF BCP 47 เช่น "en", "mas", "zh-Hant", "de-CH-1901" ดูที่ http://www.w3.org/International/articles/language-tags/ |
value |
ข้อความในภาษาข้างต้น (UTF-8) |
ตำแหน่ง
ข้อมูลทางภูมิศาสตร์เกี่ยวกับสถานที่
| ช่อง | |
|---|---|
place_id |
รหัสสถานที่สำหรับสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id หากระบุข้อมูลนี้ Google จะจับคู่ตำแหน่งกับสถานที่นี้ |
name |
ระบบจะใช้ชื่อ โทรศัพท์ URL และพิกัดทางภูมิศาสตร์ของสถานที่เพื่อช่วยจับคู่สถานที่กับสถานที่ที่มีอยู่ใน Google Maps อยู่แล้ว ช่องนี้เป็นข้อมูลที่ไม่บังคับ แต่ในบางบริบทอาจต้องระบุ ตัวอย่างเช่น ระบบจะไม่จับคู่ Service.location ที่ไม่มีชื่อกับองค์กรธุรกิจ แม้ว่าจะอยู่ที่เดียวกันก็ตาม (ไม่บังคับ) |
telephone |
หมายเลขโทรศัพท์สาธารณะของสถานที่ตั้ง รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 (ไม่บังคับ) |
url |
URL ของเว็บไซต์สาธารณะของสถานที่ (ไม่บังคับ) |
geo |
ข้อมูลทางภูมิศาสตร์ของสถานที่ ซึ่งรวมถึงละติจูด ลองจิจูด และที่อยู่ (ไม่บังคับ) |
location_type |
ต้องระบุประเภทของสถานที่หากระบุสถานที่นี้สำหรับบริการ |
location_id |
การอ้างอิงที่ไม่ซ้ำกันของสถานที่ตั้งภายในบริการ รหัสนี้ใช้เพื่ออ้างอิงตำแหน่งนี้ในช่องบริการอื่นๆ ได้ เช่น ในแบบฟอร์มรับข้อมูลที่กำหนดเอง คุณสามารถใช้ชุดรหัสสถานที่ตั้งเพื่อระบุตัวเลือกสถานที่รับสินค้าได้ หากตั้งค่าไว้ รหัสนี้ควรไม่ซ้ำกันภายในบริการเดียวกัน (ไม่บังคับ) |
LocationType
ประเภทของสถานที่ตั้งนี้
| Enum | |
|---|---|
LOCATION_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทสถานที่ตั้ง |
VISITED_LOCATION |
สถานที่ที่บริการนี้ไป |
START_LOCATION |
สถานที่ที่บริการนี้เริ่มต้นจะทำหน้าที่เป็น MEETING_LOCATION ด้วย |
END_LOCATION |
สถานที่ที่บริการนี้สิ้นสุด |
ผู้ขาย
ข้อมูลเกี่ยวกับผู้ขายที่อยู่ในแพลตฟอร์มของผู้รวบรวมข้อมูล
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของผู้ขายซึ่งมีรูปแบบ |
merchant_name |
ระบบจะใช้ merchant_name, telephone, url และ geo เพื่อรองรับการจับคู่สินค้าคงคลังของพาร์ทเนอร์กับผู้ขายที่มีอยู่ใน Google Maps อยู่แล้ว ระบบจะไม่แสดงข้อมูลนี้ ชื่อผู้ขาย |
telephone |
หมายเลขโทรศัพท์สาธารณะของผู้ขาย รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 |
url |
URL ของเว็บไซต์สาธารณะของผู้ขาย |
geo |
ข้อมูลทางภูมิศาสตร์ของผู้ขาย ซึ่งรวมถึงละติจูด ลองจิจูด และที่อยู่ |
category |
หมวดหมู่ของธุรกิจในแพลตฟอร์มของผู้รวบรวมข้อมูล |
num_bookings_30d |
ช่องนี้เลิกใช้งานแล้ว |
tax_rate_basis_points |
อัตราภาษีของผู้ขายในหน่วย Basis Point (1/100 ของ 1 เปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 7.5% คุณควรตั้งค่าช่องนี้เป็น 750 หากไม่ได้ตั้งค่าช่องนี้หรือตั้งค่าเป็น 0 ราคาที่เรียกเก็บจากผู้ใช้สำหรับบริการใดๆ ที่ผู้ขายรายนี้ให้บริการจะเป็นราคาที่แน่นอนซึ่งระบุโดย Service.price ระบบจะถือว่าราคาบริการได้รับการยกเว้นหรือรวมภาษีที่เกี่ยวข้องไว้แล้ว ระบบจะไม่แสดงภาษีต่อผู้ใช้เป็นบรรทัดรายการแยกต่างหาก หากตั้งค่าฟิลด์นี้เป็นค่าใดก็ตามที่ไม่ใช่ 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดก็ตามที่ผู้ขายรายนี้ให้บริการจะรวมราคาบริการบวกภาษีที่ประเมินโดยใช้อัตราภาษีที่ระบุไว้ที่นี่ ระบบจะปัดเศษเศษส่วนของหน่วยสกุลเงินที่เล็กที่สุด (เช่น เศษส่วนของ 1 เซ็นต์) โดยใช้การปัดเศษคู่ที่ใกล้ที่สุด ระบบจะแสดงภาษีต่อผู้ใช้เป็นบรรทัดรายการแยกต่างหาก ฟิลด์นี้เลิกใช้งานแล้ว โปรดใช้ tax_rate แทน |
tax_rate |
อัตราภาษีของผู้ขาย หากมี ฟิลด์นี้จะลบล้างฟิลด์ tax_rate_basis_points ที่เลิกใช้งานแล้ว ข้อความที่ว่างเปล่า (เช่น tax_rate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 เลิกใช้งานแล้วเนื่องจากไม่รองรับการชำระเงินแบบ E2E อีกต่อไป |
payment_restrictions |
ข้อจำกัดของวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ เราจะถือว่าไม่มีข้อจำกัดหากไม่ได้ตั้งค่าฟิลด์นี้ เลิกใช้งานแล้วเนื่องจากไม่รองรับการชำระเงินแบบ E2E อีกต่อไป |
payment_option[] |
ตัวเลือกการชำระเงินที่ใช้ได้กับผู้ขายรายนี้ บริการภายใต้ผู้ขายรายนี้จะสามารถจำกัดตัวเลือกการชำระเงินที่อนุญาตได้ทีละรายการ เลิกใช้งานแล้วเนื่องจากไม่รองรับการชำระเงินแบบ E2E อีกต่อไป |
payment_processor_config |
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินด้วยโทเค็น หากผู้ขายรองรับ |
tokenization_config |
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินด้วยโทเค็น หากผู้ขายรองรับ เลิกใช้งานแล้วเนื่องจากไม่รองรับการชำระเงินแบบ E2E อีกต่อไป |
terms |
ข้อกำหนดและเงื่อนไขของผู้ขายที่เฉพาะเจาะจงซึ่งแสดงต่อผู้ใช้เมื่อมีการจองบริการผ่านจองกับ Google นอกจากนี้ ข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ที่เป็นเครื่องมือรวบรวมจะแสดงต่อผู้ใช้เสมอ และไม่ควรระบุไว้ที่นี่ |
brand_id |
สตริงทึบแสงที่ระบุแบรนด์สำหรับผู้บริโภคเพื่อใช้เมื่อแสดงการระบุแหล่งที่มาของพาร์ทเนอร์ ฟิลด์นี้ช่วยให้พาร์ทเนอร์ที่มีแบรนด์ที่แสดงต่อผู้บริโภคหลายแบรนด์สามารถระบุผู้ขายสำหรับทุกแบรนด์ภายในฟีดเดียวกันได้ แบรนด์ประกอบด้วยพร็อพเพอร์ตี้สำหรับผู้บริโภค เช่น ชื่อ โลโก้ ข้อกำหนดในการให้บริการ และนโยบายความเป็นส่วนตัว หากมีแบรนด์พาร์ทเนอร์สำหรับผู้บริโภคเพียงแบรนด์เดียว ก็ไม่จำเป็นต้องตั้งค่าช่องนี้และสามารถละเว้นได้ หากพาร์ทเนอร์... ไม่มีแบรนด์สำหรับผู้บริโภคหลายแบรนด์ --> ละเว้นช่องนี้ มีการกำหนดค่าแบรนด์หลายรายการ หมายเหตุสำคัญ: พาร์ทเนอร์ส่วนใหญ่ไม่จำเป็นต้องตั้งค่าช่องนี้ หากพาร์ทเนอร์ต้องการใช้ช่องนี้ พาร์ทเนอร์ต้องติดต่อเราก่อนเพื่อกำหนดค่ายี่ห้อแยกต่างหาก รวมถึงยี่ห้อเริ่มต้น |
matching_hints |
คำแนะนำที่จะช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps ได้ หมายเหตุ: พาร์ทเนอร์ส่วนใหญ่ไม่จำเป็นต้องตั้งค่าฟิลด์นี้ เนื่องจาก Google จะจับคู่ผู้ขายกับสถานที่ใน Google Maps โดยใช้ข้อมูลที่ระบุไว้ข้างต้น (ไม่บังคับ) |
service_attribute[] |
คำจำกัดความของแอตทริบิวต์บริการที่ใช้เพื่ออธิบายบริการสำหรับผู้ขายรายนี้ (ไม่บังคับ) |
action_link[] |
ไม่บังคับ URL การดำเนินการพร้อมภาษาที่เชื่อมโยง รายชื่อประเทศที่ถูกจำกัด ประเภท และแพลตฟอร์มที่ไม่บังคับซึ่งระบุแพลตฟอร์มที่ควรดำเนินการนี้ |
reservation_linkout_template[] |
ไม่บังคับ เทมเพลตลิงก์ออกที่ระบุวิธีที่ Google ควรสร้าง URL ของพาร์ทเนอร์เพื่อจองโต๊ะบนแพลตฟอร์มของพาร์ทเนอร์ โปรดทราบว่าปัจจุบันระบบจะใช้เฉพาะรายการแรกเท่านั้นหากมีการระบุหลายรายการ เทมเพลต URI รองรับฟิลด์ที่จะได้รับการป้อนข้อมูลตามตัวเลือกการจองของผู้ใช้ โดยคุณต้องระบุฟิลด์ที่จำเป็นทั้งหมดเพื่อสร้าง URL การจองให้สำเร็จ * (ต้องระบุ) party_size, int: ขนาดของกลุ่มที่ผู้ใช้ขอจอง * (ต้องระบุ) selected_date_time, วันที่และเวลา ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): เวลาที่ผู้ใช้ขอจอง * (ไม่บังคับ) merchant_id, สตริง: รหัสผู้ขายที่ผู้ใช้ขอทำการจอง ไม่จำเป็นหากเทมเพลตมีรหัสระบุผู้ขายอยู่แล้ว * (ไม่บังคับ) room_id, สตริง: รหัสของห้องที่ผู้ใช้ขอจอง |
waitlist_advisement |
ไม่บังคับ คำแนะนำทั่วไปจากผู้ขายที่เฉพาะเจาะจงสำหรับผู้ใช้ที่เข้าร่วมคิวรอผ่าน "จองกับ Google" ฟิลด์ข้อความแต่ละรายการในคำแนะนำควรมีความยาวไม่เกิน 100 ไบต์ |
economic_operator |
ไม่บังคับ ข้อมูลผู้ประกอบการทางเศรษฐกิจที่เชื่อมโยงกับผู้ขายรายนี้ซึ่งจำเป็นต่อการปฏิบัติตามกฎระเบียบ (ไม่บังคับ) |
MerchantMatchingHints
คำใบ้ที่ใช้เพื่อช่วย Google จับคู่ผู้ขายกับสถานที่ใน Google Maps
| ช่อง | |
|---|---|
place_id |
รหัสสถานที่สำหรับสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id |
MerchantStatus
สถานะของผู้ขายในแพลตฟอร์ม "จองกับ Google"
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรสถานะผู้ขายซึ่งมีรูปแบบเป็น |
merchant_name |
ชื่อผู้ขายที่พาร์ทเนอร์ระบุ |
input_geo_info |
พาร์ทเนอร์ให้ข้อมูลทางภูมิศาสตร์ของผู้ขาย |
processing_status |
สถานะการประมวลผลของผู้ขาย |
booking_status |
สถานะที่เกี่ยวข้องกับการผสานรวมการจองแบบครบวงจร |
waitlist_status |
สถานะที่เกี่ยวข้องกับการผสานรวมคิวรอ |
geo_match |
สถานที่ทางภูมิศาสตร์ที่ตรงกันของผู้ขายรายนี้ เว้นว่างไว้หากผู้ขายไม่ได้จับคู่ทางภูมิศาสตร์ |
local_services_match |
การจับคู่บริการในพื้นที่ของผู้ขายรายนี้ ว่างเปล่าหากไม่ใช่ผู้ขายบริการในพื้นที่หรือไม่ตรงกับผู้ให้บริการรายใด |
direct_urls[] |
รายการ URL เพื่อแสดงเนื้อหาของสินค้าคงคลังของผู้ขายปัจจุบัน โปรดทราบว่าไม่ได้หมายความว่าระบบจะแสดงพื้นที่โฆษณาจริง และ URL อาจแตกต่างจาก URL ที่แสดงต่อสาธารณะ |
BookingStatus
สถานะที่เกี่ยวข้องกับการผสานรวมการจองแบบครบวงจร
| ช่อง | |
|---|---|
has_valid_future_inventory |
เป็นจริงหากผู้ขายมีสินค้าคงคลังในอีก 30 วันข้างหน้า ไม่ได้เป็นการรับประกันว่าผู้ขายจะได้รับการแสดงผลจริง |
DirectUrl
URL ที่แสดงผู้ขาย
| ช่อง | |
|---|---|
type |
ประเภทของ URL นี้ |
url |
URL ที่อาจแสดงผู้ขายรายนี้ |
UrlType
ประเภทของ URL ที่แสดง
| Enum | |
|---|---|
URL_TYPE_UNSPECIFIED |
ไม่ได้ระบุ |
BOOKING |
URL การจองแบบครบวงจร |
WAITLIST |
URL รายชื่อผู้รอแบบครบวงจร |
LOCAL_SERVICES |
URL ของบริการในพื้นที่ของ Google |
LocalServicesMatchInfo
ข้อมูลการจับคู่บริการในพื้นที่ของ Google (ตั้งค่าสำหรับผู้ขายบริการในพื้นที่เท่านั้น)
| ช่อง | |
|---|---|
matched_providers[] |
ผู้ให้บริการที่ตรงกัน ระบบจะจับคู่ผู้ขายกับผู้ให้บริการหลายรายได้ |
MatchedProvider
ผู้ให้บริการในพื้นที่
| ช่อง | |
|---|---|
customer_id |
รหัสลูกค้าภายนอกของบริการในพื้นที่ของ Google |
categories[] |
หมวดหมู่บริการในพื้นที่ (อุตสาหกรรมเฉพาะ) เช่น "ช่างประปา" และ "carpet_cleaning" |
PlaceInfo
ข้อมูลของสถานที่ที่ตรงกัน
| ช่อง | |
|---|---|
name |
ชื่อสถานที่ |
formatted_address |
ที่อยู่ที่จัดรูปแบบแล้วในภาษาท้องถิ่น |
place_id |
รหัสสถานที่ของ Google ของสถานที่นี้ ใช้เพื่อสร้าง URL ของ Google Maps หรือดึงรายละเอียดเพิ่มเติมของสถานที่ได้ ดูตัวอย่างการใช้งานได้ที่ https://developers.google.com/places/web-service/place-id |
ProcessingStatus
สถานะการประมวลผลของผู้ขาย
| Enum | |
|---|---|
PROCESSING_STATUS_UNSPECIFIED |
ไม่ได้ระบุสถานะ |
IN_PROGRESS |
Madden ได้รับข้อมูลผู้ขายแล้ว แต่ยังคงประมวลผลอยู่ ผู้ขายที่มีสถานะนี้จะไม่มีสถานะอื่นๆ |
COMPLETED |
ระบบได้คำนวณสถานะอื่นๆ ของผู้ขายแล้ว |
WaitlistStatus
สถานะที่เกี่ยวข้องกับการผสานรวมคิวรอ
| ช่อง | |
|---|---|
has_valid_waitlist_service |
เป็นจริงหากผู้ขายมีบริการคิวรอ ไม่ได้เป็นการรับประกันว่าผู้ขายจะได้รับการแสดงผลจริง |
MoneyRange
Wrapper สำหรับช่วงของจำนวนเงินที่อาจมีขอบเขตหรือไม่ก็ได้ ต้องระบุ min_amount และ max_amount อย่างน้อย 1 รายการ
| ช่อง | |
|---|---|
min_amount |
จำนวนเงินขั้นต่ำ |
max_amount |
จำนวนเงินสูงสุด |
NoShowFee
ค่าธรรมเนียมที่ระบบอาจเรียกเก็บจากผู้ใช้ในกรณีที่จองแล้วแต่ไม่เข้าพัก
| ช่อง | |
|---|---|
fee |
จำนวนเงินที่ระบบอาจเรียกเก็บจากผู้ใช้หากไม่มาตามเวลาที่จองไว้ |
fee_type |
กำหนดวิธีพิจารณาค่าธรรมเนียมจากความพร้อมจำหน่ายสินค้า |
สั่งซื้อ
คำสั่งซื้อสำหรับการนัดหมายรับบริการกับผู้ขาย
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของคำสั่งซื้อ: |
client_information |
ข้อมูลส่วนบุคคลของลูกค้าที่ทำการสั่งซื้อ |
payment_information |
ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับคำสั่งซื้อ |
merchant_id |
รหัสของผู้ขายที่บริการทั้งหมดในคำสั่งซื้อนี้เป็นของผู้ขายรายนั้น |
item[] |
รายการโฆษณาในคำสั่งซื้อนี้ |
OrderOnlineMetadata
ข้อมูลเมตาสำหรับลิงก์การดำเนินการสั่งซื้อออนไลน์
| ช่อง | |
|---|---|
fulfillment_option[] |
ตัวเลือกการดำเนินการตามคำสั่งซื้อที่ใช้ได้สำหรับลิงก์การดำเนินการสั่งซื้อออนไลน์ |
PaymentInformation
รายละเอียดการชำระเงินที่เกี่ยวข้องกับการจอง
| ช่อง | |
|---|---|
prepayment_status |
สถานะการชำระเงินล่วงหน้าของการจอง หาก prepayment_status เป็น PREPAYMENT_PROVIDED หรือ PREPAYMENT_REFUNDED แสดงว่า payment_transaction_id มีรหัสธุรกรรมที่ไม่ซ้ำที่เชื่อมโยง |
payment_transaction_id |
ตัวระบุที่ไม่ซ้ำกันสำหรับธุรกรรมการชำระเงินที่เชื่อมโยงกับการจอง โดยจะเว้นว่างไว้หากไม่เกี่ยวข้อง |
PaymentOption
ตัวเลือกการชำระเงินที่ใช้ชำระค่าบริการที่ผู้ขายให้บริการได้ ตัวเลือกการชำระเงินสามารถแชร์ระหว่างผู้ขายหลายรายได้ (เช่น ผู้ขายที่อยู่ในเครือเดียวกัน)
| ช่อง | |
|---|---|
payment_option_id |
รหัสนี้ใช้เพื่อระบุตัวเลือกการชำระเงินนี้ รหัสนี้เป็นรหัสส่วนกลางสำหรับผู้รวบรวมข้อมูลทั้งหมด และการนำค่ากลับมาใช้ซ้ำในผู้ขายหลายรายจะช่วยให้ผู้ใช้ชำระเงินด้วยตัวเลือกการชำระเงินที่เกี่ยวข้องในผู้ขายเหล่านั้นได้ เมื่อใช้รหัสซ้ำในผู้ขายหลายราย การอัปเดตค่าใดๆ สำหรับตัวเลือกการชำระเงินภายใต้ผู้ขายรายหนึ่งจะอัปเดตตัวเลือกการชำระเงินอื่นๆ ที่มีรหัสเดียวกันภายใต้ผู้ขายรายอื่นด้วย ดังนั้นแนวทางปฏิบัติแนะนำคือให้ตัวเลือกการชำระเงินทั้งหมดใช้รหัสเดียวกัน และอัปเดตค่าให้เหมือนกันอยู่เสมอ เพื่อหลีกเลี่ยงความเป็นไปได้ที่จะเกิดพฤติกรรมที่บ่อนทำลาย |
name |
ชื่อตัวเลือกการชำระเงิน ซึ่งผู้ใช้จะมองเห็นได้ |
description |
คำอธิบายตัวเลือกการชำระเงิน ซึ่งผู้ใช้จะมองเห็นได้ |
price |
ราคาของตัวเลือกการชำระเงิน |
tax_rate |
อัตราภาษีสำหรับตัวเลือกการชำระเงินนี้ หากมี ช่องนี้จะลบล้างช่อง tax_rate ที่มีอยู่ในผู้ขายหรือบริการ ข้อความที่ว่างเปล่า (เช่น tax_rate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
payment_option_type |
ประเภทของตัวเลือกการชำระเงินนี้ ใช้ครั้งเดียวสำหรับการโทรดรอปอิน ใช้ได้หลายครั้งสำหรับแพ็ก และใช้ได้ไม่จำกัดสำหรับการเป็นสมาชิก |
session_count |
จำนวนเซสชันที่ใช้ตัวเลือกการชำระเงินนี้ได้ ใช้ได้เฉพาะกับแพ็กเกจ / หลายเซสชัน โดยค่าควรมากกว่า 1 |
purchase_interval |
คุณซื้อตัวเลือกการชำระเงินได้ภายในช่วงเวลานี้ |
valid_interval |
คุณสามารถใช้ตัวเลือกการชำระเงินภายในช่วงเวลานี้ได้ (เช่น ราคาพิเศษสำหรับเดือนมกราคม 2017) หากมี ค่านี้จะลบล้าง valid_duration และ activation_type |
valid_duration |
ระยะเวลาที่ตัวเลือกการชำระเงินมีผล (เช่น การเป็นสมาชิก 30 วัน) |
activation_type |
กำหนดวิธีกำหนดวันที่เริ่มต้นอายุการใช้งานสำหรับตัวเลือกการชำระเงินนี้ |
user_restriction |
จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงินนี้ ใช้เพื่อจำกัดตัวเลือกการชำระเงินโปรโมชันให้ผู้ใช้บางกลุ่มได้ หากไม่ได้ตั้งค่าไว้ ผู้ใช้ทุกคนจะมีสิทธิ์ |
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 |
กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่การกำหนดค่านี้มีผล |
public_key |
คีย์ที่ใช้เพื่อระบุผู้ขายรายนี้กับผู้ประมวลผลการชำระเงิน สำหรับ Stripe โปรดดูที่ https://stripe.com/docs/dashboard#api-keys สำหรับ Braintree โปรดดูที่ https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
หมายเลขเวอร์ชัน API ที่ส่งไปยังผู้ประมวลผลการชำระเงินพร้อมกับคำขอการชำระเงิน |
โปรเซสเซอร์
กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่เฉพาะเจาะจง
| Enum | |
|---|---|
PROCESSOR_UNSPECIFIED |
ไม่ได้ใช้งาน |
PROCESSOR_STRIPE |
การกำหนดค่าสำหรับการชำระเงินด้วย Stripe |
PROCESSOR_BRAINTREE |
การกำหนดค่าสำหรับการชำระเงินด้วย Braintree |
PaymentRestrictions
ข้อจำกัดของวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ
| ช่อง | |
|---|---|
credit_card_restrictions |
ข้อจำกัดของบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ เราถือว่าระบบยอมรับบัตรเครดิตทั้งหมดหากไม่ได้ตั้งค่าช่องนี้ โปรดทราบว่ารายการการ์ดที่รองรับโดย CreditCardType จะเพิ่มขึ้นเมื่อเวลาผ่านไป ซึ่งหมายความว่าการปล่อยให้ช่องนี้ว่างจะทำให้การกำหนดค่ามีการเปลี่ยนแปลงในอนาคต |
PerOrderFee
ค่าธรรมเนียมที่ต้องชำระครั้งเดียวต่อคำสั่งซื้อ ไม่ว่าจะมีตั๋วกี่ใบก็ตาม
| ช่อง | |
|---|---|
delivery_fee |
ค่าธรรมเนียมที่อาจแตกต่างกันไปตามวิธีการแสดงโฆษณา |
processing_fee |
ค่าธรรมเนียมในการประมวลผลวิธีการชำระเงินของผู้ใช้ |
PerTicketFee
ค่าธรรมเนียมที่ต้องชำระสำหรับตั๋วแต่ละใบที่ผู้ใช้ซื้อ
| ช่อง | |
|---|---|
service_charge |
ค่าใช้จ่ายเพิ่มเติมที่ประเมินสำหรับบริการ |
facility_fee |
ค่าธรรมเนียมที่ส่งไปยังสถานที่จัดงาน/สิ่งอำนวยความสะดวก |
taxes |
ภาษีต่อตั๋ว |
PostalAddress
ที่อยู่ของลูกค้าหรือธุรกิจ
| ช่อง | |
|---|---|
address_country |
ประเทศที่ระบุโดยใช้รหัสประเทศ ISO 3166-1 alpha-2 เช่น "US" (ต้องระบุ) |
address_locality |
สถานที่ เช่น "Mountain View" (ต้องระบุ) |
address_region |
ภูมิภาค เช่น "CA" ฟิลด์นี้จำเป็นต้องระบุเฉพาะในประเทศที่ภูมิภาคเป็นส่วนหนึ่งของที่อยู่โดยทั่วไป (ไม่บังคับ) |
postal_code |
รหัสไปรษณีย์ เช่น "94043" (ต้องระบุ) |
street_address |
ที่อยู่ เช่น "1600 Amphitheatre Pkwy" (ต้องระบุ) |
การชำระเงินล่วงหน้า
การชำระเงินที่ระบบอาจเรียกเก็บจากผู้ใช้เมื่อจอง
| ช่อง | |
|---|---|
price_info |
ที่เก็บรายละเอียดราคา |
PrepaymentStatus
สถานะการชำระล่วงหน้าของการจอง
| Enum | |
|---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
ไม่ได้ระบุ ค่าเริ่มต้นคือ PREPAYMENT_NOT_PROVIDED |
PREPAYMENT_PROVIDED |
มีการชำระค่าธรรมเนียมสำหรับการจองล่วงหน้าแล้ว |
PREPAYMENT_NOT_PROVIDED |
ยังไม่ได้ชำระค่าธรรมเนียมสำหรับการจองล่วงหน้า |
PREPAYMENT_REFUNDED |
ก่อนหน้านี้ค่าธรรมเนียมดังกล่าวมีสถานะเป็น PREPAYMENT_PROVIDED แต่ตอนนี้เราได้คืนเงินให้คุณแล้ว |
ราคา
ราคาของบริการหรือค่าธรรมเนียม
| ช่อง | |
|---|---|
price_micros |
ราคาในหน่วยไมโครของสกุลเงิน ระบบจะปัดเศษเศษส่วนของหน่วยสกุลเงินที่เล็กที่สุดโดยใช้การปัดเศษคู่ที่ใกล้ที่สุด (เช่น 2.5 เซนต์ USD ปัดเศษเป็น 2 เซนต์, 3.5 เซนต์ปัดเศษเป็น 4 เซนต์, 0.5 เซนต์ปัดเศษเป็น 0 เซนต์, 2.51 เซนต์ปัดเศษเป็น 3 เซนต์) |
currency_code |
สกุลเงินของราคาที่กำหนดใน ISO 4217 |
pricing_option_tag |
สตริงที่ไม่บังคับและไม่โปร่งใสซึ่งระบุตัวเลือกการกำหนดราคาที่เชื่อมโยงกับราคาที่ขยาย |
PriceInfo
ที่เก็บรายละเอียดราคา
| ช่อง | |
|---|---|
price_type |
กำหนดวิธีใช้ราคาหรือช่วงราคา (ต่อคนหรือคงที่) |
ฟิลด์ Union price_options ตัวเลือกราคาคือการระบุราคาที่แน่นอนหรือช่วงราคา price_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
price |
ราคาของบริการหรือค่าธรรมเนียม |
price_range |
ขอบเขตบนและ/หรือขอบเขตล่างของบริการหรือค่าธรรมเนียม |
PriceInterpretation
อธิบายวิธีตีความและแสดงราคาต่อผู้ใช้
| Enum | |
|---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
ไม่ได้ระบุการตีความราคา ค่าเริ่มต้นคือ EXACT_AMOUNT |
EXACT_AMOUNT |
เมื่อควรตีความราคาเป็นค่าที่เฉพาะเจาะจง ตัวอย่าง: 600 บาทสำหรับคลาสโยคะ 450 บาทสำหรับการตัดผมเด็ก |
STARTS_AT |
เมื่อราคาของบริการเปลี่ยนแปลงได้ แต่ทราบราคาต่ำสุดและแสดงต่อผู้บริโภค ผู้บริโภคอาจเลือกตัวเลือกที่ทำให้ราคาเพิ่มขึ้น โปรดทราบว่าบริการใดก็ตามที่ใช้ PriceInterpretation นี้ต้องใช้ PrepaymentType NOT_SUPPORTED ตัวอย่าง: $30 สำหรับการดูแลสุนัข แต่ตัวเลือกเพิ่มเติมสำหรับผู้บริโภคอาจเพิ่มราคา |
NOT_DISPLAYED |
เมื่อราคาของบริการเปลี่ยนแปลงได้และไม่มีการแสดงข้อมูลราคาต่อผู้บริโภคล่วงหน้า โปรดทราบว่าบริการใดก็ตามที่ใช้ PriceInterpretation นี้จะต้องใช้ PrepaymentType NOT_SUPPORTED และ Price ต้องว่างเปล่า ตัวอย่าง: การให้คำปรึกษาสำหรับบริการเกี่ยวกับบ้าน |
PriceRange
Wrapper สำหรับช่วงของจำนวนเงินที่ถือว่าไม่มีขอบเขต เว้นแต่จะตั้งค่าทั้ง 2 ค่า ต้องระบุ min_amount และ max_amount อย่างน้อย 1 รายการ
| ช่อง | |
|---|---|
min_price |
จำนวนเงินขั้นต่ำ |
max_price |
จำนวนเงินสูงสุด ควรมากกว่า min_price เสมอ |
PriceType
กำหนดวิธีคำนวณราคารวมจากจำนวนห้องว่าง
| Enum | |
|---|---|
FIXED_RATE_DEFAULT |
ราคาเป็นจำนวนเงินที่แน่นอน ค่านี้เป็นค่าเริ่มต้นหากไม่ได้ตั้งค่าฟิลด์ ตัวอย่าง: มัดจำ 500 บาทเพื่อจองโต๊ะ ค่าธรรมเนียมการไม่แสดงตัว 200 บาทสำหรับชั้นเรียนโยคะ |
PER_PERSON |
ราคาที่ระบุเป็นราคาต่อคน และระบบจะคำนวณราคารวมตามขนาดกลุ่มที่ระบุในทรัพยากรเป็น price_micros * party_size ราคา PER_PERSON ต้องมาพร้อมกับขนาดปาร์ตี้ในแหล่งข้อมูลความพร้อม หากไม่มี ระบบจะใช้ขนาดปาร์ตี้เป็น 1 ตัวอย่าง: $10 ต่อใบสำหรับตั๋วเข้าชมพิพิธภัณฑ์ |
QuantitativeValue
Wrapper สำหรับค่าตัวเลขซึ่งอาจเป็นช่วงหรือค่าคงที่ QuantitativeValue ตัวอย่าง * ค่าเดียว: value: 10.5 * ช่วงที่จำกัด: value_range {min_value: 5.5, max_value 10.5} * ขอบเขตล่าง: value_range {min_value: 5.5} * ขอบเขตบน: value_range {max_value: 10.5}
| ช่อง | |
|---|---|
ฟิลด์ Union value_options (ต้องระบุ) value_options ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
value |
ค่าเดียว เช่น 5.6 |
value_range |
ช่วงของค่าที่อาจเป็นแบบเปิดหรือแบบมีขอบเขต ตัวอย่าง: * อย่างน้อย 5.5 * อย่างมาก 5.5 * 5.5 ถึง 6.5 |
RangeValue
ช่วงของค่าที่ min_value < max_value ต้องมี min_value และ max_value อย่างน้อย 1 รายการ
| ช่อง | |
|---|---|
min_value |
ค่าต่ำสุด |
max_value |
ค่าสูงสุด |
Rating
กำหนดคะแนนสำหรับเอนทิตี
| ช่อง | |
|---|---|
value |
ค่าคะแนนเฉลี่ย (ต้องระบุเมื่อ number_of_ratings > 0) ค่าต้องอยู่ในช่วง [1, 5] และจะละเว้นได้ก็ต่อเมื่อ number_of_ratings เป็น 0 เท่านั้น |
number_of_ratings |
จำนวนการให้คะแนนที่ใช้ในการคำนวณค่า (ต้องระบุ) |
RelatedMedia
รูปภาพที่เกี่ยวข้องกับบริการนี้ Google จะทำการ Crawl สื่อเหล่านี้เพื่อให้มั่นใจว่าสื่อจะแสดงต่อผู้ใช้ปลายทางอย่างถูกต้อง (ไม่บังคับ)
| ช่อง | |
|---|---|
url |
URL ของแหล่งที่มาของสื่อนี้ Google จะทำการ Crawl สื่อที่โฮสต์ใน URL นี้ |
type |
ประเภทของแหล่งที่มาของสื่อนี้ |
localized_caption |
คำบรรยายของสื่อที่รองรับ i18n รองรับเฉพาะข้อความธรรมดา ระบบจะนำคอมโพเนนต์ HTML ออก (ไม่บังคับ) |
attribution |
ข้อมูลการระบุแหล่งที่มาเกี่ยวกับแหล่งที่มาของสื่อ โปรดทราบว่าหากต้องมีการระบุแหล่งที่มาเพื่อแสดงพร้อมกับสื่อเพื่อเป็นการให้เครดิตแก่ช่างภาพหรือเอเจนซี คุณจะต้องตั้งค่าช่องนี้ (ไม่บังคับ) |
caption |
เลิกใช้งานแล้ว โปรดใช้ localized_caption แทน |
การระบุแหล่งที่มา
ข้อมูลการระบุแหล่งที่มาของสื่อนี้
| ช่อง | |
|---|---|
localized_text |
ข้อความสำหรับให้เครดิตช่างภาพหรือเอเจนซีที่สนับสนุน i18n ข้อความนี้จะแสดงพร้อมกับสื่อต้นฉบับ โปรดทราบว่าช่องนี้รองรับเฉพาะข้อความธรรมดา ระบบจะนำคอมโพเนนต์ HTML ออก (ไม่รองรับการระบุแหล่งที่มาตามไฮเปอร์ลิงก์) |
text |
เลิกใช้งานแล้ว ขอแนะนำให้ใช้ localized_text |
MediaType
การแจงนับเพื่อระบุประเภทของแหล่งที่มาของสื่อนี้ รองรับเฉพาะรูปภาพ โปรดติดต่อทีมจองกับ Google หากต้องการให้รองรับสื่ออื่นๆ นอกเหนือจากรูปภาพ
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
ไม่ได้ใช้ |
PHOTO |
ระบุว่าสื่อที่ URL ระบุเป็นรูปภาพ |
ReplaceServiceAvailabilityRequest
คำขอเพื่อแทนที่ความพร้อมให้บริการของ Service
| ช่อง | |
|---|---|
service_availability |
ความพร้อมให้บริการที่ใช้แทนที่ความพร้อมให้บริการที่มีอยู่ |
RequireCreditCard
กำหนดว่าต้องใช้บัตรเครดิตเพื่อจองการนัดหมายหรือไม่
| Enum | |
|---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
ไม่ได้ระบุข้อกำหนดบัตรเครดิตอย่างชัดเจน และลักษณะการทำงานจะเหมือนกับที่ระบุไว้สำหรับ CONDITIONAL |
REQUIRE_CREDIT_CARD_CONDITIONAL |
Google จะกำหนดให้ใช้บัตรเครดิตสำหรับการจองหากตรงตามเงื่อนไขต่อไปนี้ * ความพร้อมมีราคาและต้องระบุ prepayment_type * มีการตั้งค่า no_show_fee * มีการตั้งค่าฟิลด์มัดจำ |
REQUIRE_CREDIT_CARD_ALWAYS |
คุณต้องใช้บัตรเครดิตในการจองห้องว่างนี้เสมอ ไม่ว่าค่าในช่องอื่นๆ จะเป็นอย่างไรก็ตาม |
แหล่งข้อมูล
ระบบจะใช้แหล่งข้อมูลเพื่อแยกความแตกต่างของช่วงเวลาที่พร้อมให้บริการเมื่อมีเจ้าหน้าที่หรือห้องที่แตกต่างกันเป็นส่วนหนึ่งของบริการ ช่องหลายช่องสำหรับบริการและช่วงเวลาเดียวกันจะอยู่ร่วมกันได้เมื่อมีทรัพยากรที่แตกต่างกัน
| ช่อง | |
|---|---|
staff_id |
รหัสที่ไม่บังคับสำหรับพนักงานที่ให้บริการ ฟิลด์นี้ระบุพนักงานในผู้ขาย บริการ และบันทึกความพร้อมทั้งหมด นอกจากนี้ ยังต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้เชื่อมโยงกับการจองที่ผ่านมาได้ ต้องระบุช่องนี้หากมี staff_name |
staff_name |
ชื่อของพนักงานที่ให้บริการ (ไม่บังคับ) ฟิลด์นี้จะแสดงต่อผู้ใช้ที่ทำการจอง และควรเป็นข้อความที่มนุษย์อ่านได้ ไม่ใช่ตัวระบุที่ทึบแสง ต้องระบุฟิลด์นี้หากมี staff_id |
room_id |
รหัสที่ไม่บังคับสำหรับห้องพักที่มีบริการ ฟิลด์นี้จะระบุห้องพักในผู้ขาย บริการ และบันทึกห้องว่างทั้งหมด นอกจากนี้ ยังต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้เชื่อมโยงกับการจองที่ผ่านมาได้ ต้องระบุฟิลด์นี้หากมี room_name |
room_name |
ชื่อของห้องที่ตั้งของบริการ (ไม่บังคับ) ฟิลด์นี้จะแสดงต่อผู้ใช้ที่ทำการจอง และควรเป็นข้อความที่มนุษย์อ่านได้ ไม่ใช่ตัวระบุที่ทึบแสง (ไม่บังคับ แต่ต้องระบุหากมี room_id) ในการรับประทานอาหาร ควรใช้ชื่อห้องสำหรับพื้นที่นั่งเท่านั้น เช่น บาร์หรือลาน และไม่ควรใช้สำหรับเมนูราคาคงที่ กิจกรรมพิเศษ หรือค่าอื่นๆ ที่ไม่ใช่ห้อง (เช่น การจองหรืออาหารค่ำ) เราขอแนะนำอย่างยิ่งว่าพื้นที่นั่งเริ่มต้นไม่ควรมีห้องที่เชื่อมโยงอยู่ |
party_size |
ใช้ได้กับการจองร้านอาหารเท่านั้น: จำนวนแขกที่รองรับได้ในช่วงเวลาที่เลือก ร้านอาหารสามารถเชื่อมโยงกับช่วงเวลาหลายช่วงเวลาสำหรับเวลาเดียวกัน โดยแต่ละช่วงเวลาจะระบุ party_size ที่แตกต่างกันได้ เช่น หากรองรับลูกค้า 2, 3 หรือ 4 คนที่จองไว้ |
room_description |
ไม่บังคับ คำอธิบายห้องพักที่แปลแล้ว หากตั้งค่าไว้ ต้องระบุค่าเริ่มต้น นอกจากนี้ เราขอแนะนำให้ระบุภาษาที่ใช้กันทั่วไปสำหรับภาษาของร้านค้าด้วย (ไม่บังคับ) |
SchedulingRules
กฎการจัดเวลาสำหรับบริการ
| ช่อง | |
|---|---|
min_advance_online_canceling |
การแจ้งล่วงหน้าขั้นต่ำเป็นวินาทีที่จำเป็นในการยกเลิกการนัดหมายที่จองไว้ทางออนไลน์ (ไม่บังคับ) |
late_cancellation_fee |
ค่าธรรมเนียมสำหรับการยกเลิกภายในระยะเวลาประกาศแจ้งล่วงหน้าขั้นต่ำ |
noshow_fee |
ค่าธรรมเนียมการไม่แสดงตัวโดยไม่ยกเลิก |
admission_policy |
นโยบายการรับเข้าที่ใช้กับบริการนี้ หากไม่ได้ตั้งค่า ระบบจะใช้ TIME_STRICT เป็นค่าเริ่มต้น (ไม่บังคับ) |
cancellation_policy |
นโยบายการยกเลิกกฎการจัดเวลา (ต้องระบุสำหรับกิจกรรมน่าสนใจ) |
ฟิลด์ Union หากตั้งค่า "min_advance_booking" ไว้ ระบบจะคำนวณเวลาที่จองได้ล่าสุดเป็น (<เวลาเริ่มต้นของสล็อต> - "min_advance_booking") หากตั้งค่า "min_booking_buffer_before_end_time" ระบบจะคำนวณเวลาที่จองได้ล่าสุดเป็น (<เวลาสิ้นสุดของช่วงเวลา> - "min_booking_buffer_before_end_time") โปรดทราบว่าค่าของ "min_booking_buffer_before_end_time" ต้องเป็นค่าบวกหากตั้งค่าไว้ หากไม่ได้ตั้งค่าทั้ง 2 อย่าง ระบบจะจองสล็อตได้จนถึงเวลาเริ่มต้นของสล็อต หากตั้งค่าทั้ง 2 ช่อง ระบบจะเลือกค่าเพียงค่าเดียวและจะไม่สนใจค่าอีกค่าหนึ่ง เนื่องจากเราไม่สามารถคาดการณ์ได้อย่างแม่นยำว่าจะเลือกค่าใด ตัวอย่าง
|
|
min_advance_booking |
ระยะเวลา (เป็นวินาที) ตั้งแต่เวลาที่จองครั้งสุดท้ายได้จนถึงเวลาที่ช่วงเวลาที่พร้อมให้บริการเริ่มต้น |
min_booking_buffer_before_end_time |
ระยะเวลา (เป็นวินาที) ตั้งแต่เวลาที่ทำการจองครั้งสุดท้ายได้จนถึงเวลาที่ช่วงเวลาที่พร้อมจำหน่ายสิ้นสุด หากตั้งค่าฟิลด์นี้ ฟิลด์ "admission_policy" ต้องตั้งค่าเป็น TIME_FLEXIBLE เพื่อระบุว่าผู้ใช้สามารถใช้ตั๋วที่ซื้อหลังจากช่วงเวลาเริ่มต้นได้ |
AdmissionPolicy
นโยบายการรับเข้าของบริการนี้
| Enum | |
|---|---|
ADMISSION_POLICY_UNSPECIFIED |
ไม่ได้ใช้ |
TIME_STRICT |
ลูกค้าต้องมาถึงตามเวลาเริ่มต้นของช่วงเวลาที่พร้อมให้บริการ และคาดว่าบริการจะเสร็จสิ้นตามเวลาสิ้นสุดของช่วงเวลา ตัวอย่างกรณีการใช้งาน TIME_STRICT * ทัวร์ที่เริ่มเวลา 09:00 น. ซึ่งกำหนดให้ผู้เข้าร่วมทุกคนมาถึงตรงเวลา และกลับมาถึงประมาณ 12:00 น. * จองเวลาตัดผมตอน 15:00 น. ในวันเสาร์ ซึ่งจะใช้เวลาประมาณ 30 นาที * คลาสออกกำลังกายตั้งแต่ 18:00 น. ถึง 20:00 น. |
TIME_FLEXIBLE |
ลูกค้าสามารถมาถึงได้ทุกเมื่อระหว่างเวลาเริ่มต้นและเวลาสิ้นสุดของช่วงเวลาที่พร้อมให้บริการเพื่อใช้การจองนี้ ตัวอย่างกรณีการใช้งาน TIME_FLEXIBLE * ตั๋วเข้าชมพิพิธภัณฑ์ที่ใช้ได้ทุกเวลาในวันที่ซื้อ * บัตรเข้าชมสวนสนุกช่วงบ่ายที่ใช้ได้ตั้งแต่เวลา 12:00 น. ถึง 21:00 น. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
ลูกค้าต้องมาถึงร้านค้าในเวลาเริ่มต้นของช่วงเวลาที่พร้อมให้บริการ แต่จะออกไปเมื่อใดก็ได้ เช่น ในสถานการณ์การเข้าชมพิพิธภัณฑ์ ตั๋วเข้าชมแบบระบุเวลาสำหรับเวลา 10:00 น. กำหนดให้ผู้ใช้ต้องอยู่ที่พิพิธภัณฑ์ในเวลา 10:00 น. เวลาเริ่มต้นของช่วงเวลาที่พร้อมให้บริการสำหรับบริการนี้แสดงถึงเวลาเข้าที่กำหนด อย่างไรก็ตาม ระบบจะใช้เวลาสิ้นสุดเป็นคีย์เพื่อระบุช่วงเวลาที่พร้อมให้บริการสำหรับการจองเท่านั้น |
บริการ
ข้อมูลเกี่ยวกับบริการที่ผู้ขายจัดหาให้ เช่น ตัดผม
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของบริการซึ่งมีรูปแบบเป็น |
service_name |
ชื่อบริการ เช่น "ตัดผมชาย" เลิกใช้งานแล้ว โปรดใช้ localized_service_name แทน |
localized_service_name |
ชื่อบริการ เช่น "ตัดผมชาย" อาจมีให้บริการในหลายภาษา |
description |
คำอธิบายของบริการที่ผู้ใช้มองเห็น เลิกใช้งานแล้ว โปรดใช้ localized_description แทน |
localized_description |
คำอธิบายของบริการที่ผู้ใช้มองเห็น ฟิลด์นี้รองรับทั้งข้อความธรรมดาและการจัดรูปแบบคล้าย HTML คุณสร้างเลย์เอาต์ที่ปรับแต่งได้ที่นี่โดยใช้ส่วนหัว ย่อหน้า รายการ และแท็กวลีบางรายการ ซึ่งต่างจากส่วนข้อความธรรมดา โปรดอ่านวิธีการและหมายเหตุต่อไปนี้อย่างละเอียดเพื่อให้มั่นใจว่าคุณจะสร้างประสบการณ์ของผู้ใช้ที่ดีที่สุดได้ แท็กการจัดรูปแบบที่รองรับซึ่งคล้ายกับ HTML มีดังนี้ แท็กส่วนหัว: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> แท็กย่อหน้า: <p> แท็กรายการ: <ul>, <ol>, <li> แท็ก Division: <div> แท็กวลี: <br>, <strong>, <em>: แท็กที่ไม่รองรับ
หมายเหตุสำคัญ
|
price |
ราคาของบริการ |
price_interpretation |
อธิบายวิธีตีความและแสดงราคาต่อผู้ใช้ ใช้ได้กับทุกประเภทธุรกิจ ยกเว้นการรับประทานอาหารและกิจกรรมน่าสนใจ เพื่อกำหนดค่าการแสดงราคาบริการ |
rules |
กฎในการจอง/ยกเลิกการนัดหมาย |
prepayment_type |
ต้องชำระเงินล่วงหน้าหรือไม่ หรือไม่รองรับ |
prepayment_terms |
ข้อกำหนดเกี่ยวกับเวลาที่การชำระเงินล่วงหน้าเสร็จสมบูรณ์ |
form[] |
เลิกใช้งานแล้ว โปรดใช้ intake_form และ per_ticket_intake_form |
intake_form |
แบบฟอร์มที่ขอข้อมูลเพิ่มเติมจากผู้ใช้เมื่อจองบริการนี้ (ไม่บังคับ) |
per_ticket_intake_form |
แบบฟอร์มที่ขอข้อมูลเพิ่มเติมจากผู้ใช้เมื่อจองบริการนี้ ผู้ใช้ต้องกรอกแบบฟอร์มนี้ 1 ครั้งต่อตั๋วแต่ละใบที่จอง (ไม่บังคับ) |
tax_rate |
อัตราภาษีของบริการ หากมี ฟิลด์นี้จะลบล้าง tax_rate ที่ตั้งไว้ที่ระดับผู้ขาย ข้อความที่ว่างเปล่า (เช่น tax_rate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
payment_option_id[] |
รายการรหัสที่อ้างอิงตัวเลือกการชำระเงินซึ่งใช้ชำระค่าบริการนี้ได้ ตัวเลือกการชำระเงินจริงจะกำหนดไว้ที่ระดับผู้ขาย และยังใช้ร่วมกันในผู้ขายหลายรายได้ด้วย |
deposit |
กำหนดวิธีเรียกเก็บเงินมัดจำจากผู้ใช้ ลบล้างเงินฝากของบริการหากมีการระบุไว้ การตั้งค่านี้เป็นข้อความการฝากที่ว่างเปล่าจะนำเงินฝากระดับบริการออก (ไม่บังคับ) |
no_show_fee |
กำหนดค่าธรรมเนียมการไม่แสดงตัวที่อาจเรียกเก็บจากผู้ใช้ ลบล้างค่าธรรมเนียมการไม่แสดงตัวของบริการหากมีการระบุไว้ การตั้งค่านี้เป็นข้อความ NoShowFee ที่ว่างเปล่าจะนำค่าธรรมเนียมการไม่แสดงตัวระดับบริการออก (ไม่บังคับ) |
require_credit_card |
ระบุว่าผู้ใช้ต้องระบุบัตรเครดิตเพื่อจองบริการนี้หรือไม่ คุณลบล้างช่องนี้ได้ที่ระดับความพร้อม (ไม่บังคับ) |
action_link[] |
ลิงก์การดำเนินการที่เกี่ยวข้องกับบริการนี้ หากมีลิงก์การดำเนินการ คุณต้องตั้งค่าประเภท (ดูด้านล่าง) ในบริการ |
type |
ประเภทที่กำหนดไว้ล่วงหน้าของบริการนี้ (ไม่บังคับ) |
ticket_type[] |
ประเภทตั๋วที่จอง/ซื้อได้สำหรับบริการนี้ หากรองรับตั๋ว (ไม่บังคับ) |
related_media[] |
รูปภาพที่เกี่ยวข้องกับบริการนี้ Google จะทำการ Crawl และจัดเก็บสื่อเพื่อให้มั่นใจว่าสื่อจะแสดงต่อผู้ใช้ปลายทางได้อย่างมีประสิทธิภาพสูงสุด (ไม่บังคับ) |
service_attribute_value_id[] |
ค่าแอตทริบิวต์บริการที่ใช้กับบริการนี้ (ไม่บังคับ) แต่ละบริการอาจมีค่า 0 ค่าขึ้นไปสำหรับแอตทริบิวต์บริการแต่ละรายการที่กำหนดไว้ในผู้ขายที่เกี่ยวข้อง (ไม่บังคับ) |
waitlist_rules |
กฎการเข้าร่วมคิวรอ |
ticketing_vertical_specific_data |
ข้อมูลเพิ่มเติมเฉพาะสำหรับหมวดหมู่การจำหน่ายตั๋วเข้างาน (ไม่บังคับ) |
integration_type |
ระดับการผสานรวมที่เรารองรับสำหรับบริการนี้ (ไม่บังคับ) ไม่เกี่ยวข้องกับพาร์ทเนอร์ที่มีการผสานรวมเริ่มต้น ระบบจะปิดใช้การเข้ารหัสจากต้นทางถึงปลายทางสำหรับพาร์ทเนอร์เหล่านี้เสมอ |
per_order_fee |
ค่าธรรมเนียมระดับคำสั่งซื้อสำหรับการซื้อบริการนี้ (ไม่บังคับ) |
tours_and_activities_content |
ฟิลด์เนื้อหาที่เฉพาะเจาะจงสำหรับทัวร์และกิจกรรม |
location[] |
สถานที่ที่เกี่ยวข้องกับบริการนี้ หมายเหตุสำคัญ: หากมีสถานที่ที่เข้าชมหลายแห่งที่เกี่ยวข้องกับบริการนี้ หรือ START_LOCATION แตกต่างจาก VISITED_LOCATION คุณต้องระบุ START_LOCATION ตัวอย่าง: - ทัวร์ปั่นจักรยานพร้อมไกด์ที่แวะ 3 สถานที่ คุณต้องระบุสถานที่เริ่มต้น ทัวร์รถบัสนำเที่ยวที่นัดพบกันที่ล็อบบี้ของโรงแรม แล้วเดินทางไปยังสถานที่ที่เข้าชม ต้องระบุสถานที่ประชุม |
rating |
การให้คะแนนของผู้ใช้สำหรับบริการนี้เป็นตัวชี้วัดรวมจากรีวิวทั้งหมด |
home_service_data |
ข้อมูลเพิ่มเติมเฉพาะสำหรับธุรกิจบริการในบ้าน (ไม่บังคับ) |
virtual_session |
ไม่บังคับ ข้อมูลเกี่ยวกับเซสชันเสมือน จำเป็นต้องระบุเพื่อเปิดใช้บริการเสมือน |
direct_merchant_payment |
ไม่บังคับ ข้อมูลเพิ่มเติมที่ต้องเพิ่มหากบริการกำหนดให้ผู้ใช้ชำระเงินให้ผู้ขายโดยตรง หมายเหตุสำคัญ: RwG จะไม่มีส่วนเกี่ยวข้องกับธุรกรรมนี้ ต้องระบุหากมีการกำหนด virtual_session และบริการไม่ฟรี หรือไม่ได้ตั้งค่า prepayment_type เป็น REQUIRED |
uri_template |
ไม่บังคับ เทมเพลตที่ไม่บังคับซึ่งระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ภายนอก |
PrepaymentTerms
ข้อมูลเฉพาะเกี่ยวกับเวลาที่การชำระเงินล่วงหน้าเสร็จสมบูรณ์
| ช่อง | |
|---|---|
charge_timing |
เวลาที่จะมีการเรียกเก็บเงินเมื่อเทียบกับเวลาที่ซื้อ |
charge_time_before_start_time_sec |
เวลาเป็นวินาทีก่อนเวลาเริ่มต้นของบริการที่ระบบจะเรียกเก็บเงินจากผู้ใช้ ควรตั้งค่าช่องนี้เมื่อ 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 |
ตัวระบุที่ระบุแอตทริบิวต์บริการนี้โดยไม่ซ้ำกันในบรรดาแอตทริบิวต์อื่นๆ สำหรับผู้ขายรายเดียวกัน เช่น "account-type" |
attribute_name |
ชื่อที่ผู้ใช้มองเห็นได้สำหรับแอตทริบิวต์นี้ เช่น "ประเภทบัญชี" |
value[] |
ค่าที่เป็นไปได้ทั้งหมดสำหรับแอตทริบิวต์บริการนี้ |
ค่า
แสดงค่าที่เป็นไปได้สำหรับแอตทริบิวต์บริการหนึ่งๆ
| ช่อง | |
|---|---|
value_id |
ตัวระบุที่ระบุค่านี้โดยไม่ซ้ำกันในค่าอื่นๆ สำหรับแอตทริบิวต์บริการนี้ เช่น "ส่วนตัว" |
value_name |
ชื่อที่ผู้ใช้มองเห็นสำหรับค่า เช่น "ส่วนตัว" |
ServiceAttributeValueId
ระบุค่าแอตทริบิวต์บริการที่เฉพาะเจาะจงที่จะใช้กับบริการ
| ช่อง | |
|---|---|
attribute_id |
รหัสของแอตทริบิวต์ตามที่กำหนดไว้ใน Merchant.service_attribute เช่น "service-type" |
value_id |
รหัสของค่าสำหรับแอตทริบิวต์นี้ เช่น "ตัดผม" ต้องตรงกับ value_id ในคำจำกัดความแอตทริบิวต์บริการ |
ServiceAvailability
รายการความพร้อมใช้งานและผู้ที่ควรใช้/เวลาที่ควรใช้
| ช่อง | |
|---|---|
name |
ชื่อทรัพยากรของบริการที่จะใช้ ในรูปแบบ |
start_time_restrict |
หากระบุไว้ เราจะพิจารณาเอนทิตีความพร้อมที่ระบุว่าเป็นสแนปชอตที่สมบูรณ์จาก [start_time_restrict, end_time_restrict) กล่าวคือ ระบบจะลบความพร้อมที่มีอยู่ทั้งหมดหากเงื่อนไขต่อไปนี้เป็นจริง หากตั้งค่าข้อความระยะเวลาไว้ เงื่อนไขจะถูกจำกัดเพิ่มเติมดังนี้ หากตั้งค่าข้อความ resources_restrict ระบบจะจำกัดเงื่อนไขเพิ่มเติมดังนี้ โดยปกติแล้วจะใช้ช่องเหล่านี้เพื่ออัปเดตความพร้อมอย่างสมบูรณ์ในช่วงเวลาที่กำหนด การตั้งค่า start_time_restrict ขณะที่ปล่อยให้ end_time_restrict ไม่ได้ตั้งค่าไว้จะถือว่าหมายถึงเวลาทั้งหมดที่เริ่มต้นที่ start_time_restrict |
end_time_restrict |
การตั้งค่า end_time_restrict ขณะที่ปล่อยให้ start_time_restrict ไม่ได้ตั้งค่าไว้จะถือว่าหมายถึงเวลาทั้งหมดจนถึง end_time_restrict |
duration_restrict |
การตั้งค่าระยะเวลาจะจำกัดขอบเขตของการอัปเดตให้เหลือเฉพาะความพร้อมที่มีระยะเวลาตรงกัน |
resources_restrict |
การตั้งค่า resources_restrict จะจำกัดขอบเขตของการอัปเดตให้เหลือเพียงชุดทรัพยากรนี้ ฟิลด์รหัสทั้งหมดของทรัพยากรต้องตรงกันทุกประการ |
availability[] |
รายการเวลาว่างใหม่ |
ServiceIntakeForm
กำหนดแบบฟอร์มรับข้อมูลที่ปรับแต่งบริการที่ผู้ขายจัดหาให้
| ช่อง | |
|---|---|
field[] |
ฟิลด์ที่จะแสดงต่อผู้ใช้ |
first_time_customers |
หากเป็นจริง แบบฟอร์มนี้จะแสดงต่อลูกค้าที่ซื้อเป็นครั้งแรก เลิกใช้งานแล้ว แบบฟอร์มรับข้อมูลไม่รองรับฟังก์ชันนี้ |
returning_customers |
หากค่าเป็นจริง แบบฟอร์มนี้จะแสดงต่อลูกค้าที่กลับมาซื้อซ้ำ เลิกใช้งานแล้ว แบบฟอร์มรับข้อมูลไม่รองรับฟังก์ชันนี้ |
ServiceIntakeFormField
กำหนดฟิลด์ที่รวมอยู่ใน ServiceIntakeForm
| ช่อง | |
|---|---|
id |
สตริงจากพาร์ทเนอร์ผู้รวบรวมซึ่งระบุฟิลด์แบบฟอร์มได้อย่างไม่ซ้ำกัน รหัสดังกล่าวควรเหมือนกับรหัสในคำตอบของช่องแบบฟอร์มที่เกี่ยวข้อง และต้องไม่ซ้ำกันทั้งในระดับบริการและแบบฟอร์มการรับคำขอต่อตั๋ว (ต้องระบุ) |
type |
ประเภทของฟิลด์นี้ |
label |
ข้อความที่แสดงต่อผู้ใช้สำหรับช่องนี้ เลิกใช้งานแล้ว โปรดใช้ |
localized_label |
ข้อความที่แสดงต่อผู้ใช้สำหรับช่องนี้ คุณระบุฟิลด์ได้ในหลายภาษา (ต้องระบุ) |
value[] |
ตั้งค่าหากและต่อเมื่อประเภทฟิลด์เป็น LOCATION_SEARCH เท่านั้น โปรดใช้ "location_id" ในช่อง "location" เพื่อระบุค่าสถานที่ตั้ง |
choice_text[] |
ตั้งค่าเฉพาะในกรณีที่ประเภทฟิลด์เป็น MULTIPLE_CHOICE, CHECKBOXES หรือ DROPDOWN ใช้เพื่อแสดงตัวเลือกที่เป็นไปได้ |
is_required |
ระบุว่าผู้ใช้ต้องตอบช่องนี้หรือไม่ |
allow_custom_answer |
ระบุว่าอนุญาตให้ใช้ค่าที่กำหนดเองนอกเหนือจากคำตอบที่กำหนดไว้ล่วงหน้าหรือไม่ การดำเนินการนี้จะมีผลเมื่อประเภทฟิลด์เป็น LOCATION_SEARCH เท่านั้น (ไม่บังคับ) |
additional_option[] |
ตัวเลือกเพิ่มเติมที่ระบุไว้เพิ่มเติมจากค่าที่ระบุ มีผลเฉพาะเมื่อประเภทฟิลด์เป็น LOCATION_SEARCH เช่น นอกเหนือจากรายการสถานที่ที่ระบุแล้ว อีกตัวเลือกที่ใช้ได้คือ "ฉันจะติดต่อซัพพลายเออร์ในภายหลัง" (ไม่บังคับ) |
ticket_type_restrict[] |
หากคำถามนี้ควรแสดงเฉพาะเมื่อผู้ใช้จองตั๋วบางประเภท คุณควรตั้งค่าช่องนี้เป็นชุดรหัสประเภทตั๋วที่เกี่ยวข้อง ปล่อยช่องว่างไว้หากคำถามใช้ได้เสมอ |
hint |
ข้อความคำแนะนำสำหรับอินพุต ซึ่งจะปรากฏเป็นตัวยึดตำแหน่งข้อความ การตั้งค่านี้จะมีผลเมื่อประเภทฟิลด์เป็น SHORT_ANSWER หรือ PARAGRAPH เท่านั้น (ไม่บังคับ) |
FieldType
Enum เพื่อระบุประเภทของฟิลด์
| Enum | |
|---|---|
FIELD_TYPE_UNSPECIFIED |
ระบบจะไม่สนใจฟิลด์ที่มีประเภทที่ไม่ได้ระบุหรือไม่รู้จัก |
SHORT_ANSWER |
ช่องป้อนข้อความแบบ 1 บรรทัด |
PARAGRAPH |
ช่องป้อนข้อมูลหลายบรรทัดสำหรับข้อความ |
MULTIPLE_CHOICE |
ชุดปุ่มตัวเลือกที่ต้องเลือก 1 ตัวเลือกจากหลายตัวเลือก |
CHECKBOXES |
รายการที่ระบุหมายเลขอย่างน้อย 1 รายการพร้อมช่องทำเครื่องหมาย |
DROPDOWN |
การเลือกจากเมนูแบบเลื่อนลง |
BOOLEAN |
ปุ่มใช่/ไม่ใช่ |
LOCATION_SEARCH |
ช่องค้นหาที่รองรับการค้นหาสถานที่ที่ตรงกันตามข้อมูลจากผู้ใช้จากรายการสถานที่ที่ระบุ |
TaxRate
อัตราภาษีที่ใช้เมื่อเรียกเก็บเงินจากผู้ใช้สำหรับบริการ และสามารถตั้งค่าได้ต่อผู้ขายหรือต่อบริการ
| ช่อง | |
|---|---|
micro_percent |
อัตราภาษีในหน่วยล้านของ 1% ซึ่งให้ความแม่นยำ 6 ทศนิยม เช่น หากอัตราภาษีคือ 7.253% คุณควรตั้งค่าช่องนี้เป็น 7253000 หากไม่ได้ตั้งค่าช่องนี้หรือตั้งค่าเป็น 0 ราคาที่เรียกเก็บจากผู้ใช้สำหรับบริการใดๆ ที่ผู้ขายรายนี้ให้บริการจะเป็นราคาที่แน่นอนซึ่งระบุโดย Service.price ระบบจะถือว่าราคาบริการได้รับการยกเว้นหรือรวมภาษีที่เกี่ยวข้องไว้แล้ว ระบบจะไม่แสดงภาษีต่อผู้ใช้เป็นบรรทัดรายการแยกต่างหาก หากตั้งค่าฟิลด์นี้เป็นค่าใดก็ตามที่ไม่ใช่ 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดก็ตามที่ผู้ขายรายนี้ให้บริการจะรวมราคาบริการบวกภาษีที่ประเมินโดยใช้อัตราภาษีที่ระบุไว้ที่นี่ ระบบจะปัดเศษเศษส่วนของหน่วยสกุลเงินที่เล็กที่สุด (เช่น เศษส่วนของ 1 เซ็นต์) โดยใช้การปัดเศษคู่ที่ใกล้ที่สุด ระบบจะแสดงภาษีต่อผู้ใช้เป็นบรรทัดรายการแยกต่างหาก |
ข้อกำหนด
ชุดกฎและหลักเกณฑ์ที่แสดงต่อผู้ใช้เพื่อทำการจองผ่านจองกับ Google
| ช่อง | |
|---|---|
url |
URL ของข้อกำหนดและเงื่อนไข (ไม่บังคับ) |
text |
ข้อความที่จะแสดงต่อผู้ใช้ ใช้ localized_text ด้านล่างสำหรับการผสานรวมใหม่ |
localized_text |
ข้อความที่แปลแล้วซึ่งจะแสดงต่อผู้ใช้ |
ข้อความ
เพย์โหลดข้อความที่อาจมีการแปลแล้ว ฟิลด์ข้อความบางรายการอาจมีเนื้อหาที่มาร์กอัป
| ช่อง | |
|---|---|
value |
ค่าข้อความในภาษาที่ไม่รู้จัก ต้องระบุหากและต่อเมื่อ |
localized_value[] |
ค่าข้อความต่อภาษา ไม่บังคับ |
TicketType
TicketType ใช้เพื่อแยกความแตกต่างระหว่างตั๋วที่มีราคาและความพร้อมจำหน่ายสินค้าต่างกันเนื่องจากผู้ใช้มีประเภทต่างกัน คุณลักษณะของบริการต่างกัน หรือมีตัวเลือก/ส่วนเสริมต่างกัน
ตั๋วคือหน่วยที่จองได้ขั้นต่ำสำหรับบริการ เช่น ที่นั่งในทริปล่องแก่ง ค่าเข้าชมพิพิธภัณฑ์ หรือค่าเช่าเรือคายัคคู่แบบเต็มวัน
| ช่อง | |
|---|---|
ticket_type_id |
ระบบใช้รหัสตั๋วเพื่อแยกความแตกต่างระหว่างตั๋วประเภทต่างๆ ของบริการเดียวกัน และคาดว่าจะไม่ซ้ำกันภายในบริการเท่านั้น |
short_description |
คำอธิบายสั้นๆ ของ TicketType นี้ ซึ่งอาจเป็นสิ่งที่ผู้ใช้มองเห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" เป็นต้น ตั๋วแต่ละประเภทควรมีคำอธิบายที่ผู้ใช้มองเห็นได้ เลิกใช้งานแล้ว โปรดใช้ localized_short_description แทน |
localized_short_description |
คำอธิบายสั้นๆ ของ TicketType นี้ที่รองรับ i18n ซึ่งอาจเป็นสิ่งที่ผู้ใช้มองเห็นได้ เช่น "ผู้ใหญ่" "เด็ก" "ทหารผ่านศึก" "แถว J" เป็นต้น ตั๋วแต่ละประเภทควรมีคำอธิบายที่ผู้ใช้มองเห็นได้ คุณระบุค่าแยกกันสำหรับแต่ละภาษาได้ |
price |
ราคาตั๋วประเภทนี้ 1 ใบ ไม่รวมภาษี ระบบจะใช้อัตราภาษีของบริการกับตั๋วของบริการ |
per_ticket_fee |
ค่าธรรมเนียมเพิ่มเติมสำหรับการซื้อตั๋วนี้ (ไม่บังคับ) |
price_display_type |
ไม่บังคับ ประเภทการแสดงราคาที่กำหนดไว้ล่วงหน้าของตั๋วประเภทนี้ |
option_description |
คำอธิบายของตัวเลือกเพิ่มเติมที่ประเภทตั๋วนี้แสดง หากมี เลิกใช้งานแล้ว ให้ใช้ localized_option_description แทน |
localized_option_description |
คำอธิบายของตัวเลือกเพิ่มเติมที่ประเภทตั๋วนี้แสดง หากมี คุณระบุค่าแยกกันสำหรับแต่ละภาษาได้ ตัวเลือกเพิ่มเติมจะมีประโยชน์เมื่อประเภทตั๋วแสดงมิติข้อมูลหลายรายการ ตัวอย่างที่ 1: ตั๋วเข้าชมที่มีประเภทต่างๆ เช่น "ผู้ใหญ่" "เด็ก" และภาษาเป็นตัวเลือกเพิ่มเติม รายการ TicketType ที่คาดไว้จะเป็นดังนี้ - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } ตัวอย่างที่ 2: การเช่าเรือคายัคหลายชั่วโมงพร้อมส่วนเสริมถุงกันน้ำ (ไม่บังคับ) คำอธิบายแบบสั้นอาจเป็น "3 ชั่วโมง" และคำอธิบายตัวเลือกอาจเป็น "มีถุงกันน้ำ" หรือ "ไม่มีถุงกันน้ำ" - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } ไม่บังคับ แต่หากตั๋วประเภทใดก็ตามภายในบริการมีการตั้งค่าฟิลด์นี้ เราคาดหวังให้ตั๋วประเภทอื่นๆ ทั้งหมดมีการตั้งค่าฟิลด์นี้ด้วย (อาจใช้ option_description เริ่มต้นได้) เช่น [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] ไม่ใช่รายการที่ถูกต้อง รองรับเฉพาะแท็กการจัดรูปแบบ HTML 2 แท็ก ได้แก่ และ |
inventory_type |
ไม่บังคับ ประเภทพื้นที่โฆษณาที่กำหนดไว้ล่วงหน้าของตั๋วประเภทนี้ 1 ใบ |
InventoryType
ประเภทพื้นที่โฆษณาที่กำหนดไว้ล่วงหน้าของตั๋วประเภทนี้ 1 ใบ
| Enum | |
|---|---|
INVENTORY_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทพื้นที่โฆษณา |
INVENTORY_TYPE_PRIMARY |
พื้นที่โฆษณาหลัก |
INVENTORY_TYPE_VERIFIED_RESALE |
สินค้าคงคลังที่ยืนยันแล้วสำหรับการขายต่อ |
INVENTORY_TYPE_RESALE |
พื้นที่โฆษณาที่ขายต่อ |
INVENTORY_TYPE_AGGREGATOR |
พื้นที่โฆษณาของผู้รวบรวมข้อมูล ผู้รวบรวมข้อมูล (เช่น www.bandsintown.com) หมายถึงพาร์ทเนอร์ที่ให้ข้อมูลกิจกรรมและตั๋ว แต่พาร์ทเนอร์ไม่ได้จำหน่ายตั๋วโดยตรง ผู้ขายตั๋วที่แท้จริงอาจเป็นผู้ขายหลัก ผู้ขายต่อที่ได้รับการยืนยัน หรือผู้ขายต่อ ตอนนี้เราจะแยกความแตกต่างเฉพาะประเภทพื้นที่โฆษณาของพาร์ทเนอร์ระดับบนสุด และไม่สนใจประเภทพื้นที่โฆษณาของผู้ขายตั๋วที่แท้จริงภายในผู้รวบรวมข้อมูล |
PriceDisplayType
ระบุรูปแบบราคาที่แสดงในหน้า Landing Page
ระบบจะละเว้นช่องนี้สำหรับพื้นที่โฆษณาที่ไม่ได้ลิงก์ออก
ฟิลด์นี้ช่วยให้แพลตฟอร์มของ Google แสดงรูปแบบราคาเดียวกันกับที่หน้า Landing Page ของบริการใช้ รูปแบบราคาที่สอดคล้องกันจะช่วยปรับปรุงอัตรา Conversion และลดความสับสน
| Enum | |
|---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทการแสดงราคา Google จะเป็นผู้กำหนดรูปแบบที่จะแสดง |
PRICE_DISPLAY_TYPE_BASE |
ราคาที่แสดงในหน้า Landing Page คือราคาฐาน |
PRICE_DISPLAY_TYPE_ALL_IN |
ราคาที่แสดงในหน้า Landing Page รวมค่าธรรมเนียมและภาษีทั้งหมดแล้ว |
TicketingVerticalSpecificData
ข้อมูลเพิ่มเติมเฉพาะสำหรับหมวดหมู่การจำหน่ายตั๋วเข้างาน
| ช่อง | |
|---|---|
event_category |
หมวดหมู่ของกิจกรรม ตั้งค่าเมื่อเหตุการณ์อยู่ในหมวดหมู่ที่กําหนดไว้ล่วงหน้าหมวดหมู่ใดหมวดหมู่หนึ่งเท่านั้น (ไม่บังคับ) |
event_url |
URL ของกิจกรรมในเว็บไซต์ของพาร์ทเนอร์ (ไม่บังคับ) |
entity[] |
รายการเอนทิตีที่เกี่ยวข้องกับเหตุการณ์ (ไม่บังคับ) |
event_attendance_mode |
ต้องระบุ ประเภทการเข้าร่วมกิจกรรม |
event_virtual_location_url[] |
ไม่บังคับ URL ที่ดูเหตุการณ์ได้ |
event_organizer |
ไม่บังคับ ผู้จัดที่โฮสต์กิจกรรม |
event_organizer_url |
ไม่บังคับ URL ของผู้จัดที่โฮสต์กิจกรรม |
event_organizer_type |
ไม่บังคับ ประเภทของผู้จัดการประชุม |
event_source_url[] |
ต้องระบุ URL ของหน้าที่คุณดูข้อมูลหรือคำอธิบายกิจกรรมได้ |
event_state |
ไม่บังคับ สถานะของเหตุการณ์ |
brand_name |
ไม่บังคับ ชื่อแบรนด์ที่แปลแล้ว |
event_creator |
ไม่บังคับ ข้อมูลเกี่ยวกับผู้สร้างกิจกรรม |
AttendanceMode
ประเภทการเข้าร่วมกิจกรรม
| Enum | |
|---|---|
ATTENDANCE_MODE_UNSPECIFIED |
ไม่ได้ระบุ |
ONLINE |
สำหรับกิจกรรมเสมือนจริง |
PHYSICAL |
สำหรับกิจกรรมที่จัดขึ้นจริง |
PHYSICAL_ONLINE_MIXED |
สำหรับกิจกรรมที่จัดทั้งแบบออฟไลน์และออนไลน์ |
เอนทิตี
แสดงถึงเอนทิตีที่เกี่ยวข้องกับเหตุการณ์
| ช่อง | |
|---|---|
id |
ตัวระบุที่ไม่ซ้ำกันของเอนทิตีในฐานข้อมูลของพาร์ทเนอร์ (ไม่บังคับ) |
name |
ชื่อของเอนทิตี (ต้องระบุ) |
url |
URL ของหน้าเว็บที่อธิบายเอนทิตีอย่างชัดเจน นี่คือหน้าเว็บในเว็บไซต์ของพาร์ทเนอร์สำหรับเอนทิตี หากมี สำหรับ URL สาธารณะอื่นๆ ของเอนทิตี ให้ใช้ relevant_url ใน public_identification_data (ไม่บังคับ) |
entity_type |
ประเภทของเอนทิตี (ไม่บังคับ) |
entity_role |
บทบาทของเอนทิตีในเหตุการณ์ (ไม่บังคับ) |
public_identification_data |
ข้อมูลอ้างอิงแบบสาธารณะของเอนทิตี (ไม่บังคับ) |
EntityRole
บทบาทของเอนทิตีในเหตุการณ์
| Enum | |
|---|---|
ENTITY_ROLE_UNSPECIFIED |
ไม่ได้ระบุ |
ENTITY_ROLE_HEADLINER |
เอนทิตีเป็นตัวแทนของศิลปินชื่อดังหรือนักแสดงนำในกิจกรรม |
ENTITY_ROLE_SUPPORTER |
เอนทิตีแสดงถึงนักแสดงสนับสนุนในกิจกรรม |
ENTITY_ROLE_HOME_TEAM |
เอนทิตีแสดงถึงทีมเหย้าในกิจกรรม (กีฬา) |
ENTITY_ROLE_AWAY_TEAM |
เอนทิตีแสดงถึงทีมเยือนในกิจกรรม (กีฬา) |
EntityType
ประเภทของเอนทิตี หมายเหตุ: ไม่ได้มีเจตนาให้เป็นอนโทโลยีสากล
| Enum | |
|---|---|
ENTITY_TYPE_UNSPECIFIED |
ไม่ได้ระบุ โปรดอย่าใช้ |
ENTITY_TYPE_PERFORMER |
เอนทิตีแสดงถึงศิลปินหรือกลุ่มที่แสดงในคอนเสิร์ตหรือรายการ ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น CONCERT หรือ THEATRE |
ENTITY_TYPE_PLAYER |
เอนทิตีแสดงถึงทีมกีฬาหรือผู้เล่นในการแข่งขัน ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็นกีฬา |
ENTITY_TYPE_CONCERT_TOUR |
เอนทิตีแสดงถึงทัวร์ที่เหตุการณ์นี้เป็นของ ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น CONCERT |
ENTITY_TYPE_SPORTS_SERIES |
เอนทิตีแสดงถึงการแข่งขันกีฬาที่เหตุการณ์นี้เป็นส่วนหนึ่ง ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็นกีฬา |
ENTITY_TYPE_PLAY |
เอนทิตีแสดงถึงประเภทของการแสดง (เช่น ละครเพลง ตลก บัลเลต์ ฯลฯ) ที่แสดงในกิจกรรม ใช้ได้เฉพาะเมื่อหมวดหมู่กิจกรรมเป็น THEATRE |
EventCategory
หมวดหมู่เหตุการณ์ย่อยที่เราปรับแต่งประสบการณ์การใช้งานผลิตภัณฑ์ หมายเหตุ: ไม่ได้มีเจตนาที่จะเป็นอนโทโลยีเหตุการณ์สากล
| Enum | |
|---|---|
EVENT_CATEGORY_UNSPECIFIED |
ไม่ได้ระบุ โปรดอย่าใช้ |
EVENT_CATEGORY_CONCERT |
คอนเสิร์ต |
EVENT_CATEGORY_SPORTS |
การแข่งขันกีฬา |
EVENT_CATEGORY_THEATRE |
กิจกรรมในโรงละคร |
EVENT_CATEGORY_EXHIBITS |
การจัดแสดง |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
เวิร์กช็อปและชั้นเรียน |
EventCreator
ข้อมูลเกี่ยวกับผู้สร้างกิจกรรม เกี่ยวข้องเฉพาะกับแพลตฟอร์มที่มีเหตุการณ์เนื้อหาที่ผู้ใช้สร้างขึ้น
| ช่อง | |
|---|---|
name |
ไม่บังคับ ชื่อผู้สร้างกิจกรรม ไม่มีข้อจำกัดด้านอักขระ |
EventState
สถานะของเหตุการณ์
| Enum | |
|---|---|
EVENT_STATE_UNSPECIFIED |
ไม่ได้ระบุ |
SCHEDULED |
กำหนดเวลากิจกรรมแล้ว |
RESCHEDULED |
กำหนดการของกิจกรรมมีการเปลี่ยนแปลง |
CANCELLED |
กิจกรรมถูกยกเลิกแล้ว |
POSTPONED |
กิจกรรมถูกเลื่อนออกไป |
OrganizerType
ประเภทของผู้จัดการประชุม
| Enum | |
|---|---|
ORGANIZER_TYPE_UNSPECIFIED |
ไม่ได้ระบุ |
PERSON |
สำหรับผู้จัดที่เป็นบุคคล |
ORGANIZATION |
สำหรับผู้จัดที่เป็นองค์กร |
PublicIdentificationData
ตัวระบุ หน้าเว็บ หรือแหล่งข้อมูลสาธารณะอื่นๆ ที่อ้างอิงถึงเอนทิตี
| ช่อง | |
|---|---|
relevant_url[] |
URL สาธารณะของหน้าเว็บที่เกี่ยวข้องกับหัวข้อนั้นๆ เท่านั้น ซึ่งอาจรวมถึงเว็บไซต์อย่างเป็นทางการ, Discogs, แพลตฟอร์มโซเชียลมีเดีย, หน้า Wikipedia หรือ IMDB เช่น https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan (ไม่บังคับ) |
musicbrainz_id |
ตัวระบุ Musicbrainz แบบ 36 อักขระของศิลปินหรือเอนทิตีเพลงอื่นๆ (หากมี) ดู https://musicbrainz.org/doc/MusicBrainz_Identifier (ไม่บังคับ) |
TimeRange
ช่วงเวลาปิด-เปิด เช่น [start_time, end_time)
| ช่อง | |
|---|---|
start_time |
ขอบเขตล่างของช่วงเวลา |
end_time |
ขอบเขตบนของช่วงเวลา |
TokenizationConfig
การกำหนดค่าสำหรับการแปลงโทเค็นของผู้ประมวลผลการชำระเงิน ซึ่งตั้งค่าตามผู้ขายแต่ละราย
| ช่อง | |
|---|---|
tokenization_parameter |
โดยปกติแล้ว การกำหนดค่าการแปลงโทเค็นจะมี tokenization_parameter รายการเดียวที่มีคีย์เป็น "gateway" และมีค่าเป็นชื่อของตัวประมวลผล พารามิเตอร์ที่เหลือจะขึ้นอยู่กับโปรเซสเซอร์ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Google Pay ตัวอย่าง Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" } ตัวอย่าง Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" } ตัวอย่าง Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" } |
billing_information_format |
รวมข้อมูลสำหรับการเรียกเก็บเงินของผู้ใช้ตามที่ป้อนลงใน Google Pay ด้วย FOP (ดูด้านบน) ไว้ในโทเค็นการชำระเงิน การเว้นช่องว่างไว้จะเทียบเท่ากับการระบุ MIN |
BillingInformationFormat
ต้องกำหนดให้ผู้ใช้ระบุที่อยู่สำหรับการเรียกเก็บเงินมากน้อยเพียงใด และจะรวมไว้ในโทเค็นหรือไม่ ค่า Enum จะสอดคล้องกับพารามิเตอร์ใน Google Pay API (ดู https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)
| Enum | |
|---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
ไม่ได้ระบุ ค่าเริ่มต้นคือ MIN |
MIN |
ชื่อ รหัสประเทศ และรหัสไปรษณีย์ (การตั้งค่าเริ่มต้นของ Google Pay) |
FULL |
ชื่อ ที่อยู่ ถนน สถานที่ ภูมิภาค รหัสประเทศ และรหัสไปรษณีย์ |
ToursAndActivitiesContent
ฟิลด์เนื้อหาที่เฉพาะเจาะจงสำหรับทัวร์และกิจกรรม องค์ประกอบแต่ละรายการในฟิลด์ที่ซ้ำกันควรเป็นอิสระเพื่อให้แสดงผลแยกกันได้ (เช่น เป็นหัวข้อย่อย)
เราขอแนะนำเป็นอย่างยิ่งให้ระบุ ToursAndActivitiesContent สำหรับทัวร์และกิจกรรม แต่ไม่บังคับ ทุกช่องรองรับทั้งข้อความธรรมดาและข้อความที่คล้าย HTML สำหรับการจัดรูปแบบพื้นฐาน แท็กการจัดรูปแบบที่รองรับซึ่งคล้ายกับ HTML มีดังนี้
แท็กวลี:
, , , : รองรับเฉพาะแท็ก 3 รายการที่กล่าวถึงข้างต้น
ใช้เพื่อขึ้นบรรทัดใหม่ในย่อหน้า และ // ใช้เพื่อไฮไลต์ข้อความสำคัญ ระบบจะไม่สนใจแท็กวลีอื่นๆ
ไม่อนุญาตให้ใช้แท็กและสไตล์ที่กำหนดเองอื่นๆ ทั้งหมด และระบบจะนำออก ระบบจะนำ URL, Anchor และลิงก์ทั้งหมดออก และจะไม่แสดงต่อผู้ใช้ปลายทาง
หมายเหตุสำคัญ: * อย่าทำซ้ำข้อมูลที่ระบุไว้แล้วใน highlights, exclusion และช่องอื่นๆ ที่เฉพาะเจาะจงกว่าในคำอธิบายบริการ * หลีกเลี่ยงการใช้แท็กอื่นๆ ยกเว้นแท็กที่รองรับซึ่งกล่าวถึงข้างต้น เนื่องจากระบบจะนำเนื้อหาภายในแท็กที่ไม่รองรับออก ซึ่งอาจส่งผลให้ผู้ใช้ได้รับประสบการณ์ที่ไม่พึงประสงค์
| ช่อง | |
|---|---|
highlights[] |
รายการไฮไลต์ที่ผู้ใช้มองเห็น |
inclusions[] |
รายการที่ผู้ใช้มองเห็นได้ |
exclusions[] |
รายการการยกเว้นที่ผู้ใช้มองเห็นได้ |
must_know[] |
รายการหมายเหตุสำคัญที่ผู้ใช้มองเห็น ใช้สำหรับรายละเอียด เช่น การจำกัดอายุหรือเงื่อนไขอื่นๆ ที่ทำให้บริการนี้ไม่เหมาะสม |
UnsupportedPartySizeOption
ตัวเลือกสำหรับบุคคลที่อยู่นอกช่วง
| ช่อง | |
|---|---|
ฟิลด์ Union kind ตัวเลือกที่มีสำหรับบุคคลที่อยู่นอกช่วง kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
call_merchant |
หากจำนวนคนในปาร์ตี้อยู่นอกช่วงที่กำหนด ให้โทรหาธุรกิจ ระบบจะแสดงข้อความที่กำหนดไว้ล่วงหน้าต่อผู้ใช้ ข้อความตัวอย่างที่จะแสดง: "สำหรับกลุ่มลูกค้าที่มารับประทานอาหารเกินกว่า {waitlist_rules.max_party_size} คน โปรดโทรติดต่อร้านอาหารที่หมายเลข {phone}" ต้องตั้งค่า CallMerchant แต่จะว่างเปล่า |
UpdateAdsAccountLinkRequest
ข้อความคำขอสำหรับ AdsAccountLinkingService.UpdateAdsAccountLink
| ช่อง | |
|---|---|
ads_account_link |
ต้องระบุ ลิงก์บัญชี Google Ads ที่จะอัปเดต ระบบใช้ฟิลด์ |
update_mask |
ไม่บังคับ รายการฟิลด์ที่จะอัปเดต |
UpdateBookingRequest
คำขออัปเดต google.maps.booking.v1alpha.Booking
| ช่อง | |
|---|---|
update_mask |
ฟิลด์มาสก์ของช่องการจองทั้งหมดที่จะอัปเดต |
booking |
การจองที่จะอัปเดต |
booking_failure |
หากการประมวลผลคำขอจองที่ยืนยันแบบไม่พร้อมกันไม่สำเร็จและระบบกำลังอัปเดตสถานะการจองเป็น "ไม่สำเร็จ" ช่องนี้ควรแสดงข้อผิดพลาดทางตรรกะทางธุรกิจ (เช่น ผู้ใช้มีการจองที่ใกล้กับเวลานี้มากเกินไป) คุณควรตั้งค่าฟิลด์นี้เมื่ออัปเดตสถานะการจองเป็น "ไม่สำเร็จ" เท่านั้น มิเช่นนั้นระบบจะไม่สนใจ |
UpdateMerchantRequest
คำขออัปเดต Merchant
| ช่อง | |
|---|---|
merchant |
ข้อมูลผู้ขายใหม่ |
update_mask |
ฟิลด์ที่เฉพาะเจาะจงซึ่งต้องอัปเดตสำหรับผู้ขาย |
UpdateOrderRequest
คำขออัปเดต google.maps.booking.v1alpha.Order
| ช่อง | |
|---|---|
update_mask |
ฟิลด์มาสก์ของช่องคำสั่งซื้อทั้งหมดที่จะอัปเดต |
order |
ลำดับที่จะอัปเดต |
UpdateServiceRequest
คำขออัปเดต Service
| ช่อง | |
|---|---|
service |
ข้อมูลบริการใหม่ |
update_mask |
ฟิลด์ที่เฉพาะเจาะจงซึ่งต้องอัปเดตสำหรับบริการ |
UriTemplate
เทมเพลตที่ระบุวิธีที่ Google ควรสร้าง URL ไปยังเว็บไซต์ภายนอก
| ช่อง | |
|---|---|
uri_template |
ไม่บังคับ เทมเพลต URI ต้องเป็นไปตาม RFC6570 ดู https://datatracker.ietf.org/doc/html/rfc6570 รองรับเทมเพลตระดับ 2 ระบบจะแปลงพารามิเตอร์เหล่านี้เป็นค่าที่ระบุไว้ในเอนทิตีที่เกี่ยวข้อง พารามิเตอร์ที่ใช้ได้สำหรับลิงก์การจองร้านอาหาร: 1) (ต้องระบุ) {availability_slot_start_seconds} :: สร้างจากฟิลด์ start_sec ในฟีดความพร้อม 2) (ต้องระบุ) {resources_party_size} :: สร้างจากฟิลด์ party_size ในฟีดความพร้อม 3) (ไม่บังคับ) {availability_slot_duration_seconds} :: สร้างจากฟิลด์ duration_sec ในฟีดความพร้อม 4) (ไม่บังคับ) {availability_slot_availability_tag} :: สร้างจากฟิลด์ availability_tag ในฟีดความพร้อม ตัวอย่างการใช้งาน: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} โดยมี * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
UserPurchaseRestriction
จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงิน
| ช่อง | |
|---|---|
new_to_merchant |
ตัวเลือกการชำระเงินที่ซื้อได้เฉพาะผู้ใช้ที่ไม่เคยซื้อจากผู้ขายรายเดียวกันมาก่อน |
new_to_payment_option |
ตัวเลือกการชำระเงินที่ซื้อได้เฉพาะผู้ใช้ที่ไม่เคยซื้อตัวเลือกการชำระเงินเดียวกันนี้มาก่อน |
VirtualSession
ข้อมูลเกี่ยวกับเซสชันเสมือน/ออนไลน์ เช่น คลาสโยคะออนไลน์ คลาสทำอาหารเสมือนจริง เป็นต้น
| ช่อง | |
|---|---|
session_instructions |
วิธีการตั้งค่าชั้นเรียนเสมือนนี้ หากพาร์ทเนอร์ไม่ได้ระบุ URL ของวิดีโอในการจอง ข้อความนี้จะต้องระบุเวลาที่จะแชร์ URL ของวิดีโอกับผู้ใช้ เช่น ระบบจะส่ง URL ของ Zoom ทางอีเมล 30 นาทีก่อนเริ่มคลาส (แนะนำ) |
session_requirements |
ข้อกำหนดสำหรับเซสชันเสมือนที่ระบุ เช่น เสื่อโยคะ เครื่องครัว ฯลฯ (แนะนำ) |
virtual_platform_info |
ข้อมูลเกี่ยวกับแพลตฟอร์มเสมือนที่ใช้ในเซสชันนี้ (ต้องระบุเพื่อเปิดใช้บริการเสมือน) |
is_session_prerecorded |
ต้องระบุ ตั้งค่าเป็น "จริง" หากเซสชันเสมือนจริงไม่ได้เป็นการถ่ายทอดสดและมีการบันทึกไว้ล่วงหน้า |
VirtualPlatformInfo
ข้อมูลเกี่ยวกับแพลตฟอร์มที่จะใช้สำหรับเซสชันเสมือนนี้
| ช่อง | |
|---|---|
platform |
แพลตฟอร์มที่ใช้สำหรับเซสชันเสมือน |
other_platform_name |
ชื่อแพลตฟอร์มหากตั้งค่าแพลตฟอร์มเป็น "อื่นๆ" (ต้องระบุหากตั้งค่าแพลตฟอร์มเป็น "อื่นๆ") |
แพลตฟอร์ม
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 |
ต้องระบุ ต้องเป็นจำนวนเต็มบวกสำหรับบริการที่มีฟังก์ชันการทำงานของคิวรอ หากบริการหรือผู้ขายไม่มีฟังก์ชันการใช้งานรายการรอ คุณต้องไม่ป้อนข้อมูลนี้ |
max_party_size |
ต้องระบุ ต้องเป็นจำนวนเต็มบวกสำหรับบริการที่มีฟังก์ชันการทำงานของคิวรอ หากบริการหรือผู้ขายไม่มีฟังก์ชันการใช้งานรายการรอ คุณต้องไม่ป้อนข้อมูลนี้ |
supports_additional_request |
หากเป็นจริง ผู้ใช้จะส่งคำขอข้อความเพิ่มเติมแบบอิสระได้เมื่อเข้าร่วมคิวรอเพื่อใช้บริการนี้ |
above_max_party_size_options[] |
ตั้งค่าตัวเลือกสำหรับปาร์ตี้ที่มีขนาดใหญ่กว่า max_party_size ที่ตั้งไว้ ปล่อยว่างไว้หากไม่ควรให้ตัวเลือกอื่นแก่กลุ่มที่มีจำนวนคนมากกว่าสำหรับการเข้าร่วมคิวรอ |