Indeks
BookingNotification
(antarmuka)Feed
(antarmuka)InvalidationService
(antarmuka)InventoryStatus
(antarmuka)InventoryUpdate
(antarmuka)ActionLink
(pesan)ActionLink.ActionLinkType
(enum)ActionPlatform
(enum)Advisement
(pesan)Availability
(pesan)Availability.ConfirmationMode
(enum)Availability.DurationRequirement
(enum)Availability.Recurrence
(pesan)Availability.ScheduleException
(pesan)Availability.SchedulingRuleOverrides
(pesan)BatchDeleteGenericRecordsRequest
(pesan)BatchPushGenericRecordRequest
(pesan)BatchReplaceServiceAvailabilityRequest
(pesan)BatchReplaceServiceAvailabilityResponse
(pesan)Booking
(pesan)BookingFailure
(pesan)BookingFailure.Cause
(enum)BookingFailure.PaymentFailureInformation
(pesan)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters
(pesan)BookingStatus
(enum)CallMerchant
(pesan)CancellationPolicy
(pesan)CancellationPolicy.RefundCondition
(pesan)ClientInformation
(pesan)CreateMerchantRequest
(pesan)CreateServiceRequest
(pesan)CreditCardRestrictions
(pesan)CreditCardRestrictions.CreditCardType
(enum)DeleteMerchantRequest
(pesan)DeleteServiceRequest
(pesan)Deposit
(pesan)DirectMerchantPayment
(pesan)DurationRange
(pesan)ExtendedServiceAvailability
(pesan)FeedStatistics
(pesan)FeedStatus
(pesan)FeedStatus.State
(enum)FoodOrderingMetadata
(pesan)FoodOrderingMetadata.AdvanceOrderDetails
(pesan)FoodOrderingMetadata.FeeDetails
(pesan)FoodOrderingMetadata.FeeDetails.FeeAmount
(pesan)FoodOrderingMetadata.FeeDetails.FeeType
(enum)FulfillmentOption
(pesan)FulfillmentOption.AvailableDay
(pesan)FulfillmentOption.FeeDetails
(pesan)FulfillmentOption.FixedFee
(pesan)FulfillmentOption.FulfillmentType
(enum)FulfillmentOption.MinimumFee
(pesan)FulfillmentOption.NoFee
(pesan)GenericDeleteRecord
(pesan)GenericRecord
(pesan)GeoCoordinates
(pesan)GetMerchantStatusRequest
(pesan)GetStatusRequest
(pesan)HomeServiceData
(pesan)IntegrationType
(enum)InvalidateResourceRequest
(pesan)LineItem
(pesan)LineItem.OrderedTickets
(pesan)ListMerchantStatusesRequest
(pesan)ListMerchantStatusesRequest.BookingInventoryStatus
(enum)ListMerchantStatusesRequest.GeoMatchingStatus
(enum)ListMerchantStatusesRequest.WaitlistInventoryStatus
(enum)ListMerchantStatusesResponse
(pesan)ListStatusRequest
(pesan)ListStatusResponse
(pesan)LocalizedString
(pesan)Location
(pesan)LocationType
(enum)Merchant
(pesan)MerchantMatchingHints
(pesan)MerchantStatus
(pesan)MerchantStatus.BookingStatus
(pesan)MerchantStatus.DirectUrl
(pesan)MerchantStatus.DirectUrl.UrlType
(enum)MerchantStatus.LocalServicesMatchInfo
(pesan)MerchantStatus.LocalServicesMatchInfo.MatchedProvider
(pesan)MerchantStatus.PlaceInfo
(pesan)MerchantStatus.ProcessingStatus
(enum)MerchantStatus.WaitlistStatus
(pesan)MoneyRange
(pesan)NoShowFee
(pesan)Order
(pesan)OrderOnlineMetadata
(pesan)PaymentInformation
(pesan)PaymentOption
(pesan)PaymentOption.ActivationType
(enum)PaymentOption.PaymentOptionType
(enum)PaymentProcessorConfig
(pesan)PaymentProcessorConfig.Processor
(enum)PaymentRestrictions
(pesan)PerOrderFee
(pesan)PerTicketFee
(pesan)PostalAddress
(pesan)PrepaymentStatus
(enum)Price
(pesan)PriceInterpretation
(enum)PriceType
(enum)QuantitativeValue
(pesan)QuantitativeValue.RangeValue
(pesan)Rating
(pesan)RelatedMedia
(pesan)RelatedMedia.Attribution
(pesan)RelatedMedia.MediaType
(enum)ReplaceServiceAvailabilityRequest
(pesan)RequireCreditCard
(enum)Resources
(pesan)SchedulingRules
(pesan)SchedulingRules.AdmissionPolicy
(enum)Service
(pesan)Service.PrepaymentTerms
(pesan)Service.PrepaymentTerms.ChargeTiming
(enum)Service.PrepaymentType
(enum)Service.ServiceType
(enum)ServiceAttribute
(pesan)ServiceAttribute.Value
(pesan)ServiceAttributeValueId
(pesan)ServiceAvailability
(pesan)ServiceIntakeForm
(pesan)ServiceIntakeFormField
(pesan)ServiceIntakeFormField.FieldType
(enum)TaxRate
(pesan)Terms
(pesan)Text
(pesan)TicketType
(pesan)TicketingVerticalSpecificData
(pesan)TicketingVerticalSpecificData.AttendanceMode
(enum)TicketingVerticalSpecificData.Entity
(pesan)TicketingVerticalSpecificData.Entity.EntityRole
(enum)TicketingVerticalSpecificData.Entity.EntityType
(enum)TicketingVerticalSpecificData.EventCategory
(enum)TicketingVerticalSpecificData.EventState
(enum)TicketingVerticalSpecificData.OrganizerType
(enum)TicketingVerticalSpecificData.PublicIdentificationData
(pesan)TimeRange
(pesan)TokenizationConfig
(pesan)TokenizationConfig.BillingInformationFormat
(enum)ToursAndActivitiesContent
(pesan)UnsupportedPartySizeOption
(pesan)UpdateBookingRequest
(pesan)UpdateMerchantRequest
(pesan)UpdateOrderRequest
(pesan)UpdateServiceRequest
(pesan)UserPurchaseRestriction
(pesan)VirtualSession
(pesan)VirtualSession.VirtualPlatformInfo
(pesan)VirtualSession.VirtualPlatformInfo.Platform
(enum)WaitlistRules
(pesan)
BookingNotification
Menerima notifikasi untuk janji temu dari partner penjadwalan eksternal. Partner harus memanggil UpdateBooking atau UpdateOrder, bergantung pada apakah partner menerapkan RPC berbasis pemesanan, seperti CreateBooking dan CheckAvailability, maupun memesan RPC dasar seperti CreateOrder dan CheckOrderFulfillability.
UpdateBooking |
---|
Memperbarui
|
UpdateOrder |
---|
Memperbarui
|
Feed
Mengambil status pemrosesan untuk feed yang diupload oleh partner agregator eksternal.
GetStatus |
---|
Mengambil
|
ListStatus |
---|
Mengambil
|
InvalidationService
Menerima permintaan pembatalan validasi resource dari partner eksternal.
InvalidateResource |
---|
Membatalkan validasi resource yang ada. Permintaan akan diabaikan jika resource yang diminta tidak berlangganan layanan Google. Jenis resource yang didukung: - Pengambilan
|
InventoryStatus
Mengambil inventaris dan status pencocokan penjual yang diupload.
GetMerchantStatus |
---|
Mendapatkan
|
ListMerchantStatuses |
---|
Cantumkan semua
|
InventoryUpdate
Menerima pembaruan inventaris dari agregator eksternal.
BatchDeleteGenericRecords |
---|
Menghapus kumpulan data jenis feed yang ditentukan. Hanya melakukan validasi dasar (seperti permintaan dengan format yang salah) setelah itu respons yang sesuai segera dikirim kepada partner. Google melakukan validasi logika bisnis berdasarkan permintaan secara asinkron. Panggilan batch ini tidak menjamin atomicity.
|
BatchPushGenericRecord |
---|
Menyisipkan dan/atau memperbarui catatan jenis feed yang ditentukan. Hanya melakukan validasi dasar (seperti permintaan dengan format yang salah) setelah itu respons yang sesuai segera dikirim kepada partner. Google melakukan validasi logika bisnis berdasarkan permintaan secara asinkron. Panggilan batch ini tidak menjamin atomicity.
|
BatchReplaceServiceAvailability |
---|
Mengganti
|
CreateMerchant |
---|
Membuat
|
CreateService |
---|
Membuat
|
DeleteMerchant |
---|
Menghapus
|
DeleteService |
---|
Menghapus
|
ReplaceServiceAvailability |
---|
Mengganti
|
UpdateMerchant |
---|
Memperbarui
|
UpdateService |
---|
Memperbarui
|
ActionLink
URL tindakan dengan bahasa terkait, daftar negara yang dibatasi, dan platform opsional yang menunjukkan pada platform mana tindakan tersebut harus dilakukan.
Kolom | |
---|---|
url |
URL titik masuk untuk link tindakan ini. |
language |
Tag bahasa BCP-47 yang mengidentifikasi bahasa yang menyediakan konten dari URI ini. |
restricted_country[] |
Kode negara ISO 3166-1 alpha-2. Biarkan kosong untuk visibilitas yang tidak dibatasi. |
platform |
Platform tempat tindakan ini harus dilakukan. Jika kolom ini tidak ditetapkan, ACTION_PLATFORM_WEB_APPLICATION akan digunakan sebagai penggantian. |
action_link_type |
Jenis tindakan yang ditentukan sebelumnya. |
order_online_metadata |
Metadata untuk link online pesanan. Mendukung tindakan dengan ActionLinkType dari ACTION_LINK_TYPE_SHOP_ONLINE. |
food_ordering_metadata |
Metadata untuk link Pemesanan Makanan. Mendukung jenis tindakan: * |
ActionLinkType
Jenis tindakan yang ditentukan sebelumnya yang terkait dengan link tindakan.
Enum | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Jenis link tindakan belum ditetapkan. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Jenis link tindakan adalah membuat janji temu. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Jenis link tindakan adalah membuat janji temu online. |
ACTION_LINK_TYPE_ORDER_FOOD |
Jenis link tindakan adalah memesan makanan untuk diantar, dibawa pulang, atau keduanya. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Jenis link tindakan adalah memesan makanan untuk diantar. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Jenis link tindakan adalah memesan makanan untuk dibawa pulang. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Jenis link tindakan adalah membuat reservasi makan di tempat. |
ACTION_LINK_TYPE_SHOP_ONLINE |
Jenis link tindakan adalah memesan untuk belanja, dapat dikirim atau diambil, atau keduanya. |
ActionPlatform
Platform tempat tindakan dijalankan. Aplikasi web adalah penggantian umum. Sebaiknya Anda memiliki setidaknya satu ActionLink dengan ACTION_PLATFORM_WEB_APPLICATION. Link dengan Android dan iOS sebagai platform hanya digunakan di sistem masing-masing.
Enum | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
Platform tidak ditentukan. |
ACTION_PLATFORM_WEB_APPLICATION |
Platform tindakan adalah web secara umum. |
ACTION_PLATFORM_MOBILE_WEB |
Platform tindakan adalah web di perangkat seluler. |
ACTION_PLATFORM_ANDROID |
Platform tindakan adalah Android OS. |
ACTION_PLATFORM_IOS |
Platform tindakan adalah iOS. |
Saran
Saran yang ditampilkan kepada pengguna saat memesan melalui Pesan dengan Google.
Kolom | |
---|---|
text |
Pesan kustom yang akan ditampilkan kepada pengguna saat memesan melalui Pesan dengan Google. |
Ketersediaan
Slot ketersediaan layanan penjual, yang menunjukkan waktu dan jumlah tempat.
Kolom | |
---|---|
start_time |
Waktu mulai slot janji temu. |
duration |
Durasi slot janji temu |
spots_total |
Jumlah total tempat dan tempat terbuka dari ketersediaan ini. Contoh:
Catatan: Jika mengirim permintaan menggunakan format kompresi ketersediaan yang ditentukan di bawah, kedua kolom ini akan diisi berdasarkan permintaan tersebut.
|
spots_open |
Jumlah tempat terbuka. |
availability_tag |
String buram opsional untuk mengidentifikasi slot ketersediaan ini. Jika ditetapkan, string ini akan disertakan dalam permintaan yang memesan/memperbarui/membatalkan janji temu. |
resources |
Resource opsional biasanya digunakan untuk memperjelas slot ketersediaan ini dari yang lain jika anggota staf yang berbeda, atau ruangan merupakan bagian dari layanan. Mis., kelas yoga yang sama dengan 2 instruktur:
|
payment_option_id[] |
Daftar id yang mereferensikan opsi pembayaran yang dapat digunakan untuk membayar slot ini. Opsi pembayaran yang sebenarnya ditentukan di tingkat Penjual, dan juga dapat digunakan bersama oleh beberapa penjual. Kolom ini mengganti payment_option_id yang ditentukan dalam pesan layanan. Demikian pula, payment_option_id yang ditentukan di sini TIDAK harus ada dalam pesan layanan, meskipun harus ditentukan di tingkat Penjual. |
recurrence |
Informasi pengulangan untuk ketersediaan, yang merepresentasikan lebih dari satu waktu mulai. Pengulangan harus berisi janji temu untuk satu hari kerja. |
schedule_exception[] |
Waktu saat layanan ini tidak dapat dijadwalkan. Untuk membatasi jumlah pesan schedule_exception, pertimbangkan untuk menggabungkan pengecualian yang berdekatan. |
deposit |
Deposit opsional untuk ketersediaan ini. Mengganti deposit layanan jika ditentukan. |
no_show_fee |
Denda ketidakhadiran opsional untuk ketersediaan ini. Mengganti denda ketidakhadiran layanan jika ditentukan. |
require_credit_card |
Menunjukkan apakah pengguna harus menyediakan kartu kredit untuk memesan slot ketersediaan ini. Jika tidak ditetapkan, nilai ini akan diwarisi dari tingkat layanan jika ditetapkan di sana. (opsional) |
ticket_type_id[] |
Menunjukkan daftar jenis tiket yang didukung untuk slot ketersediaan ini. Jika tidak ditetapkan, semua jenis tiket di layanan induk tersedia untuk slot ini. Perhatikan bahwa nilai kolom ini harus ditentukan di layanan induk. Contoh:
Untuk merepresentasikan inventaris selama hari kerja:
Untuk menunjukkan bahwa ketiga jenis tiket tersebut tersedia untuk slot waktu ini, gunakan (opsional) |
duration_requirement |
Persyaratan untuk menampilkan durasi slot dan/atau waktu berakhir. Kolom ini akan diabaikan jika slot tidak tersedia. Tidak digunakan dalam vertical Rekomendasi Aktivitas. (opsional) |
scheduling_rule_overrides |
Aturan penjadwalan ketersediaan. Jika diisi, kolom tersebut akan mengganti setiap aturan penjadwalan yang sesuai di SchedulingRules tingkat layanan. |
confirmation_mode |
Mode konfirmasi yang akan digunakan saat memesan ketersediaan ini. Percobaan pembuatan pemesanan untuk ketersediaan dengan mode konfirmasi CONFIRMATION_MODE_SYNCHRONOUS harus segera dikonfirmasi atau ditolak. Percobaan pembuatan pemesanan untuk ketersediaan dengan mode konfirmasi CONFIRMATION_MODE_ASYNCHRONOUS harus segera ditolak atau dibuat dengan status PENDING. |
ConfirmationMode
Mode konfirmasi yang digunakan saat memesan info detail.
Enum | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED |
Mode konfirmasi tidak ditentukan. Konfirmasi sinkron akan dipilih. |
CONFIRMATION_MODE_SYNCHRONOUS |
Pemesanan untuk ketersediaan ini akan dikonfirmasi secara sinkron. |
CONFIRMATION_MODE_ASYNCHRONOUS |
Pemesanan untuk ketersediaan ini akan dikonfirmasi secara asinkron. |
DurationRequirement
Enum ini menunjukkan persyaratan yang ada bagi pengguna untuk mengonfirmasi atau melihat durasi/waktu berakhir slot yang diminta.
Enum | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
Penanganan waktu berakhir tidak ditentukan. Ini adalah defaultnya. |
DO_NOT_SHOW_DURATION |
Waktu berakhir tidak ditampilkan kepada pengguna. |
MUST_SHOW_DURATION |
Waktu berakhir harus ditampilkan kepada pengguna sebelum janji temu dapat dibuat. |
Berulang
Pesan Recurrence (Pengulangan) bersifat opsional, tetapi memungkinkan representasi yang lebih ringkas dari slot ketersediaan yang berulang secara konsisten. Pesan ini biasanya merepresentasikan jadwal kerja dalam sehari. Pesan ScheduleException kemudian digunakan untuk merepresentasikan rentang waktu yang dipesan/tidak tersedia dalam hari kerja.
Persyaratan:
- Perluasan slot ketersediaan atau pengulangan TIDAK boleh membuat slot yang identik. Jika id, start_time, duration, dan resources cocok, slot akan dianggap identik.
- JANGAN mencampur format ketersediaan standar dan pengulangan dalam slot satu layanan. Pengulangan memberikan manfaat ke penjual/layanan yang menawarkan janji temu. Format standar ditujukan untuk penjual/layanan dengan kelas yang dijadwalkan secara rutin.
- Pengulangan tidak boleh berdurasi lebih dari 24 jam.
Kolom | |
---|---|
repeat_until |
Stempel waktu UTC maksimum inklusif yang menunjukkan sampai kapan ketersediaan akan berulang. |
repeat_every |
Menentukan waktu di antara beberapa slot ketersediaan berurutan. Contoh: Ketersediaan dengan durasi 20 mnt, repeat_every 30 menit, a start_time 09.00, dan repeat_until 11.00 akan menghasilkan slot pada pukul 09.00-09.20, 09.30-09.50, 10.00-10.20, 10.30-10.50, 11.00-11.20. (wajib) |
ScheduleException
ScheduleException merepresentasikan rentang waktu yang dipesan/tidak tersedia dalam hari kerja, yang merupakan pengecualian terhadap pengulangan yang dideskripsikan di atas. Saat slot waktu dipesan, daftar pengecualian harus diperbarui untuk mencerminkan rentang waktu yang baru saja tidak tersedia. Pengulangan itu sendiri tidak boleh dimodifikasi.
Kolom | |
---|---|
time_range |
Rentang waktu pengecualian. Setiap slot yang dideskripsikan oleh pengulangan yang tumpang tindih dengan rentang waktu tertutup-terbuka ini akan dianggap tidak tersedia. Contoh: Jika pengulangan menentukan durasi 20 mnt, repeat_every 30 menit, start_time 09.00, dan repeat_until 11.00, ScheduleException dengan time_range 09.45-11.00 akan membuat slot tidak tersedia pada pukul 09.30-90.50, 10.00-10.20, dan 10.30-10.50. Perhatikan bahwa karena rentang waktu bersifat tertutup-terbuka, slot yang dimulai pada pukul 11.00 tidak akan terpengaruh. |
SchedulingRuleOverrides
Aturan penjadwalan tingkat ketersediaan.
Kolom | |
---|---|
last_bookable_sec |
Waktu terakhir (dalam detik) saat slot ini dapat dipesan. Stempel waktu ini harus sebelum start_sec yang ditetapkan untuk slot agar dapat diterapkan (jika pengguna harus dapat memesan setelah waktu mulai, gunakan SchedulingRules.min_booking_before_end_time tingkat layanan). Jika ada, akan mengganti apa pun yang ditentukan dalam min_booking_buffer dari SchedulingRules milik Layanan terkait. |
first_bookable_sec |
Waktu pertama (dalam detik) saat slot ini dapat dipesan. Stempel waktu ini harus sebelum start_sec yang ditetapkan untuk slot, atau last_bookable_sec jika ditentukan. |
last_online_cancellable_sec |
Jika ditetapkan, waktu terakhir (dalam detik sejak epoch Unix) slot janji temu khusus ini dapat dibatalkan melalui Pesan dengan Google. Kolom ini akan menggantikan aturan pembatalan tingkat layanan apa pun. (opsional) |
BatchDeleteGenericRecordsRequest
Permintaan batch untuk menghapus kumpulan data jenis feed yang ditentukan.
Kolom | |
---|---|
parent |
Nama resource, yang memiliki format - |
records[] |
Data yang akan dihapus. Maksimum 1.000 data diizinkan dalam satu panggilan API. |
BatchPushGenericRecordRequest
Permintaan batch untuk menyisipkan dan/atau memperbarui kumpulan data jenis feed yang ditentukan dalam URL permintaan.
Kolom | |
---|---|
parent |
Nama resource, yang memiliki format - |
records[] |
Kumpulan data yang akan disisipkan dan/atau diperbarui. Maksimum 1.000 data diizinkan dalam satu panggilan API. |
BatchReplaceServiceAvailabilityRequest
Permintaan batch untuk mengganti beberapa slot ketersediaan Service
.
Kolom | |
---|---|
parent |
Format |
extended_service_availability[] |
Ketersediaan layanan tambahan yang digunakan untuk mengganti slot ketersediaan yang ada. |
BatchReplaceServiceAvailabilityResponse
Respons batch untuk mengganti beberapa slot ketersediaan Service
. Hanya akan menyertakan slot yang berhasil diperbarui dalam pesan ini
Kolom | |
---|---|
extended_service_availability[] |
Pesan ketersediaan layanan tambahan yang berhasil diperbarui yang digunakan untuk mengganti slot ketersediaan yang ada. |
Booking
Pemesanan untuk slot inventaris
Kolom | |
---|---|
name |
Nama resource pemesanan: |
merchant_id |
ID penjual untuk slot |
service_id |
ID layanan penjual |
start_time |
Waktu mulai slot janji temu |
duration |
Durasi slot janji temu |
client_information |
Informasi pribadi klien yang membuat janji temu |
status |
Status pemesanan |
payment_information |
Informasi tentang transaksi pembayaran yang terkait dengan pemesanan. |
party_size |
Jumlah tamu pemesanan |
BookingFailure
Data status yang menunjukkan alasan pemrosesan pemesanan gagal secara asinkron. BookingFailure ditujukan terutama untuk mengambil error logika bisnis.
Kolom | |
---|---|
cause |
Alasan pemesanan gagal. (wajib) |
rejected_card_type |
(hanya wajib jika penyebabnya adalah PAYMENT_ERROR_CARD_TYPE_TOPICED) |
description |
Kolom opsional ini digunakan partner guna menyertakan informasi tambahan hanya untuk tujuan proses debug. (opsional) |
payment_failure |
Informasi tentang kegagalan pembayaran. |
Cause
Enumerasi penyebab kegagalan.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Nilai default: Jangan digunakan; menghasilkan "error tidak diketahui" |
SLOT_UNAVAILABLE |
Slot ketersediaan yang direferensikan tidak tersedia lagi. |
SLOT_ALREADY_BOOKED_BY_USER |
Pengguna telah memesan janji temu untuk slot ketersediaan yang direferensikan. |
LEASE_EXPIRED |
Lease (jika tersedia) telah habis masa berlakunya dan tidak dapat digunakan lagi untuk menyelesaikan pemesanan yang diminta. |
OUTSIDE_CANCELLATION_WINDOW |
Pembatalan yang diminta tidak dapat dilakukan saat ini karena pembatasan waktu dalam kebijakan pembatalan dari penjual. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Terjadi error saat memproses pembayaran karena jenis kartu kredit yang diberikan tidak diterima oleh penjual. Jenis kartu kredit harus diberikan dalam rejected_card_type. |
PAYMENT_ERROR_CARD_DECLINED |
Terjadi error saat memproses pembayaran karena kartu kredit yang diberikan ditolak. |
PAYMENT_OPTION_NOT_VALID |
Terjadi error dengan paket/keanggotaan yang digunakan untuk membayar pemesanan. Mungkin tidak ada penggunaan valid yang tersisa, bisa jadi sudah habis masa berlakunya, dll. |
PAYMENT_ERROR |
Terjadi error saat memproses pembayaran untuk pemesanan ini. Gunakan nilai ini untuk menunjukkan error terkait pembayaran umum, hanya jika error tidak cocok dengan error pembayaran tertentu di atas. |
USER_CANNOT_USE_PAYMENT_OPTION |
Pengguna tidak dapat menggunakan opsi pembayaran tertentu (mis., pengguna mencoba menggunakan harga pengguna baru untuk kedua kalinya). |
BOOKING_ALREADY_CANCELLED |
Pemesanan yang coba dibatalkan oleh pengguna sudah dibatalkan. |
BOOKING_NOT_CANCELLABLE |
Pemesanan yang coba dibatalkan oleh pengguna tidak dapat dibatalkan. |
OVERLAPPING_RESERVATION |
Pengguna sudah memiliki reservasi yang terlalu dekat dengan waktu saat ini. |
USER_OVER_BOOKING_LIMIT |
Pemesanan gagal karena pengguna melebihi batas pemesanan gabungan per pengguna dari agregator. |
PAYMENT_REQUIRES_3DS1 |
Ditetapkan jika pembayaran ditolak karena Anda meminta agar transaksi dicoba lagi, tetapi kali ini setelah menyelesaikan tantangan/respons 3DS1. Perhatikan bahwa status kegagalan transaksi saat ini akan tetap gagal. Percobaan ulang akan benar-benar terpisah. Jika ini adalah alasan kegagalan, payment_failure.3DS1_parameters HARUS ditetapkan. Jika tidak, penyebab saat ini akan diperlakukan seolah-olah PAYMENT_ERROR. |
PaymentFailureInformation
Informasi tentang kegagalan pembayaran.
Kolom | |
---|---|
threeds1_parameters |
Parameter yang digunakan oleh agregator RwG untuk memulai protokol autentikasi 3DS1 dengan pengguna. Akan diabaikan kecuali jika BookingFailure.cause ditetapkan ke PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Parameter yang meminta agar RwG menjalankan tantangan 3DS1.
Parameter ditetapkan oleh deskripsi EMVCo protokol 3DS1.
Kolom | |
---|---|
acs_url |
URL tempat memuat formulir yang akan ditampilkan kepada Pengguna untuk autentikasi. |
pa_req |
Permintaan PaymentAuthentication. Untuk diposting ke formulir ACSUrl jika disediakan. |
transaction_id |
ID yang digunakan oleh penyedia ACS. Untuk diposting ke formulir ACSUrl jika disediakan. |
md_merchant_data |
Data penjual. Untuk diposting ke formulir ACSUrl jika disediakan. |
BookingStatus
Status pemesanan
Enum | |
---|---|
BOOKING_STATUS_UNSPECIFIED |
Tidak ditentukan. |
CONFIRMED |
Pemesanan telah dikonfirmasi |
PENDING_MERCHANT_CONFIRMATION |
Pemesanan menunggu konfirmasi oleh penjual sebelum dapat bertransisi ke status CONFIRMED (saat ini TIDAK didukung) |
PENDING_CLIENT_CONFIRMATION |
Pemesanan menunggu konfirmasi oleh klien sebelum dapat bertransisi ke status CONFIRMED (saat ini TIDAK didukung) |
CANCELED |
Pemesanan telah dibatalkan atas nama pengguna. |
NO_SHOW |
Klien tidak hadir untuk janji temu |
NO_SHOW_PENALIZED |
Klien tidak hadir untuk janji temu sehingga melanggar kebijakan pembatalan. |
FAILED |
Pemesanan tidak dapat diselesaikan karena kegagalan pemrosesan. |
DECLINED_BY_MERCHANT |
Pemesanan ditolak secara asinkron oleh penjual. |
CallMerchant
Pesan kosong untuk digunakan di UnusedPartySizeOption. Menetapkan setelan ini akan menampilkan opsi bagi pengguna untuk menelepon bisnis tersebut untuk pemesanan.
CancellationPolicy
Kebijakan pembatalan untuk layanan.
Kolom | |
---|---|
refund_condition[] |
Tidak ada ketentuan pengembalian dana atau lebih yang berlaku untuk kebijakan. |
RefundCondition
Menentukan satu kondisi pengembalian dana. Beberapa kondisi pengembalian dana dapat digunakan bersamaan untuk mendeskripsikan "langkah-langkah pengembalian dana" sebagai berbagai durasi sebelum waktu mulai layanan.
Kolom | |
---|---|
min_duration_before_start_time |
Durasi sebelum waktu mulai, hingga saat pelanggan dapat menerima pengembalian dana untuk sebagian biaya layanan yang ditentukan di |
refund_percent |
Persentase yang dapat dikembalikan dananya, selama pemesanan layanan dibatalkan setidaknya |
ClientInformation
Informasi pribadi tentang orang yang membuat pemesanan
Kolom | |
---|---|
given_name |
Nama depan klien |
family_name |
Nama keluarga klien |
address |
Alamat klien |
telephone |
Nomor telepon klien |
email |
Alamat email klien |
CreateMerchantRequest
Permintaan untuk membuat Merchant
.
Kolom | |
---|---|
parent |
Nama resource induk untuk partner yang memiliki penjual ini, dalam format |
merchant_id |
ID penjual yang akan digunakan untuk penjual ini. |
merchant |
Penjual yang akan dibuat. |
CreateServiceRequest
Permintaan untuk membuat Service
baru.
Kolom | |
---|---|
parent |
Nama resource induk untuk penjual yang memiliki layanan ini, dalam format |
service_id |
ID layanan yang akan digunakan untuk layanan ini. |
service |
Layanan yang akan dibuat. |
CreditCardRestrictions
Batasan pada jenis kartu kredit yang diterima penjual ini.
Kolom | |
---|---|
credit_card_type[] |
Daftar kartu kredit yang didukung. Tidak ada kartu kredit yang didukung jika kosong. |
CreditCardType
Jenis kartu kredit.
Enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Tidak digunakan. |
VISA |
Kartu kredit Visa. |
MASTERCARD |
Kartu kredit Mastercard. |
AMERICAN_EXPRESS |
Kartu kredit American Express. |
DISCOVER |
Kartu kredit Discover. |
JCB |
Kartu kredit JCB. |
DeleteMerchantRequest
Permintaan untuk menghapus Merchant
.
Kolom | |
---|---|
name |
Nama resource penjual yang akan dihapus. Dalam format partners/{partner_id}/merchants/{merchant_id} |
DeleteServiceRequest
Permintaan untuk menghapus Service
.
Kolom | |
---|---|
name |
Nama resource layanan yang akan dihapus. Dalam format |
Deposit
Deposit yang mungkin ditagih kepada pengguna atau ditangguhkan pada kartu kreditnya.
Kolom | |
---|---|
deposit |
Jumlah setoran. |
min_advance_cancellation_sec |
Pembatalan di muka minimum untuk setoran. |
deposit_type |
Menentukan cara deposit ditentukan dari ketersediaan. |
DirectMerchantPayment
Informasi tentang cara pengguna dapat membayar langsung kepada penjual, bukan prabayar untuk layanan melalui RwG.
Kolom | |
---|---|
payment_methods[] |
Pengguna hanya disarankan untuk membayar melalui metode pembayaran yang disebutkan di bawah ini. |
DurationRange
Wrapper untuk rentang durasi yang dapat dibatasi atau tidak dibatasi. Setidaknya salah satu dari min_duration dan max_duration durasi diperlukan.
Kolom | |
---|---|
min_duration |
Durasi minimum. |
max_duration |
Durasi maksimum. |
ExtendedServiceAvailability
Daftar ketersediaan dan siapa/kapan harus menerapkannya.
Kolom | |
---|---|
merchant_id |
Kolom ini wajib diisi untuk menentukan penjual mana yang memiliki pesan ketersediaan di bawah. |
service_id |
Kolom ini wajib diisi untuk menentukan layanan mana yang memiliki pesan ketersediaan di bawah. |
start_time_restrict |
Jika disediakan, kami akan menganggap entity Availability yang disediakan sebagai snapshot lengkap dari [start_time_restrict, end_time_restrict). Artinya, semua ketersediaan yang ada akan dihapus jika ketentuan berikut berlaku:
Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:
Jika pesan resources_restrict ditetapkan, ketentuan akan dibatasi lebih lanjut:
Kolom ini biasanya digunakan untuk memberikan pembaruan lengkap tentang ketersediaan dalam rentang waktu tertentu. Menetapkan start_time_restrict dan membiarkan end_time_restrict tidak ditetapkan akan berarti setiap waktu dimulai pada start_time_restrict. |
end_time_restrict |
Menetapkan end_time_restrict dan membiarkan start_time_restrict tidak ditetapkan akan berarti semua waktu berakhir pada end_time_restrict. |
duration_restrict |
Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok. |
resources_restrict |
Menetapkan resources_restrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk set resource ini. Semua kolom id resource harus sama persis. |
availability[] |
Daftar ketersediaan baru. |
FeedStatistics
Statistik yang diperoleh saat memproses feed yang diupload.
Kolom | |
---|---|
new_items |
Item yang baru saja ditambahkan oleh feed ini. Item dapat berupa penjual, layanan, atau slot ketersediaan, bergantung pada jenis feed. |
existing_items |
Item yang ada, diperbarui sesuai kebutuhan dari informasi baru dari feed. |
deleted_items |
Item yang tidak lagi ada di feed ini dan sebagai akibatnya dihapus. |
FeedStatus
Status feed yang diupload oleh platform agregator.
Kolom | |
---|---|
name |
Nama resource feed, yang memiliki format
|
state |
Status pemrosesan feed ini. |
error_details |
String yang dapat dibaca manusia yang memberikan detail selengkapnya jika kami gagal memproses feed ini. |
statistics |
Statistik khusus untuk feed ini. |
State
Enum untuk menunjukkan status pemrosesan feed.
Enum | |
---|---|
STATE_UNSPECIFIED |
Nilai default. Tidak digunakan. |
IN_PROGRESS |
Feed masih diproses. |
SUCCESS |
Feed telah berhasil diproses. |
FAILURE |
Kami mengalami error saat memproses feed. |
FoodOrderingMetadata
Metadata untuk tautan tindakan pemesanan makanan.
Kolom | |
---|---|
fee_details[] |
Detail biaya yang ditagih kepada pengguna selain total item. Berulang untuk berbagai jenis biaya seperti tarif layanan, biaya pengiriman, dll. |
advance_order_details |
Detail tentang dukungan pemesanan lanjutan juga dikenal sebagai pesan di muka di mana pengguna dapat melakukan pemesanan untuk pemenuhan pesanan di kemudian hari. |
Kolom union fulfillment_duration_options . Durasi waktu pemenuhan pesanan dari konfirmasi pesanan. Untuk pesanan pengiriman, durasi waktu hingga makanan diantar. Untuk pesanan pengambilan, durasi waktu hingga makanan siap diambil. fulfillment_duration_options hanya dapat berupa salah satu dari berikut: |
|
fulfillment_lead_time_duration |
Durasi tetap. Misalnya: 30 menit. |
fulfillment_lead_time_duration_range |
Rentang durasi. Contoh: * 30 menit hingga 45 menit * Lebih dari 30 menit * Kurang dari 50 menit |
AdvanceOrderDetails
Untuk dukungan pesan di muka.
Kolom | |
---|---|
is_supported |
Benar jika Pesanan di Muka, yang juga dikenal sebagai Pesan di Muka, didukung. (wajib) |
FeeDetails
Detail biaya.
Kolom | |
---|---|
type |
Jenis biaya. (wajib) |
fee_amount |
Jumlah biaya dalam mata uang satuan, persentase nilai keranjang, atau kombinasi keduanya. (wajib) |
FeeAmount
FeeAmount
contoh: * Biaya tetap: USD 0 (tanpa biaya), USD 1,5 * Rentang biaya tetap: USD 1,0 (minimum), USD 3,0 (maksimum), USD 5,0-6,0 * Persentase ukuran keranjang: 15,5%, 10%-20%, 10% (minimum), 15% (maksimum) * Kombinasi rentang dan persentase: 25% &persentase: USD 2,5 (minimum), 25,5% & USD 4,5 (maksimum), 10% & USD 1,5-2,5, 10,5%-20% & USD 2,5-3,5
Kolom | |
---|---|
cart_percentage |
Biaya dalam bentuk persentase nilai keranjang. Mendukung rentang (terikat dan tidak terbatas) atau persentase tetap. Nilai harus antara 0 dan 100. Contoh: * Tetap 5,5% * Setidaknya 5,5% * Maksimal 5,5% * 4,5% hingga 5,5% |
Kolom union amount_options . Opsi untuk menentukan jumlah uang. amount_options hanya dapat berupa salah satu dari berikut: |
|
amount |
Jumlah tetap. Misalnya, USD 3,5. |
amount_range |
Rentang jumlah. Contoh: * USD 3,5 hingga USD 5,5 * Minimal USD 3,5 * Maksimal USD 5,5 |
amount_unknown |
Jumlah tidak diketahui. |
FeeType
Jenis biaya.
Enum | |
---|---|
FEE_TYPE_UNSPECIFIED |
Jenis biaya belum ditetapkan. |
DELIVERY |
Untuk biaya pengiriman. |
SERVICE |
Untuk tarif layanan. |
FulfillmentOption
Opsi pemenuhan pesanan untuk link tindakan online pesanan.
Kolom | |
---|---|
fulfillment_type |
Wajib diisi. Jenis fulfillment. |
available_day[] |
Wajib diisi. Daftar hari saat ketersediaan untuk metode pemenuhan ini (sebaiknya minimal 2). |
fee_details |
Wajib diisi. Detail biaya untuk metode pemenuhan. |
minimum_order |
Wajib diisi. Pesanan minimum untuk metode pemenuhan yang terkait dengan link tindakan. |
AvailableDay
Ketersediaan tingkat hari.
Kolom | |
---|---|
fulfillment_date |
Wajib diisi. Tanggal yang tersedia untuk metode pemenuhan. Diasumsikan berada dalam zona waktu penjual. |
last_ordering_time |
Wajib diisi. Stempel waktu Unix. Terakhir kali pengguna dapat memesan dan menerima item paling lambat Misalnya, jika fulfillment_date adalah 2020-08-10: - nilai last_ordering_time dari 2020-08-10 18:00 berarti bahwa, untuk menerima pesanan mereka pada 10-08-2020, pelanggan harus melakukan pesanan tersebut paling lambat pukul 18.00 pada hari yang sama. - nilai last_ordering_time 2020-08-08 20:00 berarti, untuk menerima pesanan mereka pada 2020-08-10, pelanggan harus melakukan pemesanan tersebut sebelum pukul 20:00 dua hari sebelumnya. |
FeeDetails
Detail biaya untuk metode pemenuhan yang dikaitkan dengan link tindakan.
Kolom | |
---|---|
Kolom union fee_details . Model biaya untuk metode pemenuhan. fee_details hanya dapat berupa salah satu dari berikut: |
|
no_fee |
Tidak ada biaya untuk metode pemenuhan. |
base_fee |
Biaya dasar yang terkait dengan metode pemenuhan. |
fixed_fee |
Biaya tetap yang terkait dengan metode pemenuhan pesanan. |
FixedFee
Biaya tetap yang diperlukan untuk metode pemenuhan yang terkait dengan link tindakan.
Kolom | |
---|---|
amount |
Wajib diisi. Jumlah biaya tetap untuk metode pemenuhan. |
FulfillmentType
Jenis fulfillment yang terkait dengan link tindakan.
Enum | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Jenis fulfillment tidak ditentukan. |
FULFILLMENT_TYPE_DELIVERY |
Jenis pemenuhan pesanan adalah pengiriman. |
FULFILLMENT_TYPE_PICKUP |
Jenis pemenuhan pesanan adalah pengambilan. |
MinimumFee
Biaya minimum yang diperlukan untuk metode pemenuhan yang terkait dengan link tindakan.
Kolom | |
---|---|
base_fee_amount |
Wajib diisi. Jumlah biaya dasar untuk metode pemenuhan. |
NoFee
Tidak perlu biaya untuk metode pemenuhan yang terkait dengan link tindakan.
GenericDeleteRecord
Kumpulan data yang akan dihapus dari jenis feed yang disebutkan dalam permintaan URL.
Kolom | |
---|---|
delete_time |
Wajib diisi. Stempel waktu ini digunakan untuk menentukan urutan penghapusan akan diterapkan ke inventaris. |
Kolom union record_type . Mengenkapsulasi berbagai jenis feed (ndjson, berbasis proto, dll.) Partner dapat memberikan data lengkap yang mirip dengan cara data diberikan dalam feed atau BatchPush API. Partner juga memiliki opsi untuk hanya menyertakan kolom penting dari data yang diperlukan untuk mengidentifikasinya secara unik. record_type hanya dapat berupa salah satu dari berikut: |
|
data_record |
Untuk feed berbasis non-proto. |
proto_record |
Untuk feed berbasis proto. |
GenericRecord
Data jenis feed yang disebutkan dalam permintaan URL.
Kolom | |
---|---|
generation_timestamp |
Wajib diisi. Stempel waktu ini digunakan untuk memastikan urutan pembaruan inventaris yang benar. |
Kolom union record_type . Mengenkapsulasi berbagai jenis feed (ndjson, berbasis proto, dll.) record_type hanya dapat berupa salah satu dari berikut: |
|
data_record |
Untuk feed berbasis non-proto. |
proto_record |
Untuk feed berbasis proto. |
GeoCoordinates
Data Geografis lokasi, termasuk lintang, bujur, dan alamat.
Kolom | |
---|---|
latitude |
Lintang dalam derajat. (opsional) |
longitude |
Bujur dalam derajat. (opsional) |
Kolom union addresses . Alamat untuk lokasi, dapat terstruktur atau tidak terstruktur. addresses hanya dapat berupa salah satu dari berikut: |
|
address |
Alamat pos lokasi, disarankan. |
unstructured_address |
Alamat yang tidak terstruktur juga dapat diberikan sebagai penggantian. Mis., "1600 amphitheatre parkway mountain view, ca 94043" |
GetMerchantStatusRequest
Permintaan untuk mendapatkan MerchantStatus
Kolom | |
---|---|
name |
Wajib diisi. Nama resource, dalam format Partners/{partner_id}/merchants/{merchant_id}/status. |
GetStatusRequest
Permintaan untuk mengambil Status
untuk feed tertentu yang diupload platform agregator.
Kolom | |
---|---|
name |
Nama resource feed, yang memiliki format
|
HomeServiceData
Informasi tambahan yang harus disediakan untuk vertical layanan rumah tangga.
Kolom | |
---|---|
category_type |
Kategori tingkat tinggi yang mencakup layanan rumah tangga ini. Mis. tukang leding, tukang listrik, dll. |
job_type |
Jenis pekerjaan dalam kategori yang mencakup layanan rumah tangga yang diberikan. Mis. {i>unclog_drain, install_faucet<i} adalah jenis pekerjaan dalam kategori tukang leding. |
IntegrationType
Kedalaman integrasi yang didukung.
Enum | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
Default-nya adalah END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
Integrasi lengkap yang memungkinkan pemesanan menyeluruh melalui Google. |
INTEGRATION_TYPE_INVENTORY_ONLY |
Server pemesanan tidak perlu mendukung layanan ini. Hanya data ketersediaan penjual (opsional), layanan, dan penjual yang perlu dikirim. |
InvalidateResourceRequest
Permintaan untuk membatalkan resource.
Kolom | |
---|---|
resource_id |
Nama resource yang akan dibatalkan validasinya. Misalnya, untuk aset Pengambilan, nama harus memiliki format |
LineItem
Satu item dalam satu pesanan - pemesanan satu layanan dalam satu slot waktu.
Kolom | |
---|---|
service_id |
ID Layanan penjual. |
start_sec |
Waktu mulai slot janji temu dalam detik waktu UTC sejak Unix epoch. |
duration_sec |
Durasi slot janji temu dalam detik. |
tickets[] |
Jumlah tiket yang dipesan menurut Jenis Tiket. |
price |
Harga total (tidak termasuk pajak) untuk Item Baris ini. |
status |
Status Item Baris. |
OrderedTickets
Jumlah tiket yang dipesan menurut Jenis Tiket.
Kolom | |
---|---|
ticket_id |
ID Jenis Tiket. |
count |
Jumlah tiket yang dipesan untuk jenis ini. |
ListMerchantStatusesRequest
Permintaan untuk mendapatkan daftar MerchantStatus
Kolom | |
---|---|
parent |
Wajib diisi. Induk, yang memiliki kumpulan status penjual ini. Format: |
page_size |
Wajib diisi. Jumlah maksimum item untuk ditampilkan. Perhatikan bahwa server mungkin mengurangi ukuran halaman. |
page_token |
Opsional. Nilai nextPageToken yang ditampilkan dari ListMerchantStatusResponse sebelumnya, jika ada. |
booking_inventory_status_restrict |
Opsional. Batasan opsional untuk memfilter hasil menurut status inventaris pemesanan. |
waitlist_inventory_status_restrict |
Opsional. Batasan opsional untuk memfilter hasil menurut status inventaris daftar tunggu. |
geo_match_restrict |
Opsional. Pembatasan opsional untuk memfilter hasil menurut status Pencocokan geografis. |
BookingInventoryStatus
Status inventaris pemesanan menyeluruh.
Enum | |
---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Tidak ditentukan. |
NO_VALID_FUTURE_INVENTORY |
Penjual tidak memiliki inventaris pemesanan dalam 30 hari ke depan. |
HAS_VALID_FUTURE_INVENTORY |
Penjual memiliki inventaris pemesanan dalam 30 hari ke depan. |
GeoMatchingStatus
Status pencocokan geografis penjual.
Enum | |
---|---|
GEO_MATCHING_STATUS_UNSPECIFIED |
Tidak ditentukan. |
GEO_UNMATCHED |
Penjual tidak dicocokkan secara geografis. |
GEO_MATCHED |
Penjual dicocokkan secara geografis. |
WaitlistInventoryStatus
Status inventaris daftar tunggu end-to-end.
Enum | |
---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Tidak ditentukan. |
NO_VALID_WAITLIST_SERVICE |
Penjual tidak memiliki layanan yang mendukung daftar tunggu. |
HAS_VALID_WAITLIST_SERVICE |
Penjual memiliki layanan yang mendukung daftar tunggu. |
ListMerchantStatusesResponse
Respons untuk daftar MerchantStatus
.
Kolom | |
---|---|
merchant_statuses[] |
Daftar status penjual yang memenuhi kondisi filter. |
next_page_token |
Token untuk mengambil halaman hasil berikutnya. Tidak ada lagi hasil dalam daftar jika kosong. |
ListStatusRequest
Permintaan untuk mengambil Status
untuk beberapa feed yang diupload oleh platform agregator.
Kolom | |
---|---|
name |
Nama resource feed, yang memiliki format
|
page_size |
Jumlah maksimum item untuk ditampilkan. |
page_token |
Nilai next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada. |
state_restrict |
Pembatasan opsional untuk memfilter hasil menurut status feed. |
time_range_restrict |
Pembatasan opsional untuk memfilter hasil menurut batas atas dan bawah. Jika start_time tidak ditetapkan, setelan default-nya adalah awal waktu unix. Jika end_time tidak ditetapkan, setelan default-nya adalah sekarang. |
ListStatusResponse
Permintaan untuk mengambil Status
untuk beberapa feed yang diupload oleh platform agregator.
Kolom | |
---|---|
status[] |
Daftar kronologis terbalik status untuk feed yang diupload. Jumlah maksimum item yang ditampilkan didasarkan pada kolom page_size dalam permintaan. |
next_page_token |
Token untuk mengambil halaman hasil berikutnya. Tidak ada lagi hasil dalam daftar jika kosong. |
LocalizedString
Instance string dalam satu lokal.
Kolom | |
---|---|
locale |
Kode bahasa BCP 47 IETF, seperti "en", "mas", "zh-Hant", "de-CH-1901". Lihat http://www.w3.org/International/articles/language-tags/. |
value |
Pesan dalam lokalitas di atas (UTF-8). |
Location
Informasi geografis tentang lokasi.
Kolom | |
---|---|
place_id |
ID Tempat untuk suatu tempat di database Google Places dan di Google Maps. Lihat https://developers.google.com/places/web-service/place-id untuk mengetahui ID Tempat lebih lanjut. Jika disediakan, Google akan mencocokkan suatu lokasi dengan tempat ini. |
name |
Nama lokasi, telepon, url, dan geografis digunakan untuk mendukung pencocokan lokasi dengan tempat yang sudah ada di Google Maps. Kolom ini bersifat opsional, tetapi mungkin diwajibkan dalam beberapa konteks. Misalnya, Service.location tanpa nama tidak akan dicocokkan dengan entitas bisnis, meskipun jika keduanya berlokasi di alamat yang sama. (opsional) |
telephone |
Nomor telepon publik lokasi termasuk kode negara dan area, mis., +14567891234. (opsional) |
url |
Url situs publik lokasi. (opsional) |
geo |
Info Geografis lokasi, termasuk lintang, bujur, dan alamat. (opsional) |
location_type |
Jenis lokasi, harus diberikan jika lokasi ini disediakan untuk Layanan. |
location_id |
Referensi unik lokasi dalam layanan. ID ini dapat digunakan untuk merujuk ke lokasi ini dalam kolom layanan lainnya. Mis. dalam formulir informasi kontak kustom, kumpulan ID lokasi dapat digunakan untuk menentukan opsi lokasi penjemputan. Jika ditetapkan, ID ini harus unik dalam layanan yang sama. (opsional) |
LocationType
Jenis lokasi ini.
Enum | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
Jenis lokasi tidak ditentukan. |
VISITED_LOCATION |
Lokasi tempat layanan ini dikunjungi. |
START_LOCATION |
Lokasi tempat layanan ini dimulai, juga berfungsi sebagai MEETING_LOCATION. |
END_LOCATION |
Lokasi tempat layanan ini berakhir. |
Merchant
Info tentang penjual yang ada di platform agregator.
Kolom | |
---|---|
name |
Nama resource penjual, yang memiliki format |
merchant_name |
Merchant_name, telepon, url, dan geo digunakan untuk mendukung kecocokan inventaris partner dengan penjual yang sudah ada di Google Maps. Informasi ini tidak akan ditampilkan. Nama penjual. |
telephone |
Nomor telepon publik penjual termasuk kode negara dan areanya, mis. +14567891234. |
url |
URL situs publik penjual. |
geo |
Info Geografis penjual, termasuk lintang, bujur, dan alamat. |
category |
Kategori bisnis di platform agregator. |
num_bookings_30d |
Kolom ini tidak digunakan lagi. |
tax_rate_basis_points |
Tarif pajak penjual dalam poin dasar (seribu dari satu persen). Misalnya, jika tarif pajak adalah 7,5%, kolom ini harus ditetapkan ke 750. Jika kolom ini tidak ditetapkan atau ditetapkan ke 0, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini adalah harga persis yang ditentukan oleh Service.price. Harga layanan diasumsikan bebas dari atau sudah termasuk pajak yang berlaku. Pajak tidak akan ditampilkan kepada pengguna sebagai item baris terpisah. Jika kolom ini ditetapkan ke nilai selain nol, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini akan mencakup harga layanan ditambah pajak yang dihitung menggunakan tarif pajak yang diberikan di sini. Pecahan dari satuan mata uang terkecil (misalnya, pecahan dari satu sen) akan dibulatkan menggunakan pembulatan genap terdekat. Pajak akan ditampilkan kepada pengguna sebagai item baris terpisah. Kolom ini tidak digunakan lagi, sebagai gantinya gunakan tax_rate. |
tax_rate |
Tarif pajak penjual. Jika ada, kolom ini akan mengganti kolom tax_rate_basis_points yang tidak digunakan lagi. Pesan kosong (yaitu tax_rate { }) akan mereset tarif pajak yang berlaku ke nol. |
payment_restrictions |
Batasan metode pembayaran yang diterima penjual ini. Kami mengasumsikan tidak ada batasan jika kolom ini tidak ditetapkan. |
payment_option[] |
Opsi pembayaran yang tersedia untuk penjual ini. Layanan pada penjual ini akan dapat membatasi opsi pembayaran yang mereka izinkan secara individu. |
payment_processor_config |
Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya. |
tokenization_config |
Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya. |
terms |
Persyaratan dan Ketentuan penjual tertentu yang ditampilkan kepada pengguna saat layanan dipesan melalui Pesan dengan Google. Selain hal tersebut, Persyaratan dan Ketentuan partner agregator selalu ditampilkan kepada pengguna dan tidak boleh disediakan di sini. |
brand_id |
String buram yang mengidentifikasi merek yang ditampilkan ke konsumen untuk digunakan saat menampilkan atribusi partner. Kolom ini memungkinkan partner dengan beberapa merek yang ditampilkan ke konsumen memberikan penjual untuk semua merek dalam feed yang sama. Merek terdiri dari properti yang dilihat konsumen seperti nama, logo, Persyaratan Layanan, dan Kebijakan Privasi. Jika hanya ada satu merek partner yang ditampilkan ke konsumen, kolom ini tidak perlu ditetapkan dan dapat diabaikan. Jika partner... Apakah tidak memiliki beberapa merek yang dilihat pelanggan? --> Abaikan kolom ini Punya Beberapa Merek yang dikonfigurasi?
Perhatian: sebagian besar partner tidak perlu menetapkan kolom ini. Jika partner ingin menggunakan kolom ini, partner harus menghubungi kami terlebih dahulu untuk mengonfigurasi merek terpisah, termasuk merek default. |
matching_hints |
Petunjuk untuk membantu Google mencocokkan penjual dengan suatu tempat di Google Maps. Catatan: sebagian besar partner tidak perlu menetapkan kolom ini, karena Google akan mencocokkan penjual dengan suatu tempat di Google Maps menggunakan informasi yang diberikan di atas. (opsional) |
service_attribute[] |
Definisi untuk setiap atribut layanan yang digunakan untuk mendeskripsikan Layanan bagi Penjual ini. (opsional) |
action_link[] |
Opsional. URL tindakan dengan bahasa terkait, daftar negara yang dibatasi, jenis, dan platform opsional yang menunjukkan di platform mana tindakan ini harus dilakukan, |
waitlist_advisement |
Opsional. Saran umum dari penjual tertentu untuk pengguna yang bergabung ke daftar tunggu melalui Pesan dengan Google. Panjang kolom teks individual dalam saran harus dibatasi hingga 100 byte. |
MerchantMatchingHints
Petunjuk yang digunakan untuk membantu Google mencocokkan penjual dengan suatu tempat di Google Maps.
Kolom | |
---|---|
place_id |
ID Tempat untuk suatu tempat di database Google Places dan di Google Maps. Lihat https://developers.google.com/places/web-service/place-id untuk mengetahui ID Tempat lebih lanjut. |
MerchantStatus
Status penjual di platform Pesan dengan Google.
Kolom | |
---|---|
name |
Nama resource status penjual, yang memiliki format |
merchant_name |
Nama penjual yang disediakan oleh partner. |
input_geo_info |
Partner memberikan info Geografis penjual. |
processing_status |
Status pemrosesan penjual. |
booking_status |
Status terkait integrasi pemesanan menyeluruh. |
waitlist_status |
Status terkait integrasi daftar tunggu. |
geo_match |
Cocok dengan tempat Geografis penjual ini. Kosong jika penjual tidak cocok dengan Geografis. |
local_services_match |
Iklan Jasa dan Servis yang cocok dengan penjual ini. Kosong jika bukan penjual jasa lokal atau tidak cocok dengan penyedia mana pun. |
direct_urls[] |
Daftar URL untuk menunjukkan konten inventaris penjual saat ini. Perlu diketahui bahwa ini tidak berarti inventaris benar-benar ditayangkan dan URL-nya mungkin berbeda dari yang terlihat oleh publik. |
BookingStatus
Status terkait integrasi pemesanan menyeluruh.
Kolom | |
---|---|
has_valid_future_inventory |
Berlaku jika penjual memiliki inventaris dalam 30 hari ke depan. Tidak menjamin penjual benar-benar dilayani. |
DirectUrl
URL yang menampilkan penjual.
Kolom | |
---|---|
type |
Jenis URL ini. |
url |
URL yang mungkin menampilkan penjual ini. |
UrlType
Jenis URL yang ditampilkan.
Enum | |
---|---|
URL_TYPE_UNSPECIFIED |
Tidak ditentukan. |
BOOKING |
URL pemesanan end-to-end. |
WAITLIST |
URL daftar tunggu end-to-end. |
LOCAL_SERVICES |
URL Jasa dan Servis Google. |
LocalServicesMatchInfo
Informasi jasa dan servis Google cocok (hanya ditetapkan untuk penjual jasa dan servis).
Kolom | |
---|---|
matched_providers[] |
Penyedia layanan yang cocok. Seorang penjual dapat dicocokkan dengan beberapa penyedia layanan. |
MatchedProvider
Penyedia jasa dan servis.
Kolom | |
---|---|
customer_id |
ID pelanggan eksternal layanan lokal Google. |
categories[] |
Kategori jasa dan servis (vertikal). Mis. "tukang leding" dan "pembersihan karpet". |
PlaceInfo
Informasi tempat yang cocok.
Kolom | |
---|---|
name |
Nama tempat. |
formatted_address |
Alamat yang diformat dalam bahasa lokal. |
place_id |
ID Google Place untuk tempat ini. Dapat digunakan untuk membuat URL Google Maps atau mengambil detail tempat lebih lanjut. Lihat https://developers.google.com/places/web-service/place-id untuk mengetahui contoh penggunaan. |
ProcessingStatus
Status pemrosesan penjual.
Enum | |
---|---|
PROCESSING_STATUS_UNSPECIFIED |
Status belum ditetapkan. |
IN_PROGRESS |
Penjual telah diterima oleh Madden, tetapi masih diproses. Penjual dalam status ini tidak akan memiliki status lainnya yang terisi. |
COMPLETED |
Status lainnya dari penjual telah dihitung. |
WaitlistStatus
Status terkait integrasi daftar tunggu.
Kolom | |
---|---|
has_valid_waitlist_service |
Benar jika penjual memiliki layanan daftar tunggu. Tidak menjamin penjual benar-benar dilayani. |
MoneyRange
Wrapper untuk rentang jumlah uang yang dapat dibatasi atau tidak dibatasi. Setidaknya salah satu dari min_amount dan max_amount wajib diisi.
Kolom | |
---|---|
min_amount |
Jumlah minimum. |
max_amount |
Jumlah maksimum. |
NoShowFee
Biaya yang mungkin ditagihkan kepada pengguna jika mereka telah membuat pemesanan tetapi tidak datang ke layanan yang dipesan.
Kolom | |
---|---|
fee |
Jumlah yang mungkin ditagihkan kepada pengguna jika mereka tidak hadir untuk reservasi mereka. |
fee_type |
Menentukan cara biaya ditentukan dari ketersediaan. |
Order
Pesanan untuk janji temu layanan dengan penjual.
Kolom | |
---|---|
name |
Nama resource pesanan: |
client_information |
Informasi pribadi klien yang membuat pesanan. |
payment_information |
Informasi tentang transaksi pembayaran yang terkait dengan pesanan. |
merchant_id |
ID penjual tempat semua layanan dalam pesanan ini berada. |
item[] |
Item baris dalam pesanan ini. |
OrderOnlineMetadata
Metadata untuk link tindakan online pesanan.
Kolom | |
---|---|
fulfillment_option[] |
Opsi pemenuhan pesanan yang tersedia untuk link tindakan online pesanan. |
PaymentInformation
Detail pembayaran terkait pemesanan
Kolom | |
---|---|
prepayment_status |
Status prabayar pemesanan. Jika prepayment_status adalah PREPAYMENT_PROVIDED atau PREPAYMENT_REFUNDED, payment_transaction_id berisi id transaksi unit terkait. |
payment_transaction_id |
ID unik untuk transaksi pembayaran terkait pemesanan. Kosong jika tidak berlaku. |
PaymentOption
Opsi pembayaran, yang dapat digunakan untuk membayar layanan yang disediakan penjual. Opsi pembayaran dapat dibagikan di antara beberapa penjual (mis. penjual di jaringan yang sama).
Kolom | |
---|---|
payment_option_id |
ID ini digunakan untuk mengidentifikasi opsi pembayaran ini. ID ini bersifat global untuk seluruh agregator, dan penggunaan kembali nilai dalam beberapa penjual akan memungkinkan pengguna membayar dengan opsi pembayaran yang sesuai di semua penjual tersebut. Saat menggunakan kembali ID di beberapa penjual, memperbarui nilai apa pun untuk opsi pembayaran pada satu penjual juga akan memperbarui opsi pembayaran lainnya dengan ID yang sama, pada penjual yang berbeda. Oleh karena itu, sebaiknya semua opsi pembayaran yang memiliki ID sama selalu diperbarui ke nilai yang identik untuk menghindari kemungkinan perilaku yang tidak deterministik. |
name |
Nama opsi pembayaran. Ini dapat dilihat pengguna. |
description |
Deskripsi opsi pembayaran. Ini dapat dilihat pengguna. |
price |
Harga opsi pembayaran. |
tax_rate |
Tarif pajak untuk opsi pembayaran ini. Jika ada, kolom ini akan mengganti kolom tax_rate yang ada di Penjual atau Layanan. Pesan kosong (yaitu tax_rate { }) akan mereset tarif pajak yang berlaku ke nol. |
payment_option_type |
Jenis opsi pembayaran ini. Penggunaan tunggal untuk penurunan, multi-penggunaan untuk paket, dan tanpa batas untuk keanggotaan. |
session_count |
Jumlah sesi yang dapat digunakan oleh opsi pembayaran ini. Hanya valid untuk multi-sesi/paket, dengan nilai harus > 1. |
purchase_interval |
Opsi pembayaran dapat dibeli dalam interval ini. |
valid_interval |
Opsi pembayaran dapat digunakan dalam interval ini (mis., harga khusus untuk Januari 2017). Jika ada, metode ini akan mengganti valid_duration dan activation_type. |
valid_duration |
Durasi validitas opsi pembayaran (mis., keanggotaan 30 hari). |
activation_type |
Menentukan cara tanggal mulai validitas ditentukan untuk opsi pembayaran ini. |
user_restriction |
Membatasi pengguna yang valid untuk membeli opsi pembayaran ini. Dapat digunakan untuk membatasi opsi pembayaran promosi ke subkumpulan pengguna. Jika tidak ditetapkan, semua pengguna memenuhi syarat. |
ActivationType
Menentukan bagaimana tanggal mulai validitas ditentukan.
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Tidak digunakan. |
ACTIVATION_ON_PURCHASE |
Validitas dimulai pada saat pembelian. |
ACTIVATION_ON_FIRST_USE |
Validitas dimulai saat opsi pembayaran digunakan untuk pertama kalinya. |
PaymentOptionType
Jenis opsi pembayaran.
Enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Tidak digunakan. |
PAYMENT_OPTION_SINGLE_USE |
Opsi pembayaran hanya dapat digunakan sekali. |
PAYMENT_OPTION_MULTI_USE |
Opsi pembayaran dapat digunakan jika jumlah sesinya > 0. |
PAYMENT_OPTION_UNLIMITED |
Opsi pembayaran dapat digunakan dalam rentang waktu yang valid - jumlah sesi tidak dapat diterapkan. |
PaymentProcessorConfig
Konfigurasi untuk pemroses pembayaran, yang disiapkan per Penjual.
Kolom | |
---|---|
processor |
Menentukan partner pemroses pembayaran yang menerapkan konfigurasi ini. |
public_key |
Kunci yang digunakan untuk mengidentifikasi penjual ini dengan pemroses pembayaran. Untuk Stripe, lihat: https://stripe.com/docs/dashboard#api-keys Untuk Braintree, lihat: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Nomor versi API yang dikirim ke pemroses pembayaran beserta permintaan pembayaran. |
Processor
Menentukan partner pemroses pembayaran tertentu.
Enum | |
---|---|
PROCESSOR_UNSPECIFIED |
Tidak digunakan |
PROCESSOR_STRIPE |
Konfigurasi untuk pembayaran dengan stripe. |
PROCESSOR_BRAINTREE |
Konfigurasi untuk pembayaran dengan Braintree. |
PaymentRestrictions
Batasan metode pembayaran yang diterima penjual ini.
Kolom | |
---|---|
credit_card_restrictions |
Batasan pada kartu kredit yang diterima penjual ini. Kami berasumsi bahwa semua kartu kredit diterima jika kolom ini tidak ditetapkan. Perhatikan bahwa daftar kartu yang didukung oleh CreditCardType akan bertambah dari waktu ke waktu, artinya jika kolom ini dikosongkan, sebuah konfigurasi dapat berubah di masa mendatang. |
PerOrderFee
Biaya yang harus dibayar sekali per pesanan, berapa pun jumlah tiketnya.
Kolom | |
---|---|
delivery_fee |
Biaya yang dapat bervariasi menurut metode pengiriman. |
processing_fee |
Biaya untuk memproses metode pembayaran pengguna. |
PerTicketFee
Biaya yang harus dibayar untuk setiap tiket yang dibeli pengguna.
Kolom | |
---|---|
service_charge |
Biaya tambahan yang dikenakan untuk satu layanan. |
facility_fee |
Biaya yang masuk ke tempat/fasilitas. |
taxes |
Pajak per tiket. |
PostalAddress
Alamat pelanggan atau bisnis.
Kolom | |
---|---|
address_country |
Negara, yang ditentukan menggunakan kode negara ISO 3166-1 alpha-2, misalnya "AS" (wajib diisi) |
address_locality |
Lokalitas, mis., "Mountain View". (wajib) |
address_region |
Wilayah, mis., "CA". Kolom ini hanya wajib diisi di negara-negara tempat wilayah biasanya merupakan bagian dari alamat. (opsional) |
postal_code |
Kode pos, mis., "94043". (wajib) |
street_address |
Alamat, mis., "1600 Amphitheater Pkwy". (wajib) |
PrepaymentStatus
Status pembayaran di muka untuk pemesanan.
Enum | |
---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
Tidak ditentukan, ditetapkan secara default ke PREPAYMENT_NOT_PROVIDED. |
PREPAYMENT_PROVIDED |
Biaya pemesanan telah dibayar di awal. |
PREPAYMENT_NOT_PROVIDED |
Biaya pemesanan belum dibayar di awal. |
PREPAYMENT_REFUNDED |
Biaya tersebut sebelumnya adalah PREPAYMENT_PROVIDED, tetapi kini dananya telah dikembalikan. |
Price
Harga layanan atau biaya.
Kolom | |
---|---|
price_micros |
Harga dalam satuan mikro mata uang. Bagian dari satuan mata uang terkecil akan dibulatkan menggunakan pembulatan genap terdekat. (mis., untuk USD, 2,5 sen dibulatkan ke 2 sen, 3,5 sen dibulatkan ke 4 sen, 0,5 sen dibulatkan ke 0 sen, 2,51 sen dibulatkan ke 3 sen). |
currency_code |
Mata uang harga yang ditentukan dalam ISO 4217. |
pricing_option_tag |
String opsional dan buram yang mengidentifikasi opsi harga yang dikaitkan dengan harga keseluruhan. |
PriceInterpretation
Menjelaskan bagaimana Harga seharusnya ditafsirkan dan ditampilkan kepada pengguna.
Enum | |
---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
Penafsiran harga tidak ditentukan, ditetapkan secara default ke EXACT_AMOUNT. |
EXACT_AMOUNT |
Jika harga harus ditafsirkan sebagai nilai tertentu. Contoh: $20 untuk kelas yoga; $15 untuk potong rambut anak |
STARTS_AT |
Jika harga layanan adalah variabel, tetapi harga minimum diketahui dan ditampilkan kepada konsumen. Konsumen dapat membuat pilihan yang meningkatkan harga. Perlu diketahui bahwa layanan apa pun yang menggunakan PriceInterpretation ini harus menggunakan PrepaymentType NOT_SUPPORTED. Contoh: $30 untuk salon perawatan anjing, tetapi pilihan konsumen tambahan dapat meningkatkan harga |
NOT_DISPLAYED |
Jika harga layanan adalah variabel dan tidak ada informasi harga yang ditampilkan kepada konsumen sebelumnya. Perlu diketahui bahwa layanan apa pun yang menggunakan PriceInterpretation ini harus menggunakan PrepaymentType NOT_SUPPORTED dan Price harus kosong. Contoh: Konsultasi untuk layanan rumah tangga |
PriceType
Menentukan bagaimana total harga ditetapkan dari ketersediaan.
Enum | |
---|---|
FIXED_RATE_DEFAULT |
Harga untuk jumlah tetap. Ini adalah nilai default jika kolom tidak ditetapkan. Contoh: Deposit sebesar $50 untuk mereservasi meja; denda ketidakhadiran sebesar $20 untuk kelas yoga |
PER_PERSON |
Harga yang ditentukan adalah per orang, dan total harga dihitung sesuai dengan jumlah tamu yang disebutkan dalam Resources sebagai price_micros * party_size. Harga PER_PERSON harus disertai jumlah tamu dalam sumber daya ketersediaan. Jika tidak, jumlah satu tamu akan digunakan. Contoh: $10 untuk tiket museum |
QuantitativeValue
Wrapper untuk nilai numerik yang bisa berupa rentang atau nilai tetap. Contoh QuantitativeValue
: * Nilai tunggal: value: 10.5
* Rentang terikat: value_range {min_value: 5.5, max_value 10.5}
* Batas bawah: value_range {min_value: 5.5}
* Batas atas: value_range {max_value: 10.5}
Kolom | |
---|---|
Kolom union value_options . (wajib) value_options hanya dapat berupa salah satu dari yang berikut: |
|
value |
Nilai tunggal. Misalnya: 5.6 |
value_range |
Rentang nilai yang juga dapat berupa uraian atau dibatasi. Contoh: * Minimal 5,5 * Maksimal 5,5 * 5,5 hingga 6,5 |
RangeValue
Rentang nilai sedemikian rupa sehingga min_value
< max_value
. Memerlukan setidaknya salah satu dari min_value
dan max_value
.
Kolom | |
---|---|
min_value |
Nilai minimum. |
max_value |
Nilai maksimum. |
Rating
Menentukan Rating untuk entitas.
Kolom | |
---|---|
value |
Nilai rating rata-rata (wajib jika number_of_ratings > 0). Nilai harus dalam rentang [1, 5] dan dapat dihilangkan jika dan hanya jika number_of_ratings nol. |
number_of_ratings |
Jumlah rating yang digunakan untuk menghitung nilai (wajib). |
RelatedMedia
Foto terkait layanan ini. Google akan meng-crawl media ini untuk memastikan bahwa media tersebut ditampilkan dengan benar kepada pengguna akhir. (opsional)
Kolom | |
---|---|
url |
URL asal media ini. Google akan meng-crawl media yang dihosting di URL ini. |
type |
Jenis sumber media ini. |
localized_caption |
Teks media yang mendukung i18n, hanya mendukung teks biasa. Setiap komponen HTML akan dihapus. (opsional) |
attribution |
Informasi atribusi tentang asal media. Perhatikan bahwa jika atribusi diwajibkan untuk ditampilkan dengan media guna memberikan kredit kepada fotografer atau agen, kolom ini harus ditetapkan. (opsional) |
caption |
Tidak digunakan lagi, lebih memilih menggunakan localized_caption. |
Attribution
Informasi atribusi untuk media ini.
Kolom | |
---|---|
localized_text |
Teks untuk memberikan kredit kepada fotografer atau agen yang mendukung i18n. Teks ini akan ditampilkan bersama media sumber. Perhatikan bahwa hanya teks biasa yang didukung untuk kolom ini, komponen HTML apa pun akan dihapus (atribusi berbasis hyperlink tidak didukung). |
text |
Tidak digunakan lagi, lebih memilih menggunakan localized_text. |
MediaType
Enum untuk menunjukkan jenis sumber media ini. Hanya foto yang didukung. Hubungi tim Pesan dengan Google jika media lain selain foto perlu didukung.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tidak digunakan. |
PHOTO |
Menunjukkan media yang disediakan oleh url adalah foto. |
ReplaceServiceAvailabilityRequest
Permintaan untuk mengganti ketersediaan Service
.
Kolom | |
---|---|
service_availability |
Ketersediaan layanan yang digunakan untuk mengganti yang sudah ada. |
RequireCreditCard
Menentukan apakah kartu kredit diwajibkan untuk memesan janji temu.
Enum | |
---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
Persyaratan kartu kredit tidak ditentukan secara eksplisit dan perilakunya sama dengan persyaratan yang ditentukan untuk CONDITIONAL. |
REQUIRE_CREDIT_CARD_CONDITIONAL |
Google akan mewajibkan kartu kredit untuk pemesanan jika salah satu ketentuan berikut terpenuhi: * ketersediaan memiliki harga dan prepayment_type adalah REQUIRED * kolom no_show_fee ditetapkan * kolom deposit ditetapkan. |
REQUIRE_CREDIT_CARD_ALWAYS |
Kartu kredit selalu diwajibkan untuk memesan ketersediaan ini, terlepas dari nilai kolom lainnya. |
Resource
Resource (sumber daya) digunakan untuk membedakan slot ketersediaan dari satu sama lain jika anggota staf yang berbeda, atau ruangan merupakan bagian dari layanan. Beberapa slot untuk layanan dan interval waktu yang sama dapat muncul bersamaan meskipun memiliki sumber daya yang berbeda.
Kolom | |
---|---|
staff_id |
ID opsional untuk anggota staf yang menyediakan layanan. Kolom ini menunjukkan anggota staf di seluruh catatan penjual, layanan, dan ketersediaan. Kolom ini juga harus stabil dari waktu ke waktu untuk memungkinkan korelasi dengan pemesanan terdahulu. Kolom ini harus ada jika staff_name ada. |
staff_name |
Nama opsional anggota staf yang menyediakan layanan. Kolom ini akan ditampilkan kepada pengguna yang melakukan pemesanan, dan harus dapat dibaca oleh manusia, bukan ID buram. Kolom ini harus ada jika staff_id ada. |
room_id |
ID opsional untuk ruangan tempat layanan berada. Kolom ini menunjukkan ruangan di seluruh catatan penjual, layanan, dan ketersediaan. Kolom ini juga harus stabil dari waktu ke waktu untuk memungkinkan korelasi dengan pemesanan terdahulu. Kolom ini harus ada jika room_name ada. |
room_name |
Nama opsional untuk ruangan tempat layanan berada. Kolom ini akan ditampilkan kepada pengguna yang melakukan pemesanan, dan harus dapat dibaca oleh manusia, bukan ID buram. (opsional tetapi wajib jika room_id ada) Di ruang makan, nama kamar hanya boleh digunakan untuk area tempat duduk seperti bar atau teras dan tidak boleh digunakan untuk menu harga tetap, aktivitas khusus, atau nilai non-ruangan lainnya (seperti reservasi atau makan malam). Sangat disarankan agar area tempat duduk default tidak memiliki ruangan yang terkait dengannya. |
party_size |
Hanya berlaku untuk Tempat Makan: Jumlah tamu yang dapat diakomodasi selama slot waktu ini. Restoran dapat dikaitkan dengan beberapa Slot untuk waktu yang sama, yang masing-masing menentukan party_size yang berbeda, jika misalnya 2, 3, atau 4 orang dapat duduk dengan reservasi. |
SchedulingRules
Aturan penjadwalan untuk layanan.
Kolom | |
---|---|
min_advance_online_canceling |
Pemberitahuan awal minimum dalam hitungan detik diwajibkan untuk membatalkan janji temu yang telah dipesan secara online. (opsional) |
late_cancellation_fee |
Biaya pembatalan dalam periode pemberitahuan awal minimum. |
noshow_fee |
Denda ketidakhadiran tanpa pembatalan. |
admission_policy |
Kebijakan tiket masuk yang berlaku untuk layanan ini. Jika tidak ditetapkan, ditetapkan secara default ke TIME_STRICT. (opsional) |
cancellation_policy |
Kebijakan pembatalan aturan penjadwalan. (wajib untuk rekomendasi aktivitas) |
Kolom union Jika "min_advance_booking" ditetapkan, waktu yang dapat dipesan terakhir akan dihitung sebagai (<slot start time> - "min_advance_booking"). Jika "min_booking_buffer_before_end_time" ditetapkan, waktu yang dapat dipesan terakhir akan dihitung sebagai (<slot end time> - "min_booking_buffer_before_end_time"). Perhatikan bahwa nilai "min_booking_buffer_before_end_time" harus positif jika ditetapkan. Jika keduanya tidak ditetapkan, slot dapat dipesan hingga waktu mulai slot. Jika kedua kolom ditetapkan, hanya satu nilai yang akan diambil, sedangkan nilai lainnya diabaikan--kami tidak dapat memprediksi nilai mana yang dipilih secara akurat. Contoh:
|
|
min_advance_booking |
Durasi (dalam detik) dari saat pemesanan terakhir dapat dilakukan hingga saat slot ketersediaan dimulai. |
min_booking_buffer_before_end_time |
Durasi (dalam detik) dari saat pemesanan terakhir dapat dibuat hingga slot ketersediaan berakhir. Jika kolom ini ditetapkan, kolom "admission_policy" harus ditetapkan ke TIME_FLEXIBLE untuk menunjukkan bahwa pengguna dapat menggunakan tiket yang dibeli setelah slot dimulai. |
AdmissionPolicy
Kebijakan tiket masuk layanan ini.
Enum | |
---|---|
ADMISSION_POLICY_UNSPECIFIED |
Tidak digunakan. |
TIME_STRICT |
Pelanggan harus hadir pada waktu mulai slot ketersediaan, dan layanan diharapkan selesai pada waktu berakhir slot. Contoh kasus penggunaan TIME_STRICT: * Tur yang dimulai pada pukul 09.00 yang mewajibkan semua tamu datang pada waktu mulai, dan kembali sekitar pukul 12.00. * Reservasi potong rambut rambut pukul 15.00 pada hari Sabtu yang membutuhkan waktu sekitar 30 menit. * Kelas kebugaran dari pukul 18.00 hingga 20.00. |
TIME_FLEXIBLE |
Pelanggan dapat tiba kapan saja antara waktu mulai dan berakhir dari suatu slot ketersediaan untuk menggunakan pemesanan ini. Contoh kasus penggunaan TIME_FLEXIBLE: * Tiket museum yang dapat digunakan selama waktu kapan pun pada tanggal pembelian. * Tiket masuk sore ke taman hiburan yang dapat digunakan dari pukul 12.00 sampai 21.00. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
Pelanggan harus tiba di tempat penjual pada waktu mulai slot ketersediaan, tetapi dapat keluar kapan saja. Misalnya, dalam skenario tiket masuk museum, biaya masuk terjadwal untuk pukul 10.00 mewajibkan pengguna berada di museum pukul 10.00. Waktu mulai slot ketersediaan untuk layanan ini mewakili waktu masuk yang ditetapkan. Namun, waktu berakhir hanya digunakan sebagai kunci untuk mengidentifikasi slot ketersediaan untuk pemesanan. |
Service
Info tentang layanan yang disediakan penjual, misalnya potong rambut.
Kolom | |
---|---|
name |
Nama resource layanan, yang memiliki format |
service_name |
Nama layanan, misalnya "potong rambut pria". Tidak digunakan lagi, sebagai gantinya gunakan localized_service_name. |
localized_service_name |
Nama layanan, misalnya "potong rambut pria". Mungkin di beberapa lokal. |
description |
Deskripsi layanan yang dilihat pengguna. Tidak digunakan lagi, sebagai gantinya gunakan localized_description. |
localized_description |
Deskripsi layanan yang dilihat pengguna. Kolom ini mendukung pemformatan teks biasa dan HTML. Tidak seperti bagian teks biasa, tata letak yang disesuaikan dapat dibuat di sini menggunakan heading, paragraf, daftar, dan beberapa tag frasa. Baca petunjuk dan catatan berikut dengan cermat untuk memastikan Anda menghadirkan pengalaman pengguna terbaik. Tag pemformatan seperti HTML yang didukung: Tag heading: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Tag paragraf: <p> Tag daftar: <ul>, <ol>, <li> Tag divisi: <div> Tag frasa: <br>, <strong>, <em>: Tag tidak didukung:
Catatan penting:
|
price |
Harga layanan. |
price_interpretation |
Menjelaskan bagaimana harga ditafsirkan dan ditampilkan kepada pengguna. Dapat digunakan oleh vertical apa pun kecuali Tempat Makan dan Rekomendasi Aktivitas untuk mengonfigurasi tampilan harga layanan. |
rules |
Aturan untuk membuat/membatalkan janji temu. |
prepayment_type |
Apakah prabayar diperlukan, opsional, atau tidak didukung. |
prepayment_terms |
Persyaratan terkait kapan pembayaran di muka selesai. |
form[] |
Tidak digunakan lagi. Gunakan intake_form dan per_ticket_intake_form. |
intake_form |
Formulir yang meminta informasi tambahan dari pengguna saat mereka memesan layanan ini. (opsional) |
per_ticket_intake_form |
Formulir yang meminta informasi tambahan dari pengguna saat mereka memesan layanan ini. Formulir ini harus diisi sekali untuk setiap tiket yang dipesan pengguna. (opsional) |
tax_rate |
Tarif pajak layanan. Jika ada, kolom ini akan mengganti tax_rate yang ditetapkan di tingkat penjual. Pesan kosong (yaitu tax_rate { }) akan mereset tarif pajak yang berlaku ke nol. |
payment_option_id[] |
Daftar id yang mereferensikan opsi pembayaran yang dapat digunakan untuk membayar layanan ini. Opsi pembayaran yang sebenarnya ditentukan di tingkat Penjual, dan juga dapat digunakan bersama oleh beberapa penjual. |
deposit |
Menentukan bagaimana deposit dapat ditagih kepada pengguna. Mengganti deposit layanan jika ditentukan. Menyetelnya ke pesan Deposit kosong akan menghapus deposit tingkat layanan apa pun. (opsional) |
no_show_fee |
Menentukan denda ketidakhadiran yang ditagih kepada pengguna. Mengganti denda ketidakhadiran layanan jika ditentukan. Menetapkannya ke pesan NoShowFee kosong akan menghapus semua denda ketidakhadiran tingkat layanan apa pun. (opsional) |
require_credit_card |
Menunjukkan apakah pengguna harus menyediakan kartu kredit untuk memesan layanan ini. Kolom ini dapat diganti pada tingkat ketersediaan. (opsional) |
action_link[] |
Link tindakan terkait layanan ini. Jika link tindakan sudah ada, jenis (lihat di bawah) harus ditetapkan dalam Layanan. |
type |
Jenis layanan ini yang telah ditetapkan sebelumnya. (opsional) |
ticket_type[] |
Jenis tiket yang dapat dipesan/dibeli untuk layanan ini, jika tiket didukung. (opsional) |
related_media[] |
Foto terkait layanan ini. Google akan meng-crawl dan menyimpan media untuk memastikan media ditampilkan kepada pengguna akhir dengan cara yang paling efisien. (opsional) |
service_attribute_value_id[] |
Nilai atribut Layanan yang berlaku untuk layanan ini (opsional). Setiap Layanan dapat memiliki nilai nol atau lebih untuk setiap atribut layanan yang ditentukan di Penjual yang sesuai. (opsional) |
waitlist_rules |
Aturan untuk bergabung ke daftar tunggu. |
ticketing_vertical_specific_data |
Informasi tambahan yang unik untuk vertical penjualan tiket acara. (opsional) |
integration_type |
Kedalaman integrasi yang kami dukung untuk layanan ini. (opsional) Tidak relevan untuk partner dengan integrasi starter. Secara menyeluruh akan selalu dinonaktifkan untuk partner tersebut. |
per_order_fee |
Biaya tingkat pesanan untuk membeli layanan ini. (opsional) |
tours_and_activities_content |
Kolom konten khusus untuk Tur dan Aktivitas. |
location[] |
Lokasi terkait layanan ini. CATATAN PENTING: Jika ada beberapa lokasi yang dikunjungi terkait layanan ini, atau START_LOCATION berbeda dari VISITED_LOCATION, START_LOCATION tersebut harus ditentukan. Contoh: - Tur sepeda bersama pemandu yang mengunjungi tiga tempat, tempat awal harus ditentukan. - Rapat tur bus di lobi hotel, lalu menuju tempat yang dikunjungi. Lokasi rapat harus ditentukan. |
rating |
Rating pengguna untuk layanan ini sebagai metrik gabungan atas semua ulasan. |
home_service_data |
Informasi tambahan khusus untuk vertical layanan rumah tangga. (opsional) |
virtual_session |
Opsional. Informasi tentang sesi virtual. Langkah ini diperlukan untuk mengaktifkan layanan virtual. |
direct_merchant_payment |
Opsional. Informasi tambahan yang perlu ditambahkan jika layanan mengharuskan pengguna membayar langsung kepada penjual. CATATAN PENTING: RwG tidak akan terlibat dalam transaksi ini. Hal ini diperlukan jika virtual_session ditentukan dan layanan tidak gratis atau prepayment_type TIDAK ditetapkan ke REQUIRED. |
PrepaymentTerms
Informasi khusus terkait kapan pembayaran di muka selesai.
Kolom | |
---|---|
charge_timing |
Kapan tagihan akan muncul relatif terhadap waktu pembelian. |
charge_time_before_start_time_sec |
Waktu dalam detik sebelum waktu mulai layanan saat pengguna ditagih untuk pembayaran. Bidang ini hanya boleh disetel jika ChargeTiming adalah CHARGE_LATER. |
ChargeTiming
Enum untuk menentukan kapan tagihan akan terjadi, relatif terhadap waktu pembelian.
Enum | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
Tidak digunakan. |
CHARGE_NOW |
Pelanggan akan langsung ditagih. |
CHARGE_LATER |
Pelanggan akan ditagih nanti. |
PrepaymentType
Enum untuk menunjukkan jenis prabayar.
Enum | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Secara default, kami akan mengasumsikan bahwa prabayar bersifat NOT_SUPPORTED. |
REQUIRED |
Pengguna harus membayar layanan ini pada saat pemesanan. |
OPTIONAL |
Pengguna dapat memilih untuk melakukan prabayar atas layanan ini pada waktu pemesanan atau setelahnya, tetapi tidak diwajibkan untuk membuat pemesanan. |
NOT_SUPPORTED |
Prabayar tidak didukung untuk layanan ini. |
ServiceType
Jenis layanan yang telah ditetapkan sebelumnya.
Enum | |
---|---|
SERVICE_TYPE_UNSPECIFIED |
Tidak digunakan. |
SERVICE_TYPE_DINING_RESERVATION |
Reservasi tempat makan. |
SERVICE_TYPE_FOOD_ORDERING |
Pemesanan makanan, bisa berupa layanan pesan-antar makanan atau bawa pulang atau keduanya. |
SERVICE_TYPE_FOOD_DELIVERY |
Layanan pesan-antar makanan. |
SERVICE_TYPE_FOOD_TAKEOUT |
Makanan bawa pulang. |
SERVICE_TYPE_EVENT_TICKET |
Tiket acara. |
SERVICE_TYPE_TRIP_TOUR |
Tur perjalanan. |
SERVICE_TYPE_APPOINTMENT |
Layanan yang menyediakan janji temu atau kelas. Direkomendasikan untuk (1) kesehatan dan kebugaran, (2) spa dan kecantikan, serta (3) layanan konsultasi dan evaluasi keuangan. Lihat jenis layanan yang didukung: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Layanan yang menyediakan janji temu online untuk kelas atau sesi yang sepenuhnya dilakukan secara virtual. Harus ditetapkan jika mengaktifkan pemesanan layanan virtual. |
SERVICE_TYPE_SHOPPING |
Layanan yang memungkinkan pengguna berbelanja dari penjual tertentu. Bisa pesan antar atau ambil. |
ServiceAttribute
Atribut layanan adalah kategori yang ditentukan partner yang mendeskripsikan Layanan untuk Penjual. Misalnya, bank dapat menentukan atribut layanan "Jenis Rekening" dengan kemungkinan nilai "Pribadi" dan "Bisnis", sementara salon rambut dapat menentukan atribut layanan "Jenis Layanan" dengan kemungkinan nilai "Potong Rambut", "Warna", dan "Gaya".
Kolom | |
---|---|
attribute_id |
ID yang mengidentifikasi atribut layanan ini secara unik di antara atribut lainnya untuk penjual yang sama, misalnya, "jenis akun". |
attribute_name |
Nama yang terlihat oleh pengguna untuk atribut ini, mis. "Jenis Akun". |
value[] |
Semua nilai yang mungkin untuk atribut layanan ini. |
Value
Merepresentasikan kemungkinan nilai untuk atribut layanan tertentu.
Kolom | |
---|---|
value_id |
ID yang mengidentifikasi nilai ini secara unik di antara nilai lainnya untuk atribut layanan ini, misalnya, "pribadi". |
value_name |
Nama yang terlihat oleh pengguna untuk nilai, mis. "Pribadi". |
ServiceAttributeValueId
Mengidentifikasi nilai atribut layanan tertentu yang akan diterapkan ke Layanan.
Kolom | |
---|---|
attribute_id |
ID atribut seperti yang ditentukan dalam Merchant.service_attribute, mis. "service-type". |
value_id |
ID nilai untuk atribut ini, misalnya "potong rambut rambut". Harus cocok dengan value_id dalam definisi atribut layanan. |
ServiceAvailability
Daftar ketersediaan dan siapa/kapan harus menerapkannya.
Kolom | |
---|---|
name |
Nama resource layanan yang akan menerapkannya. Dalam format |
start_time_restrict |
Jika disediakan, kami akan menganggap entity Availability yang disediakan sebagai snapshot lengkap dari [start_time_restrict, end_time_restrict). Artinya, semua ketersediaan yang ada akan dihapus jika ketentuan berikut berlaku:
Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:
Jika pesan resources_restrict ditetapkan, ketentuan akan dibatasi lebih lanjut:
Kolom ini biasanya digunakan untuk memberikan pembaruan lengkap tentang ketersediaan dalam rentang waktu tertentu. Menetapkan start_time_restrict dan membiarkan end_time_restrict tidak ditetapkan akan berarti setiap waktu dimulai pada start_time_restrict. |
end_time_restrict |
Menetapkan end_time_restrict dan membiarkan start_time_restrict tidak ditetapkan akan berarti semua waktu berakhir pada end_time_restrict. |
duration_restrict |
Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok. |
resources_restrict |
Menetapkan resources_restrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk set resource ini. Semua kolom id resource harus sama persis. |
availability[] |
Daftar ketersediaan baru. |
ServiceIntakeForm
Menentukan formulir informasi awal yang menyesuaikan layanan yang disediakan penjual.
Kolom | |
---|---|
field[] |
Kolom yang akan ditampilkan kepada pengguna. |
first_time_customers |
Jika bernilai benar, formulir ini akan ditampilkan kepada pelanggan baru. Tidak digunakan lagi. Fungsi ini tidak didukung untuk formulir informasi awal. |
returning_customers |
Jika bernilai benar, formulir ini akan ditampilkan kepada pelanggan berulang. Tidak digunakan lagi. Fungsi ini tidak didukung untuk formulir informasi awal. |
ServiceIntakeFormField
Menentukan kolom yang disertakan dalam ServiceIntakeForm.
Kolom | |
---|---|
id |
String dari partner agregator yang mengidentifikasi kolom formulir secara unik. ID ini harus sama dengan ID dalam jawaban kolom formulir yang sesuai dan harus unik di kedua tingkat layanan dan per formulir informasi awal tiket. (wajib) |
type |
Jenis kolom ini. |
label |
Teks yang ditampilkan kepada pengguna untuk kolom ini. Tidak digunakan lagi, sebagai gantinya gunakan |
localized_label |
Teks yang ditampilkan kepada pengguna untuk kolom ini. Kolom ini dapat diberikan di beberapa lokal. (wajib) |
value[] |
Setel jika dan hanya jika jenis kolom adalah LOCATION_SEARCH. Gunakan "location_id" di kolom "location" untuk menentukan nilai lokasi. |
choice_text[] |
Tetapkan jika dan hanya jika jenis kolom adalah MULTIPLE_CHOICE, CHECKBOXES, atau DROPDOWN. Digunakan untuk menghitung kemungkinan pilihan. |
is_required |
Menunjukkan apakah jawaban untuk kolom ini diperlukan oleh pengguna. |
allow_custom_answer |
Menunjukkan apakah nilai kustom diizinkan sebagai tambahan atas jawaban yang telah ditentukan. Ini hanya berlaku bila jenis kolom adalah LOCATION_SEARCH. (opsional) |
additional_option[] |
Opsi tambahan yang diberikan selain nilai yang diberikan. Hanya berlaku bila jenis kolom adalah LOCATION_SEARCH. Mis. selain daftar lokasi yang disediakan, opsi lain yang tersedia dapat berupa "Saya akan menghubungi pemasok nanti". (opsional) |
ticket_type_restrict[] |
Jika pertanyaan ini hanya ditampilkan saat pengguna memesan jenis tiket tertentu, kolom ini harus ditetapkan sebagai kumpulan ID jenis tiket yang berlaku. Biarkan kolom tetap kosong jika pertanyaan selalu berlaku. |
hint |
Teks petunjuk untuk input, yang muncul sebagai placeholder teks. Ini hanya berlaku bila jenis kolom adalah SHORT_ANSWER atau PARAGRAPH. (opsional) |
FieldType
Enum untuk menunjukkan jenis kolom.
Enum | |
---|---|
FIELD_TYPE_UNSPECIFIED |
Kolom jenis yang tidak ditentukan atau tidak dikenal akan diabaikan. |
SHORT_ANSWER |
Kolom masukan satu baris untuk teks. |
PARAGRAPH |
Kolom masukan multi-baris untuk teks. |
MULTIPLE_CHOICE |
Kumpulan tombol pilihan yang mewajibkan satu pilihan dari banyak opsi. |
CHECKBOXES |
Satu atau beberapa item terenumerasi dengan kotak centang. |
DROPDOWN |
Pilihan dari drop-down. |
BOOLEAN |
Tombol ya/tidak. |
LOCATION_SEARCH |
Kotak penelusuran yang mendukung pencarian lokasi yang cocok berdasarkan masukan pengguna dari daftar lokasi yang disediakan. |
TaxRate
Tarif pajak yang diterapkan saat menagih pengguna untuk layanan, dan yang dapat ditetapkan per penjual atau per layanan.
Kolom | |
---|---|
micro_percent |
Tarif pajak dalam sepersejuta persen, yang pada dasarnya memberikan 6 desimal presisi. Misalnya, jika tarif pajak adalah 7,253%, kolom ini harus ditetapkan ke 7253000. Jika kolom ini tidak ditetapkan atau ditetapkan ke 0, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini adalah harga persis yang ditentukan oleh Service.price. Harga layanan diasumsikan bebas dari atau sudah termasuk pajak yang berlaku. Pajak tidak akan ditampilkan kepada pengguna sebagai item baris terpisah. Jika kolom ini ditetapkan ke nilai selain nol, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini akan mencakup harga layanan ditambah pajak yang dihitung menggunakan tarif pajak yang diberikan di sini. Pecahan dari satuan mata uang terkecil (misalnya, pecahan dari satu sen) akan dibulatkan menggunakan pembulatan genap terdekat. Pajak akan ditampilkan kepada pengguna sebagai item baris terpisah. |
Terms
Kumpulan aturan dan pedoman yang ditampilkan kepada pengguna untuk membuat pemesanan melalui Pesan dengan Google.
Kolom | |
---|---|
url |
(Opsional) URL ke Persyaratan dan Ketentuan. |
text |
Teks yang akan ditampilkan kepada pengguna. Gunakan localized_text di bawah untuk integrasi baru. |
localized_text |
Teks yang dilokalkan yang akan ditampilkan kepada pengguna. |
Text
Payload teks yang dapat dilokalkan. Beberapa kolom Teks mungkin berisi konten yang di-markup.
Kolom | |
---|---|
value |
Nilai teks dalam lokal yang tidak diketahui. Wajib jika dan hanya jika |
localized_value[] |
Nilai teks per lokal. Opsional. |
TicketType
TicketType digunakan untuk membedakan antara tiket dengan harga dan/atau ketersediaan yang berbeda karena berbagai jenis pengguna, atribut layanan yang berbeda, atau opsi/add-on yang berbeda.
Tiket adalah unit minimum yang dapat dipesan ke layanan, misalnya tempat di perjalanan rafting, biaya masuk ke museum, rental kayak dua hari penuh.
Kolom | |
---|---|
ticket_type_id |
ID tiket digunakan untuk membedakan berbagai jenis tiket dari layanan yang sama, dan hanya diharapkan unik dalam suatu layanan. |
short_description |
Deskripsi singkat untuk TicketType ini. Ini dapat dilihat pengguna, misalnya, “dewasa”, "anak-anak", “veteran”, “Baris J”, dll. Wajib, setiap jenis tiket harus memiliki deskripsi agar dapat dilihat pengguna. Tidak digunakan lagi, sebagai gantinya gunakan localized_short_description. |
localized_short_description |
Deskripsi singkat untuk TicketType ini dengan dukungan i18n. Ini dapat dilihat pengguna, misalnya, “dewasa”, "anak-anak", “veteran”, “Baris J”, dll. Wajib, setiap jenis tiket harus memiliki deskripsi agar dapat dilihat pengguna. Nilai terpisah dapat diberikan untuk setiap lokal. |
price |
Harga tiket tunggal jenis ini, tidak termasuk pajak apa pun. Tarif pajak Layanan berlaku untuk tiketnya. |
per_ticket_fee |
Biaya tambahan untuk membeli tiket ini. (opsional) |
option_description |
Deskripsi tambahan mengenai opsi tambahan yang ditunjukkan jenis tiket ini, jika ada. Tidak digunakan lagi, sebagai gantinya gunakan localized_option_description. |
localized_option_description |
Deskripsi tambahan mengenai opsi tambahan yang ditunjukkan jenis tiket ini, jika ada. Nilai terpisah dapat diberikan untuk setiap lokal. Opsi tambahan berguna jika jenis tiket merepresentasikan beberapa dimensi. Contoh 1: tiket masuk dengan berbagai jenis 'dewasa', 'anak-anak' dan bahasa sebagai opsi tambahan, daftar TicketType yang diharapkan akan menjadi: - { 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" } } Contoh 2: rental kayak beberapa jam dengan add-on tas kering opsional, short_description bisa jadi "3 jam" dan option_description bisa jadi "dengan tas kering" atau "tanpa tas kering": - { 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" } } Opsional, tetapi jika jenis tiket apa pun dalam layanan memiliki kumpulan kolom ini, kami mengharapkan semua jenis tiket lainnya menetapkan kolom ini juga (option_description default dapat digunakan). Mis. [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] bukan daftar yang valid. Hanya dua tag pemformatan HTML yang didukung: dan |
TicketingVerticalSpecificData
Informasi tambahan yang unik untuk vertical penjualan tiket acara.
Kolom | |
---|---|
event_category |
Kategori acara. Ditetapkan hanya bila acara termasuk dalam salah satu kategori yang sudah ditetapkan. (opsional) |
event_url |
URL acara di situs partner. (opsional) |
entity[] |
Daftar entitas terkait acara. (opsional) |
event_attendance_mode |
Wajib diisi. Jenis kehadiran acara. |
event_virtual_location_url[] |
Opsional. URL tempat acara dapat ditonton. |
event_organizer |
Opsional. Penyelenggara yang menyelenggarakan acara. |
event_organizer_url |
Opsional. URL penyelenggara yang menyelenggarakan acara. |
event_organizer_type |
Opsional. Jenis penyelenggara. |
event_source_url[] |
Wajib diisi. URL halaman tempat informasi atau deskripsi acara dapat ditemukan. |
event_state |
Opsional. Status peristiwa. |
AttendanceMode
Jenis kehadiran acara.
Enum | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
Tidak ditentukan. |
ONLINE |
Untuk acara virtual. |
PHYSICAL |
Untuk acara fisik. |
PHYSICAL_ONLINE_MIXED |
Untuk acara yang bersifat fisik dan virtual. |
Entitas
Mewakili entitas terkait acara.
Kolom | |
---|---|
id |
ID unik entitas dalam database partner. (opsional) |
name |
Nama entitas. (wajib) |
url |
Url halaman web yang menjelaskan entitas tidak secara ambigu. Ini adalah halaman web di situs partner untuk entitas jika ada; untuk URL publik lainnya dari entitas tersebut, gunakan relevan_url dalam public_identification_data. (opsional) |
entity_type |
Jenis entitas. (opsional) |
entity_role |
Peran entitas dalam acara. (opsional) |
public_identification_data |
Referensi publik tentang entitas. (opsional) |
EntityRole
Peran entitas dalam acara.
Enum | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
Tidak dicantumkan. |
ENTITY_ROLE_HEADLINER |
Entitas ini mewakili artis utama atau artis yang paling ditunggu di acara tersebut. |
ENTITY_ROLE_SUPPORTER |
Entitas ini mewakili artis pendukung pada acara tersebut. |
ENTITY_ROLE_HOME_TEAM |
Entitas mewakili tim kandang di suatu acara (olahraga). |
ENTITY_ROLE_AWAY_TEAM |
Entitas mewakili tim tandang di suatu acara (olahraga). |
EntityType
Jenis entitas. Catatan: tidak ditujukan untuk menjadi ontologi universal.
Enum | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
Tidak dicantumkan. Jangan gunakan. |
ENTITY_TYPE_PERFORMER |
Entitas mewakili artis atau grup yang tampil di konser atau pertunjukan. Hanya berlaku jika kategori acara adalah CONCERT atau THEATRE. |
ENTITY_TYPE_PLAYER |
Entitas mewakili tim olahraga atau pemain pada acara tersebut. Hanya berlaku jika kategori acara adalah SPORTS. |
ENTITY_TYPE_CONCERT_TOUR |
Entitas ini mewakili tur tempat acara ini berada. Hanya berlaku jika kategori acara adalah CONCERT. |
ENTITY_TYPE_SPORTS_SERIES |
Entitas ini mewakili turnamen olahraga yang diselenggarakan acara ini. Hanya berlaku jika kategori acara adalah SPORTS. |
ENTITY_TYPE_PLAY |
Entitas mewakili jenis drama (misalnya, musik, komedi, balet, dll.) yang ditampilkan pada acara tersebut. Hanya berlaku jika kategori acara adalah THEATRE. |
EventCategory
Subkumpulan kategori acara yang kami sesuaikan pengalaman produknya. Catatan: tidak ditujukan untuk menjadi ontologi universal suatu acara.
Enum | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
Tidak dicantumkan. Jangan gunakan. |
EVENT_CATEGORY_CONCERT |
Konser. |
EVENT_CATEGORY_SPORTS |
Acara olahraga. |
EVENT_CATEGORY_THEATRE |
Acara teater. |
EVENT_CATEGORY_EXHIBITS |
Pameran. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Lokakarya dan Kelas. |
EventState
Status peristiwa.
Enum | |
---|---|
EVENT_STATE_UNSPECIFIED |
Tidak ditentukan. |
SCHEDULED |
Acara ini dijadwalkan. |
RESCHEDULED |
Acara dijadwalkan ulang. |
CANCELLED |
Acara dibatalkan. |
POSTPONED |
Acara ditunda. |
OrganizerType
Jenis penyelenggara.
Enum | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Tidak ditentukan. |
PERSON |
Untuk penyelenggara yang merupakan pribadi. |
ORGANIZATION |
Untuk penyelenggara yang merupakan organisasi. |
PublicIdentificationData
ID, halaman web, atau sumber publik lainnya yang mereferensikan entitas.
Kolom | |
---|---|
relevant_url[] |
URL Publik setiap halaman web yang didedikasikan hanya untuk topik tersebut. Halaman ini mencakup halaman situs resmi, discogs, platform media sosial, wikipedia, atau imdb, mis. https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (opsional) |
musicbrainz_id |
ID musicbrainz 35 karakter untuk artis atau entitas musik lainnya, jika berlaku. Lihat https://musicbrainz.org/doc/MusicBrainz_Identifier. (opsional) |
TimeRange
Rentang waktu tertutup-terbuka, yaitu [start_time, end_time).
Kolom | |
---|---|
start_time |
Batas bawah rentang waktu. |
end_time |
Batas atas rentang waktu. |
TokenizationConfig
Konfigurasi untuk tokenisasi pemroses pembayaran, yang disiapkan per Penjual.
Kolom | |
---|---|
tokenization_parameter |
Konfigurasi tokenisasi biasanya akan memiliki satu tokenization_parameter yang kuncinya adalah "gateway" dan yang nilainya adalah nama pemroses. Sisa parameter bergantung pada pemroses. Lihat dokumentasi Google Pay untuk mengetahui informasi lebih lanjut. Contoh 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" } Contoh Stripe: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" } Contoh Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" } |
billing_information_format |
Sertakan dalam token pembayaran, informasi penagihan pengguna seperti yang dimasukkan ke Google Pay dengan FOP (lihat di atas). Mengosongkan kolom sama dengan menentukan MIN. |
BillingInformationFormat
Seberapa lengkap Alamat Penagihan yang diperlukan dari pengguna dan disertakan dalam token. Nilai enum sesuai dengan parameter di Google Pay API (lihat https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Tidak dicantumkan. Default-nya adalah MIN. |
MIN |
nama, kode negara, dan kode pos (setelan default Google Pay). |
FULL |
nama, alamat jalan, lokalitas, wilayah, kode negara, dan kode pos. |
ToursAndActivitiesContent
Kolom konten khusus untuk Tur dan Aktivitas. Setiap elemen di kolom berulang harus bersifat independen untuk memungkinkan rendering terpisah (misalnya, poin bertanda).
Mengisi ToursAndActivitiesContent sangat disarankan untuk tur dan aktivitas, tetapi tidak diwajibkan. Semua kolom mendukung teks biasa dan teks seperti HTML untuk pemformatan dasar. Tag pemformatan seperti HTML yang didukung:
Tag frasa:
, , , : Hanya tiga tag yang disebutkan di atas yang didukung.
dapat digunakan untuk memisahkan baris dalam paragraf, dan // dapat digunakan untuk menandai teks penting. Setiap tag frasa lainnya akan diabaikan.
Semua tag dan gaya khusus lainnya tidak diizinkan dan akan dihapus. Semua URL, anchor, dan link akan dihapus, dan tidak akan pernah ditampilkan kepada pengguna akhir.
Catatan penting: * Jangan menduplikasi data yang sudah disediakan di highlights
, exclusion
, dan kolom lainnya yang lebih spesifik dalam deskripsi layanan. * Hindari penggunaan tag lain kecuali tag yang didukung di atas, karena konten dalam tag yang tidak didukung akan dihapus, dan dapat menyebabkan pengalaman pengguna yang tidak diinginkan.
Kolom | |
---|---|
highlights[] |
Daftar sorotan yang terlihat oleh pengguna. |
inclusions[] |
Daftar penyertaan yang terlihat oleh pengguna. |
exclusions[] |
Daftar pengecualian yang terlihat oleh pengguna. |
must_know[] |
Daftar catatan penting yang dapat dilihat pengguna, digunakan untuk detail seperti pembatasan usia atau ketentuan lain yang membuat layanan ini tidak sesuai. |
UnsupportedPartySizeOption
Opsi untuk pesta yang berada di luar jangkauan.
Kolom | |
---|---|
call_merchant |
Jumlah tamu yang berada di luar rentang dapat menelepon bisnis. Pesan standar akan ditampilkan kepada pengguna. Contoh teks yang akan ditampilkan: "Untuk pesta yang lebih besar dari {waitlist_rules.max_party_size}, harap hubungi restorannya di {phone}." CallMerchant harus ditetapkan, tetapi akan kosong. |
UpdateBookingRequest
Permintaan untuk memperbarui google.maps.booking.v1alpha.Booking
Kolom | |
---|---|
update_mask |
Mask kolom untuk semua kolom pemesanan yang akan diperbarui |
booking |
Pemesanan yang akan diperbarui |
booking_failure |
Jika pemrosesan permintaan pemesanan yang dikonfirmasi secara asinkron gagal dan status pemesanan sedang diperbarui ke FAILED, kolom ini harus mencerminkan error logika bisnis (mis., pengguna memiliki reservasi yang terlalu dekat dengan waktu saat ini). Kolom ini hanya boleh ditetapkan saat memperbarui status pemesanan ke FAILED dan akan diabaikan jika tidak. |
UpdateMerchantRequest
Permintaan untuk memperbarui Merchant
.
Kolom | |
---|---|
merchant |
Data penjual baru. |
update_mask |
Kolom spesifik yang akan diperbarui untuk penjual. |
UpdateOrderRequest
Permintaan untuk memperbarui google.maps.booking.v1alpha.Order
Kolom | |
---|---|
update_mask |
Mask kolom untuk semua kolom pesanan yang akan diperbarui |
order |
Pesanan yang akan diperbarui |
UpdateServiceRequest
Permintaan untuk memperbarui Service
.
Kolom | |
---|---|
service |
Data layanan baru. |
update_mask |
Kolom spesifik yang akan diperbarui untuk layanan. |
UserPurchaseRestriction
Membatasi pengguna yang memenuhi syarat untuk membeli opsi pembayaran.
Kolom | |
---|---|
new_to_merchant |
Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli dari penjual yang sama sebelumnya. |
new_to_payment_option |
Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli opsi pembayaran yang sama sebelumnya. |
VirtualSession
Informasi tentang sesi virtual/online. Mis. Kelas yoga online, kelas memasak virtual, dll.
Kolom | |
---|---|
session_instructions |
Petunjuk tentang cara menyiapkan kelas virtual ini. Jika partner tidak menyertakan URL video pada pemesanan, teks ini harus disertakan saat URL video akan dibagikan kepada pengguna. Misalnya, “URL Zoom akan dikirim 30 menit sebelum kelas dimulai”. (Direkomendasikan) |
session_requirements |
Persyaratan untuk sesi virtual yang ditentukan. Misalnya, matras yoga, peralatan memasak, dll. (Direkomendasikan) |
virtual_platform_info |
Informasi tentang platform virtual yang digunakan dalam sesi ini. (Diperlukan untuk mengaktifkan layanan virtual) |
is_session_prerecorded |
Wajib diisi. Tetapkan nilainya sebagai benar (true) jika sesi virtual tidak live dan direkam sebelumnya. |
VirtualPlatformInfo
Informasi tentang platform yang akan digunakan untuk sesi virtual ini.
Kolom | |
---|---|
platform |
Platform yang digunakan untuk sesi virtual. |
other_platform_name |
Nama platform jika platform disetel ke OTHER. (Wajib jika platform ditetapkan ke LAINNYA) |
Platform
Enum untuk menunjukkan platform virtual mana yang akan digunakan oleh penjual.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Tidak digunakan. |
FLEXIBLE |
Penjual fleksibel saat menggunakan platform video tertentu. |
GOOGLE_HANGOUTS |
Produk Google Hangouts. |
GOOGLE_MEET |
Produk Google Meet. |
ZOOM |
Komunikasi Video Zoom. |
SKYPE |
Skype. |
YOUTUBE |
Live streaming di YouTube. |
OTHER |
Harus disetel jika platform video yang digunakan berbeda dengan yang disebutkan di sini. |
WaitlistRules
Aturan terkait bergabung ke daftar tunggu.
Kolom | |
---|---|
min_party_size |
Wajib. Harus berupa bilangan bulat positif untuk layanan yang menyediakan fungsi daftar tunggu. Jika layanan atau penjual tidak menyediakan fungsi daftar tunggu, kolom ini tidak boleh diisi. |
max_party_size |
Wajib. Harus berupa bilangan bulat positif untuk layanan yang menyediakan fungsi daftar tunggu. Jika layanan atau penjual tidak menyediakan fungsi daftar tunggu, kolom ini tidak boleh diisi. |
supports_additional_request |
Jika benar, pengguna akan dapat mengirim permintaan teks tambahan bentuk bebas saat bergabung ke daftar tunggu untuk layanan ini. |
above_max_party_size_options[] |
Tetapkan opsi untuk pihak yang lebih besar dari jumlah maksimum yang ditetapkan. Biarkan kosong jika pihak yang lebih besar tidak boleh diberi opsi alternatif untuk bergabung ke daftar tunggu. |