Package google.maps.booking.v1alpha

Indeks

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

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

Memperbarui Booking yang ada.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

Memperbarui Order yang ada.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking

Feed

Mengambil status pemrosesan untuk feed yang diupload oleh partner agregator eksternal.

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Mengambil Status dari feed yang diupload sebelumnya oleh agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
ListStatus

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

Mengambil Status dari beberapa feed penjual, layanan, atau ketersediaan yang diupload sebelumnya oleh agregator yang ditetapkan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/mapsbooking

InvalidationService

Menerima permintaan pembatalan validasi resource dari partner eksternal.

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

Membatalkan validasi resource yang ada.

Permintaan akan diabaikan jika sumber daya yang diminta tidak berlangganan layanan Google.

Jenis resource yang didukung: - Pengambilan

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/mapsbooking

InventoryStatus

Mengambil inventaris dan status pencocokan dari penjual yang diupload.

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Dapatkan MerchantStatus dari Merchant.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/mapsbooking
ListMerchantStatuses

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

Cantumkan semua MerchantStatus partner yang memenuhi kondisi filter.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking

InventoryUpdate

Menerima pembaruan inventaris dari agregator eksternal.

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

Menghapus data jenis feed yang ditentukan. Hanya melakukan validasi dasar (seperti permintaan yang salah format) setelah itu, respons yang sesuai akan segera dikirimkan kepada partner. Google melakukan validasi logika bisnis pada permintaan secara asinkron. Panggilan batch ini tidak menjamin atomicity.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/mapsbooking
BatchPushGenericRecord

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

Menyisipkan dan/atau memperbarui data jenis feed yang ditentukan. Hanya melakukan validasi dasar (seperti permintaan yang salah format) setelah itu, respons yang sesuai akan segera dikirimkan kepada partner. Google melakukan validasi logika bisnis pada permintaan secara asinkron. Panggilan batch ini tidak menjamin atomicity.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/mapsbooking
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

Mengganti Availability dari Services yang ada. Panggilan batch ini tidak menjamin atomicity. Hanya akan menampilkan slot ketersediaan yang berhasil diperbarui.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
CreateMerchant

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

Membuat Merchant baru yang dikelola agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
CreateService

rpc CreateService(CreateServiceRequest) returns (Service)

Membuat Service baru dari penjual yang dikelola oleh agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
DeleteMerchant

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

Menghapus Merchant yang ada yang dikelola agregator yang ditentukan. Semua layanan dan ketersediaan penjual juga akan dinonaktifkan. Jika Anda menambahkan kembali penjual di lain waktu, serangkaian slot layanan dan ketersediaan yang sama akan muncul.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Empty)

Menghapus Service yang ada dari penjual yang dikelola agregator yang ditentukan. Semua ketersediaan layanan juga akan dihapus.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
ReplaceServiceAvailability

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

Mengganti Availability dari Service yang ada pada penjual yang dikelola agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
UpdateMerchant

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

Memperbarui Merchant yang ada yang dikelola agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking
UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Service)

Memperbarui Service yang ada dari penjual yang dikelola agregator yang ditentukan, dan menampilkannya.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/mapsbooking

ActionLinkType

Jenis tindakan yang ditentukan sebelumnya yang terkait dengan link tindakan.

Enum

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

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

Timestamp

Waktu mulai slot janji temu.

duration

Duration

Durasi slot janji temu

spots_total

int64

Jumlah total tempat dan tempat terbuka dari ketersediaan ini. Contoh:

  • Kelas yoga yang menyediakan 10 tempat dengan 3 tempat yang sudah dipesan: availability {spots_total: 10, spots_open: 7 ...}
  • Sesi pijat kursi yang sudah habis dipesan: availability {spots_total: 1, spots_open: 0 ...}

Catatan: Jika mengirim permintaan menggunakan format kompresi ketersediaan yang ditentukan di bawah, kedua kolom ini akan diisi berdasarkan permintaan tersebut.

  • Sebuah Recurrence menyiratkan spots_total=1 dan spots_open=1.
  • Sebuah ScheduleException menyiratkan spots_total=1 dan spots_open=0.
spots_open

int64

Jumlah titik terbuka.

availability_tag

string

String buram opsional untuk mengidentifikasi slot ketersediaan ini. Jika ditetapkan, string ini akan disertakan dalam permintaan yang memesan/memperbarui/membatalkan janji temu.

resources

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:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }
payment_option_id[]

string

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

Recurrence

Informasi pengulangan untuk ketersediaan, yang merepresentasikan lebih dari satu waktu mulai. Pengulangan harus berisi janji temu untuk satu hari kerja.

schedule_exception[]

ScheduleException

Waktu saat layanan ini tidak dapat dijadwalkan. Untuk membatasi jumlah pesan schedule_exception, pertimbangkan untuk menggabungkan pengecualian yang berdekatan.

deposit

Deposit

Deposit opsional untuk ketersediaan ini. Mengganti deposit layanan jika ditentukan.

no_show_fee

NoShowFee

Denda ketidakhadiran opsional untuk ketersediaan ini. Mengganti denda ketidakhadiran layanan jika ditentukan.

require_credit_card

RequireCreditCard

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[]

string

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:

  • Layanan dengan empat jenis tiket: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

Untuk merepresentasikan inventaris selama hari kerja: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Untuk merepresentasikan inventaris selama hari libur: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

  • Layanan dengan tiga jenis tiket: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

Untuk menunjukkan bahwa ketiga jenis tiket tersebut tersedia untuk slot waktu ini, gunakan availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} or `availability {...}' (jangan tetapkan ticket_type_id di slot ini).

(opsional)

duration_requirement

DurationRequirement

Persyaratan untuk menampilkan durasi slot dan/atau waktu berakhir. Kolom ini akan diabaikan jika slot tidak tersedia. Tidak digunakan di vertical Rekomendasi Aktivitas. (opsional)

scheduling_rule_overrides

SchedulingRuleOverrides

Aturan penjadwalan ketersediaan. Jika diisi, kolom tersebut akan mengganti setiap aturan penjadwalan yang sesuai di SchedulingRules tingkat layanan.

confirmation_mode

ConfirmationMode

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:

  1. Perluasan slot ketersediaan atau pengulangan TIDAK boleh membuat slot yang identik. Jika id, start_time, duration, dan resources cocok, slot akan dianggap identik.
  2. 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.
  3. Pengulangan tidak boleh berdurasi lebih dari 24 jam.
Kolom
repeat_until

Timestamp

Stempel waktu UTC maksimum inklusif yang menunjukkan sampai kapan ketersediaan akan berulang.

repeat_every

Duration

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

TimeRange

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

int64

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

int64

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

int64

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 data jenis feed yang ditentukan.

Kolom
parent

string

Nama resource, yang memiliki format - partners/{partner_id}/feeds/{feed_name}.

records[]

GenericDeleteRecord

Data yang akan dihapus. Maksimum 1.000 record yang diizinkan dalam satu panggilan API.

BatchPushGenericRecordRequest

Permintaan batch untuk menyisipkan dan/atau memperbarui data jenis feed yang ditentukan dalam URL permintaan.

Kolom
parent

string

Nama resource, yang memiliki format - partners/{partner_id}/feeds/{feed_name}.

records[]

GenericRecord

Kumpulan data yang akan disisipkan dan/atau diperbarui. Maksimum 1.000 record yang diizinkan dalam satu panggilan API.

BatchReplaceServiceAvailabilityRequest

Permintaan batch untuk mengganti beberapa slot ketersediaan Service.

Kolom
parent

string

Format partners/{partner_id}.

extended_service_availability[]

ExtendedServiceAvailability

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[]

ExtendedServiceAvailability

Pesan ketersediaan layanan tambahan yang berhasil diperbarui yang digunakan untuk mengganti slot ketersediaan yang ada.

Booking

Pemesanan untuk slot inventaris

Kolom
name

string

Nama resource pemesanan: partners/{partner ID}/bookings/{booking ID}

merchant_id

string

ID penjual untuk slot

service_id

string

ID layanan penjual

start_time

Timestamp

Waktu mulai slot janji temu

duration

Duration

Durasi slot janji temu

client_information

ClientInformation

Informasi pribadi klien yang membuat janji temu

status

BookingStatus

Status pemesanan

payment_information

PaymentInformation

Informasi tentang transaksi pembayaran yang terkait dengan pemesanan.

party_size

int64

Jumlah tamu pemesanan

BookingFailure

Data status yang menunjukkan alasan pemrosesan pemesanan gagal secara asinkron. BookingFailure ditujukan terutama untuk mengambil error logika bisnis.

Kolom
cause

Cause

Alasan pemesanan gagal. (wajib)

rejected_card_type

CreditCardType

(wajib jika hanya diperlukan jika penyebabnya adalah PAYMENT_ERROR_CARD_TYPE_ dikatakan DITOLAK)

description

string

Kolom opsional ini digunakan partner guna menyertakan informasi tambahan hanya untuk tujuan proses debug. (opsional)

payment_failure

PaymentFailureInformation

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

ThreeDS1Parameters

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

string

URL tempat memuat formulir yang akan ditampilkan kepada Pengguna untuk autentikasi.

pa_req

string

Permintaan PaymentAuthentication. Untuk diposting ke formulir ACSUrl jika disediakan.

transaction_id

string

ID yang digunakan oleh penyedia ACS. Untuk diposting ke formulir ACSUrl jika disediakan.

md_merchant_data

string

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 SupportedPartySizeOption, setelan ini akan menampilkan opsi kepada pengguna untuk menelepon bisnis untuk melakukan pemesanan.

CancellationPolicy

Kebijakan pembatalan untuk layanan.

Kolom
refund_condition[]

RefundCondition

Nol atau beberapa ketentuan pengembalian dana 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

Duration

Durasi sebelum waktu mulai, hingga saat pelanggan dapat menerima pengembalian dana untuk sebagian biaya layanan yang ditentukan di refund_percent. Jika ditetapkan ke 0 (default), layanan dapat dibatalkan kapan saja.

refund_percent

uint32

Persentase yang dapat dikembalikan dananya, selama pemesanan layanan dibatalkan setidaknya min_duration_before_start_time sebelum waktu mulai layanan, dalam rentang [0, 100]. Jika ditetapkan ke 0 (default), layanan tidak dapat mengembalikan dana. Jika ditetapkan ke 100, layanan ini dapat mengembalikan dana sepenuhnya.

ClientInformation

Informasi pribadi tentang orang yang membuat pemesanan

Kolom
given_name

string

Nama depan klien

family_name

string

Nama belakang klien

address

PostalAddress

Alamat klien

telephone

string

Nomor telepon klien

email

string

Alamat email klien

CreateMerchantRequest

Permintaan untuk membuat Merchant.

Kolom
parent

string

Nama resource induk untuk partner yang memiliki penjual ini, dalam format partners/{partner_id}.

merchant_id

string

ID penjual yang akan digunakan untuk penjual ini.

merchant

Merchant

Penjual yang akan dibuat.

CreateServiceRequest

Permintaan untuk membuat Service baru.

Kolom
parent

string

Nama resource induk untuk penjual yang memiliki layanan ini, dalam format partners/{partner_id}/merchants/{merchant_id}.

service_id

string

ID layanan yang akan digunakan untuk layanan ini.

service

Service

Layanan yang akan dibuat.

CreditCardRestrictions

Batasan pada jenis kartu kredit yang diterima penjual ini.

Kolom
credit_card_type[]

CreditCardType

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

string

Nama resource penjual yang akan dihapus. Dalam format partners/{partner_id}/merchants/{merchant_id}

DeleteServiceRequest

Permintaan untuk menghapus Service.

Kolom
name

string

Nama resource layanan yang akan dihapus. Dalam format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Deposit

Deposit yang mungkin ditagih kepada pengguna atau ditangguhkan pada kartu kreditnya.

Kolom
deposit

Price

Jumlah setoran.

min_advance_cancellation_sec

int64

Pembatalan di awal minimum untuk setoran.

deposit_type

PriceType

Menentukan cara deposit ditentukan dari ketersediaan.

DirectMerchantPayment

Informasi tentang cara pengguna dapat membayar langsung ke penjual, bukan prabayar untuk layanan melalui RwG.

Kolom
payment_methods[]

Text

Pengguna akan disarankan untuk membayar hanya melalui metode pembayaran yang disebutkan di bawah.

DurationRange

Wrapper untuk rentang durasi yang dapat dibatasi atau tidak terbatas. Setidaknya salah satu dari durasi min_duration dan max_duration diperlukan.

Kolom
min_duration

Duration

Durasi minimum.

max_duration

Duration

Durasi maksimum.

ExtendedServiceAvailability

Daftar ketersediaan dan siapa/kapan harus menerapkannya.

Kolom
merchant_id

string

Kolom ini wajib diisi untuk menentukan penjual mana yang memiliki pesan ketersediaan di bawah.

service_id

string

Kolom ini wajib diisi untuk menentukan layanan mana yang memiliki pesan ketersediaan di bawah.

start_time_restrict

Timestamp

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:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:

  availability.duration == duration_restrict

Jika pesan resources_restrict ditetapkan, ketentuan akan dibatasi lebih lanjut:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

Timestamp

Menetapkan end_time_restrict dan membiarkan start_time_restrict tidak ditetapkan akan berarti semua waktu berakhir pada end_time_restrict.

duration_restrict

Duration

Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok.

resources_restrict

Resources

Menetapkan resources_restrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk set resource ini. Semua kolom id resource harus sama persis.

availability[]

Availability

Daftar ketersediaan baru.

FeedStatistics

Statistik yang diperoleh saat memproses feed yang diupload.

Kolom
new_items

int64

Item yang baru saja ditambahkan oleh feed ini. Item dapat berupa penjual, layanan, atau slot ketersediaan, bergantung pada jenis feed.

existing_items

int64

Item yang ada, diperbarui sesuai kebutuhan dari informasi yang lebih baru dari feed.

deleted_items

int64

Item yang tidak ada lagi di feed ini, dan sebagai akibatnya dihapus.

FeedStatus

Status feed yang diupload oleh platform agregator.

Kolom
name

string

Nama resource feed, yang memiliki format

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

State

Status pemrosesan feed ini.

error_details

string

String yang dapat dibaca manusia yang memberikan detail lebih lanjut jika kami gagal memproses feed ini.

statistics

FeedStatistics

Statistik khusus untuk feed ini.

Negara Bagian

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 link tindakan pemesanan makanan.

Kolom
fee_details[]

FeeDetails

Detail biaya yang dibebankan kepada pengguna di luar total item. Berulang untuk berbagai jenis biaya seperti tarif layanan, biaya pengiriman, dll.

advance_order_details

AdvanceOrderDetails

Detail tentang dukungan pemesanan lanjutan yang juga dikenal sebagai pesan di muka, yang memungkinkan pengguna memesan untuk pemenuhan pada waktu yang lebih lama dari saat ini.

Kolom union fulfillment_duration_options. Durasi waktu pemenuhan pesanan sejak konfirmasi pesanan. Untuk pesanan pengiriman, durasi waktu hingga makanan dikirim. Untuk pesanan ambil sendiri, durasi waktu hingga makanan siap diambil. fulfillment_duration_options hanya ada berupa salah satu diantara berikut:
fulfillment_lead_time_duration

Duration

Durasi tetap. Misalnya: 30 menit.

fulfillment_lead_time_duration_range

DurationRange

Rentang durasi. Contoh: * 30 menit hingga 45 menit * Lebih dari 30 menit * Kurang dari 50 menit

AdvanceOrderDetails

Untuk dukungan pesanan di muka.

Kolom
is_supported

bool

True jika Pesanan di Muka, juga dikenal sebagai Pesan di Depan, didukung. (wajib)

FeeDetails

Detail biaya.

Kolom
type

FeeType

Jenis biaya. (wajib)

fee_amount

FeeAmount

Jumlah biaya baik dalam mata uang satuan, persentase nilai keranjang, atau kombinasi keduanya. (wajib)

FeeAmount

Contoh FeeAmount: * 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), 5,5%, dan persentase: 15% (maksimum), 5,5% & 2,5%: 2,5%

Kolom
cart_percentage

QuantitativeValue

Biaya dalam persentase nilai keranjang. Mendukung rentang (terbatas dan tidak terbatas) atau persentase tetap. Nilai harus antara 0 dan 100. Contoh: * Tetap 5,5% * Minimal 5,5% * Maksimal 5,5% * 4,5% hingga 5,5%

Kolom union amount_options. Opsi untuk menentukan jumlah uang. amount_options hanya ada berupa salah satu diantara berikut:
amount

Money

Jumlah tetap. Misalnya, USD 3,5.

amount_range

MoneyRange

Rentang jumlah. Contoh: * USD 3.5 sampai USD 5.5 * Minimal USD 3.5 * Maksimal USD 5.5

amount_unknown

bool

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

FulfillmentType

Wajib. Jenis fulfillment.

available_day[]

AvailableDay

Wajib. Daftar hari saat ada ketersediaan untuk metode fulfillment ini (sebaiknya minimal 2).

fee_details

FeeDetails

Wajib. Detail biaya untuk metode fulfillment.

minimum_order

Price

Wajib. Pesanan minimum untuk metode fulfillment yang terkait dengan link tindakan.

AvailableDay

Ketersediaan tingkat harian.

Kolom
fulfillment_date

Date

Wajib. Tanggal tersedia untuk metode fulfillment. Dianggap berada dalam zona waktu penjual.

last_ordering_time

Timestamp

Wajib. Stempel waktu Unix. Terakhir kali pengguna dapat memesan dan menerima item paling lambat fulfillment_date. Dengan kata lain, setelah last_ordering_time, fulfillment_date tidak lagi ditampilkan sebagai tersedia.

Misalnya, jika fulfillment_date adalah 10-08-2020: - nilai last_ordering_time 2020-08-10 18:00 berarti bahwa, untuk menerima pesanannya pada 10-08-2020, pelanggan harus melakukan pesanan tersebut sebelum pukul 18.00 di hari yang sama. - a last_ordering_time nilai 2020-08-08 20:00 berarti, untuk menerima pesanan mereka pada 10-08-2020, pelanggan harus melakukan pemesanan tersebut sebelum pukul 20:00 dua hari sebelumnya.

FeeDetails

Detail biaya untuk metode pemenuhan yang terkait dengan link tindakan.

Kolom
Kolom union fee_details. Model biaya untuk metode fulfillment. fee_details hanya ada berupa salah satu diantara berikut:
no_fee

NoFee

Tidak ada biaya untuk metode fulfillment.

base_fee

MinimumFee

Biaya dasar yang terkait dengan metode fulfillment.

fixed_fee

FixedFee

Biaya tetap yang terkait dengan metode fulfillment.

FixedFee

Biaya tetap yang diperlukan untuk metode fulfillment yang terkait dengan link tindakan.

Kolom
amount

Price

Wajib. Jumlah biaya tetap untuk metode fulfillment.

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 fulfillment yang terkait dengan link tindakan.

Kolom
base_fee_amount

Price

Wajib. Jumlah biaya dasar untuk metode fulfillment.

NoFee

Tidak diperlukan biaya untuk metode fulfillment yang terkait dengan link tindakan.

GenericDeleteRecord

Kumpulan data yang akan dihapus dari jenis feed yang disebutkan dalam permintaan URL.

Kolom
delete_time

Timestamp

Wajib. Stempel waktu ini digunakan untuk menentukan urutan saat penghapusan akan diterapkan ke inventaris.

Kolom union record_type. Mengenkapsulasi berbagai jenis feed (ndjson, berbasis proto, dll.) Partner dapat memberikan catatan lengkap yang mirip dengan cara data disediakan 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 ada berupa salah satu diantara berikut:
data_record

bytes

Untuk feed berbasis non-proto.

proto_record

Any

Untuk feed berbasis proto.

GenericRecord

Data jenis feed yang disebutkan dalam permintaan URL.

Kolom
generation_timestamp

Timestamp

Wajib. 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 ada berupa salah satu diantara berikut:
data_record

bytes

Untuk feed berbasis non-proto.

proto_record

Any

Untuk feed berbasis proto.

GeoCoordinates

Data Geografis lokasi, termasuk lintang, bujur, dan alamat.

Kolom
latitude

double

Lintang dalam derajat. (opsional)

longitude

double

Bujur dalam derajat. (opsional)

Kolom union addresses. Alamat untuk lokasi, dapat terstruktur atau tidak terstruktur. addresses hanya dapat berupa salah satu dari berikut:
address

PostalAddress

Alamat pos lokasi, lebih disarankan.

unstructured_address

string

Alamat yang tidak terstruktur juga dapat diberikan sebagai penggantian. Mis., "1600 amphitheatre parkway mountain view, ca 94043"

GetMerchantStatusRequest

Permintaan untuk mendapatkan MerchantStatus

Kolom
name

string

Wajib. 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

string

Nama resource feed, yang memiliki format

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

HomeServiceData

Informasi tambahan harus diberikan untuk vertical layanan rumah.

Kolom
category_type

string

Kategori tingkat tinggi yang mencakup layanan rumah ini. Misalnya, tukang leding, tukang listrik, dll.

job_type

string

Jenis pekerjaan dalam kategori yang mencakup layanan rumah tangga tertentu. Mis. unclog_drain, install_faucet 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

string

Nama resource yang akan dibatalkan validasinya.

Misalnya, untuk resource Pengambilan, nama harus memiliki format partners/{partner_id}/pickups/{pickup_id}. Implementasi HARUS menghapus versi yang di-cache dari resource yang diidentifikasi.

LineItem

Satu item dalam satu pesanan - pemesanan satu layanan dalam satu slot waktu.

Kolom
service_id

string

ID Layanan penjual.

start_sec

int64

Waktu mulai slot janji temu dalam detik waktu UTC sejak epoch Unix.

duration_sec

int64

Durasi slot janji temu dalam detik.

tickets[]

OrderedTickets

Jumlah tiket yang dipesan menurut Jenis Tiket.

price

Price

Total harga (tidak termasuk pajak) untuk Item Baris ini.

status

BookingStatus

Status Item Baris.

OrderedTickets

Jumlah tiket yang dipesan menurut Jenis Tiket.

Kolom
ticket_id

string

ID Jenis Tiket.

count

int32

Jumlah tiket yang dipesan untuk jenis ini.

ListMerchantStatusesRequest

Permintaan untuk mendapatkan daftar MerchantStatus

Kolom
parent

string

Wajib. Induk, yang memiliki kumpulan status penjual ini. Format: partners/{partner_id}/merchants

page_size

int32

Wajib. Jumlah maksimum item untuk ditampilkan. Perhatikan bahwa server dapat mengurangi ukuran halaman.

page_token

string

Opsional. Nilai nextPageToken yang ditampilkan dari ListMerchantStatusResponse sebelumnya, jika ada.

booking_inventory_status_restrict

BookingInventoryStatus

Opsional. Pembatasan opsional untuk memfilter hasil menurut status inventaris pemesanan.

waitlist_inventory_status_restrict

WaitlistInventoryStatus

Opsional. Pembatasan opsional untuk memfilter hasil menurut status inventaris daftar tunggu.

geo_match_restrict

GeoMatchingStatus

Opsional. Pembatasan opsional untuk memfilter hasil berdasarkan 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 cocok secara geografis.
GEO_MATCHED Penjual dicocokkan secara geografis.

WaitlistInventoryStatus

Status inventaris daftar tunggu menyeluruh.

Enum
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Tidak ditentukan.
NO_VALID_WAITLIST_SERVICE Penjual tidak memiliki daftar tunggu yang mendukung layanan.
HAS_VALID_WAITLIST_SERVICE Penjual memiliki layanan yang mendukung daftar tunggu.

ListMerchantStatusesResponse

Respons untuk daftar MerchantStatus.

Kolom
merchant_statuses[]

MerchantStatus

Daftar status penjual yang memenuhi kondisi filter.

next_page_token

string

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

string

Nama resource feed, yang memiliki format

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

int32

Jumlah maksimum item untuk ditampilkan.

page_token

string

Nilai next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.

state_restrict

State

Pembatasan opsional untuk memfilter hasil menurut status feed.

time_range_restrict

TimeRange

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[]

FeedStatus

Daftar kronologis terbalik status untuk feed yang diupload. Jumlah maksimum item yang ditampilkan didasarkan pada kolom page_size dalam permintaan.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya. Tidak ada lagi hasil dalam daftar jika kosong.

LocalizedString

Instance string dalam satu lokal.

Kolom
locale

string

Kode bahasa BCP 47 IETF, seperti "en", "mas", "zh-Hant", "de-CH-1901". Lihat http://www.w3.org/International/articles/language-tags/.

value

string

Pesan dalam lokalitas di atas (UTF-8).

Lokasi

Informasi geografis tentang lokasi.

Kolom
place_id

string

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

string

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 wajib diisi dalam beberapa konteks. Misalnya, Service.location tanpa nama tidak akan dicocokkan dengan entitas bisnis, meskipun berada di alamat yang sama. (opsional)

telephone

string

Nomor telepon publik lokasi termasuk kode negara dan area, mis., +14567891234. (opsional)

url

string

Url situs publik lokasi. (opsional)

geo

GeoCoordinates

Info Geografis lokasi, termasuk lintang, bujur, dan alamat. (opsional)

location_type

LocationType

Jenis lokasi harus diberikan jika lokasi ini disediakan untuk Layanan.

location_id

string

Referensi unik lokasi dalam layanan. ID ini dapat digunakan untuk merujuk ke lokasi ini dalam kolom layanan lainnya. Misalnya, dalam formulir informasi awal kustom, sekumpulan ID lokasi dapat digunakan untuk menentukan opsi lokasi pengambilan. 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

string

Nama resource penjual, yang memiliki format partners/{partner_id}/merchants/{merchant_id}.

merchant_name

string

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

string

Nomor telepon publik penjual, termasuk kode negara dan area, mis., +14567891234.

url

string

URL situs publik penjual.

geo

GeoCoordinates

Info Geografis penjual, termasuk lintang, bujur, dan alamat.

category

string

Kategori bisnis di platform agregator.

num_bookings_30d
(deprecated)

int64

Kolom ini tidak digunakan lagi.

tax_rate_basis_points
(deprecated)

uint32

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

TaxRate

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

PaymentRestrictions

Batasan metode pembayaran yang diterima penjual ini. Kami mengasumsikan tidak ada batasan jika kolom ini tidak ditetapkan.

payment_option[]

PaymentOption

Opsi pembayaran yang tersedia untuk penjual ini. Layanan pada penjual ini akan dapat membatasi opsi pembayaran yang mereka izinkan secara individu.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya.

tokenization_config

TokenizationConfig

Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya.

terms

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

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?

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

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

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

MerchantMatchingHints

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[]

ServiceAttribute

Definisi untuk setiap atribut layanan yang digunakan untuk mendeskripsikan Layanan bagi Penjual ini. (opsional)

waitlist_advisement

Advisement

Opsional. Saran umum dari penjual tertentu bagi pengguna yang bergabung ke daftar tunggu melalui Pesan dengan Google. Setiap bidang teks 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

string

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

string

Nama resource status penjual, yang memiliki format partners/{partner_id}/merchants/{merchant_id}/status

merchant_name

string

Nama penjual yang diberikan oleh partner.

input_geo_info

GeoCoordinates

Partner memberikan info Geografis penjual.

processing_status

ProcessingStatus

Status pemrosesan penjual.

booking_status

BookingStatus

Status terkait integrasi pemesanan menyeluruh.

waitlist_status

WaitlistStatus

Status terkait integrasi daftar tunggu.

geo_match

PlaceInfo

Tempat Geo yang cocok dari penjual ini. Kosong jika penjual tidak cocok secara Geografis.

local_services_match

LocalServicesMatchInfo

Iklan Jasa dan Servis yang cocok dari penjual ini. Kosong jika lokasi bisnis bukan penjual jasa lokal atau tidak cocok dengan penyedia mana pun.

direct_urls[]

DirectUrl

Daftar URL untuk menunjukkan konten inventaris penjual saat ini. Perlu diketahui bahwa ini tidak berarti inventaris benar-benar ditayangkan dan URL mungkin berbeda dari URL yang terlihat oleh publik.

BookingStatus

Status terkait integrasi pemesanan menyeluruh.

Kolom
has_valid_future_inventory

bool

True jika penjual memiliki inventaris dalam 30 hari ke depan. Tidak menjamin penjual benar-benar dilayani.

DirectUrl

URL yang menampilkan penjual.

Kolom
type

UrlType

Jenis URL ini.

url

string

URL yang dapat menampilkan penjual ini.

UrlType

Jenis URL yang muncul.

Enum
URL_TYPE_UNSPECIFIED Tidak ditentukan.
BOOKING URL pemesanan menyeluruh.
WAITLIST URL daftar tunggu menyeluruh.
LOCAL_SERVICES URL Jasa dan Servis Google.

LocalServicesMatchInfo

Informasi kecocokan jasa dan servis Google (hanya ditetapkan untuk penjual jasa dan servis).

Kolom
matched_providers[]

MatchedProvider

Penyedia layanan yang cocok. Penjual dapat dicocokkan dengan beberapa penyedia layanan.

MatchedProvider

Penyedia jasa dan servis.

Kolom
customer_id

int64

ID pelanggan eksternal layanan lokal Google.

categories[]

string

Kategori jasa dan servis (vertical). Misalnya, "tukang leding" dan "pembersihan karpet".

PlaceInfo

Informasi tempat yang cocok.

Kolom
name

string

Nama tempat.

formatted_address

string

Alamat yang diformat dalam bahasa lokal.

place_id

string

ID Tempat Google untuk tempat ini. Dapat digunakan untuk membuat URL Google Maps atau mengambil detail tempat selengkapnya. Lihat https://developers.google.com/places/web-service/place-id untuk 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 lain yang terisi.
COMPLETED Status lain dari penjual telah dihitung.

WaitlistStatus

Status terkait integrasi daftar tunggu.

Kolom
has_valid_waitlist_service

bool

True 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

Money

Jumlah minimum.

max_amount

Money

Jumlah maksimum.

NoShowFee

Biaya yang mungkin ditagihkan kepada pengguna jika mereka telah membuat pemesanan tetapi tidak datang ke layanan yang dipesan.

Kolom
fee

Price

Jumlah yang mungkin ditagihkan kepada pengguna jika mereka tidak hadir untuk reservasi mereka.

fee_type

PriceType

Menentukan cara biaya ditetapkan dari ketersediaan.

Pesan

Pesanan untuk janji temu layanan dengan penjual.

Kolom
name

string

Nama resource pesanan: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

Informasi pribadi klien yang membuat pesanan.

payment_information

PaymentInformation

Informasi tentang transaksi pembayaran yang terkait dengan pesanan.

merchant_id

string

ID penjual tempat semua layanan dalam pesanan ini berada.

item[]

LineItem

Item baris dalam pesanan ini.

OrderOnlineMetadata

Metadata untuk link tindakan online pesanan.

Kolom
fulfillment_option[]

FulfillmentOption

Opsi pemenuhan pesanan yang tersedia untuk link tindakan online pesanan.

PaymentInformation

Detail pembayaran terkait pemesanan

Kolom
prepayment_status

PrepaymentStatus

Status prabayar pemesanan. Jika prepayment_status adalah PREPAYMENT_PROVIDED atau PREPAYMENT_REFUNDED, payment_transaction_id berisi id transaksi unit terkait.

payment_transaction_id

string

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

string

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

string

Nama opsi pembayaran. Ini dapat dilihat pengguna.

description

string

Deskripsi opsi pembayaran. Ini dapat dilihat pengguna.

price

Price

Harga opsi pembayaran.

tax_rate

TaxRate

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

PaymentOptionType

Jenis opsi pembayaran ini. Penggunaan tunggal untuk penurunan, multi-penggunaan untuk paket, dan tanpa batas untuk keanggotaan.

session_count

int64

Jumlah sesi yang dapat digunakan oleh opsi pembayaran ini. Hanya valid untuk multi-sesi/paket, dengan nilai harus > 1.

purchase_interval

TimeRange

Opsi pembayaran dapat dibeli dalam interval ini.

valid_interval

TimeRange

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

Duration

Durasi validitas opsi pembayaran (mis., keanggotaan 30 hari).

activation_type

ActivationType

Menentukan bagaimana tanggal mulai validitas ditentukan untuk opsi pembayaran ini.

user_restriction

UserPurchaseRestriction

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

Processor

Menentukan partner pemroses pembayaran yang menerapkan konfigurasi ini.

public_key

string

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

string

Nomor versi API yang dikirim ke pemroses pembayaran bersama dengan 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

CreditCardRestrictions

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

Price

Biaya yang dapat bervariasi menurut metode pengiriman.

processing_fee

Price

Biaya untuk memproses metode pembayaran pengguna.

PerTicketFee

Biaya yang harus dibayar untuk setiap tiket yang dibeli pengguna.

Kolom
service_charge

Price

Biaya tambahan yang dikenakan untuk layanan.

facility_fee

Price

Biaya yang dikenakan ke tempat/fasilitas.

taxes

Price

Pajak per tiket.

PostalAddress

Alamat pelanggan atau bisnis.

Kolom
address_country

string

Negara yang ditentukan menggunakan kode negara ISO 3166-1 alpha-2, mis. "US" (wajib)

address_locality

string

Lokalitas, mis., "Mountain View". (wajib)

address_region

string

Wilayah, mis., "CA". Kolom ini hanya wajib diisi di negara-negara tempat wilayah biasanya merupakan bagian dari alamat. (opsional)

postal_code

string

Kode pos, mis., "94043". (wajib)

street_address

string

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.

Harga

Harga layanan atau biaya.

Kolom
price_micros

int64

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

string

Mata uang harga yang ditentukan dalam ISO 4217.

pricing_option_tag

string

String opsional dan buram yang mengidentifikasi opsi penetapan 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 dapat berupa rentang atau nilai tetap. Contoh QuantitativeValue: * Nilai tunggal: value: 10.5 * Rentang batas: 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

double

Nilai tunggal. Misalnya: 5.6

value_range

RangeValue

Rentang nilai yang juga dapat berupa nilai terbuka atau dibatasi. Contoh: * Setidaknya 5.5 * Maksimal 5.5 * 5.5 hingga 6.5

RangeValue

Rentang nilai sehingga min_value < max_value. Memerlukan setidaknya salah satu dari min_value dan max_value.

Kolom
min_value

double

Nilai minimum.

max_value

double

Nilai maksimum.

Rating

Menentukan Rating untuk entitas.

Kolom
value

double

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

uint64

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

string

URL asal media ini. Google akan meng-crawl media yang dihosting di URL ini.

type

MediaType

Jenis sumber media ini.

localized_caption

Text

Teks media yang mendukung i18n, hanya mendukung teks biasa. Setiap komponen HTML akan dihapus. (opsional)

attribution

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
(deprecated)

string

Tidak digunakan lagi, lebih memilih menggunakan localized_caption.

Attribution

Informasi atribusi untuk media ini.

Kolom
localized_text

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
(deprecated)

string

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

ServiceAvailability

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.

Referensi

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

string

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

string

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

string

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

string

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 diperlukan jika room_id ada) Dalam ruang makan, nama ruang hanya boleh digunakan untuk area duduk seperti bar atau teras dan tidak boleh digunakan untuk menu harga tetap, aktivitas khusus, atau nilai non-kamar lainnya (seperti reservasi atau makan malam). Sangat disarankan agar tidak ada ruangan yang terkait dengan area duduk default.

party_size

int32

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

int64

Pemberitahuan awal minimum dalam hitungan detik diwajibkan untuk membatalkan janji temu yang telah dipesan secara online. (opsional)

late_cancellation_fee
(deprecated)

Price

Biaya pembatalan dalam periode pemberitahuan awal minimum.

noshow_fee
(deprecated)

Price

Denda ketidakhadiran tanpa pembatalan.

admission_policy

AdmissionPolicy

Kebijakan tiket masuk yang berlaku untuk layanan ini. Jika tidak ditetapkan, ditetapkan secara default ke TIME_STRICT. (opsional)

cancellation_policy

CancellationPolicy

Kebijakan pembatalan aturan penjadwalan. (wajib untuk rekomendasi aktivitas)

Kolom union min_booking_buffer. Durasi (dalam detik) dari saat pemesanan terakhir dapat dibuat hingga slot ketersediaan dimulai atau berakhir.

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 dipilih, sedangkan nilai lain diabaikan--kita tidak dapat memprediksi dengan pasti nilai mana yang dipilih.

Contoh:

  • Layanan potong rambut yang perlu dipesan setidaknya 1 jam sebelum waktu mulai. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Museum dengan tiket terakhir dapat dibeli 30 menit sebelum penutupan: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Tiket bioskop yang perlu dibeli sebelum waktu mulai. 'scheduling_rules{ ...}' (leave this field empty) (optional) min_booking_buffer hanya dapat berupa salah satu dari berikut:

min_advance_booking

int64

Durasi (dalam detik) dari saat pemesanan terakhir dapat dibuat hingga slot ketersediaan dimulai.

min_booking_buffer_before_end_time

int64

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.

Layanan

Info tentang layanan yang disediakan penjual, misalnya potong rambut.

Kolom
name

string

Nama resource layanan, yang memiliki format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

service_name

string

Nama layanan, misalnya "potong rambut pria". Tidak digunakan lagi, sebagai gantinya gunakan localized_service_name.

localized_service_name

Text

Nama layanan, misalnya "potong rambut pria". Mungkin di beberapa lokal.

description

string

Deskripsi layanan yang dilihat pengguna. Tidak digunakan lagi, sebagai gantinya gunakan localized_description.

localized_description

Text

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 heading dapat digunakan untuk menampilkan judul dan sub-judul. Misalnya, <h1>Itinerary</h1> akan menampilkan bagian dari teks sebagai heading bagian terpenting. Perhatikan bahwa setiap tag, gaya, atau atribut HTML dalam akan diabaikan. Misalnya, <h1 style=".."> akan diperlakukan sama seperti <h1>. Hanya teks asli yang akan dipertahankan.

Tag paragraf: <p>
Tag paragraf dapat digunakan untuk menandai pengantar atau konten mendetail. Setiap tag, gaya, atau atribut dalam akan diabaikan, dengan beberapa pengecualian: <br>, <strong>, dan <em>. Lihat bagian tag frasa di bawah untuk mengetahui detail selengkapnya.

Tag daftar: <ul>, <ol>, <li>
Tag <ul> dapat digunakan dengan tag <li> untuk menampilkan daftar yang tidak diurutkan, dan tag <ol> dapat digunakan dengan <li> untuk menampilkan daftar yang dirutkan. Ini adalah cara yang baik untuk menampilkan checklist, jadwal, atau daftar lainnya yang cocok dengan kasus penggunaan Anda.
Contoh: Untuk menampilkan daftar fitur perjalanan kapal pesiar:
<ol>
<li>Panorama laut yang menakjubkan dan peluang untuk bermain dengan satwa liar.</li>
<li>Pengaturan dan layanan perjalanan yang dirancang dengan cermat.</li>
<li>Dijamin harga terendah.</li>
</ol>
Perhatikan bahwa hanya <li> anak-anak berusia di bawah <ul> atau <ol> yang akan dikonversi. Semua turunan lainnya akan dihapus. Selain itu, tag, atribut, dan gaya dalam akan diabaikan; kami hanya menyimpan konten teks asli.

Tag divisi: <div>
Semua tag dalam yang didukung pada tag <div> akan diuraikan dengan aturan yang dinyatakan di atas, tag <div> itu sendiri tidak berarti menyiratkan pembuatan grup atau indentasi di sini. Selain itu, setiap atribut dan gaya dalam akan diabaikan.

Tag frasa: <br>, <strong>, <em>:
Hanya tiga tag yang disebutkan di atas yang didukung. <br> dapat digunakan untuk memisahkan baris dalam paragraf, dan <strong>/<em> dapat digunakan untuk menandai teks penting. Setiap tag frasa lainnya akan diabaikan.

Tag tidak didukung:

  • Tag <html>, <header>, dan <body> tidak diizinkan.
  • Setiap tag lain yang tidak disebutkan di atas tidak didukung (misalnya <table>, <td> ...),
    Semua URL, anchor, dan link akan dihapus, dan tidak akan pernah ditampilkan kepada pengguna akhir. Jika Anda ingin menggunakan foto untuk membuat pengalaman pengguna yang lengkap, gunakan kolom "related_media" di bawah untuk mengirimkan URL foto.

Catatan penting:

  • Coba untuk tidak menggunakan tag lain kecuali tag yang didukung di atas, karena konten dalam tag yang tidak didukung akan dihapus, dan dapat menghasilkan pengalaman pengguna yang tidak diinginkan.
  • Coba hindari struktur bertingkat dalam seperti lebih dari 3 tingkat judul yang berbeda atau daftar bertingkat. Menjaga agar struktur tetap datar, sederhana, dan jelas akan membantu menciptakan pengalaman pengguna yang lebih baik.
  • Jika tata letak yang saat ini didukung tidak memadai untuk kasus penggunaan Anda, hubungi tim Pesan dengan Google.
  • Rekomendasi ukuran maksimum adalah 32.000 karakter.
price

Price

Harga layanan.

price_interpretation

PriceInterpretation

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

SchedulingRules

Aturan untuk membuat/membatalkan janji temu.

prepayment_type

PrepaymentType

Apakah prabayar diperlukan, opsional, atau tidak didukung.

prepayment_terms

PrepaymentTerms

Persyaratan sekitar ketika pembayaran di muka selesai.

form[]
(deprecated)

ServiceIntakeForm

Tidak digunakan lagi. Harap gunakan intake_form dan per_ticket_intake_form.

intake_form

ServiceIntakeForm

Formulir yang meminta informasi tambahan dari pengguna saat mereka memesan layanan ini. (opsional)

per_ticket_intake_form

ServiceIntakeForm

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

TaxRate

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[]

string

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

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

NoShowFee

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

RequireCreditCard

Menunjukkan apakah pengguna harus menyediakan kartu kredit untuk memesan layanan ini. Kolom ini dapat diganti pada tingkat ketersediaan. (opsional)

type

ServiceType

Jenis layanan ini yang telah ditetapkan sebelumnya. (opsional)

ticket_type[]

TicketType

Jenis tiket yang dapat dipesan/dibeli untuk layanan ini, jika tiket didukung. (opsional)

related_media[]

RelatedMedia

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[]

ServiceAttributeValueId

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

WaitlistRules

Aturan untuk bergabung ke daftar tunggu.

ticketing_vertical_specific_data

TicketingVerticalSpecificData

Informasi tambahan yang unik untuk vertical penjualan tiket acara. (opsional)

integration_type

IntegrationType

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

PerOrderFee

Biaya tingkat pesanan untuk membeli layanan ini. (opsional)

tours_and_activities_content

ToursAndActivitiesContent

Kolom konten khusus untuk Tur dan Aktivitas.

location[]

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

Rating pengguna untuk layanan ini sebagai metrik gabungan atas semua ulasan.

home_service_data

HomeServiceData

Informasi tambahan unik untuk vertical layanan rumah tangga. (opsional)

virtual_session

VirtualSession

Opsional. Informasi tentang sesi virtual. Hal ini diperlukan untuk mengaktifkan layanan virtual.

direct_merchant_payment

DirectMerchantPayment

Opsional. Informasi tambahan yang perlu ditambahkan jika layanan mengharuskan pengguna membayar langsung ke penjual. CATATAN PENTING: RwG tidak akan terlibat dalam transaksi ini. Atribut ini wajib jika virtual_session ditetapkan dan layanan tidak gratis atau prepayment_type TIDAK ditetapkan ke REQUIRED.

PrepaymentTerms

Informasi spesifik terkait kapan pembayaran di muka selesai.

Kolom
charge_timing

ChargeTiming

Kapan tagihan akan muncul sesuai dengan waktu pembelian.

charge_time_before_start_time_sec

int64

Waktu dalam detik sebelum waktu mulai layanan saat pengguna ditagih untuk pembayaran. Bidang ini hanya boleh ditetapkan ketika 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 antar makanan, bawa pulang, atau keduanya.
SERVICE_TYPE_FOOD_DELIVERY Layanan pesan-antar makanan.
SERVICE_TYPE_FOOD_TAKEOUT Bawa pulang makanan.
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 akan sepenuhnya bersifat virtual. Harus ditetapkan jika mengaktifkan pemesanan layanan virtual.
SERVICE_TYPE_SHOPPING Layanan yang memungkinkan pengguna berbelanja dari penjual tertentu. Layanan ini dapat berupa layanan pesan antar atau pesan 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

string

ID yang mengidentifikasi atribut layanan ini secara unik di antara atribut lainnya untuk penjual yang sama, mis., "jenis akun".

attribute_name

string

Nama yang terlihat oleh pengguna untuk atribut ini, mis., "Jenis Akun".

value[]

Value

Semua nilai yang mungkin untuk atribut layanan ini.

Nilai

Merepresentasikan kemungkinan nilai untuk atribut layanan tertentu.

Kolom
value_id

string

ID yang mengidentifikasi nilai ini secara unik di antara nilai lainnya untuk atribut layanan ini, mis. "pribadi".

value_name

string

Nama yang terlihat oleh pengguna untuk nilai, misalnya "Pribadi".

ServiceAttributeValueId

Mengidentifikasi nilai atribut layanan tertentu yang akan diterapkan ke Layanan.

Kolom
attribute_id

string

ID atribut seperti yang dijelaskan di Merchant.service_attribute, mis. "service-type".

value_id

string

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

string

Nama resource layanan yang akan menerapkannya. Dalam format partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

start_time_restrict

Timestamp

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:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Jika pesan durasi ditetapkan, ketentuan akan dibatasi lebih lanjut:

  availability.duration == duration_restrict

Jika pesan resources_restrict ditetapkan, ketentuan akan dibatasi lebih lanjut:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

Timestamp

Menetapkan end_time_restrict dan membiarkan start_time_restrict tidak ditetapkan akan berarti semua waktu berakhir pada end_time_restrict.

duration_restrict

Duration

Menetapkan durasi akan lebih lanjut membatasi cakupan pembaruan hanya untuk ketersediaan dengan durasi yang cocok.

resources_restrict

Resources

Menetapkan resources_restrict akan lebih lanjut membatasi cakupan pembaruan hanya untuk set resource ini. Semua kolom id resource harus sama persis.

availability[]

Availability

Daftar ketersediaan baru.

ServiceIntakeForm

Menentukan formulir informasi awal yang menyesuaikan layanan yang disediakan penjual.

Kolom
field[]

ServiceIntakeFormField

Kolom yang akan ditampilkan kepada pengguna.

first_time_customers
(deprecated)

bool

Jika bernilai benar, formulir ini akan ditampilkan kepada pelanggan baru. Tidak digunakan lagi. Fungsi ini tidak didukung untuk formulir informasi awal.

returning_customers
(deprecated)

bool

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

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

FieldType

Jenis kolom ini.

label

string

Teks yang ditampilkan kepada pengguna untuk kolom ini. Tidak digunakan lagi, sebagai gantinya gunakan localized_label.

localized_label

Text

Teks yang ditampilkan kepada pengguna untuk kolom ini. Kolom ini dapat diberikan di beberapa lokal. (wajib)

value[]

string

Tetapkan jika dan hanya jika jenis kolom adalah LOCATION_SEARCH. Gunakan "location_id" di kolom "location" untuk menentukan nilai lokasi.

choice_text[]

Text

Tetapkan jika dan hanya jika jenis kolom adalah MULTIPLE_CHOICE, CHECKBOXES, atau DROPDOWN. Digunakan untuk menghitung kemungkinan pilihan.

is_required

bool

Menunjukkan apakah jawaban untuk kolom ini diperlukan oleh pengguna.

allow_custom_answer

bool

Menunjukkan apakah nilai kustom diizinkan sebagai tambahan untuk jawaban yang telah ditentukan. Ini hanya berlaku jika jenis kolom adalah LOCATION_SEARCH. (opsional)

additional_option[]

Text

Opsi tambahan yang diberikan selain nilai yang diberikan. Hanya berlaku jika jenis kolom adalah LOCATION_SEARCH. Misalnya, selain daftar lokasi yang diberikan, opsi lain yang tersedia adalah "Saya akan menghubungi pemasok nanti". (opsional)

ticket_type_restrict[]

string

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

Text

Teks petunjuk untuk input, yang ditampilkan sebagai placeholder teks. Ini hanya berlaku jika 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.

TaxRate

Tarif pajak yang diterapkan saat menagih pengguna untuk layanan, dan yang dapat ditetapkan per penjual atau per layanan.

Kolom
micro_percent

int32

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

string

Secara opsional, URL untuk Persyaratan dan Ketentuan.

text

string

Teks yang akan ditampilkan kepada pengguna. Gunakan localized_text di bawah untuk integrasi baru.

localized_text

Text

Teks yang dilokalkan yang akan ditampilkan kepada pengguna.

Teks

Payload teks yang dapat dilokalkan. Beberapa kolom Teks mungkin berisi konten yang di-markup.

Kolom
value

string

Nilai teks dalam lokal yang tidak diketahui. Wajib jika dan hanya jika localized_value kosong. Lokal untuk nilai ini mungkin bergantung pada partner atau penyedia layanan - lokal seharusnya tidak diasumsikan sebagai bahasa apa pun.

localized_value[]

LocalizedString

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

string

ID tiket digunakan untuk membedakan berbagai jenis tiket dari layanan yang sama, dan hanya diharapkan unik dalam layanan.

short_description

string

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

Text

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

Price

Harga tiket tunggal jenis ini, tidak termasuk pajak apa pun. Tarif pajak Layanan berlaku untuk tiketnya.

per_ticket_fee

PerTicketFee

Biaya tambahan untuk membeli tiket ini. (opsional)

option_description

string

Deskripsi tambahan mengenai opsi tambahan yang ditunjukkan jenis tiket ini, jika ada. Tidak digunakan lagi, sebagai gantinya gunakan localized_option_description.

localized_option_description

Text

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
. Opsi tersebut ditujukan agar digunakan untuk menentukan opsi dengan judul dan deskripsi mendetail, misalnya: "Tempat Duduk Premium
Opsi ini menawarkan tempat duduk di kotak pribadi termasuk tempat duduk empuk, TV pribadi, layanan makanan dan minuman di tempat duduk. Tempat duduk ini memberikan tampilan kolom yang indah".

TicketingVerticalSpecificData

Informasi tambahan yang unik untuk vertical penjualan tiket acara.

Kolom
event_category

EventCategory

Kategori acara. Ditetapkan hanya bila acara termasuk dalam salah satu kategori yang sudah ditetapkan. (opsional)

event_url

string

URL acara di situs partner. (opsional)

entity[]

Entity

Daftar entitas terkait acara. (opsional)

event_attendance_mode

AttendanceMode

Wajib. Jenis kehadiran acara.

event_virtual_location_url[]

string

Opsional. URL tempat acara dapat ditonton.

event_organizer

Text

Opsional. Penyelenggara acara.

event_organizer_url

string

Opsional. URL penyelenggara yang menyelenggarakan acara.

event_organizer_type

OrganizerType

Opsional. Jenis penyelenggara.

event_source_url[]

string

Wajib. URL halaman tempat informasi atau deskripsi acara dapat ditemukan.

event_state

EventState

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

string

ID unik entitas dalam database partner. (opsional)

name

string

Nama entitas. (wajib)

url

string

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

EntityType

Jenis entitas. (opsional)

entity_role

EntityRole

Peran entitas dalam acara. (opsional)

public_identification_data

PublicIdentificationData

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 dijadwalkan.
RESCHEDULED Acara akan dijadwalkan ulang.
CANCELLED Acara dibatalkan.
POSTPONED Acara ditunda.

OrganizerType

Jenis penyelenggara.

Enum
ORGANIZER_TYPE_UNSPECIFIED Tidak ditentukan.
PERSON Untuk penyelenggara yang berupa seseorang.
ORGANIZATION Untuk penyelenggara yang merupakan sebuah organisasi.

PublicIdentificationData

ID, halaman web, atau sumber publik lainnya yang mereferensikan entitas.

Kolom
relevant_url[]

string

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

string

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

Timestamp

Batas bawah rentang waktu.

end_time

Timestamp

Batas atas rentang waktu.

TokenizationConfig

Konfigurasi untuk tokenisasi pemroses pembayaran, yang disiapkan per Penjual.

Kolom
tokenization_parameter

map<string, string>

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

BillingInformationFormat

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[]

Text

Daftar sorotan yang dapat dilihat pengguna.

inclusions[]

Text

Daftar penyertaan yang dapat dilihat pengguna.

exclusions[]

Text

Daftar pengecualian yang dapat dilihat pengguna.

must_know[]

Text

Daftar catatan penting yang dapat dilihat pengguna, yang digunakan untuk detail seperti pembatasan usia atau ketentuan lain yang membuat layanan ini tidak sesuai.

UnsupportedPartySizeOption

Opsi untuk pihak yang berada di luar cakupan.

Kolom
call_merchant

CallMerchant

Jumlah tamu yang berada di luar jangkauan dapat menghubungi bisnis. Pesan yang telah ditentukan akan ditampilkan kepada pengguna. Contoh teks yang akan ditampilkan: "Untuk pesta yang lebih besar dari {waitlist_rules.max_party_size}, harap hubungi restoran di {phone}." CallMerchant harus ditetapkan, tetapi kosong.

UpdateBookingRequest

Permintaan untuk memperbarui google.maps.booking.v1alpha.Booking

Kolom
update_mask

FieldMask

Mask kolom untuk semua kolom pemesanan yang akan diperbarui

booking

Booking

Pemesanan yang akan diperbarui

booking_failure

BookingFailure

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

Merchant

Data penjual baru.

update_mask

FieldMask

Kolom spesifik yang akan diperbarui untuk penjual.

UpdateOrderRequest

Permintaan untuk memperbarui google.maps.booking.v1alpha.Order

Kolom
update_mask

FieldMask

Mask kolom untuk semua kolom pesanan yang akan diperbarui

order

Order

Pesanan yang akan diperbarui

UpdateServiceRequest

Permintaan untuk memperbarui Service.

Kolom
service

Service

Data layanan baru.

update_mask

FieldMask

Kolom spesifik yang akan diperbarui untuk layanan.

UserPurchaseRestriction

Membatasi pengguna yang memenuhi syarat untuk membeli opsi pembayaran.

Kolom
new_to_merchant

bool

Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli dari penjual yang sama sebelumnya.

new_to_payment_option

bool

Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli opsi pembayaran yang sama sebelumnya.

VirtualSession

Informasi tentang sesi virtual/online. Misalnya, kelas yoga online, kelas memasak virtual, dll.

Kolom
session_instructions

Text

Petunjuk cara menyiapkan class virtual ini. Jika partner tidak menyertakan URL video dengan pemesanan, teks ini harus disertakan saat URL video akan dibagikan kepada pengguna. Misalnya, “URL Zoom akan dikirim melalui email 30 menit sebelum kelas”. (Disarankan)

session_requirements

Text

Persyaratan untuk sesi virtual tertentu. Misalnya, matras yoga, peralatan memasak, dll. (Direkomendasikan)

virtual_platform_info

VirtualPlatformInfo

Informasi tentang platform virtual yang digunakan dalam sesi ini. (Diperlukan untuk mengaktifkan layanan virtual)

is_session_prerecorded

bool

Wajib. Tetapkan nilai ini sebagai true (benar) jika sesi virtual tidak live dan direkam sebelumnya.

VirtualPlatformInfo

Informasi tentang platform yang akan digunakan untuk sesi virtual ini.

Kolom
platform

Platform

Platform yang digunakan untuk sesi virtual.

other_platform_name

Text

Nama platform jika platform ditetapkan ke OTHER. (Wajib jika platform ditetapkan ke OTHER)

Platform

Enum untuk menunjukkan platform virtual yang akan digunakan oleh penjual.

Enum
PLATFORM_UNSPECIFIED Tidak digunakan.
FLEXIBLE Penjual fleksibel dalam hal platform video yang mereka gunakan.
GOOGLE_HANGOUTS produk Google Hangouts.
GOOGLE_MEET produk Google Meet.
ZOOM Zoom Video Communications.
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

int32

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

int32

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

bool

Jika true (benar), pengguna akan dapat mengirim permintaan teks tambahan berformat bebas saat bergabung ke daftar tunggu untuk layanan ini.

above_max_party_size_options[]

UnsupportedPartySizeOption

Menetapkan opsi untuk pesta yang lebih besar dari max_party_size yang ditetapkan. Biarkan kosong jika pihak besar tidak boleh diberi opsi alternatif untuk bergabung ke daftar tunggu.