Package google.maps.booking.v1alpha

Dizin

AdsAccountLinkingService

Google Ads ile İş Ortağı Merkezi arasındaki hesap bağlantılarını yönetme hizmeti.

BookingNotification

Harici planlama iş ortaklarından randevularla ilgili bildirimler alır. İş ortağı, CreateBooking ve CheckAvailability gibi rezervasyona dayalı UPÇ'leri mi yoksa CreateOrder ve CheckOrderFulfillability gibi siparişe dayalı UPÇ'leri mi uyguladığına bağlı olarak UpdateBooking veya UpdateOrder'ı çağırmalıdır.

UpdateBooking

rpc UpdateBooking(UpdateBookingRequest) returns (Booking)

Mevcut bir Booking öğesini günceller.

Yetkilendirme kapsamları

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

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

rpc UpdateOrder(UpdateOrderRequest) returns (Order)

Mevcut bir Order öğesini günceller.

Yetkilendirme kapsamları

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

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

Feed

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

GetStatus

rpc GetStatus(GetStatusRequest) returns (FeedStatus)

Belirtilen toplayıcı tarafından daha önce yüklenen bir feed'in Status değerini 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 daha önce yüklenen birden fazla satıcı, hizmet veya bilgi dokümanı feed'inin Status değerini alır ve döndürür.

Yetkilendirme kapsamları

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

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

InvalidationService

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

InvalidateResource

rpc InvalidateResource(InvalidateResourceRequest) returns (Empty)

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

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

Desteklenen kaynak türleri: - Araç teslimi

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 (bozuk istek gibi) gerçekleştirir ve 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ı, atomikliği garanti etmez.

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ı, atomikliği garanti etmez. Yalnızca başarıyla güncellenen müsaitlik durumu aralıkları 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 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'yi siler. Satıcının tüm hizmetleri ve müsaitlik 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. Hizmetin tüm müsaitlik durumu bilgileri 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 döndürür.

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

EventMetadata

Etkinlikler alanına özgü olan işlem bağlantısı hakkında ek bilgiler.

Alanlar
surface

Surface

Bir işlem bağlantısıyla ilişkili, önceden belirlenmiş etkinlik yüzeyi. Bu özellik yalnızca Etkinlik sektörü için kullanılır.

Platform

Bir işlem bağlantısıyla ilişkili, önceden belirlenmiş etkinlik yüzeyi. Bu özellik yalnızca Etkinlik sektörü için kullanılır.

Sıralamalar
SURFACE_UNSPECIFIED Yüzey belirtilmedi.
SURFACE_YOUTUBE İşlem bağlantısı, YouTube'da etkinlik bileti rezervasyonu yapma işlemidir.
SURFACE_ADS İşlem bağlantısı, etkinlikle ilgili bir reklamı tıklamaktır.

ActionPlatform

İşlemin gerçekleştirildiği platform. Web uygulaması genel yedek çözümdür. ACTION_PLATFORM_WEB_APPLICATION ile en az bir ActionLink'in olması önerilir. Platformu Android ve iOS olan bağlantılar yalnızca ilgili sistemde kullanılır.

Sıralamalar
ACTION_PLATFORM_UNSPECIFIED Platform belirtilmemiş.
ACTION_PLATFORM_WEB_APPLICATION İşlem platformu genellikle 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.

Durum

Ads hesabı bağlantısının durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen durum.
LINKED Hesap, İş Ortağı Merkezi ile Ads Portalı arasında bağlanır.
PENDING Hesap, İş Ortağı Merkezi veya Ads Portal'da onay bekliyor.
DELETED Hesap bağlantısı silinir.
REJECTED Hesap bağlantısı isteği, İş Ortağı Merkezi veya Ads Portalı tarafından reddedilir.

Tavsiye

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

Alanlar
text

Text

Google ile Rezervasyon üzerinden rezervasyon yapılırken 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

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

duration

Duration

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

spots_total

int64

Bu müsaitlik durumunun toplam yer sayısı ve açık yer sayısı. Örnekler:

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

Not: Aşağıda tanımlanan müsaitlik durumu sıkıştırma biçimini kullanarak istek gönderirseniz bu iki alan çıkarı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.

Örneğin, iki eğitmenle aynı yoga sınıfı:

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çeneklerine atıfta bulunan 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 değerlerini geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_ids parametresinin hizmet mesajında bulunması gerekmez ancak Satıcı düzeyinde tanımlanması gerekir.

recurrence

Recurrence

Birden fazla başlangıç zamanını temsil eden müsaitlik durumu için yineleme bilgileri. Tekrarlanan bir toplantı, bir iş günü için randevular içermelidir.

schedule_exception[]

ScheduleException

Bu hizmetin programlanamayacağı zamanlar. schedule_exception mesajlarının sayısını sınırlamak için bitişik istisnaları birleştirebilirsiniz.

deposit

Deposit

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

no_show_fee

NoShowFee

Bu müsaitlik durumu için isteğe bağlı olarak uygulanan, rezervasyonun kullanılmaması durumunda ödenmesi gereken ücret. Hizmetin gösterilmeme ücreti belirtilmişse geçersiz kılınır.

prepayment

Prepayment

İsteğe bağlı. Bu kullanılabilirlik durumu için isteğe bağlı ön ödeme bilgileri.

require_credit_card

RequireCreditCard

Kullanıcının bu müsaitlik durumu aralığında rezervasyon yapması 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üne sahip 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 sonu"} TicketType {ticket_type_id: "youth_1" short_description: "Çocuk hafta içi"} TicketType {ticket_type_id: "youth_2" short_description: "Çocuk hafta sonu"}

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

  • Üç bilet türüne sahip hizmet: TicketType {ticket_type_id: "adult" short_description: "Yetişkin"} TicketType {ticket_type_id: "youth" short_description: "Genç"} TicketType {ticket_type_id: "senior" short_description: "Yaşlı"}

Bu zaman aralığında üç bilet türünün de mevcut olduğunu belirtmek için availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} veya "availability {...}" değerini kullanın (bu aralıkta ticket_type_id ayarını yapmayı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'da ilgili tüm planlama kuralları geçersiz kılınır.

confirmation_mode

ConfirmationMode

Bu müsaitlik durumu için rezervasyon yapılırken kullanılacak onay modu. ONAY_MODU_SYNCHRONOUS onay modu olan müsaitlik durumu rezervasyonu oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. ONAY_MODU_ASYNKRON kabul modu olan müsaitlik durumları için rezervasyon oluşturma girişimleri hemen reddedilmelidir veya BEKLEMEDE durumuyla oluşturulmalıdır.

linkout_required_reason

LinkoutRequiredReason

İsteğe bağlı. Bu slot için bağlantı çıkışının gerekli olmasının nedeni. Ayarlanırsa bu alanın Satıcı kaynağında geçerli bir LinkoutTemplate olması gerekir. (isteğe bağlı)

ConfirmationMode

Müsaitlik durumu rezervasyonu yapılırken kullanılan onay modları.

Sıralamalar
CONFIRMATION_MODE_UNSPECIFIED Onay modu belirtilmedi. Eşzamanlı onay varsayılır.
CONFIRMATION_MODE_SYNCHRONOUS Bu müsaitlik durumu için yapılan rezervasyonlar eşzamanlı olarak onaylanır.
CONFIRMATION_MODE_ASYNCHRONOUS Bu müsaitlik durumu için yapılan rezervasyonlar eşzamansız olarak onaylanı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 seçenektir.
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.

LinkoutRequiredReason

Bir slotun bağlantı deneyimi sunmasının nedeni.

Sıralamalar
LINKOUT_REQUIRED_REASON_UNSPECIFIED Varsayılan değer: Kullanmayın, bilinmiyor değerine eşittir.
PAYMENT_REQUIRED Rezervasyon için iş ortağı platformunda ödeme yapılması 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. Bunlar genellikle bir günlük çalışma programını temsil eder. 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

Stok durumunun şu tarihe kadar tekrarlanacağı maksimum UTC zaman damgasıdır.

repeat_every

Duration

Art arda gelen müsaitlik durumu aralıkları arasındaki süreyi tanımlar.

Örnek: 20 dakikalık bir süre, 30 dakikalık bir repeat_every, 9:00'da bir start_time ve 11:00'de bir repeat_until değeri olan bir müsaitlik durumu, 9:00-9:20, 9:30-9:50, 10:00-10:20, 10:30-10:50, 11:00-11:20 saatlerinde aralık oluşturur. (gerekli)

ScheduleException

ScheduleException mesajları, çalışma gününde rezerve edilmiş/kullanılamayacak zaman aralıklarını temsil eder. Bunlar, yukarıda açıklanan yineleme için istisnalardır. Zaman aralıkları rezerve edildikçe istisnalar listesi, yeni kullanılamayan zaman aralıklarını yansıtacak şekilde güncellenmelidir. Tekrarlama işleminin kendisi değiştirilmemelidir.

Alanlar
time_range

TimeRange

Özel durumun zaman aralığı. Yineleme tarafından açıklanan ve bu kapalı-açık zaman aralığıyla çakşan tüm aralıklar kullanılamaz olarak kabul edilir.

Örnek: Yineleme için 20 dakikalık bir süre, 30 dakikalık bir repeat_every, 9:00'da bir start_time ve 11:00'da bir repeat_until belirtilmişse 9:45-11:00 arası bir time_range içeren bir ScheduleException, 9:30-9:50, 10:00-10:20 ve 10:30-10:50 arasındaki zaman aralıklarını kullanılamaz hale getirir.

Zaman aralığı kapalı-açık olduğu için 11:00'de başlayan yuvanın etkilenmeyeceğini unutmayın.

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 zaman aralığının başlangıcından ö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). Varsa ilgili Hizmetin SchedulingRules özelliğinin min_booking_buffer parametresinde belirtilen her şeyi geçersiz kılar.

first_bookable_sec

int64

Bu zaman aralığının rezerve edilebildiği ilk zaman (saniye cinsinden). 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ünün kayıtlarını silme toplu isteği.

Alanlar
parent

string

- partners/{partner_id}/feeds/{feed_name} biçiminde 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ündeki kayıtları eklemek ve/veya güncellemek için toplu istek.

Alanlar
parent

string

- partners/{partner_id}/feeds/{feed_name} biçiminde 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 müsaitlik durumu aralığını değiştirmek için 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 müsaitlik durumu aralıklarını değiştirmek için kullanılan ve başarıyla güncellenen genişletilmiş hizmet müsaitlik durumu mesajları.

Rezervasyon

Envanter alanı için rezervasyon

Alanlar
name

string

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

merchant_id

string

Slot 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

Randevu 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şlemleri hakkında bilgi.

party_size

int64

Rezervasyonun kişi sayısı

BookingFailure

Bir rezervasyonun işlenmesinin neden eşzamansız olarak başarısız olduğunu belirten durum verileri. BookingFailure, öncelikle 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" anlamına gelir
SLOT_UNAVAILABLE Referans verilen müsaitlik durumu aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, referans verilen müsaitlik durumu aralığı için zaten randevu almış.
LEASE_EXPIRED Kiralama (varsa) süresinin dolması ve istenen rezervasyonu tamamlamak için artık kullanılamaması.
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 hata oluştu. Kredi kartı türü, rejected_card_type parametresinde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiği için ödeme işlenirken bir hata oluştu.
PAYMENT_OPTION_NOT_VALID Rezervasyon için ödeme yaparken kullanılan paket/üyelik ile ilgili bir hata oluştu. 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 yapılamadı.
PAYMENT_REQUIRES_3DS1

İşlemin tekrar denenmesini istediğiniz için ödeme reddedildiğinde ayarlanır. Ancak bu kez 3DS1 istem/yanıtından sonra. Mevcut işlemin "başarısız" durumu değişmeyecektir. Bu işlem tamamen ayrı şekilde yapılır.

Hata nedeni bu olduğunda payment_failure.3DS1_parameters parametresi ZORUNLU olarak ayarlanmalıdır. Aksi takdirde mevcut neden PAYMENT_ERROR olarak değerlendirilir.

PaymentFailureInformation

Ödeme hatalarıyla ilgili bilgiler.

Alanlar
threeds1_parameters

ThreeDS1Parameters

RwG toplayıcısı tarafından kullanıcıyla 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 gösterilecek bir formun yükleneceği URL.

pa_req

string

PaymentAuthentication Request. Sağlandıysa ACSUrl formuna gönderilir.

transaction_id

string

ACS sağlayıcısı tarafından kullanılan bir tanımlayıcı. Sağlandıysa ACSUrl formuna gönderilir.

md_merchant_data

string

Satıcı verileri. Sağlandıysa ACSUrl formuna gönderilir.

BookingStatus

Rezervasyonun durumu

Sıralamalar
BOOKING_STATUS_UNSPECIFIED Belirtilmedi.
CONFIRMED Rezervasyon onaylandı
PENDING_MERCHANT_CONFIRMATION Rezervasyon, ONAYLANMIŞ durumuna geçebilmek için satıcı tarafından onaylanmayı bekliyor (bu özellik şu anda DESTEKLENMİYOR)
PENDING_CLIENT_CONFIRMATION Rezervasyon, ONAYLANMIŞ durumuna geçebilmek için müşterinin onayını bekliyor (bu özellik şu anda DESTEKLENMİYOR)
CANCELED Rezervasyon, kullanıcı adına iptal edildi.
NO_SHOW Müşteri randevu için gösterilmedi
NO_SHOW_PENALIZED Müşteri, iptal politikasını ihlal ederek randevuya gelmedi.
FAILED İşlem hatası nedeniyle rezervasyon tamamlanamadı.
DECLINED_BY_MERCHANT Rezervasyon, satıcı tarafından eşzamansız olarak reddedildi.

CallMerchant

Bu türde alan yoktur.

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

Politikanın geçerli olduğu hiçbir geri ödeme koşulu yoktur.

RefundCondition

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

Alanlar
min_duration_before_start_time

Duration

Müşterinin, refund_percent'te belirtilen hizmet maliyetinin bir kısmı için geri ödeme alabileceği, başlangıç zamanından önceki süre. 0 olarak ayarlandığında (varsayılan) hizmet istediğiniz zaman iptal edilebilir.

refund_percent

uint32

Hizmet rezervasyonu, hizmetin başlangıç zamanından en az min_duration_before_start_time önce iptal edildiği sürece geri ödenebilecek yüzde ([0, 100] aralığında). 0 (varsayılan) 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

CreateAdsAccountLinkRequest

AdsAccountLinkingService.CreateAdsAccountLink için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu Ads hesabı bağlantısının oluşturulacağı üst kaynak. Bu, İş Ortağı Merkezi hesap kimliğiyle aynıdır. Biçim: iş ortakları/{partner}

CreateMerchantRequest

Merchant oluşturma isteği.

Alanlar
parent

string

Bu satıcının sahibi olan iş ortağının ana kaynak adı (partners/{partner_id} biçiminde).

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 üst kaynak adı (partners/{partner_id}/merchants/{merchant_id} biçiminde).

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ılmamış.
VISA Visa kredi kartı.
MASTERCARD Mastercard kredi kartı.
AMERICAN_EXPRESS American Express kredi kartı
DISCOVER Discover kredi kartı.
JCB JCB kredi kartı.

DeleteAdsAccountLinkRequest

AdsAccountLinkingService.DeleteAdsAccountLink için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek AdsAccountLink öğesinin adı. Biçim: partner/{partner}/adsAccountLinks/{ads_account_link}

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 alınabilecek veya kredi kartında açık provizyon uygulanabilecek bir depozito.

Alanlar
deposit

Price

Depozito tutarı.

min_advance_cancellation_sec

int64

Depozito için minimum iptal süresi.

deposit_type

PriceType

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

DirectMerchantPayment

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

Alanlar
payment_methods[]

Text

Kullanıcı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.

EconomicOperator

Toplayıcı için Ekonomik Operatör bilgileri.

Alanlar
text

Text

Zorunlu. Üretici, yetkili temsilci, ithalatçı, distribütör, sipariş karşılama hizmeti sağlayıcı veya ürün üretme, kullanıma sunma ya da kullanıma alma ile ilgili yükümlülüklere tabi olan diğer herhangi bir gerçek veya tüzel kişi olarak tanımlanan ekonomik işletmecinin adı, adresi, telefon numarası ve e-posta adresi. economic_operator değerinin serbest biçimli dize gösterimi. Bu bilgiler " " ve "\n" kullanılarak biçimlendirilebilir.

ExtendedServiceAvailability

Kullanılabilirlik durumunun ve bu durumun kimlere/ne zaman uygulanacağının listesi.

Alanlar
merchant_id

string

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

service_id

string

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

start_time_restrict

Timestamp

Sağ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 end_time_restrict ayarlandığında, end_time_restrict değerine kadar olan tüm sürenin kastedildiği anlaşılır.

duration_restrict

Duration

Süre ayarlamak, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlikle 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ı, hizmet veya müsaitlik durumu aralıkları olabilir.

existing_items

int64

Feed'deki yeni bilgilere göre gerektiği şekilde güncellenen mevcut öğeler.

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

Feed kaynak adı. Bu ad şu şekilde biçimlendirilir:

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

State

Bu feed'in işleme durumu.

error_details

string

Bu feed'i işleyemediğimiz durumlarda daha fazla ayrıntı sağlayan, kullanıcı tarafından okunabilen dize.

statistics

FeedStatistics

Bu yayına özel istatistikler.

Durum

Bir feed'in işleme durumunu gösteren bir enum.

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ına ek olarak 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ı tarihinden itibaren sipariş karşılama süresi. Teslimat siparişlerinde, yemeğin teslim edilmesine 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-45 dakika * 30 dakikadan uzun * 50 dakikadan kısa

AdvanceOrderDetails

Önceden sipariş vermeyle ilgili destek için.

Alanlar
is_supported

bool

Önceden Sipariş olarak da bilinen ön siparişler destekliyorsa doğru değerini alır. (gerekli)

FeeDetails

Ücret ayrıntıları.

Alanlar
type

FeeType

Ücret türü. (gerekli)

fee_amount

FeeAmount

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

FeeAmount

FeeAmount örnekler: * Sabit ücret: 0 ABD doları (ücret yok), 1,5 ABD doları * Sabit ücret aralığı: 1,0 ABD doları (minimum), 3,0 ABD doları (maksimum), 5,0-6,0 ABD doları * Alışveriş sepeti boyutunun yüzdesi: %15,5, %10-20, %10 (minimum), %15 (maksimum) * Aralığın ve yüzdenin birleşimi: %25,5 ve 2,5 ABD doları (minimum), %25,5 ve 4,5 ABD doları (maksimum), %10 ve 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

Birlik 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 ila 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ü belirtilmemiş.
DELIVERY Teslimat ücretleri için.
SERVICE Hizmet ücretleri için.

FulfillmentOption

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

Alanlar
fulfillment_type

FulfillmentType

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

available_day[]

AvailableDay

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

fee_details

FeeDetails

Zorunlu. Siparişin yerine getirilme yöntemiyle ilgili ücret ayrıntıları.

minimum_order

Price

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

AvailableDay

Gün düzeyinde müsaitlik durumu.

Alanlar
fulfillment_date

Date

Zorunlu. Bir sipariş karşılama yönteminin kullanılabileceği tarih. Satıcının saat diliminde olduğu varsayılır.

last_ordering_time

Timestamp

Zorunlu. Unix zaman damgası. Kullanıcının fulfillment_date tarihine kadar sipariş verip ürün alabileceği 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ş 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ş tamamlama yönteminin ücret ayrıntıları.

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

NoFee

Siparişin yerine getirilme yöntemi için ücret alınmaz.

base_fee

MinimumFee

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

fixed_fee

FixedFee

Siparişin yerine getirilmesiyle ilişkili sabit ücret.

FixedFee

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

Alanlar
amount

Price

Zorunlu. Siparişin yerine getirilme yöntemi için sabit ücretin 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ş tamamlama yöntemi için gereken minimum ücret.

Alanlar
base_fee_amount

Price

Zorunlu. Sağlama yönteminin taban ücret tutarı.

NoFee

Bu türde alan yok.

İşlem bağlantısıyla ilişkili satın alma yöntemi için ücret alınmaz.

GenericDeleteRecord

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

Alanlar
delete_time

Timestamp

Zorunlu. Bu zaman damgası, envantere silme işleminin uygulanma sırasını belirlemek için kullanılır.

Birlik 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 yalnızca aşağıdakilerden biri olabilir:
data_record

bytes

Proto tabanlı olmayan feed'ler için.

proto_record

Any

Proto tabanlı feed'ler için.

GenericRecord

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

Alanlar
generation_timestamp

Timestamp

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

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

bytes

Proto tabanlı olmayan feed'ler için.

proto_record

Any

Proto tabanlı feed'ler için.

GeoCoordinates

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

Alanlar
latitude

double

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

longitude

double

Boylam (derece cinsinden). (isteğe bağlı)

Birlik alanı addresses. Bir 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

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

GetAdsAccountLinkRequest

AdsAccountLinkingService.GetAdsAccountLink için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak Ads hesabı bağlantısının adı. Biçim: partners/{partner}/adsAccountLinks/{ads_account_link}

GetMerchantStatusRequest

MerchantStatus alma isteği

Alanlar
name

string

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

GetStatusRequest

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

Alanlar
name

string

Ş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

Belirli bir ev hizmetinin ait olduğu kategorideki iş türü. Örneğin, tesisatçı kategorisindeki iş türleri unclog_drain ve install_faucet'tir.

IntegrationType

Entegrasyon derinliği desteklenir.

Sıralamalar
INTEGRATION_TYPE_UNSPECIFIED Varsayılan olarak END_TO_END değerine ayarlanır.
INTEGRATION_TYPE_END_TO_END Google üzerinden uçtan uca rezervasyon yapılmasına olanak tanıyan tam 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ğın geçersiz kılınmasını isteme.

Alanlar
resource_id

string

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

Örneğin, bir teslim alma kaynağının 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.

Satır Öğesi

Siparişteki tek bir öğedir. Tek bir zaman aralığında tek bir hizmetin rezervasyonudur.

Alanlar
service_id

string

Satıcı Hizmetinin kimliği.

start_sec

int64

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

duration_sec

int64

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

tickets[]

OrderedTickets

Bilet Türüne göre 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ı. Önceki bir ListMerchantStatusResponse'ten döndürülen nextPageToken değeri (varsa).

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, 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. Liste boşsa başka sonuç yoktur.

ListStatusRequest

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

Alanlar
name

string

Feed kaynak adı. Bu ad şu şekilde biçimlendirilir:

  • 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

Önceki bir List isteğinden döndürülen next_page_token değeri (varsa).

state_restrict

State

İsteğe bağlı olarak sonuçları feed durumuna göre filtrelemek için kısıtlayın.

time_range_restrict

TimeRange

İsteğe bağlı olarak sonuçları üst ve alt sınıra göre filtrelemek için kısıtlayın. 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 öğesini 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. Liste boşsa başka sonuç yoktur.

LocalizedString

Bir yerel ayara ait 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ında ve Google Haritalar'da 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ğlanırsa Google, konumu bu yerle eşleştirir.

name

string

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

Bu alan isteğe bağlıdır ancak bazı bağlamlarda gerekli olabilir. Örneğin, adı olmayan bir Service.location, aynı adreste olsa bile bir ticari tüzel kişiyle eşleşmez. (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 dahil olmak üzere konumun coğrafi bilgileri. (isteğe bağlı)

location_type

LocationType

Bu konum bir hizmet için sağlanıyorsa konumun türü belirtilmelidir.

location_id

string

Hizmet içindeki konumun benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konuma referans vermek için kullanılabilir. Örneğin, özel kayıt formunda teslim alma yeri seçeneklerini belirtmek için bir dizi konum kimliği kullanılabilir. Ayarlanmışsa 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, MEETING_LOCATION olarak da kullanılır.
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çiminde olan satıcı kaynak 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 telefon numarası (ülke ve alan kodları dahil), ö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 birimi biriminin kesirleri (ör. bir sentin kesirleri) en yakın çift sayıya yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alanın desteği sonlandırıldı. Lütfen bunun yerine tax_rate alanı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 ayarlanmamışsa herhangi bir kısıtlama olmadığı varsayılır.

payment_option[]

PaymentOption

Bu satıcı için kullanılabilen ö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 desteklediği durumlarda jetonlu ödeme işleyici yapılandırması.

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 aracılığıyla bir hizmet rezervasyonu yapılırken kullanıcıya gösterilen ilgili satıcının 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örüntülerken 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üketicilere yönelik birden fazla markası yok mu? --> Bu alanı yoksay

Yapılandırılmış birden fazla marka var mı?

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

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

Dikkat: Çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. 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ının Hizmetleri'ni açıklamak için kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı)

waitlist_advisement

Advisement

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan bir kullanıcıya belirli bir satıcıdan gönderilen genel tavsiyeler. Önerideki her bir metin alanının uzunluğu 100 bayt ile sınırlı olmalıdır.

economic_operator

EconomicOperator

İsteğe bağlı. Yasal düzenlemelere uygunluk için bu satıcıyla ilişkili ekonomik işletme bilgileri (isteğe bağlı)

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çiminde olan 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şleme 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 konumu. Satıcı Coğrafi eşleşmede değilse boştur.

local_services_match

LocalServicesMatchInfo

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

direct_urls[]

DirectUrl

Geçerli satıcı envanterinin içeriğini gösteren URL'lerin listesi. Bu, envanterin gerçekten yayınlandığı anlamına gelmez 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österilen 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çı" ve "halı_temizleme".

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şleme durumu.

Sıralamalar
PROCESSING_STATUS_UNSPECIFIED Durum belirtilmedi.
IN_PROGRESS Satıcı Madden tarafından alındı ancak hâlâ işleniyor. Bu durumdaki satıcılar için başka bir durum 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 olabilecek bir para tutarı aralığı için sarmalayıcı. min_amount ve max_amount parametrelerinden 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ş

Satıcıyla servis randevusu için verilen bir sipariş.

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

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ılabilen 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ı için geçerlidir ve 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ı. Bu durum kullanıcı 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 hizmette bulunan tax_rate alanını geçersiz kılar. 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 çok oturumlu/paketler için geçerlidir. Bu durumda değer > 1 olmalıdır.

purchase_interval

TimeRange

Ödeme seçeneği bu aralık içinde satın alınabilir.

valid_interval

TimeRange

Ödeme seçeneği bu aralık içinde kullanılabilir (ör. Ocak 2017 için özel fiyat). Mevcut olduğunda valid_duration ve activation_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. Ayarlanmazsa tüm kullanıcılar uygun olur.

ActivationType

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

Sıralamalar
ACTIVATION_TYPE_UNSPECIFIED Kullanılmamış.
ACTIVATION_ON_PURCHASE Geçerlilik, 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ılmamış.
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ığı içinde kullanılabilir. Oturum sayısı geçerli değildir.

PaymentProcessorConfig

Satıcıya göre ayarlanan bir ö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 bir yapılandırma.

PaymentRestrictions

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

Alanlar
credit_card_restrictions

CreditCardRestrictions

Bu satıcının kabul ettiği kredi kartlarıyla ilgili kısıtlamalar. Bu alan ayarlanmazsa tüm kredi kartlarının kabul edildiğini varsayarız. CreditCardType tarafından desteklenen kartların listesinin zaman içinde büyüyeceğini unutmayın. Bu nedenle, bu alanı boş bırakmak yapılandırmayı gelecekteki değişikliklere tabi kılar.

PerOrderFee

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

Alanlar
delivery_fee

Price

Teslimat yöntemine göre değişebilen bir ücret.

processing_fee

Price

Kullanıcının ödeme yöntemini işleme ücreti.

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

Mekana/tesise ödenen ü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 (ör. "US") kullanılarak belirtilen ülke (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 zorunludur. (isteğe bağlı)

postal_code

string

Posta kodu (ör. "94043"). (gerekli)

street_address

string

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

Ön Ödeme

Kullanıcıdan rezervasyon kapsamında alınabileceği bir ödeme.

Alanlar
price_info

PriceInfo

Fiyat ayrıntılarının kapsayıcısıdır.

PrepaymentStatus

Bir rezervasyonun ön ödeme durumu.

Sıralamalar
PREPAYMENT_STATUS_UNSPECIFIED Belirtilmemişse varsayılan olarak PREPAYMENT_NOT_PROVIDED olur.
PREPAYMENT_PROVIDED Rezervasyon ücreti önceden ödenmiş olmalıdır.
PREPAYMENT_NOT_PROVIDED Rezervasyon ücreti önceden ödenmemiştir.
PREPAYMENT_REFUNDED Ücret daha önce PREPAYMENT_PROVIDED olarak ayarlanmıştı ancak şimdi geri ödendi.

Fiyat

Bir hizmetin fiyatı veya ücreti.

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.

PriceInfo

Fiyat ayrıntıları kapsayıcısı.

Alanlar
price_type

PriceType

Fiyatın veya fiyat aralığının nasıl uygulandığını tanımlar (kişi başı veya sabit)

Birleştirme alanı price_options. Fiyat seçenekleri, tam bir fiyat ya da bir aralığı belirtmektir. price_options şunlardan yalnızca biri olabilir:
price

Price

Bir hizmetin veya ücretin fiyatıdır.

price_range

PriceRange

Bir hizmetin veya ücretin üst ve/veya alt sınırı.

PriceInterpretation

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

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

Fiyat belirli bir değer olarak yorumlanmalıdır.

Ö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 PriceInterpretation özelliğini kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED değerini kullanması gerektiğini unutmayın.

Örnekler: 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 PriceInterpretation özelliğini kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED değerini kullanması ve Price değerinin boş olması gerektiğini unutmayın.

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

PriceRange

Her iki değer de ayarlanmazsa sınırsız olarak değerlendirilen bir parasal tutar aralığı için sarmalayıcı. min_amount [min_tutar] ve max_amount [maks_tutar] özelliklerinden en az biri gereklidir.

Alanlar
min_price

Price

Minimum tutar.

max_price

Price

Maksimum tutar. Her zaman > min_price olmalıdır.

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.

Örnekler: Masa rezervasyonu için 50 ABD doları depozito; yoga dersi için 20 ABD doları kullanılmayan rezervasyon ücreti

PER_PERSON

Belirtilen fiyat kişi başınadır ve toplam fiyat, Kaynaklar'da price_micros * party_size olarak belirtilen grup boyutuna göre hesaplanır. PER_PERSON fiyatına, müsaitlik durumu kaynaklarında bir grup boyutu eşlik etmelidir. Ayarlanmadıysa bir adet kişi sayısı kullanılır.

Örnekler: Müze biletleri için her biri 10 TL

QuantitativeValue

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

Alanlar
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 fazla 5,5 * 5,5 ila 6,5

RangeValue

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

Alanlar
min_value

double

Minimum değer.

max_value

double

Maksimum değer.

Derecelendirme

Bir varlığın Derecelendirmesini tanımlar.

Alanlar
value

double

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

number_of_ratings

uint64

Değeri hesaplamak için kullanılan puan 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'i destekleyen medyanın altyazısı. Yalnızca düz metin desteklenir. Tüm HTML bileşenleri kaldırılır. (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ılmamış.
PHOTO URL tarafından sağlanan medyanın fotoğraf olduğunu belirtir.

ReplaceServiceAvailabilityRequest

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

Alanlar
service_availability

ServiceAvailability

Mevcut olanları değiştirmek için kullanılan hizmet durumu.

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

Farklı personel veya odalar hizmetin bir parçası olduğunda, müsaitlik durumu aralıklarını birbirinden ayırt etmek için kaynak 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 veren personel için isteğe bağlı kimlik. Bu alan, tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında personel üyesini tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurmak için zaman içinde istikrarlı olmalıdır. staff_name alanı varsa bu alan da bulunmalıdır.

staff_name

string

Hizmeti sunan personel üyesinin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve şeffaf olmayan bir tanımlayıcı yerine kullanıcı tarafından okunabilir olmalıdır. Personel_kimliği varsa bu alan da mevcut olmalıdır.

room_id

string

Hizmetin bulunduğu oda için isteğe bağlı bir kimlik. Bu alan tüm satıcılar, hizmetler ve müsaitlik durumu kayıtlarında odayı tanımlar. Ayrıca geçmiş rezervasyonlarla ilişki kurmak için zaman içinde istikrarlı olmalıdır. room_name alanı varsa bu alan da 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 şeffaf olmayan bir tanımlayıcı yerine kullanıcı tarafından okunabilir olmalıdır. (isteğe bağlı ancak room_id varsa zorunludur) Yemek alanında oda adı yalnızca bar veya veranda gibi oturma alanları için kullanılmalıdır ve sabit fiyatlı menüler, özel etkinlikler veya oda dışındaki diğer değerler (ör. rezervasyon veya akşam yemeği) için kullanılmamalıdır. Varsayılan oturma alanının ilişkili bir odası olmaması önemle tavsiye edilir.

party_size

int32

Yalnızca Yemek için geçerli: Bu zaman aralığında kabul edilebilecek grup boyutu. 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).

room_description

Text

İsteğe bağlı. Yerelleştirilmiş oda açıklaması. Ayarlanırsa varsayılan bir değer sağlanmalıdır. Satıcının yerel ayarı için ortak dillerin belirtilmesi tercih edilir. (isteğe bağlı)

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 süresi içinde iptal ücreti.

noshow_fee
(deprecated)

Price

İptal etmeden rezervasyonu kullanmama ücreti.

admission_policy

AdmissionPolicy

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

cancellation_policy

CancellationPolicy

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

Birlik alanı min_booking_buffer. Son rezervasyonun yapılabileceği zamandan müsaitlik durumu aralığının başladığı veya sona erdiğ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ğeri ayarlanmışsa pozitif olması gerektiğini unutmayın. Her ikisi de ayarlanmazsa slot, slot başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanmışsa yalnızca bir değer seçilir ve diğer değer yoksayılır. Hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz.

Örnekler:

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

  • Son biletin kapanmadan 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 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 zamandan müsaitlik durumu aralığının sona erdiği zamana kadar geçen süre (saniye cinsinden). Bu alan ayarlanırsa kullanıcıların satın alınan biletleri aralık başladıktan sonra kullanabileceğini belirtmek için "admission_policy" alanı TIME_FLEXIBLE olarak ayarlanmalıdır.

AdmissionPolicy

Bu hizmetin giriş politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmayan.
TIME_STRICT Müşterilerin müsaitlik aralığının başlangıç zamanında hazır olmaları gerekir ve hizmetin, aralığın bitiş zamanında tamamlanması beklenir. 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 arası fitness sınıfı.
TIME_FLEXIBLE

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

TIME_FLEXIBLE kullanım alanlarına örnekler: * Satın alma tarihinde herhangi bir zamanda kullanılabilen 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üze girişi senaryosundaki 10:00 için zamanlanmış giriş bileti, kullanıcının 10:00'da müzede olmasını gerektirir. Bu hizmet için kullanım alanlarının başlangıç zamanı, belirtilen giriş zamanını temsil eder. Ancak bitiş zamanı yalnızca rezervasyon için müsaitlik aralığını tanımlamak amacıyla bir anahtar olarak kullanılır.

Hizmet

Satıcı tarafından sunulan bir hizmet (ör. saç kesimi) hakkında bilgi.

Alanlar
name

string

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

service_name

string

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

localized_service_name

Text

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

description

string

Hizmetin, kullanıcının görebildiği açıklama. Desteği sonlandırıldı. Bunun yerine localized_description özelliğini kullanın.

localized_description

Text

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

Bu alan hem düz metni hem de HTML benzeri biçimlendirmeyi destekler. Düz metin bölümlerinin aksine, burada başlıklar, paragraflar, listeler ve bazı kelime öbeği etiketleri kullanılarak özel 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. <br>, <strong> ve <em> dışındaki tüm iç etiketler, stiller veya özellikler yoksayılacaktır. 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: Gemi seyahati özelliklerinin listesini göstermek için:
<ol>
<li>Muhteşem okyanus manzarası ve vahşi yaşamla oynama şansı.</li>
<li>Seyahat planlamalarını ve hizmetlerini dikkatlice tasarladık.</li>
<li>En düşük fiyat garantisi.</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, tüm iç etiketler, özellikler ve stiller yoksayılır. Yalnızca saf metin içerikleri korunur.

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. alanına fotoğraf URL'lerinizi gönderebilirsiniz.

Önemli notlar:

  • Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve istenmeyen bir kullanıcı deneyimine neden olabileceğinden, yukarıda belirtilen desteklenen etiketler dışında başka etiketler kullanmamaya çalışın.
  • 3'ten fazla 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ıyı düz, basit ve anlaşılır tutmak daha iyi bir kullanıcı deneyimi oluşturmanıza yardımcı olur.
  • Şu anda desteklenen düzenler kullanım alanlarınız için yeterli değilse lütfen Google ile Rezervasyon Ekibi ile iletişime geçin.
  • Ö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/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

Kullanıcıdan nasıl depozito 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

Bilet destekleniyorsa bu hizmet için rezervasyon yapılabilen/satın alınabilen bilet türleri. (isteğe bağlı)

related_media[]

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, medya öğelerinin son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bu öğeleri 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 almayla ilgili 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. - Bir otel lobisinde buluşup otobüs turuyla ziyaret edilecek yere gitme Toplantı yeri belirtilmelidir.

rating

Rating

Tüm yorumlar için toplu bir metrik olarak bu hizmetin 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 oturumla ilgili bilgiler. 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 veya prepayment_type REQUIRED olarak AYARLANMAMIŞSA gereklidir.

uri_template

UriTemplate

İsteğe bağlı. Google'ın harici sitenin URL'lerini nasıl oluşturması gerektiğini belirten isteğe bağlı bir şablon.

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

Hizmetin başlangıç zamanından önce, kullanıcıdan ödeme alınması için geçen 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 kullanılan enum.

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

PrepaymentType

Ön ödeme türünü belirten bir enum.

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak, ön ödemenin NOT_SUPPORTED olduğunu varsayacağız.
REQUIRED Kullanıcının bu hizmeti rezervasyon sırasında ödemesi 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 desteklenmez.

ServiceType

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

Sıralamalar
SERVICE_TYPE_UNSPECIFIED Kullanılmamış.
SERVICE_TYPE_DINING_RESERVATION Yemek rezervasyonu.
SERVICE_TYPE_FOOD_ORDERING Yemek siparişi, paket servisi veya paket servisi ve teslimat hizmeti olabilir.
SERVICE_TYPE_FOOD_DELIVERY Paket yemek servisi.
SERVICE_TYPE_FOOD_TAKEOUT Paket servisi.
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 ortamda gerçekleştirilen 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ü" hizmet özelliğini "Kişisel" ve "İşletme" olası değerleriyle tanımlayabilir. Bir kuaför ise "Hizmet Türü" hizmet özelliğini "Saç Kesimi", "Renk" ve "Stil" olası değerleriyle tanımlayabilir.

Alanlar
attribute_id

string

Aynı satıcının diğer hizmet özellikleri arasında bu hizmet özelliğini benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "account-type").

attribute_name

string

Bu özelliğin kullanıcı tarafından görülebilen 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 diğer değerler arasında bu değeri benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "kişisel").

value_name

string

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

ServiceAttributeValueId

Bir hizmete uygulanacak hizmet özelliğinin belirli bir 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 durumunun ve bu durumun kimlere/ne zaman uygulanacağının listesi.

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. Yani aşağıdaki koşul geçerliyse mevcut tüm müsaitlik durumu silinir:

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

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

  availability.duration == duration_restrict

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 end_time_restrict ayarlandığında, end_time_restrict değerine kadar olan tüm sürenin kastedildiği anlaşılır.

duration_restrict

Duration

Süre ayarlamak, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlikle 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 bilgi formu tanımlar.

Alanlar
field[]

ServiceIntakeFormField

Kullanıcıya gösterilecek alanlar.

first_time_customers
(deprecated)

bool

Doğru ise bu form ilk kez alışveriş yapan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, kayıt 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, kayıt 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ı ve hem hizmet düzeyinde hem de destek kaydı giriş formları genelinde 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. Örneğin, sağlanan konum listesine ek olarak "Tedarikçiyle daha sonra iletişime geçeceğim" seçeneği de sunulabilir. (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 bir enum.

Sıralamalar
FIELD_TYPE_UNSPECIFIED Belirtilmemiş veya bilinmeyen türde alanlar yoksayılır.
SHORT_ANSWER Metin için tek satırlık bir giriş alanı.
PARAGRAPH Metin için çok satırlı bir 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ı içeren bir veya daha fazla listelenen öğ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ırsa veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, Service.price tarafından belirtilen fiyatın aynısıdır. Hizmet fiyatının geçerli vergilerden muaf olduğu veya bu vergileri içerdiği varsayılır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfır dışında bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, hizmet fiyatı 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 yapmak için kullanıcıya gösterilen kurallar ve yönergeler grubu.

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 parametresini kullanın.

localized_text

Text

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

Metin

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

Alanlar
value

string

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

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ılabilen en küçük birimdir (ör. rafting gezisinde yer, müzeye giriş, tam gün çift kişilik kano kiralama).

Alanlar
ticket_type_id

string

Destek kaydı kimliği, aynı hizmetin farklı destek kaydı 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şkin", "Çocuk", "Eski asker", "J Sıra" vb. Zorunlu. Her bilet türünün, kullanıcı tarafından görülebilecek bir açıklaması olmalıdır. Kullanımdan kaldırıldı, bunun yerine localized_short_description 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ür bir biletin fiyatı (vergiler hariç). Hizmet'in vergi oranı, biletlerine uygulanır.

per_ticket_fee

PerTicketFee

Bu bileti satın almanın ek ücretleri. (isteğe bağlı)

price_display_type

PriceDisplayType

İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş fiyat görüntüleme türü.

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 açıklaması (varsa). Her yerel ayar için ayrı değerler sağlanabilir.

Ek seçenekler, bilet türü birden fazla boyutu temsil ettiğinde 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: &quot;adult&quot; } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_2&quot; localized_short_description { value: &quot;adult&quot; } localized_option_description { değer: "ispanyolca" } } - { bilet_type_id: "ticket_type_3" localized_short_description { value: "alt" } localized_option_description { value: &quot;english&quot; } } - { ticket_type_id: &quot;ticket_type_4&quot; localized_short_description { value: "alt" } localized_option_description { değer: "ispanyolca" }

2. örnek: İsteğe bağlı kuru çanta eklentisi olan çok saatlik kayak kiralama. short_description "3 saat", option_description ise "kuru çanta dahil" veya "kuru çanta hariç" olabilir: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 saat" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 saat" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 saat" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 saat" } localized_option_description { value: "spanish" } }

İ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). Örneğin, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] geçerli bir liste değildir.

Yalnızca iki HTML biçimlendirme etiketi desteklenir: ve
. Bu öğeler, hem başlık hem de ayrıntılı açıklama içeren seçenekleri belirtmek için kullanılır. Örneğin: "Premium Koltuklar
Bu seçenek, tam yastıklı koltuklar, özel TV'ler ve koltuk içi yiyecek ve içecek servisi dahil olmak üzere özel kutularda koltuklar sunar. Bu koltuklardan sahaya güzel bir manzara hakimdir."

inventory_type

InventoryType

İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş envanter türü.

InventoryType

Bu türdeki tek bir biletin önceden belirlenmiş envanter türü.

Sıralamalar
INVENTORY_TYPE_UNSPECIFIED Envanter türü belirtilmedi.
INVENTORY_TYPE_PRIMARY Birincil envanter.
INVENTORY_TYPE_VERIFIED_RESALE Doğrulanmış yeniden satış envanteri.
INVENTORY_TYPE_RESALE Yeniden satış envanteri.
INVENTORY_TYPE_AGGREGATOR Toplayıcı envanteri.

PriceDisplayType

Açılış sayfasında gösterilen fiyat biçimini belirtir.

Bu alan, bağlantı vermeyen envanter için yoksayılır.

Bu alan, Google platformlarının açılış sayfasında kullanılanla aynı fiyat biçimini göstermesine olanak tanır. Tutarlı fiyat biçimleri dönüşüm oranını artırır ve kafa karışıklığını azaltır.

Sıralamalar
PRICE_DISPLAY_TYPE_UNSPECIFIED Fiyat görüntüleme türü belirtilmedi. Hangi biçimin gösterileceğini Google belirler.
PRICE_DISPLAY_TYPE_BASE Açılış sayfasında gösterilen fiyat, taban fiyattır.
PRICE_DISPLAY_TYPE_ALL_IN Açılış sayfasında gösterilen fiyata tüm ücretler ve vergiler dahildir.

TicketingVerticalSpecificData

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

Alanlar
event_category

EventCategory

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

event_url

string

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

entity[]

Entity

Etkinlikle ilgili öğelerin 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 düzenleyicinin 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.

brand_name

Text

İsteğe bağlı. Yerelleştirilmiş marka adı.

event_creator

EventCreator

İsteğe bağlı. Etkinliği oluşturan kullanıcı hakkında bilgiler.

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 öğeyi temsil eder.

Alanlar
id

string

İş ortağının veritabanındaki öğenin benzersiz tanımlayıcısı. (isteğe bağlı)

name

string

Varlığın adı. (gerekli)

url

string

Varlık hakkında net bilgi veren 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

Varlığın etkinlikteki rolü. (isteğe bağlı)

public_identification_data

PublicIdentificationData

Varlıkla ilgili 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 Varlık, etkinlikte destekleyici bir sanatçıyı temsil eder.
ENTITY_ROLE_HOME_TEAM Varlık, (spor) etkinliğindeki 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 olarak tasarlanmamıştır.

Sıralamalar
ENTITY_TYPE_UNSPECIFIED Belirtilmedi. Kullanmayın.
ENTITY_TYPE_PERFORMER Varlık, konser veya gösteride sahne alan sanatçıyı ya da grubu temsil eder. Yalnızca etkinlik kategorisi KONSER veya TİYAT olduğunda geçerlidir.
ENTITY_TYPE_PLAYER Varlık, 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: Etkinlikler için evrensel bir ontoloji olarak tasarlanmamış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.

Etkinlik Oluşturan

Etkinliği oluşturan kullanıcı hakkında bilgiler. Yalnızca kullanıcı tarafından oluşturulan içerik etkinliklerinin yer aldığı platformlar için geçerlidir.

Alanlar
name

string

İsteğe bağlı. Etkinliği oluşturan kullanıcının adı. Karakter kısıtlaması yoktur.

EventState

Etkinliğin durumu.

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

OrganizerType

Düzenleyenin türü.

Sıralamalar
ORGANIZER_TYPE_UNSPECIFIED Belirtilmedi.
PERSON Kişi olan düzenleyenler için.
ORGANIZATION Kuruluş olan düzenleyenler için.

PublicIdentificationData

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

Alanlar
relevant_url[]

string

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

musicbrainz_id

string

Varsa sanatçının veya diğer müzik öğelerinin 36 karakterli musicbrainz tanımlayıcısı. https://musicbrainz.org/doc/MusicBrainz_Identifier adresine göz atın. (isteğe bağlı)

TimeRange

Kapalı-açık 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 jeton oluşturma yapılandırması.

Alanlar
tokenization_parameter

map<string, string>

Bir jeton oluşturma yapılandırmasında genellikle anahtarı "gateway" olan ve değeri işleyicinin adı olan bir tokenization_parameter bulunur.

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: &quot;braintree:merchantId&quot; 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: &quot;gatewayMerchantId&quot; 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 varsayılan ayarı).
FULL ad, açık adres, konum, bölge, ülke kodu ve posta kodu.

ToursAndActivitiesContent

Turlar ve Etkinlikler'e özgü içerik alanları. Tekrarlanan alandaki her öğe, ayrı olarak oluşturulmaya (ör. madde işareti olarak) izin verecek şekilde bağımsız olmalıdır.

Turlar ve etkinlikler için ToursAndActivitiesContent özelliğinin doldurulması önemle tavsiye edilir ancak zorunlu değildir. Tüm alanlar, temel biçimlendirme için hem düz metni hem de HTML benzeri metni destekler. HTML benzeri biçimlendirme etiketleri desteklenir:

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 tüm etiketlere ve özel stillere izin verilmez ve kaldırılır. Tüm URL'ler, ankörler ve bağlantılar kaldırılır ve son kullanıcılara hiçbir zaman gösterilmez.

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

Alanlar
highlights[]

Text

Kullanıcıların görebileceği öne çıkan anlar 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
Birleştirme alanı kind. Kapsama alanı dışındaki tarafların kullanabileceği seçenekler. kind yalnızca aşağıdakilerden biri olabilir:
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 fazla gruplar için lütfen {phone} numaralı telefondan restoranı arayın." CallMerchant ayarlanmalıdır ancak boş olacaktır.

UpdateAdsAccountLinkRequest

AdsAccountLinkingService.UpdateAdsAccountLink için istek mesajı.

Alanlar
update_mask

FieldMask

İsteğe bağlı. Güncellenecek alanların listesi.

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 FAILED 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

UpdateServiceRequest

Service güncelleme isteği.

Alanlar
service

Service

Yeni hizmet verileri.

update_mask

FieldMask

Hizmet için güncellenecek alanlar.

UriTemplate

Google'ın harici sitenin URL'lerini nasıl oluşturması gerektiğini belirten bir şablon.

Alanlar
uri_template

string

İsteğe bağlı. URI şablonu, RFC6570'e uygun olmalıdır (bkz. https://datatracker.ietf.org/doc/html/rfc6570). 2. seviye şablonları destekler. Bu parametreler, ilgili varlıklarda belirtilen değerlerine göre çözülür.

5 available parameters for Dining Reservation Linkout: 1) (required) {availability_slot_start_seconds} :: populated from start_sec field in availability feed 2) (required) {availability_slot_duration_seconds} :: populated from duration_sec field in availability feed 3) (optional) {resources_party_size} :: populated from party_size field in availability feed 4) (optional) {availability_availability_tag} :: populated from availability_tag field in availability feed 5) (optional) {resources_room_id} :: populated from room_id field in availability feed

Örnek Kullanım: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

Ö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şturulacağıyla ilgili talimatlar. İş ortağı, rezervasyona video URL'sini eklemiyorsa bu metinde video URL'sinin kullanıcıyla ne zaman paylaşılacağı belirtilmelidir. Ör. "Zoom URL'si, dersten 30 dakika önce gönderilecek". (Önerilen)

session_requirements

Text

Belirtilen sanal oturum için gerekenler. Ör. yoga matı, pişirme aletleri vb. (Önerilir)

virtual_platform_info

VirtualPlatformInfo

Bu oturumda kullanılan sanal platformla ilgili bilgiler. (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 DİĞER 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ılmamış.
FLEXIBLE Satıcı, hangi video platformunu kullanacağı 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 sunmuyorsa bu alan doldurulmamalıdır.

max_party_size

int32

Zorunlu. Bekleme listesi işlevi sunan 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 gruplara bekleme listesine katılmak için alternatif seçenekler sunulmamalıdır.