Package google.maps.booking.v1alpha

Dizin

BookingNotification

Harici planlama iş ortaklarından gelen randevular için bildirim alır. İş ortağı, iş ortağının CreateBooking ve CheckAvailability gibi rezervasyona dayalı RPC'leri mi yoksa Create Order ve CheckOrdersFulfillability gibi sipariş tabanlı RPC'leri mi uyguladığına bağlı olarak UpdateBooking veya UpdateSipariş'i ç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şlenme durumunu alın.

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Belirtilen toplayıcı tarafından önceden yüklenmiş bir feed'in Status öğesini 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üklenen birden fazla satıcı, hizmet veya stok durumu feed'inin Status bilgilerini alır ve iade eder.

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: - Teslim alma

Yetkilendirme Kapsamları

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

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

InventoryStatus

Yüklenen satıcıların envanterini ve eşleşme durumunu alın.

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Merchant tutarından 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 öğelerini 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 feed türünün kayıtlarını siler. Yalnızca temel doğrulama (hatalı istek gibi) gerçekleştirir. Ardından, 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ı, eksiklik garantisi vermez.

Yetkilendirme Kapsamları

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

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

rpc BatchPushGenericRecord(BatchPushGenericRecordRequest) returns (Empty)

Belirtilen feed türünün kayıtlarını ekler ve/veya günceller. Yalnızca temel doğrulama (hatalı istek gibi) gerçekleştirir. Ardından, 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ı, eksiklik 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 değerini değiştirir. Bu toplu çağrı, eksiklik 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ının yeni Service numarasını oluşturur ve iade eder.

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. Ayrıca, 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 ve kullanılabilirlik alanları 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. Ayrıca 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 Availability değerini değiştirir ve 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 öğesini günceller ve 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 öğesini günceller ve iade eder.

Yetkilendirme Kapsamları

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

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

ActionLinkType

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

Sıralamalar

ActionPlatform

İşlemin gerçekleştirildiği platform. Web uygulaması genel yedek uygulamadır. ACTION_PLATFORM_WEB_APPLICATION içeren en az bir ActionLink'in olması önerilir. Platform olarak Android ve iOS ile 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.
ACTION_PLATFORM_IOS İşlem platformu iOS'tir.

Tavsiye

Google ile Rezervasyon üzerinden rezervasyon yapıldığında kullanıcıya gösterilen öneriler.

Alanlar
text

Text

Google ile Rezervasyon üzerinden rezervasyon yapıldığında kullanıcıya gösterilecek özel mesaj.

Kullanılabilirlik

Satıcının hizmetinde yer alan, zaman ve yer sayısını gösteren kullanılabilirlik alanı.

Alanlar
start_time

Timestamp

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

duration

Duration

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

spots_total

int64

Bu müsaitlik durumundaki toplam yer sayısı ve boş yer sayısı. Örnekler:

  • 10 kişilik yoga dersi ve 3 rezervasyonu: availability {spots_total: 10, spots_open: 7 ...}
  • Rezervasyonu tamamlanmış koltuk masajı oturumu: availability {spots_total: 1, spots_open: 0 ...}

Not: İstekler aşağıda tanımlanan müsaitlik durumu sıkıştırma biçimini kullanarak gönderiliyorsa bu iki alana çıkarım yapılır.

  • 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

Boş yer sayısı.

availability_tag

string

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

resources

Resources

Hizmetin bir parçası olan farklı personel veya odalar olduğunda, bu müsaitlik durumu alanını diğerlerinden netleştirmek için kullanılan isteğe bağlı kaynaklar.

Ör. iki 2 eğitmenden oluşan aynı Yoga dersinde:

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 yapmak üzere kullanılabilecek ödeme seçeneklerini referans alan kimliklerin listesi. Gerçek ödeme seçenekleri Satıcı düzeyinde tanımlanır ve birden fazla Satıcı arasında da paylaşılabilir.

Bu alan, hizmet mesajında belirtilen tüm payment_option_ids'yi geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_id'lerin hizmet mesajında bulunması GEREKMEZ, ancak Satıcı düzeyinde tanımlanmalıdır.

recurrence

Recurrence

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

schedule_exception[]

ScheduleException

Bu hizmetin programlanamayacağı zamanlar. Schedule_exception mesajlarının sayısını sınırlandırmak için bitişik istisnaları birleştirmeyi deneyin.

deposit

Deposit

Bu müsaitlik durumu için isteğe bağlı ödeme. Hizmet ödemesi belirtilmişse geçersiz kılınır.

no_show_fee

NoShowFee

Bu müsaitlik durumu için isteğe bağlı, rezervasyonu kullanmama ücreti alınır. Hizmetin gösterilmeme ücreti belirtilmişse geçersiz kılınır.

require_credit_card

RequireCreditCard

Kullanıcının bu müsaitlik durumu aralığını rezerve edebilmesi için bir kredi kartı sağlamasının gerekip gerekmediğini belirtir. Değer ayarlanmazsa ayarlanmaları hizmet düzeyinden devralınır. (isteğe bağlı)

ticket_type_id[]

string

Bu müsaitlik durumu aralığı için desteklenen bilet türlerinin listesini gösterir. Politika ayarlanmazsa bu alan için üst hizmetteki tüm bilet türleri 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şkin hafta sonları"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Gençlere yönelik hafta sonları"}

Hafta içi günlerde 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ünde hizmet: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "genç" short_description: "Gençlik"} TicketType {ticket_type_id: "yaşlı" short_description: "Kıdemli"}

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

(isteğe bağlı)

duration_requirement

DurationRequirement

Zaman aralığı süresini ve/veya bitiş zamanını gösterme koşulu. 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üzeyindeki SchedulingRules ile ilgili tüm planlama kurallarını geçersiz kılar.

confirmation_mode

ConfirmationMode

Bu müsaitlik durumu için rezervasyon yapılırken 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 moduyla müsaitlik durumu için rezervasyon oluşturma girişimleri hemen reddedilmeli ya da BEKLEMEDE durumuyla oluşturulmalıdır.

ConfirmationMode

Rezervasyon müsaitlik durumu için kullanılan onay modları.

Sıralamalar
CONFIRMATION_MODE_UNSPECIFIED Onay modu belirtilmedi. Eşzamanlı onay işlemi yapı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 sıralama, kullanıcının istenen aralık süresini/bitiş süresini onaylaması veya görüntülemesi için hangi gereksinimlerin mevcut olduğunu gösterir.

Sıralamalar
DURATION_REQUIREMENT_UNSPECIFIED Bitiş zamanının nasıl işlendiği belirtilmemiş. Bu, varsayılan ayardır.
DO_NOT_SHOW_DURATION Bitiş zamanı, kullanıcıya gösterilmez.
MUST_SHOW_DURATION Randevu alabilmeniz için bitiş zamanının kullanıcıya gösterilmesi gerekir.

Yinelenme

Yineleme mesajları isteğe bağlıdır ancak sürekli olarak tekrarlanan kullanılabilirlik alanlarının daha kompakt bir temsiline olanak tanır. Genellikle bir günlük çalışma programını temsil ederler. ScheduleException mesajları daha sonra iş günü içindeki rezerve edilmiş/kullanılamayan zaman aralıklarını göstermek için kullanılır.

Koşullar:

  1. Kullanılabilirlik slotları veya yinelemelerin genişletilmesi aynı slotları OLUŞTURMAMALIDIR. Kimlikler, start_time, 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 karıştırmayın. Yinelenme, randevu sunan satıcılara veya hizmetlere uygundur. Standart biçim, düzenli olarak planlanmış derslere sahip satıcılara/hizmetlere yöneliktir.
  3. Yinelenmeler 24 saatten uzun sürmemelidir.
Alanlar
repeat_until

Timestamp

Müsaitlik durumunun ne kadar tekrarlanacağını içeren maksimum UTC zaman damgası.

repeat_every

Duration

Art arda gelen kullanılabilirlik aralıkları arasındaki süreyi tanımlar.

Örnek: 20 dakikalık kullanılabilirlik, 30 dakikada bir tekrarlama, 09:00 başlangıç_saati ve 11:00'a kadar tekrarlama süresi aralıkları 09:00-09:20, 09:30-09:50, 10-10:20, 10:10-10:00: (gerekli)

ScheduleException

ScheduleException mesajları, yukarıda açıklanan yinelemenin istisnaları olan, iş günü içindeki rezerve edilmiş/kullanılamayan zaman aralıklarını temsil eder. Zaman aralıkları rezerve edildikçe istisnalar listesi yeni kullanılamayan zaman aralıklarını yansıtacak şekilde güncellenmelidir. Yinelenmenin kendisi değiştirilmemelidir.

Alanlar
time_range

TimeRange

Özel durumun zaman aralığı. Yinelenme tarafından tanımlanan, bu kapalı zaman aralığıyla çakışan tüm alanlar kullanılamaz olarak kabul edilir.

Örnek: Yineleme 20 dakika, her 30 dakika tekrarlama, 09:00 başlangıç_saati ve 11:00 tekrar_sona kadar dönemi belirtiyorsa 09:45-11:00 zaman_aralığı olan bir ScheduleException, 09:45-11:00 (zaman_aralığı) 09:30-01:00, 01:00-01:50 arasındadır.

Zaman aralığı kapalı ve açık olduğundan 11:00'de başlayan zaman aralığı bu durumdan etkilenmez.

SchedulingRuleOverrides

Kullanılabilirlik düzeyi planlama kuralları.

Alanlar
last_bookable_sec

int64

Bu zaman aralığının en son rezerve edilebileceği son zaman (saniye cinsinden). Bu zaman damgası, dikkate alınması gereken alanın start_sec tarihinden önce olmalıdır (kullanıcıların başlangıç zamanından sonra rezervasyon yapabilmesi gerekiyorsa hizmet düzeyinde SchedulingRules.min_booking_before_end_time değerini kullanın). Mevcut olduğunda ilgili Hizmetin SchedulingRules'un min_booking_buffer bölümünde belirtilen her şeyi geçersiz kılar.

first_bookable_sec

int64

Bu zaman aralığı ilk kez (saniye cinsinden) rezerve edilebilir. Bu zaman damgası, alanın start_sec_sn. öncesinde veya belirtilmişse last_bookable_sec öncesinde olmalıdır.

last_online_cancellable_sec

int64

Ayarlanırsa bu randevu aralığının Google ile Rezervasyon üzerinden iptal edilebileceği son zaman (Unex epoch'tan 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ın silinmesine yönelik toplu istek.

Alanlar
parent

string

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

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

İstek URL'sinde belirtilen feed türünün kayıtlarını eklemeye ve/veya güncellemeye yönelik toplu istek.

Alanlar
parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

Birden fazla Service kullanılabilirlik aralığını değiştirmeye yönelik toplu istek.

Alanlar
parent

string

partners/{partner_id} biçimi.

extended_service_availability[]

ExtendedServiceAvailability

Mevcut kullanılabilirlik slotlarının yerine kullanılan genişletilmiş hizmet kullanılabilirliği.

BatchReplaceServiceAvailabilityResponse

Birden fazla Service kullanılabilirlik aralığını değiştirmek için verilen toplu yanıt. Yalnızca başarıyla güncellenen alanlar bu mesaja dahil edilecek

Alanlar
extended_service_availability[]

ExtendedServiceAvailability

Mevcut kullanılabilirlik alanlarının yerine kullanılan genişletilmiş hizmet kullanılabilirliği mesajları başarıyla güncellendi.

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

Randevu alan müşterinin kişisel bilgileri

status

BookingStatus

Rezervasyonun durumu

payment_information

PaymentInformation

Rezervasyonla ilgili ödeme işlemleriyle ilgili bilgiler.

party_size

int64

Rezervasyon kişi sayısı

BookingFailure

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

Alanlar
cause

Cause

Rezervasyonun başarısız olmasının nedeni. (gerekli)

rejected_card_type

CreditCardType

(yalnızca neden PAYMENT_ERROR_CARD_TYPE_REJECTED ise gereklidir)

description

string

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

payment_failure

PaymentFailureInformation

Ödeme hatalarıyla ilgili bilgiler.

Neden

Hata nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanmayın; "bilinmeyen hata"
SLOT_UNAVAILABLE Referans verilen kullanılabilirlik aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, referans verilen müsaitlik durumu aralığı için zaten randevu aldı.
LEASE_EXPIRED Kiralama sözleşmesinin (belirtilmişse) süresi dolduğundan istenen rezervasyonu tamamlamak için artık 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 Sağlanan kredi kartı türü satıcı tarafından kabul edilmediğinden ödeme işlenirken bir hatayla karşılaşıldı. Kredi kartı türü, ret_card_type alanında sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiğinden ö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 hatayla karşılaşıldı. Hiç geçerli kullanım kalmamış olabilir, süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyon için ödeme işlenirken bir hatayla karşılaşıldı. Bu değeri, yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmiyorsa ödemeyle ilgili genel bir hatayı belirtmek için kullanın.
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı belirtilen ödeme seçeneğini kullanamıyor (ör. kullanıcı ikinci kez ilk kez fiyat kullanmaya çalışıyor).
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ığı rezervasyon iptal edilemez.
OVERLAPPING_RESERVATION Kullanıcının bu saate çok yakın bir rezervasyonu var.
USER_OVER_BOOKING_LIMIT Kullanıcı, toplayıcının kullanıcı başına rezervasyon sınırını aştığı için rezervasyon başarısız oldu.
PAYMENT_REQUIRES_3DS1

İşlemin tekrar denenmesini istediğiniz ancak bu kez 3DS1 sorgulaması/yanıtı tamamlandıktan sonra ödemenin ne zaman reddedileceğini ayarlayın. Geçerli işlemin başarısız durumunun başarısız olarak kalacağını unutmayın. Bu işlem tamamen ayrı şekilde yapılır.

Hatanın nedeni buysa payment_failure.3DS1_parameters ayarlanması ZORUNLUDUR. Aksi takdirde, geçerli neden PAYMENT_ERROR gibi değerlendirilir.

PaymentFailureInformation

Ödeme hatalarıyla ilgili bilgiler.

Alanlar
threeds1_parameters

ThreeDS1Parameters

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

ThreeDS1Parameters

RwG'nin 3DS1 sınaması gerçekleştirmesini isteyen parametreler.

Parametreler, EMVCo'nun 3DS1 protokolüyle ilgili açıklamasına göre ayarlanır.

Alanlar
acs_url

string

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

pa_req

string

PaymentAuthentication İsteği. Sağlanması durumunda ACSUrl formunda yayınlanır.

transaction_id

string

ACS sağlayıcısı tarafından kullanılan bir tanımlayıcı. Sağlanması durumunda ACSUrl formunda yayınlanır.

md_merchant_data

string

Satıcı verileri. Sağlanması durumunda ACSUrl formunda yayınlanır.

BookingStatus

Rezervasyonun durumu

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

CallMerchant

DesteklenmeyenPartySizeOption içinde kullanılacak boş mesaj. Bu ayar, kullanıcılara işletmeyi rezervasyon için telefonla arama seçeneği gösterir.

CancellationPolicy

Bir hizmetin iptal politikası.

Alanlar
refund_condition[]

RefundCondition

Politika için hiçbir geri ödeme koşulu yoktur.

RefundCondition

Tek bir geri ödeme koşulunu tanımlar. "Geri ödeme adımları"nı açıklamak için birden fazla geri ödeme koşulu birlikte kullanılabilir çeşitli sürelere göre değişebilir.

Alanlar
min_duration_before_start_time

Duration

Başlangıç zamanından önce, müşterinin refund_percent dilinde 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, hizmet başlangıç zamanından en az min_duration_before_start_time önce iptal edildiği sürece ([0 - 100] aralığında) geri ödenebilecek yüzde. 0 (varsayılan) olarak 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ının 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ş bırakılırsa hiçbir kredi kartı desteklenmez.

CreditCardType

Kredi kartı türü.

Sıralamalar
CREDIT_CARD_TYPE_UNSPECIFIED Kullanılmayan.
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 alınabilecek veya kredi kartında provizyon.

Alanlar
deposit

Price

Yatırılan tutar.

min_advance_cancellation_sec

int64

Ödeme için minimum ön iptal.

deposit_type

PriceType

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

DirectMerchantPayment

Kullanıcının, hizmet için RwG aracılığıyla ön ödeme yapmak yerine doğrudan satıcıya nasıl ödeme yapabileceğiyle ilgili bilgiler.

Alanlar
payment_methods[]

Text

Kullanıcıların yalnızca aşağıda belirtilen ödeme yöntemleriyle ödeme yapmaları önerilir.

DurationRange

Sınırlı veya sınırsız olabilen bir süre aralığına yönelik sarmalayıcı. min_duration ve max_duration sürelerinden en az biri gereklidir.

Alanlar
min_duration

Duration

Minimum süre.

max_duration

Duration

Maksimum süre.

ExtendedServiceAvailability

Kullanılabilirlik ve kime/ne zaman uygulanması gerektiğiyle ilgili 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 iletilerinin ait olduğu hizmeti belirtmek için zorunlu bir alandır.

start_time_restrict

Timestamp

Sağlanmışsa sağlanan Stok Durumu varlıklarını, [start_time_restrict, end_time_restrict) sayfasından eksiksiz bir anlık görüntü olarak değerlendiririz. Diğer bir deyişle, aşağıdaki koşulun geçerli olması durumunda tüm mevcut kullanılabilirlikler silinecektir:

   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

Bir 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 müsaitlik durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

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

end_time_restrict

Timestamp

start_time_restrict ayarlanmadan bırakılırsa end_time_restrict'in ayarlanması, end_time_restrict'e kadarki tüm zamanlar anlamına gelecek şekilde yorumlanır.

duration_restrict

Duration

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

resources_restrict

Resources

source_restrict'in ayarlanması güncellemenin kapsamını yalnızca bu kaynak kümesiyle 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 stok durumu alanları olabilir.

existing_items

int64

Mevcut öğeler, feed'deki yeni bilgilere göre gerektiğinde güncellenir.

deleted_items

int64

Öğeler artık bu feed'de yer almadığı için kaldırıldı.

FeedStatus

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

Alanlar
name

string

Şu biçimdeki feed kaynağı adı:

  • 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şlenemezse daha fazla ayrıntı sağlayan, kullanıcıların okuyabileceği bir dize.

statistics

FeedStatistics

Bu yayına özel istatistikler.

Eyalet

Bir feed'in işleme durumunu belirtmek için sıralama.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Kullanılmayan.
IN_PROGRESS Feed hâlâ işleniyor.
SUCCESS Feed başarıyla işlendi.
FAILURE Feed işlenirken bir hatayla karşılaşıldı.

FoodOrderingMetadata

Yemek siparişi işlem bağlantılarının meta verileri.

Alanlar
fee_details[]

FeeDetails

Öğe toplamının üzerinde kullanıcıdan alınan ücretlerin ayrıntıları. Hizmet ücreti, teslimat ücreti vb. farklı ücretler için tekrarlanır.

advance_order_details

AdvanceOrderDetails

Kullanıcının şu andan daha geç bir zamanda sipariş karşılama siparişi verebildiği gelişmiş sipariş desteğiyle ilgili ayrıntılar.

Birleştirme alanı fulfillment_duration_options. Sipariş onayından itibaren sipariş karşılama süresi. Teslimat siparişlerinde, yemeğin teslim edilene kadar geçen süre. Gel-al siparişlerde, yemeğin alınmaya hazır hale gelmesi için geçmesi gereken süre. fulfillment_duration_options şunlardan yalnızca biri olabilir:
fulfillment_lead_time_duration

Duration

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

fulfillment_lead_time_duration_range

DurationRange

Süre aralığı. Örnekler: * 30 dakika ila 45 dakika * 30 dakikadan uzun * 50 dakikadan kısa

AdvanceOrderDetails

Önceden sipariş desteği için.

Alanlar
is_supported

bool

Önceden Sipariş olarak da bilinen Erken Siparişler destekleniyorsa doğru değerini döndürür. (gerekli)

FeeDetails

Ücret ayrıntıları.

Alanlar
type

FeeType

Ücret türü. (gerekli)

fee_amount

FeeAmount

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

FeeAmount

FeeAmount örnekler: * Sabit ücret: 0 ABD doları (ücretsiz), 1,5 ABD doları * Sabit ücret aralığı: 1,0 ABD doları (minimum), 3,0 ABD doları (maksimum), 5,0-6 ABD doları * Alışveriş sepeti boyutunun yüzdesi: %15,5, %10-%20, %10 (minimum), %15 (maksimum) * Aralık ve yüzde 25'tir: 2,5 USD (minimum), %25,5 ve 4,5 USD (maksimum), %10 & 1,5-2,5 ABD doları, %10,5-%20 ve 2,5-3,5 ABD doları

Alanlar
cart_percentage

QuantitativeValue

Alışveriş sepeti değerinin belirli bir 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 çok %5,5 * %4,5 - %5,5

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

Money

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

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

Sipariş karşılama seçeneği (online sipariş bağlantısı).

Alanlar
fulfillment_type

FulfillmentType

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

available_day[]

AvailableDay

Zorunlu. Bu sipariş karşılama yöntemi için müsaitlik durumunun bulunduğu günlerin listesi (tercihen en az 2 gün).

fee_details

FeeDetails

Zorunlu. Sipariş karşılama yöntemiyle ilgili ü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 uygun bir tarih. Satıcının saat diliminde olduğu varsayılır.

last_ordering_time

Timestamp

Zorunlu. Unix zaman damgası. Bir kullanıcının fulfillment_date tarihine kadar ürün sipariş edip teslim alabileceği en son zaman. Başka bir deyişle, last_ordering_time tarihinden sonra fulfillment_date, artık kullanılabilir olarak gösterilmez.

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

FeeDetails

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

Alanlar
Birleştirme alanı fee_details. 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 taban ü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 sabit ücret tutarı.

FulfillmentType

Bir işlem bağlantısıyla ilişkili sipariş 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 almadır.

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 taban ücret tutarı.

NoFee

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

GenericDeleteRecord

URL isteğinde belirtilen feed türünde silinecek kayıt.

Alanlar
delete_time

Timestamp

Zorunlu. Bu zaman damgası, bir silmenin envantere uygulanacağı sırayı belirlemek için kullanılır.

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

bytes

Proto temelli 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.

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

bytes

Proto temelli olmayan feed'ler için

proto_record

Any

Proto tabanlı feed'ler için.

GeoCoordinates

Enlem, boylam ve adres de dahil olmak üzere bir konuma ait Coğrafi veriler.

Alanlar
latitude

double

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

longitude

double

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

Birleştirme alanı addresses. Konumun adresi, yapılandırılmış veya yapılandırılmamış olabilir. addresses şunlardan yalnızca biri olabilir:
address

PostalAddress

Tercih edilen konumun posta adresi.

unstructured_address

string

Yapılandırılmamış bir adres de yedek olarak sağlanabilir. Ör. "Vatan Caddesi No: 1604, İstanbul"

GetMerchantStatusRequest

MerchantStatus alma isteği

Alanlar
name

string

Zorunlu. Partners/{partner_id}/merchants/{merchant_id}/durum biçimindeki kaynak adı.

GetStatusRequest

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

Alanlar
name

string

Şu biçimdeki feed kaynağı adı:

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

HomeServiceData

Ev hizmeti sektörü için ek bilgi sağlanmalıdır.

Alanlar
category_type

string

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

job_type

string

İlgili ev hizmetinin ait olduğu kategori kapsamındaki iş türü. Ör. unclog_drain, install_faucet, tesisatçı kategorisindeki iş türleridir.

IntegrationType

Entegrasyon derinliği destekleniyor.

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, bir teslim alma kaynağı için ad partners/{partner_id}/pickups/{pickup_id} biçiminde olmalıdır. Uygulamaların, tanımlanan kaynağın önbelleğe alınmış sürümlerini kaldırması ZORUNLUDUR.

LineItem

Siparişteki tek bir öğe, yani tek bir hizmetin tek bir zaman diliminde rezerve edilmesi.

Alanlar
service_id

string

Satıcı Hizmetinin kimliği.

start_sec

int64

Unix döneminden bu yana, randevu aralığının saniye cinsinden başlangıç zamanı (UTC).

duration_sec

int64

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

tickets[]

OrderedTickets

Bilet Türüne göre sıralanan bilet sayısı.

price

Price

Bu Satır Öğesinin 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 koleksiyonuna sahip olan ana yayıncı. 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ümüzdeki 30 gün için rezervasyon envanterine sahip değil.
HAS_VALID_FUTURE_INVENTORY Satıcı, önümüzdeki 30 gün içinde rezervasyon envanterine sahip.

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ı, destekleyen hizmette bekleme listesi yok.
HAS_VALID_WAITLIST_SERVICE Satıcının destekleyici hizmet bekleme listesi var.

ListMerchantStatusesResponse

MerchantStatus listeleme yanıtı.

Alanlar
merchant_statuses[]

MerchantStatus

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

next_page_token

string

Sonuçların sonraki sayfasını almak için kullanılan jeton. Boşsa listede başka sonuç bulunmaz.

ListStatusRequest

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

Alanlar
name

string

Şu biçimdeki feed kaynağı adı:

  • 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 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. Başlangıç_saati ayarlanmazsa unix zamanının başlangıcı varsayılan olarak ayarlanır. Bitiş_zamanı ayarlanmazsa varsayılan olarak şimdiye ayarlanır.

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 durum listesini tersine çevirin. Döndürülen maksimum öğe sayısı, istekteki page_size alanına bağlıdır.

next_page_token

string

Sonuçların sonraki sayfasını almak için kullanılan jeton. Boşsa listede başka sonuç bulunmaz.

LocalizedString

Tek bir yerel ayardaki bir dize örneği.

Alanlar
locale

string

IETF BCP 47 dil kodu (ör. "en", "mas", "zh-Hant", "de-CH-1901"). http://www.w3.org/International/articles/language-tags/ adresine 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ı, telefon numarası, URL'si ve coğrafyası, 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, adı olmayan bir Service.location, aynı adreste olsalar bile bir ticari işletme ile eşleştirilmez. (isteğe bağlı)

telephone

string

Konumun ülke ve alan kodları da dahil olmak üzere genel 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ğrafi bilgileri. (isteğe bağlı)

location_type

LocationType

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

location_id

string

Hizmet içindeki konumun benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konumu belirtmek için kullanılabilir. Ör. alınan özel giriş formunda, yolcu 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 olarak hizmet verir.
END_LOCATION Bu hizmetin sona erdiği konum.

Satıcı

Toplayıcının platformunda yer alan satıcıyla ilgili bilgiler

Alanlar
name

string

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

merchant_name

string

merchant_name, phone, url ve geo üst bilgileri, iş ortağı envanterinin halihazırda Google Haritalar'da bulunan satıcılarla eşleştirilmesini desteklemek amacıyla kullanılır. Bu bilgiler gösterilmez.

Satıcının adı.

telephone

string

Satıcının; ülke ve alan kodları da dahil olmak üzere 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 dahil coğrafi bilgileri.

category

string

Toplayıcının platformundaki işletmenin 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 baz puan cinsinden vergi oranı (yüzde birden yüz). Ö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 tüm hizmetler için kullanıcıdan alınan toplam fiyat Service.price tarafından belirtilen tam fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya zaten 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 tüm hizmetler için kullanıcıdan alınan toplam fiyat, hizmet fiyatı ile burada belirtilen vergi oranı kullanılarak değerlendirilen vergiyi içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri) en yakın eşit 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 vergi oranını kullanın.

tax_rate

TaxRate

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

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 mevcut olmadığını varsayarız.

payment_option[]

PaymentOption

Bu satıcının kullanabileceği ödeme seçenekleri. Bu satıcının altındaki hizmetler, izin verdiği ödeme seçeneklerini ayrı ayrı sınırlandırabilir.

payment_processor_config
(deprecated)

PaymentProcessorConfig

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

tokenization_config

TokenizationConfig

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

terms

Terms

Google ile Rezervasyon üzerinden bir hizmet rezervasyonu yapılırken, kullanıcıya gösterilen, satıcıya ait olan Hükümler ve Koşullar. Bunlara ek olarak, toplayıcı iş ortağının Hükümler ve Koşulları da kullanıcıya her zaman gösterilir ve burada belirtilmemelidir.

brand_id

string

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

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

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

İş ortağı...

Tüketiciye yönelik birden fazla markası yok mu? --&gt; Bu alanı yoksay

Yapılandırılmış birden fazla marka 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

Dikkatli Not: Çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. Bir iş ortağı bu alanı kullanmak isterse varsayılan marka dahil olmak üzere ayrı markalar yapılandırmak için önce 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ği için çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. (isteğe bağlı)

service_attribute[]

ServiceAttribute

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

waitlist_advisement

Advisement

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan kullanıcılar için belirli bir satıcı tarafından verilen genel öneriler. Önerideki her bir metin alanının uzunluğu 100 bayt ile 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 bir 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ğrafi eşleşmede değilse 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ştirilmemişse boştur.

direct_urls[]

DirectUrl

Geçerli satıcı envanterinin içeriğini gösteren URL'lerin listesi. Bunun, envanterin gerçekten yayınlandığı anlamına gelmediğini 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 önümüzdeki 30 gün içinde envanteri varsa doğru değerini döndürür. Satıcıya reklam gösterileceğini 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 hizmetlerinin bilgileri eşleşiyor (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ı.

Alanlar
customer_id

int64

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

categories[]

string

Yerel hizmet kategorileri (sektörler). Ör. "tesisatçılık" ve "carpet_cleaning" (hali_temizliği) gibi özellikler içerir.

PlaceInfo

Eşleşen bir yerle ilgili 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 Satıcı Madden'dan alındı ancak işlenmeye devam ediyor. Bu durumdaki satıcılar için başka durum bilgisi doldurulmaz.
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 döndürür. Satıcıya reklam gösterileceğini garanti etmez.

MoneyRange

Sınırlı veya sınırsız olabilen parasal tutar aralıkları için sarmalayıcı. min_amount [min_tutar] ve max_amount [maks_tutar] özelliklerinden en az biri gereklidir.

Alanlar
min_amount

Money

Minimum tutar.

max_amount

Money

Maksimum tutar.

NoShowFee

Rezervasyon yapan ancak rezervasyona uğrayan kullanıcılardan alınabilecek ücret.

Alanlar
fee

Price

Rezervasyona gelmemesi durumunda kullanıcıdan alabileceği tutar.

fee_type

PriceType

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

Sipariş

Bir satıcıdan hizmet randevuları 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 ilişkili ödeme işlemleriyle ilgili 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ılabilen sipariş karşılama seçenekleri.

PaymentInformation

Bir 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şkilendirilmiş benzersiz işlem kimliğini içerir.

payment_transaction_id

string

Rezervasyonla ilişkili ö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ılabilecek bir ödeme seçeneği. Ödeme seçenekleri birden çok satıcı (ör. aynı zincirdeki 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ında geçerlidir. Bir değerin birden fazla satıcıda yeniden kullanılması, kullanıcının bu satıcılarda ilgili ödeme seçeneğiyle ödeme yapmasına olanak tanır.

Bir kimliği birden fazla satıcı için tekrar kullanırken bir satıcının altındaki ödeme seçeneğinin değerini güncellediğinizde, farklı bir satıcı altında aynı kimliğe sahip diğer tüm ödeme seçenekleri de güncellenir. Bu nedenle, olumsuz davranış olasılığını önlemek için tüm ödeme seçeneklerinin aynı kimliği paylaşan tüm ödeme seçeneklerinin her zaman aynı değerlere güncellenmesini sağlamanız önerilir.

name

string

Ödeme seçeneğinin adı. Kullanıcılar tarafından görülebilir.

description

string

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

price

Price

Ödeme seçeneğinin fiyatı.

tax_rate

TaxRate

Bu ödeme seçeneğinin vergi oranı. Bu alan varsa Satıcı veya Hizmet'te bulunan vergi oranı alanı geçersiz kılınır. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfıra sıfırlar.

payment_option_type

PaymentOptionType

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

session_count

int64

Bu ödeme seçeneğinin kullanılabileceği oturum sayısı. Yalnızca çoklu oturum / paketler için geçerlidir. Değerin > olması gerekir 1.

purchase_interval

TimeRange

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

valid_interval

TimeRange

Ödeme seçeneği bu aralıkta kullanılabilir (ör. Ocak 2017 için özel fiyat). Bu özellik mevcutsa, current_duration ve activate_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 belirleneceğ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ümesinin promosyonlu ödeme seçeneğini kısıtlamak için kullanılabilir. Politika ayarlanmazsa tüm kullanıcılar programa katılmaya uygun olur.

ActivationType

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

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

PaymentOptionType

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

Sıralamalar
PAYMENT_OPTION_TYPE_UNSPECIFIED Kullanılmayan.
PAYMENT_OPTION_SINGLE_USE Ödeme seçeneği yalnızca bir kez kullanılabilir.
PAYMENT_OPTION_MULTI_USE Ödeme seçeneği, oturum sayısı > 0
PAYMENT_OPTION_UNLIMITED Ödeme seçeneği, geçerli zaman aralığında kullanılabilir. Oturum sayısı geçerli değildir.

PaymentProcessorConfig

Satıcı bazında ayarlanan ödeme işleyici yapılandırması.

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ını ziyaret edin: 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 ödemeler için bir yapılandırma.
PROCESSOR_BRAINTREE Braintree ile ödemeler için 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 varsayarız. CreditCardType tarafından desteklenen kart listesinin zamanla büyüyeceğini, bu nedenle bu boş alanın gelecekte değişiklikler yapılmasına yol açabileceğini unutmayın.

PerOrderFee

Bilet sayısından bağımsız olarak, sipariş başına bir kez ödenmesi gereken ücretler.

Alanlar
delivery_fee

Price

Ücret, teslimat yöntemine göre değişebilir.

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 ücretler.

Alanlar
service_charge

Price

Bir hizmet için belirlenen ek ücret.

facility_fee

Price

Etkinlik mekanına/tesis alanına giden bir ücret.

taxes

Price

Bilet başına vergiler.

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". (gerekli)

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". (gerekli)

street_address

string

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

PrepaymentStatus

Bir 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 ödenmiş olmalıdır.
PREPAYMENT_NOT_PROVIDED Rezervasyon ücreti önceden ödenmemiştir.
PREPAYMENT_REFUNDED Daha önce PREPAYMENT_PROVIDED olan ücret şimdi geri ödendi.

Fiyat

Bir hizmetin veya ücretin fiyatıdır.

Alanlar
price_micros

int64

Para biriminin mikro birimleri cinsinden fiyat. En küçük para biriminin kesirleri, en yakın eşit yuvarlama kullanılarak yuvarlanır. (örneğin, 2,5 sent 2 sente yuvarlanır, 3,5 sent 4 sente yuvarlanır, 0,5 sent 0 sente yuvarlanır, 2,51 sent 3 sente yuvarlanır).

currency_code

string

ISO 4217'de tanımlanan fiyatın para birimidir.

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

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

Sıralamalar
PRICE_INTERPRETATION_UNSPECIFIED Fiyat yorumu belirtilmemiş, varsayılan olarak EXACT_AMOUNT.
EXACT_AMOUNT

Fiyatın ne zaman belirli bir değer olarak yorumlanması gerektiği.

Örnek: Yoga dersi için 20 dolar; Çocuklar için saç kesimi için 15 ABD doları

STARTS_AT

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

Bu FiyatYorumlama'yı kullanan tüm hizmetlerin, PrepaymentType NOT_SUPPORTED öğesini kullanması gerektiğini unutmayın.

Örnek: Köpek kuaför hizmeti 30 TL'dir 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 PriceYorumlama'yı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED kullanımı ve Price'ın boş olması gerektiğini unutmayın.

Örnekler: Ev hizmetleri için danışmanlık

PriceType

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

Sıralamalar
FIXED_RATE_DEFAULT

Fiyat sabit bir tutar içindir. Alan ayarlanmazsa varsayılan değer budur.

Örnek: masa ayırtmak için 50 ABD doları para yatırma; Yoga dersi için 20 ABD doları tutarında katılma ücreti

PER_PERSON

Belirtilen fiyat kişi başıdır. Toplam fiyat ise Kaynaklar'da price_micros * party_size olarak belirtilen parti büyüklüğüne göre hesaplanır. PER_PERSON fiyatıyla birlikte müsaitlik durumu kaynaklarında kişi sayısı belirtilmelidir. Ayarlanmadıysa bir adet kişi sayısı kullanılır.

Örnek: Müze bileti başına 10 TL

QuantitativeValue

Aralık veya sabit değer olabilecek sayısal bir değer için sarmalayıcı. QuantitativeValue örnekler: * 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
Birleştirme alanı value_options. (zorunlu) value_options aşağıdakilerden yalnızca biri olabilir:
value

double

Tek bir değer. Örneğin: 5,6

value_range

RangeValue

Aynı zamanda açık uçlu veya sınırlı olabilen bir değer aralığı. Örnekler: * En az 5,5 * En çok 5,5 * 5,5 - 6,5

RangeValue

min_value < şeklinde olan değer aralığı max_value. 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ığın Derecelendirmesini tanımlar.

Alanlar
value

double

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

number_of_ratings

uint64

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

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, medyaların son kullanıcılara doğru bir şekilde görüntülendiğinden 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'yi destekleyen medyanın altyazısı, yalnızca düz metin desteklenir. Tüm HTML bileşenleri kaldırılacak. (isteğe bağlı)

attribution

Attribution

Medyanın kaynağıyla ilgili atıf bilgileri. Fotoğrafçıya veya ajansa atıfta bulunmak için ilişkilendirmenin medyayla birlikte gösterilmesi gerekiyorsa bu alanın ayarlanması gerektiğini unutmayın. (isteğe bağlı)

caption
(deprecated)

string

Kullanımdan kaldırıldı, localized_caption kullanmayı tercih edin.

İlişkilendirme

Bu medyanın atıf bilgileri.

Alanlar
localized_text

Text

i18n'yi destekleyen fotoğrafçıya veya ajansa atıfta bulunulan metin. Bu metin, kaynak medyayla birlikte görüntülenir. Bu alanda yalnızca düz metin 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 kullanmayı tercih edin.

MediaType

Bu medya kaynağının türünü belirten sıralama. Yalnızca fotoğraflar desteklenir. Fotoğraflar dışındaki medyaların desteklenmesi gerekiyorsa lütfen Google ile Rezervasyon Ekibi ile iletişime geçin.

Sıralamalar
TYPE_UNSPECIFIED Kullanılmayan.
PHOTO URL'nin sağladığı medyanın bir fotoğraf olduğunu belirtir.

ReplaceServiceAvailabilityRequest

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

Alanlar
service_availability

ServiceAvailability

Mevcut hizmetlerin 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ŞULLU için belirtilenle aynı olacaktır.
REQUIRE_CREDIT_CARD_CONDITIONAL Google, aşağıdaki koşullardan herhangi biri karşılanırsa rezervasyon için kredi kartı ister: * müsaitlik durumunun bir fiyatı varsa ve prepayment_type değeri GEREKLİ * no_show_fee ayarlanmışsa * ödeme alanı ayarlanmıştır.
REQUIRE_CREDIT_CARD_ALWAYS Diğer alan değerlerinden bağımsız olarak, bu müsaitlik durumunu rezerve etmek için her zaman kredi kartı gerekir.

Kaynaklar

Kaynak, farklı personel üyeleri veya odalar hizmetin bir parçası olduğunda müsaitlik durumu alanlarını birbirinden ayırt etmek için kullanılır. Farklı kaynaklara sahip olduklarında aynı hizmet ve zaman aralığı için birden fazla yuva birlikte var olabilir.

Alanlar
staff_id

string

Hizmeti sağlayan personel için isteğe bağlı kimlik. Bu alan tüm satıcılar, hizmetler ve stok durumu kayıtlarında personeli tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurulmasını sağlamak için zaman içinde istikrarlı olmalıdır. Personel_adı varsa bu alan da mevcut olmalıdır.

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 insan tarafından okunabilir olmalıdır. Personel_kimliği varsa bu alan da mevcut olmalıdır.

room_id

string

Hizmetin bulunduğu odanın isteğe bağlı kimliği. Bu alan tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında odayı tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurulmasını sağlamak için zaman içinde istikrarlı olmalıdır. Room_name varsa bu alan bulunmalıdır.

room_name

string

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

party_size

int32

Yalnızca Yemek için geçerlidir: Bu zaman aralığı boyunca konaklayabilecek kişi sayısı. Bir restoran, aynı anda birden fazla Slot ile ilişkilendirilebilir. Her biri farklı bir parti_boyutu belirtir (örneğin, rezervasyonda 2, 3 veya 4 kişi oturabilirse).

SchedulingRules

Bir hizmetin planlama kuralları.

Alanlar
min_advance_online_canceling

int64

İnternet üzerinden alınan bir randevuyu iptal etmek için saniye cinsinden minimum ön bildirim miktarıdır. (isteğe bağlı)

late_cancellation_fee
(deprecated)

Price

Minimum ön bildirim dönemi içinde iptal etme ücreti.

noshow_fee
(deprecated)

Price

İptal etmeden rezervasyonu kullanmama ücreti.

admission_policy

AdmissionPolicy

Bu hizmet için geçerli giriş politikası. Ayarlanmadan bırakılırsa varsayılan olarak TIME_STRICT değerine ayarlanır. (isteğe bağlı)

cancellation_policy

CancellationPolicy

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

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

"min_advance_booking" ise ayarlandığında, son rezervasyon zamanı şu şekilde hesaplanır (<slot start time> - "min_advance_booking"). "min_booking_buffer_before_end_time" ise ayarlandığında, son rezervasyon zamanı şu şekilde hesaplanır (<slot end time> - "min_booking_buffer_before_end_time"). "min_booking_buffer_before_end_time" değerinin ayarlanmışsa pozitif olmalıdır. İkisi de ayarlanmazsa aralık başlangıç zamanına kadar bu aralık rezerve edilebilir. Her iki alan da ayarlanırsa yalnızca bir değer seçilirken diğer değer yok sayılır. Böylece hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz.

Örnekler:

  • Başlangıç zamanından en az 1 saat önce randevu alınması gereken bir saç kesimi. &#39;scheduling_rules{ min_advance_booking: 3600 ...}`

  • Son biletin kapanıştan 30 dakika önce satın alınabildiği bir 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şlamasına kadar geçen süre (saniye cinsinden).

min_booking_buffer_before_end_time

int64

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

AdmissionPolicy

Bu hizmetin giriş politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmayan.
TIME_STRICT Müşterilerin, kullanım alanının başlangıç zamanında mevcut olması gerekir ve hizmetin, zaman aralığının bitiş zamanında tamamlanması beklenmektedir. TIME_STRICT kullanım alanlarına örnekler: * Sabah 9'da başlayan, tüm katılımcıların başlangıç saatinde gelmesini gerektiren ve 12:00 civarında geri dönen bir tur. * Cumartesi günü saat 15:00'te yaklaşık 30 dakika sürecek saç kesimi rezervasyonu. * 18:00 - 20:00 saatleri arasında bir fitness dersi.
TIME_FLEXIBLE

Müşteriler, bu rezervasyonu kullanmak için müsaitlik durumunun başlangıç ve bitiş zamanı arasında istedikleri zaman gelebilirler.

TIME_FLEXIBLE kullanım alanlarına örnekler: * Satın alma tarihinde herhangi bir zamanda kullanılabilecek müze bileti. * 12:00-21:00 arasında kullanılabilen lunaparka öğleden sonra girişi.

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Müşterilerin, kullanım alanının başlangıç zamanında satıcıya ulaşması gerekir, ancak istedikleri zaman ayrılabilirler.

Örneğin, müzeye giriş senaryosunda, saat 10:00 için süreli giriş bileti kullanmak üzere kullanıcının sabah 10:00'da müzede olması gerekir. Bu hizmet için kullanılabilirlik aralıklarının başlangıç zamanı, belirtilen giriş zamanını temsil eder. Bununla birlikte, bitiş zamanı, rezervasyonun müsaitlik durumunu belirlemek için yalnızca anahtar olarak kullanılır.

Hizmet

Satıcı tarafından sağlanan hizmetlerle ilgili bilgiler, ör. saç kestirme.

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 çeşitli yerel ayarlarda.

description

string

Hizmetin, kullanıcının görebildiği açıklama. Kullanımdan kaldırıldı, bunun yerine localized_description kullanın.

localized_description

Text

Hizmetin, kullanıcının görebildiği açıklama.

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şturmak için lütfen aşağıdaki talimatları ve notları dikkatle 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örüntüler. Dahili HTML etiketlerinin, stillerin veya özelliklerinin yok sayılacağını unutmayın. Örneğin, <h1 style=".."> , <h1> ile aynı şekilde ele alınır. Yalnızca metin korunur.

Paragraf etiketi: <p>
Paragraf etiketi, ayrıntılı bir girişi veya içeriği vurgulamak için kullanılabilir. Tüm iç etiketler, stiller veya özellikler, birkaç istisna dışında göz ardı edilir: <br>, <strong> ve <em>. Daha fazla bilgi için lütfen aşağıdaki kelime öbeği etiketi bölümüne bakın.

Liste etiketleri: <ul>, <ol>, <li>
<ul> etiketi <li> etiketi ve <ol> etiketi <li> sıralı listeleri görüntülemek için. Bu, yapılacaklar listelerini, programları veya kullanım alanlarınıza uyan diğer listeleri görüntülemenin iyi bir yoludur.
Örnek: Bir tekne turunun özelliklerinin listesini göstermek için:
<ol>
<li>Muhteşem okyanus manzarası ve vahşi yaşamla oynama şansı.</li>
<li>Seyahat ayarlamaları ve hizmetleri dikkatlice tasarlanır.</li>
<li>En düşük fiyat garantili.</li>
</ol>
Yalnızca şunu unutmayın: <li> <ul> yaşından küçük çocuklar veya <ol> etiketleri dönüştürülür. Diğer tüm çocuklar atlanacak. Ayrıca iç etiketler, özellikler ve stiller yoksayılır; yalnızca metin içerikleri koruyoruz.

Bölüm etiketi: <div>
<div> öğesinin desteklenen tüm iç etiketleri etiketi yukarıda belirtilen kurallarla ayrıştırılır, <div> etiketinin kendisi burada herhangi bir gruplama veya girinti anlamına gelmez. İç özellikler ve stiller yoksayılır.

Sıralı etiketler: <br>, <strong>, <em>:
Yalnızca yukarıda belirtilen üç etiket desteklenir. &lt;br&gt; paragraflardaki satırları ayırmak için kullanılabilir ve <strong>/<em> önemli metinleri vurgulamak için 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, sabitler 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 lütfen "related_media" özelliğini kullanın. fotoğraf URL'lerinizi göndermek için aşağıdaki alanı doldurun.

Önemli notlar:

  • Yukarıda belirtilenler dışında başka etiketler kullanmamaya çalışın. Aksi takdirde, desteklenmeyen etiketlerdeki içerikler kaldırılır ve istenmeyen kullanıcı deneyimine yol açabilir.
  • 3 farklı başlık düzeyi veya iç içe yerleştirilmiş listeler gibi derin iç içe yerleştirilmiş yapılardan kaçının. Yapının düz, basit ve anlaşılır 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 Ekibi'ne 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 gösterilmesini yapılandırmak için Yemek ve Aktivite Önerileri dışındaki herhangi bir sektör tarafından kullanılabilir.

rules

SchedulingRules

Randevu alma veya iptal etme kuralları.

prepayment_type

PrepaymentType

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

prepayment_terms

PrepaymentTerms

Ön ödemenin tamamlandığı zamana ilişkin ş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 hizmeti rezerve ederken kullanıcıdan ek bilgi isteyen bir form. (isteğe bağlı)

per_ticket_intake_form

ServiceIntakeForm

Bu hizmeti rezerve ederken 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ı. Bu alan varsa satıcı düzeyinde belirlenen vergi oranı (tax_rate) geçersiz kılınır. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfıra sıfırlar.

payment_option_id[]

string

Bu hizmet için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerini referans alan kimliklerin listesi. Gerçek ödeme seçenekleri Satıcı düzeyinde tanımlanır ve birden fazla Satıcı arasında da paylaşılabilir.

deposit

Deposit

Ödemenin kullanıcıdan nasıl alınabileceğini tanımlar. Hizmet ödemesi belirtilmişse geçersiz kılınır. Bu değer boş bir Depozito mesajı olarak ayarlanırsa hizmet düzeyindeki tüm ödeme kaldırılır. (isteğe bağlı)

no_show_fee

NoShowFee

Kullanıcıdan alınabilecek rezervasyonu kullanmama ücretini tanımlar. Hizmetin gösterilmeme ücreti belirtilmişse geçersiz kılınır. 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 hizmet için rezervasyon yapabilmesi için kredi kartı sağlamasının gerekip gerekmediğini belirtir. Bu alan, kullanılabilirlik düzeyinde 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

Biletler destekleniyorsa bu hizmet için rezerve edilebilecek/satın alınabilecek bilet türleri. (isteğe bağlı)

related_media[]

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, medyanın son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bu medyayı tarar ve 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 biletleme sektörüne özgü 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ı entegrasyonu olan iş ortakları için alakasızdır. Bu iş ortakları için uçtan uca her zaman devre dışı olacaktır.

per_order_fee

PerOrderFee

Bu hizmeti satın almak için sipariş düzeyinde ücretler. (isteğe bağlı)

tours_and_activities_content

ToursAndActivitiesContent

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

location[]

Location

Bu hizmetle ilgili konumlar. ÖNEMLİ NOTLAR: Bu hizmetle ilgili birden fazla ziyaret edilen yer varsa veya START_LOCATION, VISITED_LOCATION konumundan farklıysa START_LOCATION belirtilmelidir. Örnek: - Üç alanı ziyaret eden rehberli bir bisiklet turu; başlangıç noktasının belirtilmesi gerekir. - Otel lobisinde otobüs turundan sonra ziyaret edilen mekana gitmek. Toplantı yerinin belirtilmesi gerekir.

rating

Rating

Tüm yorumlar üzerinden toplu bir metrik olarak bu hizmete ilişkin kullanıcı puanı.

home_service_data

HomeServiceData

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

virtual_session

VirtualSession

İsteğe bağlı. Sanal oturum hakkında bilgi. Sanal hizmetleri etkinleştirmek 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şleme RwG dahil edilmez. virtual_session tanımlanmışsa ve hizmet ücretsiz değilse ya da prepayment_type REQUIRED değerine ayarlanmadıysa gereklidir.

PrepaymentTerms

Ön ödemenin ne zaman tamamlanacağına ilişkin ayrıntılı bilgiler.

Alanlar
charge_timing

ChargeTiming

Satın alma zamanına göre ödemenin ne zaman gerçekleşeceği.

charge_time_before_start_time_sec

int64

Hizmet başlangıç zamanından önce kullanıcıdan ödeme alındığı süre (saniye cinsinden). Bu alan yalnızca ChargeTiming CHARGE_LATER olduğunda ayarlanmalıdır.

ChargeTiming

Ödemenin satın alma zamanına göre ne zaman gerçekleşeceğini belirtmek için sıralama.

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

PrepaymentType

Ön ödeme türünü belirtmek için sıralama.

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak, ön ödemenin NOT_SUPPORTED olduğunu varsayacağız.
REQUIRED Kullanıcının rezervasyon sırasında bu hizmete ödeme yapması gerekir.
OPTIONAL Kullanıcı, rezervasyon sırasında veya daha sonra bu hizmet için ön ödeme yapmayı tercih edebilir. Ancak bu işlem, rezervasyon için zorunlu değildir.
NOT_SUPPORTED Bu hizmet için ön ödeme desteklenmiyor.

ServiceType

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

Sıralamalar
SERVICE_TYPE_UNSPECIFIED Kullanılmayan.
SERVICE_TYPE_DINING_RESERVATION Yemek rezervasyonu.
SERVICE_TYPE_FOOD_ORDERING Yemek siparişi, paket yemek servisi veya paket servis ya da her ikisi de olabilir.
SERVICE_TYPE_FOOD_DELIVERY Paket yemek servisi.
SERVICE_TYPE_FOOD_TAKEOUT Paket servis.
SERVICE_TYPE_EVENT_TICKET Etkinlik bileti.
SERVICE_TYPE_TRIP_TOUR Gezi turu.
SERVICE_TYPE_APPOINTMENT Randevu veya sınıf hizmeti sunan hizmet. (1) Sağlık ve fitness, (2) spa ve güzellik, (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 Tamamen sanal olacak şekilde bir ders veya oturum için online randevu alma imkanı sunan hizmet. Sanal hizmet rezervasyonları etkinleştiriliyorsa ayarlanmalıdır.
SERVICE_TYPE_SHOPPING Kullanıcıların belirli bir satıcıdan alışveriş yapmasına olanak tanıyan hizmet. Teslimat veya teslim alma olabilir.

ServiceAttribute

Hizmet özellikleri, bir Satıcı için Hizmetler'i tanımlayan iş ortağı tarafından tanımlanan kategorilerdir. Örneğin, bir banka "Hesap Türü" tanımlayabilir. hizmet özelliği özelliği olup potansiyel "Personal" (Kişisel) değerine sahip ve "İşletme" ifadelerini içerirken bir kuaför "Hizmet Türü"nü tanımlayabilir. service [Saç Kesimi", "Renk" ve "Stil" gibi değerlere sahip olabileceğini lütfen unutmayın.

Alanlar
attribute_id

string

Aynı satıcı için bu hizmet özelliğini diğerleriyle benzersiz şekilde tanımlayan bir tanımlayıcı (ör. hesap türü.

attribute_name

string

Bu özellik için kullanıcının görebildiği ad, ör. "Hesap Türü".

value[]

Value

Bu hizmet özelliği için kullanılabilecek 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ği için bu değeri diğerleriyle benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "kişisel".

value_name

string

Değer için kullanıcının görebildiği ad (ör. "Kişisel".

ServiceAttributeValueId

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

Alanlar
attribute_id

string

Bir özelliğin Merchant.service_attribute öğesinde tanımlandığı şekilde kimliği, ör. "hizmet-türü".

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 ve kime/ne zaman uygulanması gerektiğiyle ilgili liste.

Alanlar
name

string

Bu özelliğin uygulanacağı hizmetin kaynak adı. partners/{partner_id}/merchants/{merchant_id}/services/{service_id} biçiminde

start_time_restrict

Timestamp

Sağlanmışsa sağlanan Stok Durumu varlıklarını, [start_time_restrict, end_time_restrict) sayfasından eksiksiz bir anlık görüntü olarak değerlendiririz. Diğer bir deyişle, aşağıdaki koşulun geçerli olması durumunda tüm mevcut kullanılabilirlikler silinecektir:

   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

Bir 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 müsaitlik durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

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

end_time_restrict

Timestamp

start_time_restrict ayarlanmadan bırakılırsa end_time_restrict'in ayarlanması, end_time_restrict'e kadarki tüm zamanlar anlamına gelecek şekilde yorumlanır.

duration_restrict

Duration

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

resources_restrict

Resources

source_restrict'in ayarlanması güncellemenin kapsamını yalnızca bu kaynak kümesiyle 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 giriş formu tanımlar.

Alanlar
field[]

ServiceIntakeFormField

Kullanıcıya gösterilecek alanlar.

first_time_customers
(deprecated)

bool

True (doğru) ise bu form ilk kez alışveriş yapan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

returning_customers
(deprecated)

bool

True (doğru) ise bu form düzenli müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

ServiceIntakeFormField

ServiceIntakeForm'a dahil olan bir alanı tanımlar.

Alanlar
id

string

Bir form alanını benzersiz şekilde tanımlayan, toplayıcı iş ortağından alınan bir dize. Bu kimlik, ilgili form alanı yanıtındaki kimlikle aynı olmalıdır ve hem hizmet düzeyinde hem de bilet giriş formlarında benzersiz olmalıdır. (gerekli)

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. (gerekli)

value[]

string

Yalnızca alan türü LOCATION_SEARCH ise ve bu durumda ayarlayın. Lütfen "location_id" özelliğini kullanın "konumda" alanını 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

Bir kullanıcının bu alana yanıt vermesini zorunlu kılıp kılmadığını 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. Ör. Sağlanan konum listesine ek olarak, kullanılabilecek bir diğer seçenek de "Tedarikçiyle daha sonra iletişime geçeceğim" 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ü kimlikleri grubu olarak ayarlanmalıdır. Soru her zaman geçerliyse alanı boş bırakın.

hint

Text

Metin yer tutucusu olarak gösterilen, giriş için 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ü belirten sıralama.

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

TaxRate

Kullanıcıdan bir hizmet için ödeme alırken uygulanan ve satıcı veya hizmet bazında ayarlanabilen vergi oranı.

Alanlar
micro_percent

int32

Etkin biçimde 6 ondalık basamak içeren, yüzde bir milyonda bir 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 tüm hizmetler için kullanıcıdan alınan toplam fiyat Service.price tarafından belirtilen tam fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya zaten 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 tüm hizmetler için kullanıcıdan alınan toplam fiyat, hizmet fiyatı ile burada belirtilen vergi oranı kullanılarak değerlendirilen vergiyi içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri) en yakın eşit yuvarlama kullanılarak yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Şartlar

Google ile Rezervasyon üzerinden rezervasyon yapması için kullanıcılara gösterilen kural ve kurallar grubudur.

Alanlar
url

string

İsteğe bağlı olarak, Hükümler ve Koşullar'ın URL'si.

text

string

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

localized_text

Text

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

Metin

Yerelleştirilmiş olabilecek metin yükü. Bazı Metin alanları, işaretlenmiş içerik barındırıyor olabilir.

Alanlar
value

string

Metin değeri bilinmeyen bir yerel ayarda. 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 düşünülmemelidir.

localized_value[]

LocalizedString

Yerel ayara göre metin değerleri. İsteğe bağlı.

TicketType

TicketType; farklı kullanıcı türleri, farklı hizmet özellikleri ya da farklı seçenekler/eklentiler nedeniyle farklı fiyatlara ve/veya stok durumuna sahip biletler arasında ayrım yapmak için kullanılır.

Bilet, bir hizmet için rezervasyon yapılabilecek minimum birimdir, ör. rafting gezisi, müze girişi, tam gün çift kano kiralama hizmeti.

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ı tarafından görülebilir, ör. "yetişkinler", "çocuk", "veteran", "Satır J" vb. Zorunludur. Her bilet türünün kullanıcı tarafından görülebilmesi için bir açıklaması olmalıdır. Kullanımdan kaldırıldı, bunun yerine localized_short_description kullanın.

localized_short_description

Text

i18n destekli bu TicketType için kısa açıklama.

Bu, kullanıcı tarafından görülebilir, ör. "yetişkinler", "çocuk", "veteran", "Satır J" vb. Zorunludur. Her bilet türünün kullanıcı tarafından görülebilmesi için bir açıklaması olmalıdır. Her yerel ayar için ayrı değerler sağlanabilir.

price

Price

Bu türdeki tek bir biletin, vergiler hariç fiyatıdır. Hizmet'in vergi oranı, biletlerine uygulanır.

per_ticket_fee

PerTicketFee

Bu bileti satın almanın ek ücretleri. (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 çok boyutu temsil ettiğinde ek seçenekler kullanışlıdır.

1. Örnek: "yetişkinler", "çocuklar" için farklı türde bir giriş bileti ek seçenek olarak dili veya dili seçerseniz beklenen TicketType listesi şu şekilde olur: - { Ticket_type_id: "ticket_type_1" localized_short_description { value: "yetişkinler" } localized_option_description { value: "ingilizce" } } - { bilet_type_id: "ticket_type_2" localized_short_description { value: "yetişkinler" } localized_option_description { değer: "ispanyolca" } } - { bilet_type_id: "ticket_type_3" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "ingilizce" } } - { bilet_type_id: "ticket_type_4" localized_short_description { value: &quot;child&quot; } localized_option_description { değer: "ispanyolca" }

2. Örnek: İsteğe bağlı kuru çanta eklentisiyle birden fazla saat boyunca kano kiralama hizmeti, short_description "3 saat" olabilir. Option_description, "kuru torba ile" olabilir. veya "sıcak çanta olmadan": - { Ticket_type_id: "ticket_type_1" localized_short_description { value: "2 saat" } localized_option_description { value: "ingilizce" } } - { bilet_type_id: "ticket_type_2" localized_short_description { value: "2 saat" } localized_option_description { değer: "ispanyolca" } } - { bilet_type_id: "ticket_type_3" localized_short_description { value: "3 saat" } localized_option_description { value: "ingilizce" } } - { bilet_type_id: "ticket_type_4" localized_short_description { value: "3 saat" } localized_option_description { değer: "ispanyolca" }

İsteğe bağlıdır ancak hizmet içindeki herhangi bir bilet türünde bu alan ayarlanmışsa diğer tüm bilet türlerinde bu alanın da ayarlanmasını bekleriz (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
. Bu koltuklar, hem başlık hem de ayrıntılı açıklamayla seçenek belirtmek için kullanılmak üzere tasarlanmıştır. Örneğin: "Premium Koltuk
Bu seçenek, tamamen yastıklı koltuklar, özel TV'ler, koltukta yiyecek ve içecek servisi dahil olmak üzere özel kutularda oturma alanı sunar. Bu koltuklar sahanın muhteşem manzarasını sunuyor."

TicketingVerticalSpecificData

Etkinlik biletleme sektörüne özgü ek bilgiler.

Alanlar
event_category

EventCategory

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

event_url

string

İş ortağının web sitesindeki etkinliğin 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 kullanıcı.

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 bulunabileceği 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 varlığın benzersiz tanımlayıcısı. (isteğe bağlı)

name

string

Tüzel kişinin adı. (gerekli)

url

string

Varlığı açık bir şekilde açıklayan web sayfasının URL'si. Bu, varsa tüzel kişinin 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 parametresinde relevant_url değerini kullanın. (isteğe bağlı)

entity_type

EntityType

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

entity_role

EntityRole

Tüzel kişinin etkinlikteki rolü. (isteğe bağlı)

public_identification_data

PublicIdentificationData

Tüzel kişinin herkese açık referansları. (isteğe bağlı)

EntityRole

Tüzel kişinin etkinlikteki rolü.

Sıralamalar
ENTITY_ROLE_UNSPECIFIED Belirtilmedi.
ENTITY_ROLE_HEADLINER Öğe, etkinlikteki ana sanatçıyı veya en iyi performans gösteren kişiyi temsil eder.
ENTITY_ROLE_SUPPORTER Öğe, etkinlikte destekleyici bir sanatçıyı temsil ediyor.
ENTITY_ROLE_HOME_TEAM Varlık, (spor) etkinliğinde ev sahibi takımı temsil eder.
ENTITY_ROLE_AWAY_TEAM Varlık, (spor) etkinliğinde deplasmandaki takımı temsil eder.

EntityType

Varlık türü. Not: Evrensel bir ontoloji olması amaçlanmamıştır.

Sıralamalar
ENTITY_TYPE_UNSPECIFIED Belirtilmedi. Kullanmayın.
ENTITY_TYPE_PERFORMER Varlık, bir konser veya gösteride performans gösteren sanatçıyı veya grubu temsil eder. Yalnızca etkinlik kategorisi KONSER veya TİYAT 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 KONSER olduğunda geçerlidir.
ENTITY_TYPE_SPORTS_SERIES Varlık, 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 gerçekleştirilen oyunun 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 Konserler.
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 Kişi olan düzenleyen için.
ORGANIZATION Kuruluş olan düzenleyici için.

PublicIdentificationData

Tanımlayıcılar, web sayfaları veya bir varlığa atıfta bulunan 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ı dahildir.Ör. https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (isteğe bağlı)

musicbrainz_id

string

Sanatçının veya diğer müzik varlıklarının (varsa) 36 karakterlik musicbrainz tanımlayıcısı. https://musicbrainz.org/doc/MusicBrainz_Identifier sayfasına göz atın. (isteğe bağlı)

TimeRange

Kapalı-açık bir zaman aralığı, ör. [start_time, end_time).

Alanlar
start_time

Timestamp

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

end_time

Timestamp

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

TokenizationConfig

Satıcı bazında ayarlanan ödeme işleyici jetonlara ayırma yapılandırması.

Alanlar
tokenization_parameter

map<string, string>

Tokenleştirme yapılandırmasında genellikle anahtarı "ağ geçidi" olan bir tokenization_parametresi bulunur. ve değeri işleyenin adı olur.

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

Braintree örneği: tokenization_parameter { anahtar: "ağ geçidi" değer: "braintree" } tokenization_parameter { key: &quot;braintree:apiVersion&quot; değer: "v1" } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; değer: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" değer: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; değer: "Üretim_xxx_yyy" }

Stripe örneği: tokenization_parameter { key: "ağ geçidi" değer: "çizgi" } tokenization_parameter { key: &quot;stripe:version&quot; değer: "28-02-2018" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; değer: "pk_1234" }

Adyen örneği: tokenization_parameter { anahtar: "ağ geçidi" değer: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "kimliğiniz" }

billing_information_format

BillingInformationFormat

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

BillingInformationFormat

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

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

ToursAndActivitiesContent

Turlar ve Etkinlikler'e özel içerik alanları. Tekrarlanan alandaki her öğe, ayrı oluşturmaya izin vermek için bağımsız olmalıdır (ör. madde işareti olarak).

TurlarveEtkinlikİçeriklerini Doldurmak, turlar ve etkinlikler için kesinlikle önerilir ancak kesinlikle zorunlu değildir. Tüm alanlar, temel biçimlendirme için hem düz metni hem de HTML benzeri metinleri destekler. Desteklenen HTML benzeri biçimlendirme etiketleri:

Kelime öbeği etiketleri:
, , , : 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 hiçbir etiket ve özel stile izin verilmez ve bunlar kaldırılacak. Tüm URL'ler, sabitler ve bağlantılar kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez.

Önemli notlar: * highlights, exclusion ve hizmet açıklamasındaki diğer, daha spesifik alanlarda zaten sağlanan verileri kopyalamayın. * Desteklenmeyen etiketlerdeki içerikler çıkarılacağı ve istenmeyen kullanıcı deneyimine yol açabileceği için, yukarıda belirtilenler dışında başka etiketler kullanmaktan kaçının.

Alanlar
highlights[]

Text

Öne çıkanların kullanıcı tarafından görülebilen listesi.

inclusions[]

Text

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

exclusions[]

Text

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

must_know[]

Text

Önemli notların kullanıcılar tarafından görülebilen listesi. Yaş kısıtlamaları veya bu hizmeti kullanılamaz hale getiren diğer koşullar gibi ayrıntılar için kullanın.

UnsupportedPartySizeOption

Kapsama alanı dışındaki taraflar için seçenekler.

Alanlar
call_merchant

CallMerchant

Kapsama alanı dışında olan gruplar işletmeye telefon edebilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Gösterilecek örnek metin: "{waitlist_rules.max_party_size} kişiden büyük gruplar için lütfen {phone} numaralı telefondan restoranı arayın." CallMerchant ayarlanmalıdır, ancak boş olacaktır.

UpdateBookingRequest

google.maps.booking.v1alpha.Booking güncelleme isteği

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 zamana ç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ği

Alanlar
update_mask

FieldMask

Tüm sipariş alanlarının alan maskesi güncellenecek

order

Order

Güncellenecek sıra

GüncellemeHizmet İsteği

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 hiç alışveriş yapmamış kullanıcıların satın alabileceği bir ödeme seçeneğidir.

new_to_payment_option

bool

Yalnızca aynı ödeme seçeneğini daha önce 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 kursu vb.

Alanlar
session_instructions

Text

Bu sanal sınıfın nasıl oluşturulduğuyla ilgili talimatlar. İş ortağı rezervasyona video URL'sini dahil etmezse video URL'sinin kullanıcıyla paylaşılacağı zaman bu metinde yer almalıdır. Ör. "Zoom URL'si, dersten 30 dakika önce gönderilecek". (Önerilen)

session_requirements

Text

Belirtilen sanal oturum için gerekenler. Ör. yoga matı, yemek pişirme gereçleri vb. (Önerilen)

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 canlı değilse ve önceden kaydedilmişse bu değeri true 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 OTHER olarak ayarlanmışsa platformun adı. (Platform OTHER olarak ayarlanırsa gereklidir)

Platform

Satıcı tarafından hangi sanal platformun kullanılacağını belirten sıralama.

Sıralamalar
PLATFORM_UNSPECIFIED Kullanılmayan.
FLEXIBLE Satıcı, kullandığı video platformu konusunda esnektir.
GOOGLE_HANGOUTS Google Hangouts ürünü.
GOOGLE_MEET Meet ürünü.
ZOOM Zoom Video İletişimi.
SKYPE Skype'a dokunun.
YOUTUBE YouTube'da canlı yayın yapma.
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şlevi 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şlevi sağlamıyorsa bu alan doldurulmamalıdır.

supports_additional_request

bool

True (doğru) ise kullanıcı bu hizmetin bekleme listesine katılırken serbest biçimli bir 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çenekleri ayarlayın. Daha büyük taraflara bekleme listesine katılmak için alternatif seçenekler sunulmayacaksa boş bırakın.