Package google.maps.booking.v1alpha

Dizin

BookingNotification

Harici planlama iş ortaklarından randevular için bildirim alır. İş ortağı, iş ortağının CreateReservation ve CheckAvailability gibi rezervasyona dayalı RPC'ler veya CreateOrder ve CheckOrderFulfillability gibi sipariş tabanı RPC'lerini uygulayıp uygulamadığına bağlı olarak UpdateReservation veya UpdateOrder'ı çağırmalıdır.

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

Mevcut bir Booking öğesini günceller.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

Mevcut bir Order öğesini günceller.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Feed

Harici toplayıcı iş ortakları tarafından yüklenen feed'lerin işleme durumunu alın.

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Belirtilen toplayıcı tarafından önceden yüklenen bir feed'in Status bilgisini alır ve döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc ListStatus(ListStatusRequest) returns (ListStatusResponse)

Belirtilen toplayıcı tarafından önceden yüklenmiş birden fazla satıcı, hizmet veya stok durumu feed'inin Status bilgisini alır ve döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

InvalidationService

Harici iş ortaklarından kaynak geçersiz kılma istekleri alır.

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

Mevcut bir kaynağı geçersiz kılar.

İstenen kaynak Google hizmetine abone değilse istek yoksayılır.

Desteklenen kaynak türleri: - Alma

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

InventoryStatus

Yüklenen satıcıların envanteri ve eşleşme durumunu alma.

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Merchant ile MerchantStatus kazanın.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc ListMerchantStatuses(ListMerchantStatusesRequest) returns (ListMerchantStatusesResponse)

Filtre koşullarını karşılayan bir iş ortağının tüm MerchantStatus listelemelerini listeleyin.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

InventoryUpdate

Harici toplayıcılardan envanter güncellemeleri alır.

BatchDeleteGenericRecords

rpc BatchDeleteGenericRecords(BatchDeleteGenericRecordsRequest) returns (Empty)

Belirtilen yayın türünün kayıtlarını siler. Sadece temel doğrulamayı (bozuk istek gibi) gerçekleştirir. Bu işlemden sonra iş ortağına hemen uygun bir yanıt döndürülür. Google, istek üzerinde iş mantığı doğrulamasını eşzamansız olarak gerçekleştirir. Bu toplu çağrı, atom değeri garantisi vermez.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

Belirtilen yayın türünün kayıtlarını ekler ve/veya günceller. Sadece temel doğrulamayı (bozuk istek gibi) gerçekleştirir. Bu işlemden sonra iş ortağına hemen uygun bir yanıt döndürülür. Google, istek üzerinde iş mantığı doğrulamasını eşzamansız olarak gerçekleştirir. Bu toplu çağrı, atom değeri garantisi vermez.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

Mevcut Services öğesinin Availability öğesini değiştirir. Bu toplu çağrı, atom değeri garantisi vermez. Yalnızca başarıyla güncellenen kullanılabilirlik alanları döndürülür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc CreateMerchant(CreateMerchantRequest) returns (Merchant)

Belirtilen toplayıcı tarafından yönetilen yeni bir Merchant oluşturur ve bunu döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc CreateService(CreateServiceRequest) returns (Service)

Belirtilen toplayıcı tarafından yönetilen bir satıcı için yeni Service oluşturur ve bunu döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant öğesini siler. Satıcının tüm hizmetleri ve stok durumu da devre dışı bırakılır. Satıcıyı daha sonra yeniden eklerseniz aynı hizmet grubu ve müsaitlik durumu alanı gösterilir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc DeleteService(DeleteServiceRequest) returns (Empty)

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesini siler. Hizmetin tüm kullanılabilirliği de silinir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service için Availability değerini değiştirir ve geri döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc UpdateMerchant(UpdateMerchantRequest) returns (Merchant)

Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant değerini günceller ve bunu döndürür.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc UpdateService(UpdateServiceRequest) returns (Service)

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service değerini günceller ve bu öğeyi geri gönderir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

ActionLinkType

Bir işlem bağlantısıyla ilişkilendirilmiş önceden belirlenmiş işlem türü.

Sıralamalar

ActionPlatform

İşlemin gerçekleştirildiği platform. Web uygulaması genel yedektir. ACTION_PLATFORM_WEB_APPLICATION ile en az bir ActionLink'e sahip olmanız önerilir. Platform olarak Android ve iOS olan bağlantılar yalnızca ilgili sistemde kullanılır.

Sıralamalar
ACTION_PLATFORM_UNSPECIFIED Platform belirtilmedi.
ACTION_PLATFORM_WEB_APPLICATION İşlem platformu genel olarak web'dir.
ACTION_PLATFORM_MOBILE_WEB İşlem platformu, mobil cihazlarda web'dir.
ACTION_PLATFORM_ANDROID İşlem platformu Android OS'tir.
ACTION_PLATFORM_IOS İşlem platformu iOS'tir.

Danışmanlık

Google ile Rezervasyon üzerinden rezervasyon sırasında kullanıcıya gösterilen öneriler.

Alanlar
text

Text

Google ile Rezervasyon üzerinden rezervasyon sırasında kullanıcıya gösterilecek özel mesaj.

Kullanılabilirlik

Satıcının hizmeti için zaman ve yer sayısını gösteren müsaitlik durumu alanı.

Alanlar
start_time

Timestamp

Toplantı aralığının başlangıç saati.

duration

Duration

Toplantı aralığının süresi

spots_total

int64

Müsaitlik durumundaki toplam kontenjan ve açık alan sayısı. Örnekler:

  • 3 kişilik yoga dersi için 10 kişilik yoga dersi: availability {spots_total: 10, spots_open: 7 ...}
  • Tamamen rezerve edilmiş koltuk masaj seansı: availability {spots_total: 1, spots_open: 0 ...}

Not: Aşağıda tanımlanan müsaitlik durumu sıkıştırma biçimini kullanarak istek gönderiliyorsa bu iki alan tahmin edilir.

  • Yinelenme, spots_total=1 ve spots_open=1 anlamına gelir.
  • ScheduleException, spots_total=1 ve spots_open=0 anlamına gelir.
spots_open

int64

Açık nokta sayısı.

availability_tag

string

Bu kullanılabilirlik slotunu tanımlamak için kullanılan isteğe bağlı opak dize. Ayarlanırsa randevu alma/güncelleme/iptal etme isteklerine dahil edilir.

resources

Resources

Hizmet kapsamında farklı personel veya odalar söz konusu olduğunda bu müsaitlik durumunu diğerlerinden ayırt etmek için kullanılan isteğe bağlı kaynaklar.

Örneğin, iki 2 eğitmeniyle aynı yoga dersi:

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

Bu slot için ödeme yaparken kullanılabilecek ödeme seçeneklerini belirten kimliklerin listesi. Gerçek ödeme seçenekleri, Satıcı düzeyinde tanımlanır ve birden çok Satıcı arasında da paylaşılabilir.

Bu alan, hizmet mesajında belirtilen tüm payment_option_id değerlerini geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_id değerlerinin hizmet mesajında bulunması GEREKMEZ ancak Satıcı düzeyinde tanımlanması gerekir.

recurrence

Recurrence

Müsaitlik durumu için birden fazla başlangıç zamanını temsil eden yineleme bilgileri. Yineleme, bir iş gününe ait randevuları içermelidir.

schedule_exception[]

ScheduleException

Bu hizmetin planlanamadığı zamanlar. schedule_exception iletilerinin sayısını sınırlandırmak için bitişik istisnalara katılmayı düşünebilirsiniz.

deposit

Deposit

Bu müsaitlik durumu için isteğe bağlı depozito. Belirtilmişse hizmet ödemesini geçersiz kılar.

no_show_fee

NoShowFee

İsteğe bağlı olarak bu müsaitlik durumu için rezervasyonu kullanmama ücreti ekleyin. Belirtilmiş olması halinde hizmetin rezervasyonu kullanmama ücretini geçersiz kılar.

require_credit_card

RequireCreditCard

Kullanıcının bu müsaitlik durumu randevusu için kredi kartı vermesi gerekip gerekmediğini belirtir. Ayarlanmamışsa ve ayarlanmış olması halinde hizmet düzeyinden devralınır. (isteğe bağlı)

ticket_type_id[]

string

Bu müsaitlik durumu slotu için desteklenen bilet türlerinin listesini gösterir. Politika ayarlanmazsa üst hizmetteki tüm bilet türleri bu aralık için kullanılabilir. Bu alanın değerlerinin üst hizmette tanımlanması gerektiğini unutmayın. Örnekler:

  • Dört bilet türünde hizmet: TicketType {ticket_type_id: "adult_1" short_description: "yetişkin hafta içi"} TicketType {ticket_type_id: "adult_2" short_description: "Yetişkinlere yönelik hafta sonları"} Bilet Türü {ticket_type_id: "genç_1" short_description: "Gençlik hafta sonları"} TicketType {ticket_type_id: "genç hafta sonları"} TicketType {ticket_type_id: "gençlik_tarihi"}:

Hafta içi envanteri temsil etmek için: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Tatil dönemlerinde envanteri temsil etmek için: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

  • Üç bilet türü olan hizmet: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} Bilet Türü {ticket_type_id: "senior" short_description: "Kıdemli"}

Üç bilet türünün de bu zaman aralığında uygun olduğunu belirtmek için availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} veya "availability {...}" özelliğini kullanın (bu alanda Ticket_type_id değerini ayarlamayın).

(isteğe bağlı)

duration_requirement

DurationRequirement

Slot süresini ve/veya bitiş zamanını gösterme şartı. Alan kullanılamıyorsa bu alan yoksayılır. Yapılacaklar sektöründe kullanılmaz. (isteğe bağlı)

scheduling_rule_overrides

SchedulingRuleOverrides

Müsaitlik durumu planlama kuralları. Alanlar doldurulursa hizmet düzeyinde SchedulingRules'daki karşılık gelen planlama kurallarını geçersiz kılarlar.

confirmation_mode

ConfirmationMode

Bu müsaitlik durumu için rezervasyon sırasında kullanılacak onay modu. CONFIRMATION_MODE_SYNCHRONOUS onay moduyla müsaitlik durumu için rezervasyon oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. CONFIRMATION_MODE_ASYNCHRONOUS onay moduna sahip müsaitlik durumu için rezervasyon oluşturma girişimleri hemen reddedilmeli veya BEKLEMEDE durumla oluşturulmalıdır.

ConfirmationMode

Müsaitlik durumu için rezervasyon yaparken kullanılan onay modları.

Sıralamalar
CONFIRMATION_MODE_UNSPECIFIED Onay modu belirtilmedi. Eşzamanlı onay varsayılır.
CONFIRMATION_MODE_SYNCHRONOUS Bu müsaitlik durumu için yapılan rezervasyonlar eşzamanlı olarak onaylanacaktır.
CONFIRMATION_MODE_ASYNCHRONOUS Bu müsaitlik durumu için yapılan rezervasyonlar eşzamansız olarak onaylanacaktır.

DurationRequirement

Bu numaralandırma, kullanıcının istenen slot süresini/bitiş zamanını onaylaması veya görüntülemesi için hangi gereksinimlerin bulunduğunu belirtir.

Sıralamalar
DURATION_REQUIREMENT_UNSPECIFIED Bitiş zamanının işlenme şekli belirtilmemiş. Bu varsayılan seçenektir.
DO_NOT_SHOW_DURATION Bitiş saati kullanıcıya gösterilmez.
MUST_SHOW_DURATION Randevu alınabilmesi için bitiş saatinin kullanıcıya gösterilmesi gerekir.

Yinelenme

Yineleme mesajları isteğe bağlıdır ancak sürekli olarak tekrarlanan kullanılabilirlik slotları için daha kompakt bir gösterim sağlar. Genellikle bir günlük çalışma programını temsil ederler. Daha sonra ScheduleException mesajları, iş günü içindeki ayrılmış/kullanılamayan zaman aralıklarını temsil etmek için kullanılır.

Koşullar:

  1. Kullanılabilirlik slotları veya yinelemelerin genişletilmesi aynı yuvaları OLUŞTURMAMALIDIR. Kimlikler, başlangıç_zamanı, süre ve kaynaklar eşleşirse alanlar aynı olarak kabul edilir.
  2. Standart kullanılabilirlik biçimini ve yinelenmeyi tek bir hizmetin alanlarında KULLANMAYIN. Randevu sunan satıcılar/hizmetler yinelenme açısından yararlıdır. Standart biçim, düzenli olarak planlanmış kurslara sahip satıcılara/hizmetlere yöneliktir.
  3. Yinelenmeler 24 saatten uzun sürmemelidir.
Alanlar
repeat_until

Timestamp

Müsaitlik durumunun tekrarlandığı maksimum UTC zaman damgası dahil.

repeat_every

Duration

Ardışık kullanılabilirlik aralıkları arasındaki süreyi tanımlar.

Örnek: 20 dakika süresi olan müsaitlik durumu, 30 dakika tekrarlama, 09:00 başlangıç_zamanı ve 11:00'a kadar tekrar_varlığı, 9-9:20, 09:30-09:50, 10-10:20, 10:30-10:10:10:10:10:50 aralığında zaman aralıkları sağlar. (zorunlu)

ScheduleException

ScheduleException iletileri, iş günü içindeki ayrılmış/kullanılamayan zaman aralıklarını temsil eder. Bu, yukarıda açıklanan yinelemenin istisnalarıdır. Zaman aralıkları rezerve edildikçe istisna listesi, yeni kullanılamayan zaman aralıklarını yansıtacak şekilde güncellenmelidir. Yinelemenin kendisi değiştirilmemelidir.

Alanlar
time_range

TimeRange

İstisnanın zaman aralığı. Açık olan bu kapalı zaman aralığıyla çakışan yinelenme tarafından açıklanan tüm alanlar kullanılamaz olarak kabul edilir.

Örnek: Yineleme 20 dakika, 30 dakika tekrarlama_her 30 dakika, başlangıç_zamanı 9:00 ve 11:00'a kadar tekrar_tarihi belirtiyorsa, time_aralığı 9:45-11:00 olan bir ScheduleException 09:30-9:50 saatleri arasında 01:30-9:50 saatleri arasında kullanılamaz.

Zaman aralığı kapalı olduğu için 11:00'da başlayan aralığın etkilenmeyeceğini unutmayın.

SchedulingRuleOverrides

Müsaitlik durumu düzeyi planlama kuralları.

Alanlar
last_bookable_sec

int64

Bu alanın rezerve edilebileceği son zaman (saniye cinsinden). Bu zaman damgası, dikkate alınacak alanın başlangıç_saniyesinden önce olmalıdır (kullanıcıların başlangıç zamanından sonra rezervasyon yapabilmesi gerekiyorsa hizmet düzeyi SchedulingRules.min_booking_before_end_time) bölümünü kullanın. Mevcut olduğunda, karşılık gelen Hizmetin Planlama Kurallarının min_booking_buffer öğesinde belirtilen her şeyi geçersiz kılar.

first_bookable_sec

int64

Bu alanın ilk kez rezerve edilebileceği zaman (saniye cinsinden). Bu zaman damgası, alanın başlangıç_sec'inden veya belirtilmişse last_bookable_sec'ten önce olmalıdır.

last_online_cancellable_sec

int64

Ayarlanırsa bu randevu aralığının Google ile Rezervasyon üzerinden iptal edilebileceği son zaman (Unix döneminden bu yana, saniye cinsinden). Bu alan, hizmet düzeyindeki tüm iptal kurallarını geçersiz kılar. (isteğe bağlı)

BatchDeleteGenericRecordsRequest

Belirtilen feed türündeki kayıtları silmek için toplu istek.

Alanlar
parent

string

partners/{partner_id}/feeds/{feed_name} biçimindeki kaynak adı.

records[]

GenericDeleteRecord

Silinecek kayıtlar. Bir API çağrısında en fazla 1.000 kayda izin verilir.

BatchPushGenericRecordRequest

İstek URL'sinde belirtilen feed türündeki kayıtların eklenmesi ve/veya güncellenmesi için toplu istek.

Alanlar
parent

string

partners/{partner_id}/feeds/{feed_name} biçimindeki kaynak adı.

records[]

GenericRecord

Eklenecek ve/veya güncellenecek kayıtlar. Bir API çağrısında en fazla 1.000 kayda izin verilir.

BatchReplaceServiceAvailabilityRequest

Birden çok Service kullanılabilirlik slotunu değiştirmeye yönelik toplu istek.

Alanlar
parent

string

partners/{partner_id} biçimi.

extended_service_availability[]

ExtendedServiceAvailability

Mevcut kullanılabilirlik yuvalarının yerini almak için kullanılan genişletilmiş hizmet kullanılabilirliği.

BatchReplaceServiceAvailabilityResponse

Birden çok Service kullanılabilirlik slotunu değiştirmeye yönelik toplu yanıt. Bu mesaja yalnızca başarıyla güncellenen zaman aralıkları dahil edilecek

Alanlar
extended_service_availability[]

ExtendedServiceAvailability

Mevcut kullanılabilirlik yuvalarının yerini almak için kullanılan ve başarıyla güncellenen genişletilmiş hizmet kullanılabilirliği mesajları.

Rezervasyon

Envanter alanı için rezervasyon

Alanlar
name

string

Rezervasyonun kaynak adı: partners/{partner ID}/bookings/{booking ID}

merchant_id

string

Alan için satıcının kimliği

service_id

string

Satıcı hizmetinin kimliği

start_time

Timestamp

Toplantı aralığının başlangıç zamanı

duration

Duration

Toplantı aralığının süresi

client_information

ClientInformation

Randevuyu alan müşterinin kişisel bilgileri

status

BookingStatus

Rezervasyonun durumu

payment_information

PaymentInformation

Rezervasyonla ilgili ödeme işlemleri hakkında bilgiler.

party_size

int64

Rezervasyonun katılımcı sayısı

BookingFailure

Rezervasyonun işlenmesinin neden eşzamansız olarak başarısız olduğunu açıklayan durum verileri. ReservationFailure, öncelikle iş mantığı hatalarını yakalamak için tasarlanmıştır.

Alanlar
cause

Cause

Rezervasyonun başarısız olma nedeni. (zorunlu)

rejected_card_type

CreditCardType

(yalnızca neden PAYMENT_ERROR_CARD_TYPE_REJECTED ise gerekli)

description

string

Bu isteğe bağlı alan, iş ortağının yalnızca hata ayıklama amacıyla ek bilgiler içermesi için kullanılır. (isteğe bağlı)

payment_failure

PaymentFailureInformation

Ödeme hataları hakkında bilgi.

Neden

Hata nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanmayın; "bilinmeyen hata" anlamına gelir
SLOT_UNAVAILABLE Referans verilen müsaitlik durumu alanı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, belirtilen müsaitlik durumu aralığı için zaten randevu aldı.
LEASE_EXPIRED Kontratın (sağlanmışsa) süresi doldu ve artık istenen rezervasyonu tamamlamak için kullanılamaz.
OUTSIDE_CANCELLATION_WINDOW İstenen iptal işlemi, satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle şu anda gerçekleştirilemiyor.
PAYMENT_ERROR_CARD_TYPE_REJECTED Belirtilen kredi kartı türü satıcı tarafından kabul edilmediği için ödeme işlenirken bir hatayla karşılaşıldı. Kredi kartı türü reddedilen_kart_türü biçiminde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiği için ödeme işlenirken bir hatayla karşılaşıldı.
PAYMENT_OPTION_NOT_VALID Rezervasyon için ödeme yapmak üzere kullanılan paket/üyelik ile ilgili bir hata oluştu. Geçerli kullanım kalmamış olabilir, süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyonun ödemesi işlenirken bir hatayla karşılaşıldı. Ödemeyle ilgili genel bir hatayı belirtmek için bu değeri kullanın (yalnızca hatanın yukarıdaki belirli bir ödeme hatasıyla eşleşmemesi durumunda).
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı, belirtilen ödeme seçeneğini kullanamıyor (ör. ilk fiyatı ikinci kez kullanmaya çalışan kullanıcı).
BOOKING_ALREADY_CANCELLED Kullanıcının iptal etmeye çalıştığı bir rezervasyon zaten iptal edilmiş.
BOOKING_NOT_CANCELLABLE Kullanıcının iptal etmeye çalıştığı rezervasyonlar iptal edilemez.
OVERLAPPING_RESERVATION Kullanıcının bu saate çok yakın tarihli bir rezervasyonu var.
USER_OVER_BOOKING_LIMIT Kullanıcının, toplayıcının kullanıcı başına rezervasyon sınırını aşması nedeniyle rezervasyon yapılamadı.
PAYMENT_REQUIRES_3DS1

İşlemin tekrar denenmesini istediğiniz için ödemenin reddedildiği zamanı ayarlayın, ancak bu kez 3DS1 sorgulaması/yanıtı geçtikten sonra. Geçerli işlemin başarısız durumunun başarısız olarak kalacağını unutmayın. Yeniden deneme tamamen ayrı olacaktır.

Başarısızlık nedeni buysa payment_failure.3DS1_parameters'in ayarlanması ZORUNLUDUR. Aksi takdirde, mevcut neden PAYMENT_ERROR' olarak değerlendirilecektir.

PaymentFailureInformation

Ödeme hataları hakkında bilgi.

Alanlar
threeds1_parameters

ThreeDS1Parameters

Bir RwG toplayıcısı tarafından kullanıcıyla 3DS1 kimlik doğrulama protokolü başlatmak için kullanılan parametreler. ReservationFailure.cause PAYMENT_REQUIRES_3DS1 olarak ayarlanmadığı sürece yoksayılır.

ThreeDS1Parameters

RwG'yi isteyen parametreler, bir 3DS1 testi gerçekleştirebilir.

Parametreler, EMVCo'nun 3DS1 protokolüyle ilgili açıklaması tarafından ayarlanır.

Alanlar
acs_url

string

Kullanıcıya kimlik doğrulama için sunulacak formun yükleneceği URL.

pa_req

string

Ödeme Kimlik Doğrulaması İsteği. Sağlanırsa ACSUrl formunda yayınlanacaktır.

transaction_id

string

ACS sağlayıcısı tarafından kullanılan tanımlayıcı. Sağlanırsa ACSUrl formunda yayınlanacaktır.

md_merchant_data

string

Satıcı verileri. Sağlanırsa ACSUrl formunda yayınlanacaktır.

BookingStatus

Rezervasyonun durumu

Sıralamalar
BOOKING_STATUS_UNSPECIFIED Belirtilmedi.
CONFIRMED Rezervasyon onaylandı
PENDING_MERCHANT_CONFIRMATION Rezervasyonun ONAYLANDI durumuna geçmesi için satıcıdan onay bekleniyor (bu durum şu anda DESTEKLENMEZ)
PENDING_CLIENT_CONFIRMATION Rezervasyonun ONAYLANDI durumuna geçmesi için müşteriden onay bekleniyor (bu durum şu anda DESTEKLENMEZ)
CANCELED Rezervasyon, kullanıcı adına iptal edildi.
NO_SHOW Müşteri randevuya gelmedi
NO_SHOW_PENALIZED Müşteri, iptal politikasını ihlal eden randevuya katılmadı.
FAILED İşleme hatası nedeniyle rezervasyon tamamlanamadı.
DECLINED_BY_MERCHANT Rezervasyon satıcı tarafından eşzamansız olarak reddedildi.

CallMerchant

DesteklenmeyenPartySizeOption dahilinde kullanılacak boş mesaj. Bu mesaj ayarlandığında, kullanıcılara rezervasyon için işletmeyi telefonla arama seçeneği gösterilir.

CancellationPolicy

Bir hizmet için iptal politikası.

Alanlar
refund_condition[]

RefundCondition

Politikada sıfır veya daha fazla geri ödeme koşulu geçerli.

RefundCondition

Tek bir geri ödeme koşulu tanımlar. "Geri ödeme adımlarını" hizmetin başlangıç zamanından önceki çeşitli süreler olarak tanımlamak için birden çok geri ödeme koşulu birlikte kullanılabilir.

Alanlar
min_duration_before_start_time

Duration

Başlangıç zamanından önceki, müşterinin refund_percent içinde belirtilen hizmet maliyetinin bir kısmı için geri ödeme alabileceği zamana kadar geçen süre. 0 (varsayılan) değerine ayarlanırsa hizmet herhangi bir zamanda iptal edilebilir.

refund_percent

uint32

Hizmet rezervasyonu, hizmetin başlangıç zamanından en az min_duration_before_start_time önce iptal edildiği sürece geri ödenebilecek yüzde ([0, 100] aralığında). 0 (varsayılan) değerine ayarlandığında hizmet için geri ödeme yapılmaz. 100 olarak ayarlandığında bu hizmet için tamamen geri ödeme yapılabilir.

ClientInformation

Rezervasyon yapan kişiyle ilgili kişisel bilgiler

Alanlar
given_name

string

Müşterinin adı

family_name

string

Müşterinin soyadı

address

PostalAddress

Müşterinin adresi

telephone

string

Müşterinin telefon numarası

email

string

Müşterinin e-posta adresi

CreateMerchantRequest

Merchant oluşturma isteği.

Alanlar
parent

string

Bu satıcının sahibi olan iş ortağının partners/{partner_id} biçimindeki üst kaynak adı.

merchant_id

string

Bu satıcı için kullanılacak satıcı kimliği.

merchant

Merchant

Oluşturulacak satıcı.

CreateServiceRequest

Yeni bir Service oluşturma isteği.

Alanlar
parent

string

Bu hizmetin sahibi olan satıcı için partners/{partner_id}/merchants/{merchant_id} biçimindeki üst kaynak adı.

service_id

string

Bu hizmet için kullanılacak hizmet kimliği.

service

Service

Oluşturulacak hizmet.

CreditCardRestrictions

Bu satıcının kabul ettiği kredi kartı türleriyle ilgili kısıtlamalar.

Alanlar
credit_card_type[]

CreditCardType

Desteklenen kredi kartlarının listesi. Boş olması halinde hiçbir kredi kartı desteklenmez.

CreditCardType

Kredi kartı türü.

Sıralamalar
CREDIT_CARD_TYPE_UNSPECIFIED Kullanılmamış.
VISA Visa kredi kartı.
MASTERCARD Mastercard kredi kartı.
AMERICAN_EXPRESS American Express kredi kartı.
DISCOVER Discover kredi kartı.
JCB JCB kredi kartı.

DeleteMerchantRequest

Merchant silme isteği.

Alanlar
name

string

Silinecek satıcının kaynak adı. Partners/{partner_id}/merchants/{merchant_id} biçiminde

DeleteServiceRequest

Service silme isteği.

Alanlar
name

string

Silinecek hizmetin kaynak adı. partners/{partner_id}/merchants/{merchant_id}/services/{service_id} biçiminde

Ödeme

Kullanıcıdan ödeme alabileceği veya kredi kartını bloke eden bir depozito.

Alanlar
deposit

Price

Yatırılan tutar.

min_advance_cancellation_sec

int64

Depozito için minimum ön iptal.

deposit_type

PriceType

Ödemenin, stok durumuna göre nasıl belirleneceğini tanımlar.

DirectMerchantPayment

Kullanıcının, hizmet için RwG üzerinden ön ödeme yapmak yerine doğrudan satıcıya nasıl ödeme yapabileceği hakkında bilgi.

Alanlar
payment_methods[]

Text

Kullanıcılara yalnızca aşağıda belirtilen ödeme yöntemlerini kullanarak ödeme yapmaları önerilir.

DurationRange

Sınırlı veya sınırsız olabilecek bir süre aralığı için sarmalayıcı. min_duration ve max_duration süre değerlerinden en az biri gereklidir.

Alanlar
min_duration

Duration

Minimum süre.

max_duration

Duration

Maksimum süre.

ExtendedServiceAvailability

Kullanılabilirlik listesi ve kime/ne zaman uygulanacağını gösteren liste.

Alanlar
merchant_id

string

Bu, aşağıdaki stok durumu mesajlarının hangi satıcıya ait olduğunu belirtmek için zorunlu bir alandır.

service_id

string

Bu, aşağıdaki müsaitlik durumu mesajlarının hangi hizmete ait olduğunu belirtmek için zorunlu bir alandır.

start_time_restrict

Timestamp

Sağlanması durumunda, sağlanan Müsaitlik Durumu varlıklarının [start_time_restrict, end_time_restrict). Yani aşağıdaki koşul doğruysa mevcut tüm kullanılabilirlikler silinir:

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

Bir süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == duration_restrict

Resources_restrict mesajı ayarlanırsa koşul daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki kullanılabilirliğin tam bir güncellemesini sağlamak için kullanılır.

end_time_restrict ayarlanmadan bırakılırken start_time_restrict olarak ayarlanması, tüm zamanların start_time_restrict olacağı anlamına gelecek şekilde yorumlanır.

end_time_restrict

Timestamp

start_time_restrict ayarlanmadan bırakılırken end_time_restrict ayarlandığında end_time_restrict'a kadar olan tüm zamanlar yorumlanacak şekilde yorumlanır.

duration_restrict

Duration

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik durumuyla daha da kısıtlar.

resources_restrict

Resources

source_restrict'i ayarlamak, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.

availability[]

Availability

Yeni kullanılabilirlik listesi.

FeedStatistics

Yüklenen bir feed işlenirken elde edilen istatistikler.

Alanlar
new_items

int64

Bu feed tarafından yeni eklenen öğeler. Öğeler, feed'in türüne bağlı olarak satıcılar, hizmetler veya kullanılabilirlik slotları olabilir.

existing_items

int64

Gerektiğinde feed'deki daha yeni bilgilere göre güncellenen mevcut öğeler.

deleted_items

int64

Öğeler artık bu feed'de mevcut değil ve sonuç olarak kaldırıldı.

FeedStatus

Toplayıcının platformu tarafından yüklenen bir feed'in durumu.

Alanlar
name

string

Feed kaynağı adı (şu biçimdedir):

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

State

Bu feed'in işleme durumu.

error_details

string

Bu feed'i işleyemezsek daha fazla ayrıntı sağlayan, kullanıcıların okuyabileceği bir dize.

statistics

FeedStatistics

Bu yayına özel istatistikler.

Eyalet

Feed'in işleme durumunu belirten enum.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Kullanılmamış.
IN_PROGRESS Feed hâlâ işleniyor.
SUCCESS Feed başarıyla işlendi.
FAILURE Feed'i işlerken bir hatayla karşılaştık.

FoodOrderingMetadata

Yemek siparişi işlem bağlantılarıyla ilgili meta veriler.

Alanlar
fee_details[]

FeeDetails

Öğe toplamına ek olarak kullanıcıdan alınan ücretlerin ayrıntıları. Hizmet ücreti, teslimat ücreti gibi farklı ücret türleri için tekrarlanır.

advance_order_details

AdvanceOrderDetails

Gelişmiş sipariş desteği (önceden sipariş olarak da bilinir) ile ilgili ayrıntılar. Bu destek, kullanıcının şu andaki daha ileri bir saatte siparişlerini verebilmesine olanak tanır.

fulfillment_duration_options alanı. Sipariş onayından itibaren siparişin tamamlanma süresi. Teslimat siparişleri için, yemek teslim edilene kadar geçen süre. Gel-al siparişler için, yemek teslim alınmaya hazır olana kadar geçen süre. fulfillment_duration_options şunlardan yalnızca biri olabilir:
fulfillment_lead_time_duration

Duration

Sabit süre. Örneğin: 30 dakika.

fulfillment_lead_time_duration_range

DurationRange

Süre aralığıdır. Örnekler: * 30 dakikadan 45 dakikaya kadar * 30 dakikadan uzun * 50 dakikadan kısa

AdvanceOrderDetails

Önceden sipariş desteği için.

Alanlar
is_supported

bool

Önceden Sipariş olarak da bilinen Ön Siparişler destekleniyorsa doğru değerini alır. (zorunlu)

FeeDetails

Ücret ayrıntıları.

Alanlar
type

FeeType

Ücret türü. (zorunlu)

fee_amount

FeeAmount

Birim para birimi cinsinden ücret tutarı, alışveriş sepeti değerinin belirli bir yüzdesi veya her ikisinin bir kombinasyonu. (zorunlu)

FeeAmount

FeeAmount örnekleri: * Sabit ücret: 0 ABD doları (ücretsiz), 1,5 ABD doları ve %2,5-%2,5 ABD doları (minimum, %1,5) * Sabit ücret aralığı: 1,0 ABD doları (minimum), 3,0 ABD doları (maksimum), 5,0-6,0 ABD doları * Alışveriş sepeti boyutunun yüzdesi: %15,5, %10-20, %10 (minimum), %15 (maksimum) %15-%2,5 (maksimum) (%2,5-%5,5-%2,5)

Alanlar
cart_percentage

QuantitativeValue

Alışveriş sepeti değerinin yüzdesi cinsinden ücret. Bir aralığı (sınırlı ve sınırsız) veya sabit bir yüzdeyi destekler. Değer 0 ile 100 arasında olmalıdır. Örnekler: * Sabit %5,5 * En az %5,5 * En fazla %5,5 * %4,5 - %5,5

amount_options alanı. Parasal tutarı belirtme seçenekleri. amount_options şunlardan yalnızca biri olabilir:
amount

Money

Sabit tutar. Örneğin 3,5 TL.

amount_range

MoneyRange

Tutar aralığı. Örnekler: * 3,5 - 5,5 ABD doları * En az 3,5 ABD doları * En fazla 5,5 ABD doları

amount_unknown

bool

Bilinmeyen tutar.

FeeType

Ücret türü.

Sıralamalar
FEE_TYPE_UNSPECIFIED Ücret türü belirtilmedi.
DELIVERY Teslimat ücretleri için.
SERVICE Hizmet ücretleri için.

FulfillmentOption

Online sipariş işlemi bağlantısı için sipariş karşılama seçeneği.

Alanlar
fulfillment_type

FulfillmentType

Zorunlu. Sipariş karşılama türü.

available_day[]

AvailableDay

Zorunlu. Bu sipariş karşılama yönteminin kullanılabilir olduğu günlerin listesi (tercihen en az 2 gün).

fee_details

FeeDetails

Zorunlu. Sipariş karşılama yöntemi için ücret ayrıntıları.

minimum_order

Price

Zorunlu. İşlem bağlantısıyla ilişkili sipariş karşılama yöntemi için minimum sipariş.

AvailableDay

Gün düzeyinde kullanılabilirlik.

Alanlar
fulfillment_date

Date

Zorunlu. Sipariş karşılama yöntemi için kullanılabilir tarih. Satıcının saat diliminde olduğu varsayılmıştır.

last_ordering_time

Timestamp

Zorunlu. Unix zaman damgası. Bir kullanıcının fulfillment_date tarihine kadar sipariş verip öğe alabileceği en son zamandır. Başka bir deyişle, last_ordering_time tarihinden sonra, fulfillment_date artık müsait olarak gösterilmeyecek.

Örneğin, fulfillment_date 2020-08-10: - last_ordering_time değeri 2020-08-10 18:00 ise müşterinin 10.08.2020 tarihinde siparişini aynı gün saat 18.00'e kadar teslim etmesi gerekir. - last_ordering_time değerinin 2020-08-08 20:00 olması, siparişin 10.08.2020 tarihinde teslim edilmesi için müşterinin bu siparişi iki gün önce saat 20:00'ye kadar vermesi gerektiği anlamına gelir.

FeeDetails

İşlem bağlantısıyla ilişkili sipariş karşılama yönteminin ücret ayrıntıları.

Alanlar
fee_details alanı. Sipariş karşılama yöntemi için ücret modeli. fee_details şunlardan yalnızca biri olabilir:
no_fee

NoFee

Sipariş karşılama yöntemi için ücret alınmaz.

base_fee

MinimumFee

Sipariş karşılama yöntemiyle ilişkili temel ücret.

fixed_fee

FixedFee

Sipariş karşılama yöntemiyle ilişkili sabit ücret.

FixedFee

İşlem bağlantısıyla ilişkili sipariş karşılama yöntemi için gereken sabit ücret.

Alanlar
amount

Price

Zorunlu. Sipariş karşılama yöntemi için alınan sabit ücret tutarı.

FulfillmentType

Bir işlem bağlantısıyla ilişkili istek karşılama türü.

Sıralamalar
FULFILLMENT_TYPE_UNSPECIFIED Sipariş karşılama türü belirtilmedi.
FULFILLMENT_TYPE_DELIVERY Sipariş karşılama türü teslimattır.
FULFILLMENT_TYPE_PICKUP Sipariş karşılama türü teslim alma şeklindedir.

MinimumFee

İşlem bağlantısıyla ilişkili sipariş karşılama yöntemi için gereken minimum ücret.

Alanlar
base_fee_amount

Price

Zorunlu. Sipariş karşılama yöntemi için temel ücret tutarı.

NoFee

İşlem bağlantısıyla ilişkili sipariş karşılama yöntemi için ücret gerekmez.

GenericDeleteRecord

URL isteğinde belirtilen yayın türünden silinecek kayıt.

Alanlar
delete_time

Timestamp

Zorunlu. Bu zaman damgası, silme işleminin envantere uygulanacağı sırayı belirlemek için kullanılır.

record_type alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsülleyin. İş ortağı, bir kaydın feed'de veya BatchPush API'sinde sağlanma şekline benzer bir tam kayıt sağlayabilir. İş ortakları, bir kaydı benzersiz şekilde tanımlamak için gerekli olan yalnızca temel alanları ekleme seçeneğine de sahiptir. record_type şunlardan yalnızca biri olabilir:
data_record

bytes

Proto tabanlı olmayan feed'ler için.

proto_record

Any

Proto tabanlı feed'ler için.

GenericRecord

URL isteğinde belirtilen feed türünün kaydı.

Alanlar
generation_timestamp

Timestamp

Zorunlu. Bu zaman damgası, envanter güncellemelerinin doğru sıralanmasını sağlamak için kullanılır.

record_type alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsülleyin. record_type şunlardan yalnızca biri olabilir:
data_record

bytes

Proto tabanlı olmayan feed'ler için.

proto_record

Any

Proto tabanlı feed'ler için.

GeoCoordinates

Enlem, boylam ve adres de dahil olmak üzere bir konumun Coğrafi verileri.

Alanlar
latitude

double

Derece olarak enlem. (isteğe bağlı)

longitude

double

Derece cinsinden boylam. (isteğe bağlı)

addresses alanı. Bir konumun adresi yapılandırılmış veya yapılandırılmamış olabilir. addresses şunlardan yalnızca biri olabilir:
address

PostalAddress

Konumun posta adresi (tercih edilir).

unstructured_address

string

Yapılandırılmamış bir adres de yedek olarak sağlanabilir. Ör. "Cumhuriyet Caddesi, 80300 Beyoğlu, İstanbul"

GetMerchantStatusRequest

MerchantStatus alma isteği

Alanlar
name

string

Zorunlu. Partners/{partner_id}/merchants/{merchant_id}/status biçiminde kaynak adı.

GetStatusRequest

Toplayıcının platformu tarafından yüklenen belirli bir feed için Status alma isteği.

Alanlar
name

string

Feed kaynağı adı (şu biçimdedir):

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

HomeServiceData

Ev hizmetleri sektörü için sağlanması gereken ek bilgiler

Alanlar
category_type

string

Bu ev hizmetinin ait olduğu üst düzey kategori. Ör. tesisatçı, elektrikçi vb.

job_type

string

Söz konusu ev hizmetinin ait olduğu kategori altındaki iş türü. Örneğin unclog_drain, install_faucet, tesisatçı kategorisi altındaki iş türleridir.

IntegrationType

Entegrasyon derinliği desteklenir.

Sıralamalar
INTEGRATION_TYPE_UNSPECIFIED Varsayılan olarak END_TO_END değerine ayarlanır.
INTEGRATION_TYPE_END_TO_END Google üzerinden uçtan uca rezervasyona olanak tanıyan eksiksiz entegrasyon.
INTEGRATION_TYPE_INVENTORY_ONLY Rezervasyon sunucusunun bu hizmeti desteklemesi gerekmez. Yalnızca satıcılar, hizmetler ve (isteğe bağlı olarak) stok durumu verilerinin gönderilmesi gerekir.

InvalidateResourceRequest

Bir kaynağı geçersiz kılma isteği.

Alanlar
resource_id

string

Geçersiz kılınacak kaynağın adı.

Örneğin, teslim alma ile ilgili bir kaynağın adı partners/{partner_id}/pickups/{pickup_id} biçiminde olmalıdır. Uygulamalar, tanımlanan kaynağın önbelleğe alınmış sürümlerini kaldırmalıdır.

LineItem

Bir siparişteki tek bir öğe: tek bir hizmetin tek bir zaman diliminde rezerve edilmesi.

Alanlar
service_id

string

Satıcı Hizmetinin kimliği.

start_sec

int64

Unix sıfır zamanından itibaren UTC saatiyle saniye cinsinden toplantı aralığının başlangıç zamanı.

duration_sec

int64

Toplantı aralığının saniye cinsinden süresi.

tickets[]

OrderedTickets

Bilet Türüne göre sipariş edilen bilet sayısı.

price

Price

Bu Satır Öğesi'nin toplam fiyatı (vergiler hariç).

status

BookingStatus

Satır Öğesinin durumu.

OrderedTickets

Bilet Türüne göre sipariş edilen bilet sayısı.

Alanlar
ticket_id

string

Bilet Türünün Kimliği.

count

int32

Bu tür için sipariş edilen bilet sayısı.

ListMerchantStatusesRequest

MerchantStatus listesini alma isteği

Alanlar
parent

string

Zorunlu. Bu satıcı durumu koleksiyonunun sahibi olan üst öğe. Biçim: partners/{partner_id}/merchants

page_size

int32

Zorunlu. Döndürülecek maksimum öğe sayısı. Sunucunun sayfa boyutunu küçültebileceğini unutmayın.

page_token

string

İsteğe bağlı. Varsa önceki ListMerchantStatusResponse'tan döndürülen nextPageToken değeri.

booking_inventory_status_restrict

BookingInventoryStatus

İsteğe bağlı. Sonuçları rezervasyon envanteri durumuna göre filtrelemek için isteğe bağlı kısıtlama.

waitlist_inventory_status_restrict

WaitlistInventoryStatus

İsteğe bağlı. Sonuçları bekleme listesi envanter durumuna göre filtrelemek için isteğe bağlı kısıtlama.

geo_match_restrict

GeoMatchingStatus

İsteğe bağlı. Sonuçları Coğrafi eşleşme durumuna göre filtrelemek için isteğe bağlı kısıtlama.

BookingInventoryStatus

Uçtan uca rezervasyon envanteri durumu.

Sıralamalar
BOOKING_INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
NO_VALID_FUTURE_INVENTORY Satıcının sonraki 30 gün içinde rezervasyon envanteri yok.
HAS_VALID_FUTURE_INVENTORY Satıcının önümüzdeki 30 gün için envanteri rezerve etmesi var.

GeoMatchingStatus

Satıcı coğrafi eşleşme durumu.

Sıralamalar
GEO_MATCHING_STATUS_UNSPECIFIED Belirtilmedi.
GEO_UNMATCHED Satıcı coğrafi olarak eşleşmedi.
GEO_MATCHED Satıcı coğrafi olarak eşleşiyor.

WaitlistInventoryStatus

Uçtan uca bekleme listesi envanter durumu.

Sıralamalar
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
NO_VALID_WAITLIST_SERVICE Satıcının bekleme listesini destekleyen hizmet yok.
HAS_VALID_WAITLIST_SERVICE Satıcı, hizmeti destekleyen bir bekleme listesi var.

ListMerchantStatusesResponse

MerchantStatus listesine yanıt.

Alanlar
merchant_statuses[]

MerchantStatus

Filtre koşullarını karşılayan satıcı durumlarının listesi.

next_page_token

string

Sonraki sonuç sayfasını almak için jeton. Boşsa listede başka sonuç olmaz.

ListStatusRequest

Toplayıcının platformu tarafından yüklenen birden fazla feed için Status alma isteği.

Alanlar
name

string

Feed kaynağı adı (şu biçimdedir):

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

int32

Döndürülecek maksimum öğe sayısı.

page_token

string

Varsa önceki bir Liste isteğinden döndürülen next_page_token değeri.

state_restrict

State

Sonuçları feed durumuna göre filtrelemek için isteğe bağlı kısıtlama.

time_range_restrict

TimeRange

Sonuçları üst ve alt sınıra göre filtrelemek için isteğe bağlı kısıtlama. Start_time değeri ayarlanmazsa unix zamanının başlangıcı varsayılan olur. Bitiş_zamanı ayarlanmazsa varsayılan olarak şimdi olur.

ListStatusResponse

Toplayıcının platformu tarafından yüklenen birden fazla feed için Status alma isteği.

Alanlar
status[]

FeedStatus

Yüklenen feed'lerin kronolojik durumlarının ters kronolojik listesi. Döndürülen maksimum öğe sayısı, istekteki page_size alanına bağlıdır.

next_page_token

string

Sonraki sonuç sayfasını almak için jeton. Boşsa listede başka sonuç olmaz.

LocalizedString

Bir yerel ayardaki dize örneği.

Alanlar
locale

string

"en", "mas", "zh-Hant", "de-CH-1901" gibi IETF BCP 47 dil kodu. http://www.w3.org/International/articles/language-tags/ sayfasına göz atın.

value

string

Yukarıdaki yerel ayarda bulunan ileti (UTF-8).

Konum

Bir konumla ilgili coğrafi bilgiler.

Alanlar
place_id

string

Google Rehber veritabanındaki ve Google Haritalar'daki bir yerin Yer Kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresine bakın. Bu bilgi sağlanmışsa Google, konumu bu yerle eşleştirir.

name

string

Konumun adı, telefonu, URL'si ve coğrafi konumu, konumun Google Haritalar'da mevcut olan yerlerle eşleştirilmesini desteklemek için kullanılır.

Bu alan isteğe bağlıdır, ancak bazı bağlamlarda gerekli olabilir. Örneğin, adsız bir Service.location, aynı adreste bulunuyor olsa bile bir ticari işletmeyle eşleştirilmez. (isteğe bağlı)

telephone

string

Ülke ve alan kodları dahil olmak üzere konumun herkese açık telefon numarası, ör. +14567891234. (isteğe bağlı)

url

string

Konumun herkese açık web sitesinin URL'si. (isteğe bağlı)

geo

GeoCoordinates

Enlem, boylam ve adres de dahil olmak üzere konumun Coğrafya bilgileri. (isteğe bağlı)

location_type

LocationType

Konum türü (bu konum bir Hizmet için sağlandıysa sağlanmalıdır.)

location_id

string

Hizmet içindeki konumun benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konuma atıfta bulunmak için kullanılabilir. Örneğin, özel giriş formunda, teslim alma konumu seçeneklerini belirtmek için bir dizi konum kimliği kullanılabilir. Ayarlanırsa bu kimlik aynı hizmet içinde benzersiz olmalıdır. (isteğe bağlı)

LocationType

Bu konumun türü.

Sıralamalar
LOCATION_TYPE_UNSPECIFIED Konum türü belirtilmedi.
VISITED_LOCATION Bu hizmetin ziyaret ettiği konum.
START_LOCATION Bu hizmetin başladığı konum da MEETING_LOCATION görevi görür.
END_LOCATION Bu hizmetin sona erdiği konum.

Satıcı

Toplayıcının platformunda bulunan satıcı hakkında bilgiler.

Alanlar
name

string

partners/{partner_id}/merchants/{merchant_id} biçimindeki satıcı kaynağı adı.

merchant_name

string

merchant_name, telefon, url ve coğrafya bilgileri, iş ortağı envanterini hâlihazırda Google Haritalar'da bulunan satıcılarla eşleştirmeyi desteklemek için kullanılır. Bu bilgiler gösterilmez.

Satıcının adı.

telephone

string

Ülke ve alan kodları dahil olmak üzere satıcının herkese açık telefon numarası, ör. +14567891234.

url

string

Satıcının herkese açık web sitesinin URL'si.

geo

GeoCoordinates

Satıcının enlem, boylam ve adres gibi coğrafi konum bilgileri.

category

string

Toplayıcının platformundaki işletme kategorisi.

num_bookings_30d
(deprecated)

int64

Bu alan kullanımdan kaldırılmıştır.

tax_rate_basis_points
(deprecated)

uint32

Satıcının puan cinsinden vergi oranı (yüzde birin yüzde 100'ü). Örneğin, vergi oranı %7,5 ise bu alan 750 olarak ayarlanmalıdır.

Bu alan ayarlanmadan bırakılır veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, tam olarak Service.price tarafından belirtilen fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya bu vergilere dahil olduğu varsayılır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfır dışında bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, hizmet fiyatının yanı sıra burada sağlanan vergi oranı kullanılarak hesaplanan vergiyi de içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri), en yakın çift yuvarlama kullanılarak yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alan kullanımdan kaldırıldı. Lütfen bunun yerine tax_rate değerini kullanın.

tax_rate

TaxRate

Satıcının vergi oranı. Mevcutsa bu alan, kullanımdan kaldırılan tax_rate_basis_points alanını geçersiz kılar. Boş bir mesaj (tax_rate { }) uygulanan vergi oranını sıfır olarak ayarlar.

payment_restrictions

PaymentRestrictions

Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar. Bu alan ayarlanmazsa herhangi bir kısıtlamanın olmadığını varsayarız.

payment_option[]

PaymentOption

Bu satıcı için ödeme seçenekleri mevcut. Bu satıcı kapsamındaki hizmetler, izin verdikleri ödeme seçeneklerini ayrı ayrı sınırlandırabilecek.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Satıcının destek hizmeti varsa token atanmış ödeme işleyici için yapılandırma.

tokenization_config

TokenizationConfig

Satıcının destek hizmeti varsa token atanmış ödeme işleyici için yapılandırma.

terms

Terms

Google ile Rezervasyon üzerinden bir hizmet rezervasyonu yapıldığında kullanıcıya gösterilen, satıcının Şartlar ve Koşulları. Bunlara ek olarak, toplayıcı iş ortağının Şartlar ve Koşulları kullanıcıya her zaman gösterilir ve burada sunulmamalıdır.

brand_id

string

İş ortağı ilişkilendirmesini gösterirken kullanılacak tüketiciye dönük markayı tanımlayan opak bir dize. Bu alan, tüketiciye dönük birden fazla markaya sahip iş ortaklarının tüm markalar için aynı feed'de satıcılar sunmasını sağlar.

Markalar; ad, logo, Hizmet Şartları ve Gizlilik Politikası gibi tüketicilere yönelik özelliklerden oluşur.

Tüketicilere yönelik yalnızca bir iş ortağı markası varsa bu alanın ayarlanması gerekmez ve yoksayılabilir.

İş ortağı...

Tüketicilere yönelik birden fazla markanız yok mu? --> Bu alanı yoksay

Yapılandırılmış Birden Çok Markanız mı var?

  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

Dikkat: Çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. Bu alanı kullanmak isteyen bir iş ortağı, varsayılan marka dahil olmak üzere ayrı markalar yapılandırmak için öncelikle bizimle iletişime geçmelidir.

matching_hints

MerchantMatchingHints

Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olacak ipuçları. Not: Google, yukarıda sağlanan bilgileri kullanarak satıcıları Google Haritalar'daki yerlerle eşleştireceğinden çoğu iş ortağının bu alanı ayarlaması gerekmez. (isteğe bağlı)

service_attribute[]

ServiceAttribute

Bu Satıcı için Hizmetler'i açıklamak üzere kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı)

waitlist_advisement

Advisement

İsteğe bağlı. Belirli bir satıcıdan, Google ile Rezervasyon üzerinden bekleme listesine katılan kullanıcılar için genel öneriler. Önerideki bağımsız metin alanları 100 baytla sınırlı olmalıdır.

MerchantMatchingHints

Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olmak için kullanılan ipuçları.

Alanlar
place_id

string

Google Rehber veritabanındaki ve Google Haritalar'daki bir yerin Yer Kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresine bakın.

MerchantStatus

Google ile Rezervasyon platformundaki satıcının durumu.

Alanlar
name

string

partners/{partner_id}/merchants/{merchant_id}/status biçimindeki satıcı durumu kaynak adı

merchant_name

string

İş ortakları tarafından sağlanan satıcının adı.

input_geo_info

GeoCoordinates

İş ortakları, satıcının coğrafi bilgilerini sağladı.

processing_status

ProcessingStatus

Satıcının işlem durumu.

booking_status

BookingStatus

Uçtan uca rezervasyon entegrasyonuyla ilgili durum.

waitlist_status

WaitlistStatus

Bekleme listesi entegrasyonuyla ilgili durum.

geo_match

PlaceInfo

Bu satıcının eşleşen Coğrafi yeri. Satıcı coğrafyayla eşleşmemişse boştur.

local_services_match

LocalServicesMatchInfo

Bu satıcının Yerel Hizmet Reklamları eşleşmesi. Yerel hizmet satıcısı değilse veya herhangi bir sağlayıcıyla eşleşmezse boş olur.

direct_urls[]

DirectUrl

Geçerli satıcı envanterinin içeriğini gösterecek URL'lerin listesi. Bunun, envanterin gerçekten sunulmakta olduğunu ve URL'nin, herkese açık olanlardan farklı olabileceğini unutmayın.

BookingStatus

Uçtan uca rezervasyon entegrasyonuyla ilgili durum.

Alanlar
has_valid_future_inventory

bool

Satıcının sonraki 30 gün içinde envanteri varsa doğru değerini alır. Satıcıya gerçekten hizmet sunulacağını garanti etmez.

DirectUrl

Satıcıyı gösteren URL.

Alanlar
type

UrlType

Bu URL'nin türü.

url

string

Bu satıcıyı gösterebilecek URL.

UrlType

Görünen URL'nin türü.

Sıralamalar
URL_TYPE_UNSPECIFIED Belirtilmedi.
BOOKING Uçtan uca rezervasyon URL'si.
WAITLIST Uçtan uca bekleme listesi URL'si.
LOCAL_SERVICES Google Yerel Hizmetler URL'si.

LocalServicesMatchInfo

Google yerel hizmetler eşleşmesiyle ilgili bilgiler (yalnızca yerel hizmet satıcısı için ayarlanır).

Alanlar
matched_providers[]

MatchedProvider

Eşleşen servis sağlayıcılar. Bir satıcı, birden fazla servis sağlayıcıyla eşleştirilebilir.

MatchedProvider

Yerel hizmet sağlayıcısı.

Alanlar
customer_id

int64

Google yerel hizmetler harici müşteri kimliği.

categories[]

string

Yerel hizmet kategorileri (sektörler). Ör. "tesisatçı" ve "halı_temizliği".

PlaceInfo

Eşleşen bir yere ait bilgiler.

Alanlar
name

string

Yerin adı.

formatted_address

string

Yerel dilde biçimlendirilmiş adres.

place_id

string

Bu yerin Google yer kimliği. Google Haritalar URL'si oluşturmak veya yerle ilgili daha fazla ayrıntı getirmek için kullanılabilir. Örnek kullanım için https://developers.google.com/places/web-service/place-id adresine bakın.

ProcessingStatus

Satıcının işlem durumu.

Sıralamalar
PROCESSING_STATUS_UNSPECIFIED Durum belirtilmedi.
IN_PROGRESS Madden, satıcıyı aldı ancak işlemi hâlâ devam ediyor. Bu durumdaki satıcılar için başka durum bilgileri bulunmaz.
COMPLETED Satıcının diğer durumları hesaplandı.

WaitlistStatus

Bekleme listesi entegrasyonuyla ilgili durum.

Alanlar
has_valid_waitlist_service

bool

Satıcının bekleme listesi hizmeti varsa doğru değerini alır. Satıcıya gerçekten hizmet sunulacağını garanti etmez.

MoneyRange

Sınırlı veya sınırsız olabilecek bir parasal tutar aralığı için sarmalayıcı. min_amount ve max_amount değerlerinden en az biri gereklidir.

Alanlar
min_amount

Money

Minimum tutar.

max_amount

Money

Maksimum tutar.

NoShowFee

Kullanıcı rezervasyon yaptığında ancak rezervasyona ulaşmayan kullanıcılardan alınabilecek ücret.

Alanlar
fee

Price

Rezervasyonuna katılmadığı durumlarda kullanıcıdan alınabileceği tutar.

fee_type

PriceType

Ücretin müsaitlik durumuna göre nasıl belirleneceğini tanımlar.

Sipariş verin

Bir satıcıyla servis randevusu alma siparişi.

Alanlar
name

string

Siparişin kaynak adı: partners/{partner ID}/orders/{order ID}

client_information

ClientInformation

Siparişi veren müşterinin kişisel bilgileri.

payment_information

PaymentInformation

Siparişle ilgili ödeme işlemleri hakkında bilgiler.

merchant_id

string

Bu siparişteki tüm hizmetlerin ait olduğu satıcının kimliği.

item[]

LineItem

Bu siparişteki satır öğeleri.

OrderOnlineMetadata

Online sipariş işlemi bağlantısının meta verileri.

Alanlar
fulfillment_option[]

FulfillmentOption

Online sipariş işlemi bağlantısı için kullanılabilir sipariş karşılama seçenekleri.

PaymentInformation

Rezervasyonla ilgili ödeme ayrıntıları

Alanlar
prepayment_status

PrepaymentStatus

Rezervasyonun ön ödeme durumu. prepayment_status PREPAYMENT_PROVIDED veya PREPAYMENT_REFUNDED ise payment_transaction_id ilişkili benzersiz işlem kimliğini içerir.

payment_transaction_id

string

Rezervasyonla ilişkilendirilen ödeme işleminin benzersiz tanımlayıcısı. Geçerli değilse boştur.

PaymentOption

Satıcı tarafından sağlanan hizmetler için ödeme yapmak üzere kullanılabilen bir ödeme seçeneği. Ödeme seçenekleri birden çok satıcı (ör. aynı zincire ait satıcılar) arasında paylaşılabilir.

Alanlar
payment_option_id

string

Bu kimlik, bu ödeme seçeneğini tanımlamak için kullanılır.

Bu kimlik, toplayıcının tamamı için geçerlidir. Bir değerin birden fazla satıcıda yeniden kullanılması, kullanıcının ilgili satıcılar genelinde ilgili ödeme seçeneğiyle ödeme yapmasına olanak tanır.

Bir kimliği birden çok satıcı için yeniden kullanırken, bir satıcı altındaki ödeme seçeneğinin değeri güncellendiğinde farklı bir satıcı altında aynı kimliğe sahip diğer tüm ödeme seçenekleri de güncellenir. Bu nedenle, zarar verici davranış olasılığından kaçınmak için tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlere güncellenmesi önerilir.

name

string

Ödeme seçeneğinin adı. Bu öğe, kullanıcılar tarafından görülebilir.

description

string

Ödeme seçeneğinin açıklaması. Bu öğe, kullanıcılar tarafından görülebilir.

price

Price

Ödeme seçeneğinin fiyatı.

tax_rate

TaxRate

Bu ödeme seçeneği için vergi oranı. Mevcutsa bu alan, Satıcı veya Hizmet'te bulunan tax_rate alanını geçersiz kılar. Boş bir mesaj (tax_rate { }) uygulanan vergi oranını sıfır olarak ayarlar.

payment_option_type

PaymentOptionType

Bu ödeme seçeneğinin türü. Üyelikler için tek kullanım, paketler için çok kullanım ve üyelikler için sınırsız.

session_count

int64

Bu ödeme seçeneğinin kaç oturum için kullanılabileceği. Yalnızca, değerin > 1 olması gereken çoklu oturum / paketler için geçerlidir.

purchase_interval

TimeRange

Ödeme seçeneği bu zaman aralığında satın alınabilir.

valid_interval

TimeRange

Ödeme seçeneği bu zaman aralığında kullanılabilir (ör. Ocak 2017 için özel fiyat). Mevcut olduğunda bu, valid_duration ve activity_type değerlerini geçersiz kılar.

valid_duration

Duration

Ödeme seçeneğinin geçerlilik süresi (ör. 30 günlük üyelik).

activation_type

ActivationType

Bu ödeme seçeneği için geçerlilik başlangıç tarihinin nasıl belirlendiğini tanımlar.

user_restriction

UserPurchaseRestriction

Bu ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar. Bir kullanıcı alt kümesiyle promosyon ödeme seçeneğini kısıtlamak için kullanılabilir. Politika ayarlanmazsa tüm kullanıcılar uygun olur.

ActivationType

Geçerlilik başlangıç tarihinin nasıl belirlendiğini tanımlar.

Sıralamalar
ACTIVATION_TYPE_UNSPECIFIED Kullanılmamış.
ACTIVATION_ON_PURCHASE Geçerlilik süresi, satın alma işlemi gerçekleştiğinde başlar.
ACTIVATION_ON_FIRST_USE Geçerlilik süresi, ödeme seçeneği ilk kez kullanıldığında başlar.

PaymentOptionType

Ödeme seçeneği türü.

Sıralamalar
PAYMENT_OPTION_TYPE_UNSPECIFIED Kullanılmamış.
PAYMENT_OPTION_SINGLE_USE Ödeme seçeneği yalnızca bir kez kullanılabilir.
PAYMENT_OPTION_MULTI_USE Oturum sayısı 0'dan büyükse ödeme seçeneği kullanılabilir.
PAYMENT_OPTION_UNLIMITED Ödeme seçeneği, geçerli zaman aralığında kullanılabilir; oturum sayısı geçerli değildir.

PaymentProcessorConfig

Ödeme işleyiciye yönelik bir yapılandırma ve her satıcı için ayrı ayrı ayarlanır.

Alanlar
processor

Processor

Bu yapılandırmanın geçerli olduğu ödeme işleyici iş ortağını tanımlar.

public_key

string

Bu satıcıyı ödeme işleyiciyle tanımlamak için kullanılan anahtar.

Stripe için https://stripe.com/docs/dashboard#api-keys sayfasına bakın. Braintree için https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

Ödeme istekleriyle birlikte ödeme işleyiciye gönderilen API sürüm numarası.

İşlemci

Belirli bir ödeme işleyici iş ortağı tanımlar.

Sıralamalar
PROCESSOR_UNSPECIFIED Kullanılmamış
PROCESSOR_STRIPE Stripe ile ödemelere yönelik bir yapılandırma.
PROCESSOR_BRAINTREE Braintree ile ödemeler için bir yapılandırma.

PaymentRestrictions

Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar.

Alanlar
credit_card_restrictions

CreditCardRestrictions

Bu satıcının kabul ettiği kredi kartlarıyla ilgili kısıtlamalar. Bu alan ayarlanmazsa tüm kredi kartlarının kabul edildiğini varsayıyoruz. CreditCardType tarafından desteklenen kart listesinin zamanla artacağını unutmayın. Bu alanı boş bırakırsanız gelecekteki değişiklikler için yapılandırma söz konusu olur.

PerOrderFee

Bilet sayısı ne olursa olsun sipariş başına bir kez ödenmesi gereken ücretlerdir.

Alanlar
delivery_fee

Price

Yayınlanma yöntemine göre değişebilen ücret.

processing_fee

Price

Kullanıcının ödeme yönteminin işlenmesi için alınan ücret.

PerTicketFee

Kullanıcının satın aldığı her bilet için ödenmesi gereken ücretlerdir.

Alanlar
service_charge

Price

Bir hizmet için alınan ek ücret.

facility_fee

Price

Mekana/tesis için ödenen ücret.

taxes

Price

Bilet vergileri başına.

PostalAddress

Bir müşterinin veya işletmenin adresi.

Alanlar
address_country

string

ISO 3166-1 alpha-2 ülke kodu kullanılarak belirtilen ülke, ör. "US" (zorunlu)

address_locality

string

Konum, ör. "Mountain View". (zorunlu)

address_region

string

Bölge, ör. "CA". Bu alan yalnızca, bölgenin genellikle adresin bir parçası olduğu ülkelerde gereklidir. (isteğe bağlı)

postal_code

string

Posta kodu, ör. "94043". (zorunlu)

street_address

string

Açık adres, ör. "1600 Amphitheatre Pkwy". (zorunlu)

PrepaymentStatus

Rezervasyonun ön ödeme durumu.

Sıralamalar
PREPAYMENT_STATUS_UNSPECIFIED Belirtilmedi, varsayılan olarak PREPAYMENT_NOT_PROVIDED değerine ayarlanır.
PREPAYMENT_PROVIDED Rezervasyon ücreti önceden ödendi.
PREPAYMENT_NOT_PROVIDED Rezervasyon ücreti önceden ödenmedi.
PREPAYMENT_REFUNDED Bu ücret daha önce PREPAYMENT_PROVIDED idi, ancak şimdi geri ödendi.

Fiyat

Hizmetin veya ücretin fiyatı.

Alanlar
price_micros

int64

Para biriminin mikro birimleri cinsinden fiyat. En küçük para biriminin kesirleri, en yakın çift yuvarlama kullanılarak yuvarlanır. (ör. 2,5 sentin 2 sente yuvarlanması, 3,5 sentin 4 sente, 0,5 sentin 0 sente yuvarlanması, 2,51 sentin 3 sente yuvarlanması).

currency_code

string

ISO 4217'de tanımlanmış fiyatın para birimi.

pricing_option_tag

string

Genişletilmiş fiyatla ilişkili fiyatlandırma seçeneğini tanımlayan isteğe bağlı ve opak bir dize.

PriceInterpretation

Fiyatın nasıl yorumlanması ve kullanıcıya gösterilmesi gerektiğini açıklar.

Sıralamalar
PRICE_INTERPRETATION_UNSPECIFIED Fiyat yorumlanması belirtilmemiş, varsayılan olarak EXACT_AMOUNT değeri kullanılacak.
EXACT_AMOUNT

Fiyatın belirli bir değer olarak yorumlanması gereken zaman.

Örnek: yoga dersi için 20 lira, çocuk saç kesimi için 15 lira

STARTS_AT

Bir hizmetin fiyatı değişken olmasına rağmen minimum fiyatın bilinip tüketicilere gösterildiği durumlarda. Tüketiciler fiyatı artıran seçimler yapabilir.

Bu PriceReviewation'ı kullanan tüm hizmetlerin PrepaymentType'ı NOT_SUPPORTED kullanması gerektiğini unutmayın.

Örnekler: Köpek kuaförü için 30 TL, ancak ek tüketici seçenekleri fiyatı artırabilir

NOT_DISPLAYED

Bir hizmetin fiyatı değişken olduğunda ve tüketicilere önceden fiyat bilgisi gösterilmediğinde

Bu PriceReviewation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED operatörünü kullanması ve Fiyat'ın boş bırakılması gerektiğini unutmayın.

Örnekler: ev hizmetleri danışmanlığı

PriceType

Toplam fiyatın stok durumuna göre nasıl belirleneceğini tanımlar.

Sıralamalar
FIXED_RATE_DEFAULT

Fiyat sabit bir tutardır. Alan ayarlanmazsa bu varsayılan değerdir.

Örnekler: Masa rezerve etmek için 50 ABD doları depozito, yoga dersi için 20 ABD doları rezervasyonu kullanmama ücreti

PER_PERSON

Belirtilen fiyat kişi başınadır. Toplam fiyat, Kaynaklar'da price_micros * party_size şeklinde belirtilen grup büyüklüğüne göre hesaplanır. Kullanılabilirlik kaynaklarında PER_PERSON fiyatına bir grup büyüklüğü eşlik etmelidir. Aksi takdirde bir grup büyüklüğü kullanılır.

Örnek: müze biletlerinin her biri için 10 ABD doları

QuantitativeValue

Aralık veya sabit değer olabilecek sayısal bir değer için sarmalayıcı. QuantitativeValue örnekleri: * Tekil değer: value: 10.5 * Sınırlı aralık: value_range {min_value: 5.5, max_value 10.5} * Alt sınır: value_range {min_value: 5.5} * Üst sınır: value_range {max_value: 10.5}

Alanlar
value_options alanı. (zorunlu) value_options şunlardan yalnızca biri olabilir:
value

double

Tekil bir değerdir. Örneğin: 5.6

value_range

RangeValue

Açık uçlu veya sınırlı olabilecek değer aralığı. Örnekler: * En az 5,5 * En fazla 5,5 * 5,5 - 6,5

RangeValue

min_value < max_value gibi değer aralığı. En az bir min_value ve max_value gerektirir.

Alanlar
min_value

double

Minimum değer.

max_value

double

Maksimum değer.

Derecelendirme

Bir varlık için Derecelendirme'yi tanımlar.

Alanlar
value

double

Ortalama puan değeri (number_of_ratings > 0 olduğunda gereklidir). Değer [1, 5] aralığında olmalıdır ve yalnızca derecelendirme_sayısı sıfır olduğunda atlanabilir.

number_of_ratings

uint64

Değerin hesaplanmasında kullanılan puan sayısı (zorunlu).

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, son kullanıcılara doğru şekilde gösterildiklerinden emin olmak için bu medyaları tarar. (isteğe bağlı)

Alanlar
url

string

Bu medya kaynağının URL'si. Google bu URL'de barındırılan medyayı tarar.

type

MediaType

Bu medya kaynağının türü.

localized_caption

Text

i18n'i destekleyen medyanın altyazısı, yalnızca düz metin desteklenir. Tüm HTML bileşenleri çıkarılacaktır. (isteğe bağlı)

attribution

Attribution

Medya kaynağıyla ilgili atıf bilgileri. İlişkilendirmenin, fotoğrafçıya veya ajansa atıfta bulunmak için medyayla birlikte görüntülenmesi gerekiyorsa bu alanın ayarlanması gerektiğini unutmayın. (isteğe bağlı)

caption
(deprecated)

string

Kullanımdan kaldırıldı, localized_caption kullanılması tercih edilir.

İlişkilendirme

Bu medyayla ilgili ilişkilendirme bilgileri.

Alanlar
localized_text

Text

i18n'yi destekleyen fotoğrafçıya veya ajansa atıfta bulunulacak metin. Bu metin, kaynak medya ile birlikte görüntülenir. Bu alan için yalnızca düz metnin desteklendiğini, tüm HTML bileşenlerinin çıkarılacağını unutmayın (köprü tabanlı ilişkilendirme desteklenmez).

text
(deprecated)

string

Kullanımdan kaldırıldı, localized_text'i kullanmayı tercih edin.

MediaType

Bu medya kaynağının türünü belirtmek için numaralandırma. Yalnızca fotoğraflar desteklenir. Fotoğrafların dışında başka medyaların da desteklenmesi gerekiyorsa lütfen Google ile Rezervasyon ekibiyle iletişime geçin.

Sıralamalar
TYPE_UNSPECIFIED Kullanılmamış.
PHOTO URL tarafından sağlanan medyanın bir fotoğraf olduğunu belirtir.

ReplaceServiceAvailabilityRequest

Bir Service müsaitlik durumunu değiştirme isteği.

Alanlar
service_availability

ServiceAvailability

Mevcut özelliklerin yerine kullanılan hizmet kullanılabilirliği.

RequireCreditCard

Randevu almak için kredi kartı gerekip gerekmediğini tanımlar.

Sıralamalar
REQUIRE_CREDIT_CARD_UNSPECIFIED Kredi kartı gereksinimi açık bir şekilde belirtilmemiştir ve davranış, KOŞULLAR için belirtilenle aynıdır.
REQUIRE_CREDIT_CARD_CONDITIONAL Google, şu koşullardan herhangi biri karşılanırsa rezervasyon için kredi kartı talep eder: * müsaitlik durumunun bir fiyatı varsa ve prepayment_type GEREKLİ * no_show_fee ayarlanmış * * depozito alanı ayarlanmıştır.
REQUIRE_CREDIT_CARD_ALWAYS Bu müsaitlik durumu randevusu almak için diğer alan değerlerinden bağımsız olarak her zaman kredi kartı gereklidir.

Kaynaklar

Hizmetin bir parçası olan farklı personel veya odalar olduğunda kaynak, kullanılabilirlik aralıklarını birbirinden ayırmak için kullanılır. Aynı hizmet ve zaman aralığı için birden fazla slot, kaynakları farklı olduğunda bir arada bulunabilir.

Alanlar
staff_id

string

Hizmeti sağlayan personelin isteğe bağlı kimliği. Bu alan; tüm satıcılar, hizmetler ve stok durumu kayıtları genelinde personel üyesini tanımlar. Ayrıca eski rezervasyonlarla ilişki kurulabilmesi için ücretin zaman içinde sabit kalması gerekir. personel_adı mevcutsa bu alanın gösterilmesi gerekir.

staff_name

string

Hizmeti sağlayan personelin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine, insanlar tarafından okunabilir olmalıdır. personel_kimliği varsa bu alan da mevcut olmalıdır.

room_id

string

Hizmetin bulunduğu oda için isteğe bağlı bir kimlik. Bu alan; odayı tüm satıcılar, hizmetler ve müsaitlik durumu kayıtları genelinde tanımlar. Ayrıca eski rezervasyonlarla ilişki kurulabilmesi için ücretin zaman içinde sabit kalması gerekir. Room_name mevcutsa bu alan da mevcut olmalıdır.

room_name

string

Hizmetin bulunduğu oda için isteğe bağlı bir ad. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine, insanlar tarafından okunabilir olmalıdır. (isteğe bağlı ancak oda_kimliği mevcutsa gereklidir) Yemek odası adı, yalnızca bar veya veranda gibi oturma alanları için kullanılmalıdır. Sabit fiyatlı menüler, özel etkinlikler veya oda harici diğer değerler (rezervasyon ya da akşam yemeği gibi) için kullanılmamalıdır. Varsayılan oturma alanının kendisiyle ilişkilendirilmiş bir oda olmaması önemle tavsiye edilir.

party_size

int32

Yalnızca Akşam Yemeği için geçerlidir: Bu zaman aralığında konaklayabilecek kişi sayısı. Bir restoran, aynı anda birden fazla Slot ile ilişkilendirilebilir. Bu Slot'ların her biri farklı bir group_size belirtir (örneğin, 2, 3 veya 4 kişi bir rezervasyonda oturabilirse).

SchedulingRules

Bir hizmetin zamanlama kuralları.

Alanlar
min_advance_online_canceling

int64

Alınmış bir randevuyu internetten iptal etmek için saniye cinsinden gereken minimum ön bildirim. (isteğe bağlı)

late_cancellation_fee
(deprecated)

Price

Minimum ön bildirim süresi içinde yapılan iptal ücreti.

noshow_fee
(deprecated)

Price

İptal etmeden katılmama ücreti.

admission_policy

AdmissionPolicy

Bu hizmet için geçerli olan giriş politikası. Politika ayarlanmazsa varsayılan olarak TIME_STRICT olur. (isteğe bağlı)

cancellation_policy

CancellationPolicy

Planlama kuralları iptal politikası. (Yapılacaklar için gereklidir)

min_booking_buffer alanı. Son rezervasyonun yapılabileceği andan müsaitlik durumunun başladığı veya bittiği ana kadar geçen süre (saniye cinsinden).

"min_advance_booking" ayarlandıysa son rezervasyon zamanı şu şekilde hesaplanır: (<slot start time> - "min_advance_booking"). "min_booking_buffer_before_end_time" ayarlandıysa son rezervasyon zamanı şu şekilde hesaplanır: (<slot bitiş zamanı> - "min_booking_buffer_before_end_time"). "min_booking_buffer_before_end_time" değerinin ayarlanması durumunda pozitif olması gerektiğini unutmayın. İkisi de ayarlanmadan bırakılırsa alan, zaman aralığının başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanırsa yalnızca bir değer seçilirken diğer değer yoksayılır. Hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz.

Örnekler:

  • Başlangıç zamanından en az 1 saat önce rezerve edilmesi gereken bir saç kesimi. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Son biletin kapanıştan 30 dakika önce satın alınabileceği müze: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

  • Başlangıç zamanından önce satın alınması gereken bir sinema bileti. "scheduling_rules{ ...}' (bu alanı boş bırakın) (isteğe bağlı) min_booking_buffer aşağıdakilerden yalnızca biri olabilir:

min_advance_booking

int64

Son rezervasyonun yapılabileceği andan müsaitlik durumunun başladığı ana kadar geçen süre (saniye cinsinden).

min_booking_buffer_before_end_time

int64

Son rezervasyonun yapıldığı andan müsaitlik durumunun sona erdiği ana kadar geçen süre (saniye cinsinden). Bu alan ayarlanırsa kullanıcıların satın alınan biletleri, slotlar başladıktan sonra kullanabileceklerini belirtmek için "admission_policy" alanı TIME_FLEXIBLE olarak ayarlanmalıdır.

AdmissionPolicy

Bu hizmete giriş politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmamış.
TIME_STRICT Müsaitlik durumu aralığının başlangıç zamanında müşterilerin hazır bulunması ve hizmetin slotun bitiş zamanında tamamlanması beklenir. TIME_STRICT kullanım alanına örnekler: * 09:00'da başlayan ve tüm katılımcıların başlangıç saatinde gelmesi gereken ve 12:00 civarında geri dönen bir tur. * Cumartesi günü saat 15:00'te yapılması yaklaşık 30 dakika sürecek bir saç kesimi rezervasyonu. * 18:00-20:00 arasında fitness dersi.
TIME_FLEXIBLE

Müşteriler, bu rezervasyonu kullanmak için müsaitlik durumunun başlangıç ve bitiş zamanı arasında herhangi bir zamanda gelebilir.

TIME_FLEXIBLE kullanım alanına örnekler: * Müze bileti, satın alma tarihinde herhangi bir zamanda kullanılabilir. * 12:00 ile 21:00 saatleri arasında kullanılabilen lunaparka öğleden sonra girişi.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Müşterilerin, müsaitlik durumunun başlangıç zamanında satıcıya ulaşması gerekir ancak diledikleri zaman ayrılabilirler.

Örneğin, müzeye giriş senaryosunda, 10:00 için süreli bir giriş bileti, kullanıcının gece 10'da müzede olmasını gerektirir. Bu hizmet için kullanılabilirlik aralıklarının başlangıç zamanı, belirlenen giriş zamanını temsil eder. Bununla birlikte, bitiş zamanı yalnızca rezervasyon için müsaitlik durumunu tanımlamak üzere bir anahtar olarak kullanılır.

Hizmet

Satıcı tarafından sağlanan hizmetle ilgili bilgiler (ör. saç kesimi).

Alanlar
name

string

partners/{partner_id}/merchants/{merchant_id}/services/{service_id} biçimindeki hizmet kaynağı adı.

service_name

string

Hizmetin adı; ör. "Erkek saç kesimi". Kullanımdan kaldırıldı, bunun yerine localized_service_name kullanın.

localized_service_name

Text

Hizmetin adı; ör. "Erkek saç kesimi". Muhtemelen birkaç yerel ayarda.

description

string

Hizmetin kullanıcılar tarafından görülebilen açıklaması. Kullanımdan kaldırıldı, bunun yerine localized_description kullanın.

localized_description

Text

Hizmetin kullanıcılar tarafından görülebilen açıklaması.

Bu alan hem düz metin hem de HTML benzeri biçimlendirmeyi destekler. Düz metin bölümlerinden farklı olarak burada başlıklar, paragraflar, listeler ve bazı kelime öbeği etiketleri kullanılarak özelleştirilmiş düzenler oluşturulabilir. En iyi kullanıcı deneyimini oluşturduğunuzdan emin olmak için lütfen aşağıdaki talimatları ve notları dikkatlice okuyun.

Desteklenen HTML benzeri biçimlendirme etiketleri:

Başlık etiketleri: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Başlık etiketleri, başlıkları ve alt başlıkları görüntülemek için kullanılabilir. Örneğin, <h1>Seyahat planı</h1> satır içi metni bölümün en önemli başlığı olarak gösterir. Tüm iç HTML etiketlerinin, stillerinin veya özelliklerinin yok sayılacağını unutmayın. Örneğin, <h1 style="..">, <h1> ile aynı şekilde ele alınır. Yalnızca sade metin korunur.

Paragraf etiketi: <p>
Paragraf etiketi, ayrıntılı bir tanıtımı veya içerikleri vurgulamak için kullanılabilir. Tüm iç etiketler, stiller veya özellikler, birkaç istisna dışında yok sayılır: <br>, <strong> ve <em>. Daha fazla ayrıntı için lütfen aşağıdaki kelime öbeği etiketi bölümüne bakın.

Liste etiketleri: <ul>, <ol>, <li>
<ul> etiketi, sıralanmamış listeleri görüntülemek için <li> etiketiyle, sıralı listeleri görüntülemek için <ol> etiketi <li> ile kullanılabilir. Bu, kontrol listelerini, zaman çizelgelerini veya kullanım alanınıza uyan diğer listeleri görüntülemenin iyi bir yoludur.
Örnek: Gemi seyahati ile ilgili özelliklerin listesini göstermek için:
<ol>
<li>Muhteşem okyanus manzarası ve vahşi yaşamla oynama şansı.</li>
<li>Özenle tasarlanmış seyahat düzenlemeleri ve hizmetleri.</li>
<li>En düşük fiyat garantisi.</li>
</ol>
Yalnızca <li> <ul> etiketi altındaki veya <ol> etiketi altındaki çocukların dönüştürüleceğini unutmayın. Diğer tüm alt öğeler atlanacak. Ayrıca, tüm iç etiketler, özellikler ve stiller dikkate alınmaz. Yalnızca metin içerikleri korunur.

Bölme etiketi: <div>
<div> etiketinin desteklenen tüm iç etiketleri, yukarıda belirtilen kurallarla ayrıştırılır. <div> etiketinin kendisinin burada herhangi bir gruplandırma veya girinti anlamına gelmediği ima edilir. Ayrıca, tüm iç özellikler ve stiller dikkate alınmaz.

Sıralı etiketler: <br>, <strong>, <em>:
Yalnızca yukarıda belirtilen üç etiket desteklenir. <br>, paragraflardaki satırları ayırmak için, önemli metni vurgulamak için de <strong>/<em> kullanılabilir. Diğer tüm kelime öbeği etiketleri yoksayılır.

Desteklenmeyen etiketler:

  • <html>, <header> ve <body> etiketlerine izin verilmez.
  • Yukarıda belirtilmeyen diğer etiketler (örneğin <table>, <td> ...) desteklenmez.
    Tüm URL'ler, bağlantılar ve bağlantılar kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez. Zengin bir kullanıcı deneyimi oluşturmak için fotoğrafları kullanmak istiyorsanız fotoğraf URL'lerinizi göndermek için lütfen aşağıdaki "related_media" alanını kullanın.

Önemli notlar:

  • Yukarıda belirtilen desteklenenler dışında başka etiketleri kullanmamaya çalışın. Aksi halde, desteklenmeyen etiketlerin içerdiği içerikler kaldırılır ve bu durum istenmeyen bir kullanıcı deneyimine yol açabilir.
  • 3'ten fazla farklı başlık düzeyi veya iç içe listeler gibi iç içe yerleştirilmiş derin yapılar kullanmaktan kaçının. Yapının düz, basit ve sade olması daha iyi bir kullanıcı deneyimi sunmaya yardımcı olur.
  • Şu anda desteklenen düzenler kullanım alanlarınız için yeterli değilse lütfen Google ile Rezervasyon ekibine ulaşın.
  • Önerilen maksimum boyut 32.000 karakterdir.
price

Price

Hizmetin fiyatı.

price_interpretation

PriceInterpretation

Fiyatın nasıl yorumlandığını ve kullanıcıya nasıl gösterildiğini açıklar. Hizmet fiyatının nasıl görüneceğini yapılandırmak için Yemek ve Yapılacaklar hariç herhangi bir sektör tarafından kullanılabilir.

rules

SchedulingRules

Randevu alma/iptal etme kuralları.

prepayment_type

PrepaymentType

Ön ödemenin zorunlu veya isteğe bağlı olup olmadığı.

prepayment_terms

PrepaymentTerms

Ön ödemenin ne zaman tamamlandığıyla ilgili şartlar.

form[]
(deprecated)

ServiceIntakeForm

Kullanımdan kaldırıldı. Lütfen intake_form ve per_ticket_intake_form özelliklerini kullanın.

intake_form

ServiceIntakeForm

Bu hizmet için rezervasyon yaparken kullanıcıdan ek bilgi isteyen bir form. (isteğe bağlı)

per_ticket_intake_form

ServiceIntakeForm

Bu hizmet için rezervasyon yaparken kullanıcıdan ek bilgi isteyen bir form. Bu form, kullanıcının rezervasyon yaptığı her bilet için bir kez doldurulmalıdır. (isteğe bağlı)

tax_rate

TaxRate

Hizmetin vergi oranı. Mevcut olduğunda bu alan, satıcı düzeyinde belirlenen tax_rate'i geçersiz kılar. Boş bir mesaj (tax_rate { }) uygulanan vergi oranını sıfır olarak ayarlar.

payment_option_id[]

string

Bu hizmet için ödeme yaparken kullanılabilecek ödeme seçeneklerini belirten kimliklerin listesi. Gerçek ödeme seçenekleri, Satıcı düzeyinde tanımlanır ve birden çok Satıcı arasında da paylaşılabilir.

deposit

Deposit

Kullanıcıdan depozitonun nasıl tahsil edilebileceğini tanımlar. Belirtilmişse hizmet ödemesini geçersiz kılar. Bunun boş bir Depozito mesajı olarak ayarlanması, hizmet düzeyindeki tüm ödemelerin kaldırılmasına neden olur. (isteğe bağlı)

no_show_fee

NoShowFee

Kullanıcıdan alınabilecek rezervasyonu kullanmama ücretini tanımlar. Belirtilmiş olması halinde hizmetin rezervasyonu kullanmama ücretini geçersiz kılar. Bu değer boş bir NoShowFee mesajı olarak ayarlanırsa hizmet düzeyindeki tüm rezervasyonu kullanmama ücretleri kaldırılır. (isteğe bağlı)

require_credit_card

RequireCreditCard

Kullanıcının bu hizmetten rezervasyon yapmak için bir kredi kartı vermesi gerekip gerekmediğini belirtir. Bu alan, kullanılabilirlik seviyesinde geçersiz kılınabilir. (isteğe bağlı)

type

ServiceType

Bu hizmetin önceden tanımlanmış türü. (isteğe bağlı)

ticket_type[]

TicketType

Biletlerin desteklenmesi durumunda bu hizmet için ayırtılabilecek/satın alınabilecek bilet türleri. (isteğe bağlı)

related_media[]

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, son kullanıcılara en verimli şekilde görüntülenmelerini sağlamak için medyaları tarayıp saklar. (isteğe bağlı)

service_attribute_value_id[]

ServiceAttributeValueId

Bu hizmet için geçerli olan hizmet özelliği değerleri (isteğe bağlı). Her Hizmet, ilgili Satıcı'da tanımlanan her hizmet özelliği için sıfır veya daha fazla değere sahip olabilir. (isteğe bağlı)

waitlist_rules

WaitlistRules

Bekleme listesine katılma kuralları.

ticketing_vertical_specific_data

TicketingVerticalSpecificData

Etkinlik bileti satışına özel ek bilgiler. (isteğe bağlı)

integration_type

IntegrationType

Bu hizmet için desteklediğimiz entegrasyon derinliği. (isteğe bağlı) Başlatıcı entegrasyonuna sahip iş ortakları için alakasızdır. Bu iş ortakları için uçtan uca devre dışı bırakılır.

per_order_fee

PerOrderFee

Bu hizmeti satın alırken sipariş düzeyinde alınan ücretler. (isteğe bağlı)

tours_and_activities_content

ToursAndActivitiesContent

Turlar ve Etkinlikler'e özgü içerik alanları.

location[]

Location

Bu hizmetle ilgili konumlar. ÖNEMLİ NOTLAR: Bu hizmetle ilgili olarak ziyaret edilen birden fazla konum varsa veya START_LOCATION, VISITED_LOCATION konumundan farklıysa, START_LOCATION belirtilmelidir. Örnek: - Üç mekanın ziyaret edildiği rehberli bir bisiklet turu için başlangıç yerinin belirtilmesi gerekir. - Otel lobisinde otobüs turu toplantısı ve ardından ziyaret edilen mekana gitme. Toplantı yerinin belirtilmesi gerekir.

rating

Rating

Tüm yorumlara göre bu hizmetin toplam metriği olarak kullanıcı puanı.

home_service_data

HomeServiceData

Ev hizmetleri sektörüne özel ek bilgiler. (isteğe bağlı)

virtual_session

VirtualSession

İsteğe bağlı. Sanal oturum hakkında bilgi. Sanal hizmetlerin etkinleştirilmesi için gereklidir.

direct_merchant_payment

DirectMerchantPayment

İsteğe bağlı. Hizmet, kullanıcının doğrudan satıcıya ödeme yapmasını gerektiriyorsa eklenmesi gereken ek bilgiler. ÖNEMLİ NOT: Bu işlemde RwG yer almaz. virtual_session tanımlanmışsa ve hizmet ücretsiz değilse veya prepayment_type GEREKLİ olarak ayarlanmadıysa bu parametre gereklidir.

PrepaymentTerms

Ön ödemenin ne zaman tamamlandığıyla ilgili belirli bilgiler.

Alanlar
charge_timing

ChargeTiming

Ödemenin satın alma süresine göre gerçekleşeceği zaman.

charge_time_before_start_time_sec

int64

Hizmetin başlangıç zamanından önceki, ödeme için kullanıcıdan ödeme alınmadan önceki saniye cinsinden süre. Bu alan yalnızca ChargeTiming'in CHARGE_LATER olduğu zaman ayarlanmalıdır.

ChargeTiming

Ödemenin satın alma süresine göre ne zaman yapılacağını belirten enum.

Sıralamalar
CHARGE_TIMING_UNSPECIFIED Kullanılmamış.
CHARGE_NOW Müşteriden hemen ödeme alınır.
CHARGE_LATER Müşteriden daha sonra ödeme alınır.

PrepaymentType

Ön ödeme türünü belirten numaralandırma.

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak, ön ödemenin NOT_SUPPORTED olmadığını varsayacağız.
REQUIRED Kullanıcının, bu hizmet için rezervasyon sırasında ödeme yapması gerekir.
OPTIONAL Kullanıcı, rezervasyon sırasında veya daha sonra bu hizmet için ön ödeme yapabilir. Ancak rezervasyon için bu ücretin girilmesi zorunlu değildir.
NOT_SUPPORTED Bu hizmette ön ödeme desteklenmiyor.

ServiceType

Önceden tanımlanmış hizmet türleri.

Sıralamalar
SERVICE_TYPE_UNSPECIFIED Kullanılmamış.
SERVICE_TYPE_DINING_RESERVATION Yemek rezervasyonu.
SERVICE_TYPE_FOOD_ORDERING Yemek siparişi, yemek servisi, paket servisi veya her ikisi de olabilir.
SERVICE_TYPE_FOOD_DELIVERY Yemek siparişi.
SERVICE_TYPE_FOOD_TAKEOUT Paket yemek servisi.
SERVICE_TYPE_EVENT_TICKET Etkinlik bileti.
SERVICE_TYPE_TRIP_TOUR Gezi turu.
SERVICE_TYPE_APPOINTMENT Randevu veya ders sunan hizmet. (1) Sağlık ve fitness, (2) Spa ve güzellik ve (3) finansal danışmanlık ve değerlendirme hizmetleri için önerilir. Lütfen desteklenen hizmet türlerine bakın: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Bir sınıf veya oturum için tamamen sanal ortamda online randevu sağlayan hizmet. Sanal hizmet rezervasyonları etkinleştiriliyorsa ayarlanmalıdır.
SERVICE_TYPE_SHOPPING Kullanıcıların belirtilen satıcıdan alışveriş yapmasına olanak tanıyan hizmet. Bu teslimat eve teslim veya yerinden teslim olabilir.

ServiceAttribute

Hizmet özellikleri, bir Satıcı için Hizmetler'i açıklayan, iş ortağı tanımlı kategorilerdir. Örneğin, bir banka "Kişisel" ve "İş" gibi olası değerleri içeren bir "Hesap Türü" hizmet özelliği tanımlarken bir kuaför, "Saç Kesimi", "Renk" ve "Stil" değerlerini içeren bir "Hizmet Türü" hizmet özelliği tanımlayabilir.

Alanlar
attribute_id

string

Aynı satıcının hizmet özelliğini diğer özellikler arasında benzersiz bir şekilde tanımlayan bir tanımlayıcı (ör. "hesap türü").

attribute_name

string

Bu özellik için kullanıcı tarafından görülebilen bir ad (ör. "Hesap Türü").

value[]

Value

Bu hizmet özelliğiyle ilgili olası tüm değerler.

Değer

Belirli bir hizmet özelliği için olası bir değeri temsil eder.

Alanlar
value_id

string

Bu hizmet özelliğiyle ilgili olarak bu değeri diğerleriyle birlikte benzersiz bir şekilde tanımlayan bir tanımlayıcı (ör. "kişisel").

value_name

string

Değer için kullanıcı tarafından görülebilen ad (ör. "Kişisel").

ServiceAttributeValueId

Bir Hizmete uygulanacak belirli bir hizmet özelliğinin değerini tanımlar.

Alanlar
attribute_id

string

Merchant.service_attribute öğesinde tanımlanan bir özelliğin kimliği (ör. "service-type").

value_id

string

Bu özelliğin değerinin kimliği, ör. "saç kesimi". Hizmet özelliği tanımındaki bir value_id ile eşleşmelidir.

ServiceAvailability

Kullanılabilirlik listesi ve kime/ne zaman uygulanacağını gösteren liste.

Alanlar
name

string

Bunun uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchant_id}/services/{service_id} biçiminde

start_time_restrict

Timestamp

Sağlanması durumunda, sağlanan Müsaitlik Durumu varlıklarının [start_time_restrict, end_time_restrict). Yani aşağıdaki koşul doğruysa mevcut tüm kullanılabilirlikler silinir:

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

Bir süre mesajı ayarlanırsa koşul daha da kısıtlanır:

  availability.duration == duration_restrict

Resources_restrict mesajı ayarlanırsa koşul daha da kısıtlanır:

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

Bu alanlar genellikle belirli bir zaman aralığındaki kullanılabilirliğin tam bir güncellemesini sağlamak için kullanılır.

end_time_restrict ayarlanmadan bırakılırken start_time_restrict olarak ayarlanması, tüm zamanların start_time_restrict olacağı anlamına gelecek şekilde yorumlanır.

end_time_restrict

Timestamp

start_time_restrict ayarlanmadan bırakılırken end_time_restrict ayarlandığında end_time_restrict'a kadar olan tüm zamanlar yorumlanacak şekilde yorumlanır.

duration_restrict

Duration

Sürenin ayarlanması, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik durumuyla daha da kısıtlar.

resources_restrict

Resources

source_restrict'i ayarlamak, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir.

availability[]

Availability

Yeni kullanılabilirlik listesi.

ServiceIntakeForm

Satıcı tarafından sağlanan hizmeti özelleştiren bir kabul formu tanımlar.

Alanlar
field[]

ServiceIntakeFormField

Kullanıcıya gösterilecek alanlar.

first_time_customers
(deprecated)

bool

Bu form, doğruysa yeni müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

returning_customers
(deprecated)

bool

Bu form Doğru değerine ayarlanırsa bu form, düzenli müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

ServiceIntakeFormField

ServiceIntakeForm'da yer alan bir alanı tanımlar.

Alanlar
id

string

Bir form alanını benzersiz şekilde tanımlayan, toplayıcı iş ortağından gelen bir dize. Bu kimlik, ilgili form alanı yanıtındaki kimlikle aynı olmalı ve hem hizmet düzeyi hem de bilet kabul formları genelinde benzersiz olmalıdır. (zorunlu)

type

FieldType

Bu alanın türü.

label

string

Bu alan için kullanıcıya gösterilen metin. Kullanımdan kaldırıldı, lütfen bunun yerine localized_label kullanın.

localized_label

Text

Bu alan için kullanıcıya gösterilen metin. Bu alan birden fazla yerel ayarda sağlanabilir. (zorunlu)

value[]

string

Yalnızca alan türü LOCATION_SEARCH ise ayarlayın. Konum değerini belirtmek için lütfen "location" alanında "location_id" değerini kullanın.

choice_text[]

Text

Yalnızca alan türü MULTIPLE_CHOICE, CHECKBOXES veya DROPDOWN ise ayarlayın. Olası seçenekleri numaralandırmak için kullanılır.

is_required

bool

Kullanıcının bu alana yanıt vermesinin gerekip gerekmediğini belirtir.

allow_custom_answer

bool

Önceden tanımlanmış yanıtlara ek olarak özel bir değere izin verilip verilmediğini belirtir. Bu yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. (isteğe bağlı)

additional_option[]

Text

Sağlanan değerlere ek olarak sunulan ek seçenekler. Yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. Örneğin, sağlanan konum listesine ek olarak "Tedarikçiyle daha sonra iletişime geçeceğim" başka bir seçenek de olabilir. (isteğe bağlı)

ticket_type_restrict[]

string

Bu sorunun yalnızca kullanıcı belirli bilet türleri için rezervasyon yaptığında gösterilmesi gerekiyorsa bu alan, geçerli bilet türü kimlik grubu olarak ayarlanmalıdır. Soru her zaman geçerliyse alanı boş bırakın.

hint

Text

Giriş için, metin yer tutucusu olarak gösterilen ipucu metni. Bu yalnızca alan türü SHORT_ANSWER veya PARAGRAPH olduğunda geçerlidir. (isteğe bağlı)

FieldType

Alanın türünü belirtmek için enum.

Sıralamalar
FIELD_TYPE_UNSPECIFIED Belirtilmemiş veya bilinmeyen tür alanlar yoksayılır.
SHORT_ANSWER Metin için tek satırlık giriş alanı.
PARAGRAPH Metin için çok satırlı bir giriş alanı.
MULTIPLE_CHOICE Birçok seçenek arasından bir seçim yapılmasını gerektiren radyo düğmeleri grubu.
CHECKBOXES Onay kutuları olan bir veya daha fazla numaralandırılmış öğe.
DROPDOWN Açılır listeden seçim yapın.
BOOLEAN Evet/hayır düğmesi.

TaxRate

Kullanıcıdan bir hizmet için ödeme alırken uygulanan vergi oranıdır. Satıcı veya hizmet bazında ayarlanabilir.

Alanlar
micro_percent

int32

Yüzde birin milyonda biri cinsinden, etkili şekilde 6 ondalık basamak veren vergi oranı. Örneğin, vergi oranı %7,253 ise bu alan 7253000 olarak ayarlanmalıdır.

Bu alan ayarlanmadan bırakılır veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, tam olarak Service.price tarafından belirtilen fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya bu vergilere dahil olduğu varsayılır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfır dışında bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, hizmet fiyatının yanı sıra burada sağlanan vergi oranı kullanılarak hesaplanan vergiyi de içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri), en yakın çift yuvarlama kullanılarak yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Terimler

Google ile Rezervasyon üzerinden rezervasyon yapmak için kullanıcıya gösterilen kurallar ve yönergeler grubu.

Alanlar
url

string

İsteğe bağlı olarak, Şartlar ve Koşullar'ın URL'si.

text

string

Kullanıcıya gösterilecek metin. Yeni entegrasyonlar için aşağıdaki localized_text'i kullanın.

localized_text

Text

Kullanıcıya gösterilecek yerelleştirilmiş metin.

Metin

Muhtemelen yerelleştirilmiş metin yükü. Bazı Metin alanları, işaretlenmiş içerik içerebilir.

Alanlar
value

string

Bilinmeyen bir yerel ayardaki metin değeri. Yalnızca localized_value boşsa gereklidir. Bu değerin yerel ayarı, iş ortağına veya servis sağlayıcıya bağlı olabilir. Belirli bir dil olduğu varsayılmamalıdır.

localized_value[]

LocalizedString

Yerel ayara özgü metin değerleri. İsteğe bağlı.

TicketType

TicketType, farklı kullanıcı türleri, farklı hizmet özellikleri veya farklı seçenekler/eklentiler nedeniyle farklı fiyatlı ve/veya müsaitlik durumu olan biletleri ayırt etmek için kullanılır.

Bilet, belirli bir hizmet için rezervasyon yapılabilen minimum birimdir (ör. rafting gezisi, müzeye giriş, tam gün çift kano kiralama).

Alanlar
ticket_type_id

string

Bilet kimliği, aynı hizmetin farklı bilet türlerini ayırt etmek için kullanılır ve yalnızca bir hizmet içinde benzersiz olması beklenir.

short_description

string

Bu TicketType için kısa bir açıklama.

Bu, kullanıcının görebildiği biçimde olabilir, ör. "adult", "child", "veteran", "Row J" vb. Zorunludur, her bilet türünün kullanıcı tarafından görülebilecek bir açıklaması olmalıdır. Kullanımdan kaldırıldı. Bunun yerine localized_short_description değerini kullanın.

localized_short_description

Text

i18n destekli bu TicketType'ın kısa açıklaması.

Bu, kullanıcının görebildiği biçimde olabilir, ör. "adult", "child", "veteran", "Row J" vb. Zorunludur, her bilet türünün kullanıcı tarafından görülebilecek bir açıklaması olmalıdır. Her yerel ayar için ayrı değerler sağlanabilir.

price

Price

Bu tür tek bir biletin, vergiler hariç fiyatıdır. Hizmetin vergi oranı, biletlerine uygulanır.

per_ticket_fee

PerTicketFee

Bu bileti satın alma işlemi için alınan ek ücretler. (isteğe bağlı)

option_description

string

Bu bilet türünün temsil ettiği ek seçeneklerin (varsa) açıklaması. Kullanımdan kaldırıldı, bunun yerine localized_option_description kullanın.

localized_option_description

Text

Bu bilet türünün temsil ettiği ek seçeneklerin (varsa) açıklaması. Her yerel ayar için ayrı değerler sağlanabilir.

Bilet türü birden fazla boyutu temsil ettiğinde ek seçenekler yararlı olur.

Örnek 1: "yetişkin_türü" ve "çocuk" gibi farklı türlerde 'yetişkin_türü', 'çocuk' ve dil içeren giriş bileti

2. örnek: "en-ish_type_localized_type} "en_ish_type_type} "en_ish_type_type} "noish_type_type} "short_type} "short_description} {__type} "<span_type} "<span_type} <span_key_type} "<span_type} {key_description_type} "<span_type} {key_description} <span_type} {key_description_type}

İsteğe bağlıdır ancak hizmetteki herhangi bir bilet türünde bu alan belirtilmişse diğer tüm bilet türlerinde de bu alanın ayarlanması beklenir (varsayılan bir option_description kullanılabilir). Ör. [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] geçerli bir liste değil.

Yalnızca iki HTML biçimlendirme etiketi desteklenir: ve
. Hem başlık hem de ayrıntılı açıklamayla seçenekleri belirtmek için kullanılmak üzere tasarlanmıştır. Örneğin: "Premium Koltuk
Bu seçenekte özel kutularda tamamen yastıklı koltuklar, özel TV'ler, koltuk içi yiyecek ve içecek servisi de dahil olmak üzere özel kutularda oturma alanı sunulur. Bu koltuklardan saha manzarası seyredilebilir."

TicketingVerticalSpecificData

Etkinlik bileti satışına özel ek bilgiler.

Alanlar
event_category

EventCategory

Etkinliğin kategorisi. Yalnızca etkinlik önceden tanımlanmış kategorilerden birine girdiğinde ayarlanır. (isteğe bağlı)

event_url

string

Etkinliğin iş ortağının web sitesindeki URL'si. (isteğe bağlı)

entity[]

Entity

Etkinlikle ilgili varlıkların listesi. (isteğe bağlı)

event_attendance_mode

AttendanceMode

Zorunlu. Etkinliğe katılım türü.

event_virtual_location_url[]

string

İsteğe bağlı. Etkinliğin izlenebileceği URL.

event_organizer

Text

İsteğe bağlı. Etkinliği düzenleyen düzenleyen.

event_organizer_url

string

İsteğe bağlı. Etkinliği düzenleyen kullanıcının URL'si.

event_organizer_type

OrganizerType

İsteğe bağlı. Düzenleyenin türü.

event_source_url[]

string

Zorunlu. Etkinlik bilgilerinin veya açıklamalarının bulunduğu sayfaların URL'si.

event_state

EventState

İsteğe bağlı. Etkinliğin durumu.

AttendanceMode

Etkinliğe katılım türü.

Sıralamalar
ATTENDANCE_MODE_UNSPECIFIED Belirtilmedi.
ONLINE Sanal etkinlikler için.
PHYSICAL Fiziksel etkinlikler için.
PHYSICAL_ONLINE_MIXED Hem fiziksel hem de sanal etkinlikler için.

Varlık

Etkinlikle ilgili bir varlığı temsil eder.

Alanlar
id

string

İş ortağının veritabanındaki tüzel kişinin benzersiz tanımlayıcısı. (isteğe bağlı)

name

string

Varlığın adı. (zorunlu)

url

string

Varlığı açık bir şekilde açıklayan web sayfasının URL'si. Bu, varsa tüzel kişiye ait iş ortağının web sitesindeki web sayfasıdır. Tüzel kişinin diğer herkese açık URL'leri için Public_identification_data içinde ilgili_url öğesini kullanın. (isteğe bağlı)

entity_type

EntityType

Varlığın türü. (isteğe bağlı)

entity_role

EntityRole

Etkinlikteki varlığın rolü. (isteğe bağlı)

public_identification_data

PublicIdentificationData

Tüzel kişiye yapılan genel referanslar. (isteğe bağlı)

EntityRole

Etkinlikteki varlığın rolü.

Sıralamalar
ENTITY_ROLE_UNSPECIFIED Belirtilmedi.
ENTITY_ROLE_HEADLINER Tüzel kişi, etkinlikte bir manşet veya başrolde performans gösteren kişiyi temsil eder.
ENTITY_ROLE_SUPPORTER Varlık, etkinlikteki destekleyici bir sanatçıyı temsil eder.
ENTITY_ROLE_HOME_TEAM Tüzel kişi, (spor) etkinliğinde ev sahibi takımı temsil eder.
ENTITY_ROLE_AWAY_TEAM Tüzel kişi, (spor) etkinliğinde deplasmandaki takımı temsil eder.

EntityType

Varlığın türü. Not: evrensel bir ontoloji olması amaçlanmamıştır.

Sıralamalar
ENTITY_TYPE_UNSPECIFIED Belirtilmedi. Kullanmayın.
ENTITY_TYPE_PERFORMER Tüzel kişi, bir konser veya gösteride sahne alan sanatçı veya grubu temsil eder. Yalnızca etkinlik kategorisi KONSER veya TİYATRO olduğunda geçerlidir.
ENTITY_TYPE_PLAYER Tüzel kişi, etkinlikteki spor takımını veya oyuncuyu temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir.
ENTITY_TYPE_CONCERT_TOUR Varlık, bu etkinliğin ait olduğu turu temsil eder. Yalnızca etkinlik kategorisi CONCERT olduğunda geçerlidir.
ENTITY_TYPE_SPORTS_SERIES Tüzel kişi, bu etkinliğin ait olduğu bir spor turnuvasını temsil ediyor. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir.
ENTITY_TYPE_PLAY Varlık, etkinlikte sergilenen oyun türünü (ör. müzikal, komedi, bale vb.) temsil eder. Yalnızca etkinlik kategorisi THEATRE olduğunda geçerlidir.

EventCategory

Ürün deneyimini özelleştirdiğimiz etkinlik kategorilerinin bir alt kümesi. Not: Etkinliklerin evrensel bir ontolojisi olması amaçlanmamıştır.

Sıralamalar
EVENT_CATEGORY_UNSPECIFIED Belirtilmedi. Kullanmayın.
EVENT_CATEGORY_CONCERT Konser.
EVENT_CATEGORY_SPORTS Spor etkinlikleri.
EVENT_CATEGORY_THEATRE Tiyatro etkinlikleri.
EVENT_CATEGORY_EXHIBITS Sergiler.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES Atölyeler ve Sınıflar.

EventState

Etkinliğin durumu.

Sıralamalar
EVENT_STATE_UNSPECIFIED Belirtilmedi.
SCHEDULED Etkinlik planlandı.
RESCHEDULED Etkinlik yeniden planlandı.
CANCELLED Etkinlik iptal edildi.
POSTPONED Etkinlik ertelendi.

OrganizerType

Düzenleyenin türü.

Sıralamalar
ORGANIZER_TYPE_UNSPECIFIED Belirtilmedi.
PERSON Gerçek kişilerden oluşan organizatörler içindir.
ORGANIZATION Kuruluş olan düzenleyici içindir.

PublicIdentificationData

Bir varlığa atıfta bulunan tanımlayıcılar, web sayfaları veya diğer herkese açık kaynaklar.

Alanlar
relevant_url[]

string

Yalnızca konuya ayrılmış herhangi bir web sayfasının herkese açık URL'si. Buna resmi web siteleri, diskolar, sosyal medya platformları, wikipedia veya imdb sayfaları (ör. https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan) dahil olabilir. (isteğe bağlı)

musicbrainz_id

string

Sanatçının veya diğer müzik tüzel kişilerinin 36 karakterlik musicbrainz tanımlayıcısı (varsa). https://musicbrainz.org/doc/MusicBrainz_Identifier adresine bakın. (isteğe bağlı)

TimeRange

Kapalı açık bir zaman aralığı, ör. [başlangıç_zamanı, bitiş_zamanı).

Alanlar
start_time

Timestamp

Zaman aralığının alt sınırı.

end_time

Timestamp

Zaman aralığının üst sınırı.

TokenizationConfig

Ödeme işleyici jetonlara ayırma yapılandırması için Satıcı başına ayrı olarak ayarlanır.

Alanlar
tokenization_parameter

map<string, string>

Bir tokenizasyon yapılandırmasında genellikle anahtarı "ağ geçidi", değeri ise işlemcinin adı olan bir tokenization_parametresi bulunur.

Parametrelerin geri kalanı işlemciye bağlıdır. Daha fazla bilgi için Google Pay'in dokümanlarına bakın.

Braintree örneği: tokenizasyon_parametresi { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizasyon_parametresi { key: "abc_denetim" dedeme_parametresi { key: "abc_denetim" } tokenizasyon_parametresi { key: "abcdenetim"

Stripe örneği: tokenizasyon_parametresi { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen örneği: tokenizasyon_parametresi { key: "gateway" value: "adyen" } tokenizasyon_parametresi { key: "gatewayMerchantId" value: "yourId" }

billing_information_format

BillingInformationFormat

Kullanıcının ödeme jetonuyla birlikte Google Pay'e girdiği fatura bilgilerini ödeme jetonuna ekleyin (yukarıya bakın). Alanı boş bırakmak, MIN değerini belirtmekle eşdeğerdir.

BillingInformationFormat

Kullanıcıdan istenecek ve jetona dahil edilecek Fatura Adresi ne kadardır. Sıralama değerleri, Google Pay API'deki parametrelere karşılık gelir (bkz. https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)).

Sıralamalar
BILLING_INFORMATION_FORMAT_UNSPECIFIED Belirtilmedi. Varsayılan olarak MIN değerine ayarlanır.
MIN ad, ülke kodu ve posta kodu (Google Pay varsayılan ayarı).
FULL ad, açık adres, semt, bölge, ülke kodu ve posta kodu.

ToursAndActivitiesContent

Turlar ve Etkinlikler'e özgü içerik alanları. Yinelenen alandaki her bir öğe, ayrı ayrı oluşturulmasına olanak tanımak için (ör. madde işareti olarak) bağımsız olmalıdır.

Turlar ve etkinlikler için ToursAndEventsContent'in doldurulması kesinlikle önerilir ancak bu zorunlu değildir. Tüm alanlar, temel biçimlendirme için hem düz metni hem de HTML benzeri metni destekler. Desteklenen HTML benzeri biçimlendirme etiketleri:

Sıralı etiketler:
, , , : Yalnızca yukarıda belirtilen üç etiket desteklenir.
, paragraflardaki satırları ayırmak için, // ise önemli bir metni vurgulamak için kullanılabilir. Diğer tüm kelime öbeği etiketleri yoksayılır.

Diğer tüm etiketlere ve özel stillere izin verilmez ve bunlar kaldırılacaktır. URL'ler, bağlantılar ve bağlantılar kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez.

Önemli notlar: * Halihazırda highlights, exclusion ve hizmet açıklamasındaki daha spesifik alanlarda sağlanmış diğer verileri kopyalamayın. * Desteklenmeyen etiketlerdeki içerikler kaldırılacağı ve istenmeyen bir kullanıcı deneyimine yol açabileceği için, yukarıda belirtilen desteklenenler dışında başka etiketler kullanmaktan kaçının.

Alanlar
highlights[]

Text

Kullanıcıların görebildiği öne çıkan özellikler listesi.

inclusions[]

Text

Kullanıcıların görebildiği dahil etme listesi.

exclusions[]

Text

Kullanıcıların görebileceği hariç tutma listesi.

must_know[]

Text

Kullanıcıların görebildiği önemli notların listesi. Yaş kısıtlamaları veya bu hizmeti uygunsuz hale getiren diğer koşullar gibi ayrıntılar için kullanılır.

UnsupportedPartySizeOption

Taraflar için sunulan seçenekler izin verilen aralığın dışındadır.

Alanlar
call_merchant

CallMerchant

Kapsama alanı dışındaki partiler için işletme telefonla arayabilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Görüntülenecek örnek metin: "{waitlist_rules.max_party_size} numaradan büyük gruplar için lütfen {phone} numaralı telefondan restoranı arayın." Satıcı Çağrısı ayarlanmalıdır, ancak boş bırakılır.

UpdateBookingRequest

google.maps.booking.v1alpha.Booking güncelleme isteğinde bulun

Alanlar
update_mask

FieldMask

Güncellenecek tüm rezervasyon alanlarının alan maskesi

booking

Booking

Güncellenecek rezervasyon

booking_failure

BookingFailure

Eş zamansız olarak onaylanmış bir rezervasyon isteğinin işlenmesi başarısız olursa ve rezervasyonun durumu BAŞARISIZ olarak güncelleniyorsa bu alan iş mantığı hatasını yansıtmalıdır (ör. kullanıcının mevcut rezervasyonu bu saate çok yakındır). Bu alan yalnızca rezervasyon durumu BAŞARISIZ olarak güncellenirken ayarlanmalıdır. Aksi takdirde yoksayılır.

UpdateMerchantRequest

Merchant güncelleme isteği.

Alanlar
merchant

Merchant

Yeni satıcı verileri.

update_mask

FieldMask

Satıcı için güncellenecek belirli alanlar.

UpdateOrderRequest

google.maps.booking.v1alpha.Order güncelleme isteğinde bulun

Alanlar
update_mask

FieldMask

Güncellenecek tüm sipariş alanlarının alan maskesi

order

Order

Güncellenecek sipariş

UpdateServiceRequest

Service güncelleme isteği.

Alanlar
service

Service

Yeni hizmet verileri.

update_mask

FieldMask

Hizmet için güncellenecek belirli alanlar.

UserPurchaseRestriction

Ödeme seçeneği satın almaya uygun kullanıcıları kısıtlar.

Alanlar
new_to_merchant

bool

Yalnızca daha önce aynı satıcıdan alışveriş yapmamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneğidir.

new_to_payment_option

bool

Yalnızca daha önce aynı ödeme seçeneğini hiç satın almamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneğidir.

VirtualSession

Sanal/online oturum hakkında bilgi. Ör. Online yoga dersi, sanal aşçılık dersi vb.

Alanlar
session_instructions

Text

Bu sanal sınıfın nasıl oluşturulacağına ilişkin talimatlar. İş ortağı, video URL'sini rezervasyona eklemezse bu metinde video URL'sinin kullanıcıyla ne zaman paylaşılacağı belirtilmelidir. Ör. "Zoom URL'si, dersten 30 dakika önce gönderilecek." (Önerilir)

session_requirements

Text

Belirtilen sanal oturumla ilgili gereksinimler. Ör. yoga matı, mutfak gereçleri vb. (Önerilir)

virtual_platform_info

VirtualPlatformInfo

Bu oturumda kullanılan sanal platform hakkında bilgi. (Sanal hizmetleri etkinleştirmek için gereklidir)

is_session_prerecorded

bool

Zorunlu. Sanal oturum yayınlanmadıysa ve önceden kaydedilmişse bu değeri true (doğru) olarak ayarlayın.

VirtualPlatformInfo

Bu sanal oturum için kullanılacak platform hakkında bilgi.

Alanlar
platform

Platform

Sanal oturum için kullanılan platform.

other_platform_name

Text

Platform DİĞER olarak ayarlandıysa platformun adı. (Platform OTHER olarak ayarlanmışsa gerekli)

Platform

Satıcı tarafından kullanılacak sanal platformu belirten enum.

Sıralamalar
PLATFORM_UNSPECIFIED Kullanılmamış.
FLEXIBLE Satıcı, kullandığı video platformu konusunda esnektir.
GOOGLE_HANGOUTS Google Hangouts ürünü.
GOOGLE_MEET Google Meet ürünü.
ZOOM Zoom Video İletişimi.
SKYPE Skype'ı tıklayın.
YOUTUBE YouTube'da canlı yayın yapmak.
OTHER Kullanılan video platformu burada belirtilenlerden farklıysa ayarlanmalıdır.

WaitlistRules

Bekleme listesine katılmayla ilgili kurallar.

Alanlar
min_party_size

int32

Zorunlu. Bekleme listesi işlevi sağlayan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevini sağlamıyorsa bu alan doldurulmamalıdır.

max_party_size

int32

Zorunlu. Bekleme listesi işlevi sağlayan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevini sağlamıyorsa bu alan doldurulmamalıdır.

supports_additional_request

bool

True (doğru) değerine ayarlanırsa kullanıcı bu hizmetin bekleme listesine katılırken serbest biçimli ek metin isteği gönderebilir.

above_max_party_size_options[]

UnsupportedPartySizeOption

Belirlenen max_party_size değerinden daha büyük gruplar için seçenekler belirleyin. Daha büyük taraflara bekleme listesine katılmak için alternatif seçenekler sunulmayacaksa boş bırakın.