Package google.maps.booking.v1alpha

Dizin

AdsAccountLinkingService

Google Ads ile İş Ortağı Merkezi arasındaki hesap bağlantısını yönetmek için kullanılan hizmet.

BookingNotification

Harici planlama iş ortaklarından gelen 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)

Daha önce yüklenen bir feed'in belirtilen toplayıcıya göre 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üklenmiş birden fazla satıcı, hizmet veya stok durumu 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: - Teslim alma

Yetkilendirme kapsamları

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

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

InventoryStatus

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

GetMerchantStatus

rpc GetMerchantStatus(GetMerchantStatusRequest) returns (MerchantStatus)

Merchant ile MerchantStatus avantajlarından yararlanı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ündeki kayıtları siler. Yalnızca temel doğrulama (ör. hatalı biçimlendirilmiş istek) gerçekleştirir. Ardından, iş ortağına uygun bir yanıt hemen döndürülür. Google, istek üzerinde işletme 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ündeki kayıtları ekler ve/veya günceller. Yalnızca temel doğrulama (ör. hatalı biçimlendirilmiş istek) gerçekleştirir. Ardından, iş ortağına uygun bir yanıt hemen döndürülür. Google, istek üzerinde işletme 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
BatchReplaceServiceAvailability

rpc BatchReplaceServiceAvailability(BatchReplaceServiceAvailabilityRequest) returns (BatchReplaceServiceAvailabilityResponse)

Mevcut Services öğelerinin Availability yerini alır. Bu toplu çağrı, atomikliği garanti etmez. Yalnızca başarıyla güncellenen uygunluk 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 bir Service öğesini oluşturur ve döndürür.

Yetkilendirme kapsamları

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

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

rpc DeleteMerchant(DeleteMerchantRequest) returns (Empty)

Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant öğesini siler. Satıcının tüm hizmetleri ve kullanılabilirliği de devre dışı bırakılır. Satıcıyı daha sonra yeniden eklerseniz aynı hizmetler ve uygunluk aralıkları gösterilir.

Yetkilendirme kapsamları

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

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

rpc DeleteService(DeleteServiceRequest) returns (Empty)

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

Yetkilendirme kapsamları

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

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

rpc ReplaceServiceAvailability(ReplaceServiceAvailabilityRequest) returns (ServiceAvailability)

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesinin 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

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

Sıralamalar

EventMetadata

Etkinlikler dikeyine özgü 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 yalnızca Etkinlikler dikeyinde kullanılır.

Platform

Bir işlem bağlantısıyla ilişkili önceden belirlenmiş etkinlik yüzeyi. Bu yalnızca Etkinlikler dikeyinde kullanılır.

Sıralamalar
SURFACE_UNSPECIFIED Yüzey belirtilmemiş.
SURFACE_YOUTUBE İşlem bağlantısı, YouTube'da etkinlik bileti rezervasyonu yapmaktır.
SURFACE_ADS İşlem bağlantısı, etkinlik reklamının tıklanmasıdır.

ActionPlatform

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

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

Eyalet

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

Sıralamalar
STATE_UNSPECIFIED Durum bilinmiyor.
LINKED Hesap, İş Ortağı Merkezi ile Ads Portal arasında bağlı olmalıdır.
PENDING Hesap, İş Ortağı Merkezi'nde veya Ads portalında 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 yaparken kullanıcıya gösterilen tavsiyeler.

Alanlar
text

Text

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

Kullanılabilirlik

Satıcının hizmetinin uygunluk aralığı (saat ve yer sayısı belirtilir).

Alanlar
start_time

Timestamp

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

duration

Duration

Randevu aralığının süresi

spots_total

int64

Bu uygunluk için toplam yer sayısı ve boş yer sayısı. Örnekler:

  • 10 kişilik yoga dersinde 3 rezervasyon var: availability {spots_total: 10, spots_open: 7 ...}
  • Zaten tamamen dolu olan koltuk masajı seansı: availability {spots_total: 1, spots_open: 0 ...}

Not: Aşağıda tanımlanan kullanılabilirlik sıkıştırma biçimi kullanılarak istek gönderiliyorsa 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

Açık yer sayısı.

availability_tag

string

Bu stok durumu aralığını tanımlamak için isteğe bağlı olarak kullanılan opak dize. Ayarlandığında, randevu alma/güncelleme/iptal etme isteklerine dahil edilir.

resources

Resources

Farklı personel üyeleri veya odalar hizmetin bir parçası olduğunda bu uygunluk aralığını diğerlerinden ayırt etmek için kullanılan isteğe bağlı kaynaklar.

Örneğin, iki eğitmenin verdiği aynı yoga dersi:

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

string

Bu yer için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine referans veren 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 değerlerinin hizmet mesajında bulunması GEREKMEZ ancak satıcı düzeyinde tanımlanması gerekir.

recurrence

Recurrence

Kullanılabilirlik için yinelenme bilgileri (birden fazla başlangıç zamanını temsil eder). Bir tekrar, bir iş gününe ait randevuları içermelidir.

schedule_exception[]

ScheduleException

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

deposit

Deposit

Bu uygunluk için isteğe bağlı depozito. Belirtilmişse hizmet depozitosunu geçersiz kılar.

no_show_fee

NoShowFee

Bu müsaitlik için isteğe bağlı olarak "rezervasyonu iptal etmeme" ücreti alınabilir. Belirtilmişse hizmete gelinmeme ücretini geçersiz kılar.

prepayment

Prepayment

İsteğe bağlı. Bu müsaitlik durumu için isteğe bağlı ön ödeme bilgileri.

require_credit_card

RequireCreditCard

Kullanıcının bu uygunluk aralığına rezervasyon yaptırmak için kredi kartı bilgisi vermesi gerekip gerekmediğini gösterir. Değer ayarlanmamışsa hizmet düzeyinde ayarlanmışsa oradan devralınır. (isteğe bağlı)

ticket_type_id[]

string

Bu uygunluk aralığı için desteklenen bilet türlerinin listesini gösterir. Ayarlanmamışsa üst hizmetteki tüm bilet türleri bu zaman aralığı için kullanılabilir. Bu alanın değerlerinin üst hizmette tanımlanması gerektiğini unutmayın. Örnekler:

  • Dört bilet türü içeren hizmet: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" short_description: "Youth weekends"}

Hafta içi envanteri temsil etmek için: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Tatil günlerinde envanteri temsil etmek için: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

  • Üç bilet türü içeren hizmet: TicketType {ticket_type_id: "adult" short_description: "Adult"} TicketType {ticket_type_id: "youth" short_description: "Youth"} TicketType {ticket_type_id: "senior" short_description: "Senior"}

Bu zaman aralığı için üç bilet türünün de mevcut olduğunu belirtmek üzere availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} veya `availability {...}' kullanın (bu aralıkta ticket_type_id ayarlanmaz).

(isteğe bağlı)

duration_requirement

DurationRequirement

Seans süresini ve/veya bitiş zamanını gösterme zorunluluğu. Yuva kullanılamıyorsa bu alan yoksayılır. Aktiviteler dikeyinde kullanılmaz. (isteğe bağlı)

scheduling_rule_overrides

SchedulingRuleOverrides

Kullanılabilirlik planlama kuralları. Alanlar doldurulursa hizmet düzeyindeki SchedulingRules'da bulunan ilgili planlama kurallarını geçersiz kılarlar.

confirmation_mode

ConfirmationMode

Bu müsaitlik durumu için rezervasyon yapılırken kullanılacak onay modu. CONFIRMATION_MODE_SYNCHRONOUS onay moduna sahip uygunluk durumları için rezervasyon oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. CONFIRMATION_MODE_ASYNCHRONOUS onay moduna sahip müsaitlik durumları için rezervasyon oluşturma girişimleri hemen reddedilmeli veya PENDING durumuyla oluşturulmalıdır.

linkout_required_reason

LinkoutRequiredReason

İsteğe bağlı. Bu alan için yönlendirme bağlantısı gerekmesinin nedeni. Ayarlanırsa bu yer için satıcı kaynağının geçerli bir LinkoutTemplate'i olmalıdır. (isteğe bağlı)

ConfirmationMode

Uygunluk 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 için yapılan rezervasyonlar asenkron olarak onaylanır.

DurationRequirement

Bu enum, kullanıcının istenen yuvaların süresini/bitiş zamanını onaylaması veya görüntülemesi için hangi şartların geçerli olduğunu gösterir.

Sıralamalar
DURATION_REQUIREMENT_UNSPECIFIED Bitiş zamanının nasıl işleneceği belirtilmemiştir. Bu, varsayılan seçenektir.
DO_NOT_SHOW_DURATION Bitiş saati kullanıcıya gösterilmez.
MUST_SHOW_DURATION Randevu oluşturulabilmesi için bitiş saati kullanıcıya gösterilmelidir.

LinkoutRequiredReason

Bir alanın neden yönlendirme deneyimi içerdiği.

Sıralamalar
LINKOUT_REQUIRED_REASON_UNSPECIFIED Varsayılan değer: Kullanmayın, bilinmiyor anlamına gelir.
PAYMENT_REQUIRED Slotun rezerve edilmesi için iş ortağı platformunda ödeme yapılması gerekir.

Yinelenme

Tekrar mesajları isteğe bağlıdır ancak sürekli olarak tekrarlanan uygunluk aralıklarının daha kompakt bir şekilde gösterilmesine olanak tanır. Genellikle bir günlük çalışma programını temsil eder. Ardından, ScheduleException iletileri, iş günü içindeki ayrılmış/kullanılamayan zaman aralıklarını göstermek için kullanılır.

Koşullar:

  1. Kullanılabilirlik aralıklarının veya tekrarların genişletilmesi, aynı aralıkları oluşturmamalıdır. Kimlikler, start_time, duration ve resources eşleşiyorsa yuvalar aynı kabul edilir.
  2. Tek bir hizmetin zaman aralıklarında standart kullanılabilirlik biçimini ve tekrarı KARIŞTIRMAYIN. Tekrarlama, randevu sunan satıcılar/hizmetler için avantaj sağlar. Standart biçim, düzenli olarak planlanmış dersleri olan satıcılara/hizmetlere yöneliktir.
  3. Tekrarlar 24 saatten uzun sürmemelidir.
Alanlar
repeat_until

Timestamp

Kullanılabilirliğin tekrarlandığı maksimum UTC zaman damgası (dahil).

repeat_every

Duration

Birbiri ardına gelen müsaitlik aralıkları arasındaki süreyi tanımlar.

Örnek: Süresi 20 dakika, repeat_every değeri 30 dakika, start_time değeri 09:00 ve repeat_until değeri 11:00 olan bir uygunluk, 09:00-09:20, 09:30-09:50, 10:00-10:20, 10:30-10:50 ve 11:00-11:20 saatleri arasında aralıklar oluşturur. (gerekli)

ScheduleException

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

Alanlar
time_range

TimeRange

İstisnanın zaman aralığı. Tekrarlama ile açıklanan ve bu kapalı-açık zaman aralığıyla çakışan tüm aralıklar kullanılamaz olarak kabul edilir.

Örnek: Tekrarlama 20 dakika süre, 30 dakika repeat_every, 09:00 start_time ve 11:00 repeat_until olarak belirtilmişse 09:45-11:00 time_range değerine sahip bir ScheduleException, 09:30-09:50, 10:00-10:20 ve 10:30-10:50 saatleri arasındaki aralıkları kullanılamaz hale getirir.

Zaman aralığı kapalı-açık olduğundan saat 11:00'de başlayan zaman aralığının etkilenmeyeceğini unutmayın.

SchedulingRuleOverrides

Kullanılabilirlik düzeyi planlama kuralları.

Alanlar
last_bookable_sec

int64

Bu aralığın son rezervasyon tarihi (saniye cinsinden). Bu zaman damgası, yuvanın start_sec değerinden ö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 kullanılmalıdır). Varsa ilgili hizmetin SchedulingRules özelliğinin min_booking_buffer bölümünde belirtilenleri geçersiz kılar.

first_bookable_sec

int64

Bu aralığın ilk kez rezerve edilebileceği zaman (saniye cinsinden). Bu zaman damgası, alanın start_sec değerinden veya belirtilmişse last_bookable_sec değerinden önce olmalıdır.

last_online_cancellable_sec

int64

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

BatchDeleteGenericRecordsRequest

Belirtilen feed türündeki kayıtları silme toplu isteği.

Alanlar
parent

string

Kaynak adı, partners/{partner_id}/feeds/{feed_name} biçimindedir.

records[]

GenericDeleteRecord

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

BatchPushGenericRecordRequest

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

Alanlar
parent

string

Kaynak adı, partners/{partner_id}/feeds/{feed_name} biçimindedir.

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

Birden fazla Service müsaitlik aralığını değiştirmek için toplu istek.

Alanlar
parent

string

partners/{partner_id} biçimi.

extended_service_availability[]

ExtendedServiceAvailability

Mevcut müsaitlik aralıklarının yerine kullanılan genişletilmiş hizmet müsaitliği.

BatchReplaceServiceAvailabilityResponse

Birden fazla Service müsaitlik durumu aralığını değiştirmek için toplu yanıt. Bu iletiye yalnızca başarıyla güncellenen zaman aralıkları dahil edilir.

Alanlar
extended_service_availability[]

ExtendedServiceAvailability

Mevcut uygunluk aralıklarının yerine kullanılan, başarıyla güncellenmiş genişletilmiş hizmet uygunluğu mesajları.

Rezervasyon

Envanter aralığı 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

Randevu aralığının başlangıç saati

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

party_size

int64

Rezervasyonun kişi sayısı

BookingFailure

Bir rezervasyonun neden eşzamansız olarak işlenemediğini belirten durum verileri. BookingFailure, öncelikle iş mantığı hatalarını yakalamak için tasarlanmıştır.

Alanlar
cause

Cause

Rezervasyonun neden başarısız olduğu. (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 eklemesi için kullanılır. (isteğe bağlı)

payment_failure

PaymentFailureInformation

Ödeme hataları hakkında bilgi

Neden

Hata nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanılmaz. "Bilinmeyen bir hata"ya eşittir.
SLOT_UNAVAILABLE Başvurulan uygunluk aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, söz konusu uygunluk aralığı için zaten randevu almış.
LEASE_EXPIRED Kiralama sözleşmesinin (varsa) süresi dolmuştur ve istenen rezervasyonu tamamlamak için artık kullanılamaz.
OUTSIDE_CANCELLATION_WINDOW Satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle, istenen iptal işlemi şu anda gerçekleştirilemiyor.
PAYMENT_ERROR_CARD_TYPE_REJECTED Sağlanan kredi kartı türü satıcı tarafından kabul edilmediği için ödeme işlenirken bir hata oluştu. Kredi kartı türü, rejected_card_type içinde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Belirtilen kredi kartı reddedildiği için ödeme işlenirken bir hata oluştu.
PAYMENT_OPTION_NOT_VALID Rezervasyonun ödemesi için kullanılan paket/üyelikle ilgili bir hata oluştu. Geçerli kullanım kalmamış olabilir, kuponun geçerlilik süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyonun ödemesi işlenirken bir hata oluştu. Bu değeri, yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmiyorsa genel bir ödemeyle ilgili hatayı belirtmek için kullanın.
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı, belirtilen ödeme seçeneğini kullanamıyor (ör. kullanıcı, ilk kez sunulan fiyatı ikinci kez kullanmaya çalışıyor).
BOOKING_ALREADY_CANCELLED Kullanıcının iptal etmeye çalıştığı rezervasyon zaten iptal edilmiş.
BOOKING_NOT_CANCELLABLE Kullanıcının iptal etmeye çalıştığı rezervasyon iptal edilemiyor.
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 ödemenin reddedildiği zamanı ayarlayın. Ancak bu kez 3DS1 doğrulama/yanıtı uygulandıktan sonra denenmesini isteyin. Mevcut işlemin başarısızlık durumunun başarısız olarak kalacağını unutmayın. Yeniden deneme işlemi tamamen ayrıdır.

Bu, hata nedeni olduğunda payment_failure.3DS1_parameters ayarlanmalıdır. Aksi takdirde, mevcut neden PAYMENT_ERROR olarak değerlendirilir.

PaymentFailureInformation

Ödeme hataları hakkında bilgi

Alanlar
threeds1_parameters

ThreeDS1Parameters

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

ThreeDS1Parameters

RwG'nin 3DS1 zorluğu gerçekleştirmesini isteyen parametreler.

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

Alanlar
acs_url

string

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

pa_req

string

PaymentAuthentication Request. Sağlanırsa ACSUrl formuna gönderilir.

transaction_id

string

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

md_merchant_data

string

Satıcı verileri Sağlanırsa ACSUrl formuna gönderilir.

BookingStatus

Rezervasyonun durumu

Sıralamalar
BOOKING_STATUS_UNSPECIFIED Belirtilmedi.
CONFIRMED Rezervasyon onaylandı
PENDING_MERCHANT_CONFIRMATION Rezervasyonun CONFIRMED durumuna geçebilmesi için satıcı tarafından onaylanması bekleniyor (bu özellik şu anda desteklenmemektedir).
PENDING_CLIENT_CONFIRMATION Rezervasyonun CONFIRMED durumuna geçebilmesi için müşterinin onayı bekleniyor (bu özellik şu anda desteklenmemektedir).
CANCELED Rezervasyon, kullanıcı adına iptal edildi.
NO_SHOW Müşteri randevuya gelmedi
NO_SHOW_PENALIZED Müşteri, iptal politikasını ihlal ederek randevuya gelmedi.
FAILED İşleme hatası nedeniyle rezervasyon tamamlanamadı.
DECLINED_BY_MERCHANT Rezervasyon, satıcı tarafından eşzamansız olarak reddedildi.

CallMerchant

Bu türde alan yok.

UnsupportedPartySizeOption'da kullanılacak boş mesaj. Bu ayar, kullanıcılara rezervasyon için işletmeyi arama seçeneğini gösterir.

CancellationPolicy

Bir hizmetin iptal politikası.

Alanlar
refund_condition[]

RefundCondition

Politika için geçerli olan sıfır veya daha fazla geri ödeme koşulu.

RefundCondition

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

Alanlar
min_duration_before_start_time

Duration

Başlangıç zamanından önceki süre. Müşteri, refund_percent içinde belirtilen hizmet maliyetinin bir kısmı için bu süre içinde geri ödeme alabilir. 0 (varsayılan) olarak ayarlandığında hizmet istediğiniz zaman iptal edilebilir.

refund_percent

uint32

Hizmet rezervasyonu, hizmetin başlangıç saatinden en az min_duration_before_start_time önce iptal edildiği sürece geri ödenebilecek yüzde. [0, 100] aralığında olmalıdır. 0 (varsayılan) olarak ayarlandığında hizmet için geri ödeme yapılmaz. %100 olarak ayarlandığında bu hizmetin ücreti tamamen iade edilir.

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: partners/{partner}

CreateMerchantRequest

Merchant oluşturma isteği.

Alanlar
parent

string

Bu satıcının sahibi olan iş ortağının üst 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şsa kredi kartları 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 Bir Discover kredi kartı.
JCB JCB kredi kartı

DeleteAdsAccountLinkRequest

AdsAccountLinkingService.DeleteAdsAccountLink için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek AdsAccountLink'in adı. Biçim: partners/{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ının kredi kartından alınabilecek veya kredi kartında bekletilebilecek bir depozito.

Alanlar
deposit

Price

Yatırılan tutar.

min_advance_cancellation_sec

int64

Depozito için minimum erken iptal süresi.

deposit_type

PriceType

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

DirectMerchantPayment

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

Alanlar
payment_methods[]

Text

Kullanıcı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ığı için sarmalayıcı. En az bir min_duration ve max_duration süresi 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ünlerin üretimi, kullanıma sunulması ya da hizmete alınmasıyla ilgili yükümlülüklere tabi olan diğer gerçek veya tüzel kişiler olarak tanımlanan ekonomik operatörün adı, adresi, telefon numarası ve e-posta adresi. economic_operator'ın serbest biçimli dize gösterimi. Bu bilgiler " " ve "\n" kullanılarak biçimlendirilebilir.

ExtendedServiceAvailability

Kullanılabilirlik listesi ve kimlere/ne zaman uygulanması gerektiği.

Alanlar
merchant_id

string

Bu alan, aşağıdaki stok durumu mesajlarının hangi satıcıya ait olduğunu belirtmek için zorunludur.

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ğlanırsa [start_time_restrict, end_time_restrict) aralığında sağlanan Availability öğelerinin tam bir anlık görüntü olduğu kabul edilir. Yani aşağıdaki koşul geçerliyse mevcut tüm uygunluk silinir:

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

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

  availability.duration == duration_restrict

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

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

Bu alanlar genellikle belirli bir zaman aralığında stok durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

end_time_restrict ayarlanmadan start_time_restrict ayarlanırsa bu, start_time_restrict ile başlayan tüm zamanlar olarak yorumlanır.

end_time_restrict

Timestamp

start_time_restrict ayarlanmamışken end_time_restrict ayarlanması, end_time_restrict'e kadar olan tüm zamanı ifade eder.

duration_restrict

Duration

Süre ayarlama, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik bloklarıyla daha da kısıtlar.

resources_restrict

Resources

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

availability[]

Availability

Yeni müsaitlik listesi.

FeedStatistics

Yüklenen feed işlenirken elde edilen istatistikler.

Alanlar
new_items

int64

Bu feed'e yeni eklenen öğeler. Feed'in türüne bağlı olarak öğeler; satıcılar, hizmetler veya uygunluk zaman aralıkları olabilir.

existing_items

int64

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

deleted_items

int64

Bu feed'de artık bulunmayan ve bu nedenle kaldırılan öğeler.

FeedStatus

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

Alanlar
name

string

Feed kaynak adı şu biçimdedir:

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

State

Bu feed'in işleme durumu.

error_details

string

Bu feed'i işlemeyi başaramadığımız takdirde daha fazla ayrıntı sağlayan, insanlar tarafından okunabilir dize.

statistics

FeedStatistics

Bu feed'e özgü istatistikler.

Eyalet

Feed'in işleme durumunu gösteren enum.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer. Kullanılmamış.
IN_PROGRESS Feed'in işlenmesi devam ediyor.
SUCCESS Feed başarıyla işlendi.
FAILURE Feed işlenirken bir hatayla karşılaştık.

FoodOrderingMetadata

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

Alanlar
fee_details[]

FeeDetails

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

advance_order_details

AdvanceOrderDetails

Kullanıcının şu andan daha sonraki bir zamanda yerine getirilmek üzere sipariş verebileceği, önceden sipariş olarak da bilinen gelişmiş sipariş desteği hakkında ayrıntılar.

fulfillment_duration_options birleşik alanı. Sipariş onayından itibaren sipariş karşılama süresi. Teslimat siparişlerinde, yemeğin teslim edilmesine kadar geçen süre. Teslim alma siparişlerinde, yemeğin teslim alınmaya hazır olacağı süre. fulfillment_duration_options aşağıdakilerden yalnızca biri olabilir:
fulfillment_lead_time_duration

Duration

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

fulfillment_lead_time_duration_range

DurationRange

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

AdvanceOrderDetails

Önceden sipariş desteği için.

Alanlar
is_supported

bool

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

FeeDetails

Ücret ayrıntıları.

Alanlar
type

FeeType

Ücret türü. (gerekli)

fee_amount

FeeAmount

Ücret tutarı, birim para biriminde, alışveriş sepeti değerinin yüzdesi olarak veya her ikisinin kombinasyonu şeklinde olabilir. (gerekli)

FeeAmount

FeeAmount örnekleri: * Sabit ücret: 0 TL (ücretsiz), 1,5 TL * Sabit ücret aralığı: 1 TL (minimum), 3 TL (maksimum), 5-6 TL * Sepet boyutunun yüzdesi: %15,5, %10-20, %10 (minimum), %15 (maksimum) * Aralık ve yüzde bileşimi: %25,5 ve 2,5 TL (minimum), %25,5 ve 4,5 TL (maksimum), %10 ve 1,5-2,5 TL, %10,5-20 ve 2,5-3,5 TL

Alanlar
cart_percentage

QuantitativeValue

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

amount_options birleşik alanı. Parasal tutarı belirtme seçenekleri. amount_options aşağıdakilerden yalnızca biri olabilir:
amount

Money

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

amount_range

MoneyRange

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

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ş 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 karşılama yönteminin kullanılabildiği günlerin listesi (tercihen en az 2 gün).

fee_details

FeeDetails

Zorunlu. Karşılama yöntemiyle ilgili ücret ayrıntıları.

minimum_order

Price

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

AvailableDay

Gün düzeyinde kullanılabilirlik.

Alanlar
fulfillment_date

Date

Zorunlu. Bir karşılama yöntemi için uygun 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ş verebileceği ve ürünleri teslim alabileceği son tarih. Başka bir deyişle, last_ordering_time [son_sipariş_saati] özelliğinden sonra fulfillment_date [teslim_tarihi] 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 olduğunda müşterinin siparişini 2020-08-10 tarihinde alabilmesi için aynı gün saat 18:00'a kadar sipariş vermesi gerekir. - 2020-08-08 20:00 son sipariş saati değeri, müşterinin siparişini 2020-08-10 tarihinde teslim alabilmesi için iki gün öncesinde saat 20:00'ye kadar vermesi gerektiği anlamına gelir.

FeeDetails

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

Alanlar
fee_details birleşik alanı. Karşılama yönteminin ücret modeli. fee_details aşağıdakilerden yalnızca biri olabilir:
no_fee

NoFee

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

base_fee

MinimumFee

Karşılanma yöntemiyle ilişkili temel ücret.

fixed_fee

FixedFee

Karşılanma yöntemiyle ilişkili sabit ücret.

FixedFee

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

Alanlar
amount

Price

Zorunlu. Karşılanma yöntemi için sabit ücret tutarı.

FulfillmentType

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

Sıralamalar
FULFILLMENT_TYPE_UNSPECIFIED Karşılama türü belirtilmedi.
FULFILLMENT_TYPE_DELIVERY Karşılama türü teslimattır.
FULFILLMENT_TYPE_PICKUP Karşılama türü teslim alma olmalıdır.

MinimumFee

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

Alanlar
base_fee_amount

Price

Zorunlu. Karşılama yönteminin temel ücret tutarı.

NoFee

Bu türde alan yok.

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

GenericDeleteRecord

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

Alanlar
delete_time

Timestamp

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

record_type birleşik alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsar. İş ortağı, bir feed'de veya BatchPush API'de sağlanan kayda benzer şekilde tam bir kayıt sağlayabilir. İş ortakları, bir kaydı benzersiz şekilde tanımlamak için gereken temel alanları dahil etme seçeneğine de sahiptir. record_type aşağıdakilerden yalnızca biri olabilir:
data_record

bytes

Proto tabanlı olmayan feed'ler için.

proto_record

Any

Proto tabanlı feed'ler için.

GenericRecord

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

Alanlar
generation_timestamp

Timestamp

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

record_type birleşik alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsar. record_type aşağıdakilerden 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 dahil olmak üzere bir konumun coğrafi verileri.

Alanlar
latitude

double

Enlem (derece). (isteğe bağlı)

longitude

double

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

addresses birleşik alanı. Bir konumun adresi, yapılandırılmış veya yapılandırılmamış olabilir. addresses aşağıdakilerden yalnızca biri olabilir:
address

PostalAddress

Konumun posta adresi (tercih edilir).

unstructured_address

string

Yedek olarak yapılandırılmamış bir adres de sağlanabilir. Ör. "1600 amphitheatre parkway mountain view, ca 94043"

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. Kaynak adı, partners/{partner_id}/merchants/{merchant_id}/status biçiminde.

GetStatusRequest

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

Alanlar
name

string

Feed kaynak adı şu biçimdedir:

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

HomeServiceData

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

Alanlar
category_type

string

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

job_type

string

Belirli bir ev hizmetinin ait olduğu kategori altındaki iş türü. Örneğin, unclog_drain ve install_faucet, tesisatçı kategorisindeki iş türleridir.

IntegrationType

Desteklenen entegrasyon derinliği.

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ı, hizmet ve (isteğe bağlı olarak) stok durumu verilerinin gönderilmesi gerekir.

InvalidateResourceRequest

Bir kaynağın geçersiz kılınması isteği.

Alanlar
resource_id

string

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

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

LineItem

Bir siparişteki tek bir öğe (tek bir zaman aralığında tek bir hizmetin rezervasyonu).

Alanlar
service_id

string

Satıcı hizmetinin kimliği.

start_sec

int64

Randevu aralığının başlangıç zamanı (Unix sıfır zamanından itibaren UTC zamanı saniye cinsinden).

duration_sec

int64

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

tickets[]

OrderedTickets

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

price

Price

Bu satır öğ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ı.

LinkoutTemplate

Google'ın bir iş ortağının sitesine yönelik URL'leri nasıl oluşturacağını belirten bir şablon.

Alanlar
uri_template

string

URI şablonu RFC 6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 1. düzey şablonları ve tüm 4.düzey birleşik şablonları destekler. Örneğin: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

ListMerchantStatusesRequest

MerchantStatus listesini alma isteği

Alanlar
parent

string

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

page_size

int32

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

page_token

string

İsteğe bağlı. Önceki bir ListMerchantStatusResponse'tan döndürülen nextPageToken değeri (varsa).

booking_inventory_status_restrict

BookingInventoryStatus

İsteğe bağlı. Sonuçları rezervasyon envanter 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 stok 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 envanter durumu.

Sıralamalar
BOOKING_INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
NO_VALID_FUTURE_INVENTORY Satıcının önümüzdeki 30 gün içinde rezervasyon envanteri yok.
HAS_VALID_FUTURE_INVENTORY Satıcının önümüzdeki 30 gün içinde rezervasyon envanteri olmalıdır.

GeoMatchingStatus

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

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

WaitlistInventoryStatus

Uçtan uca bekleme listesi envanter durumu.

Sıralamalar
WAITLIST_INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
NO_VALID_WAITLIST_SERVICE Satıcı, bekleme listesini destekleyen bir hizmete sahip değil.
HAS_VALID_WAITLIST_SERVICE Satıcının bekleme listesini destekleyen bir hizmeti olmalıdır.

ListMerchantStatusesResponse

MerchantStatus listesine verilen 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ı şu biçimdedir:

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

int32

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

page_token

string

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

state_restrict

State

Sonuçları feed durumuna göre filtrelemek için isteğe bağlı olarak sınırlama uygulayabilirsiniz.

time_range_restrict

TimeRange

Sonuçları üst ve alt sınıra göre filtrelemek için isteğe bağlı olarak sınırlama uygulayın. start_time ayarlanmamışsa varsayılan olarak Unix zamanının başlangıcı kullanılır. end_time ayarlanmamışsa varsayılan olarak şu anki zaman kullanılır.

ListStatusResponse

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

Alanlar
status[]

FeedStatus

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

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 ayardaki dize örneği.

Alanlar
locale

string

"en", "mas", "zh-Hant", "de-CH-1901" gibi IETF BCP 47 dil kodu. http://www.w3.org/International/articles/language-tags/ adresine bakın.

value

string

Yukarıdaki yerel ayarda mesaj (UTF-8).

Konum

Bir konumla ilgili coğrafi bilgiler.

Alanlar
place_id

string

Google Places 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 adresini ziyaret edin. Bu bilgi sağlanırsa Google, konumu bu yerle eşleştirir.

name

string

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

Bu alan isteğe bağlıdır ancak bazı durumlarda zorunlu olabilir. Örneğin, aynı adreste bulunsa bile adı olmayan bir Service.location, bir ticari işletmeyle eşleştirilmez. (isteğe bağlı)

telephone

string

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

url

string

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

geo

GeoCoordinates

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

location_type

LocationType

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

location_id

string

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

LocationType

Bu konumun türü.

Sıralamalar
LOCATION_TYPE_UNSPECIFIED Konum türü belirtilmedi.
VISITED_LOCATION Bu hizmetin ziyaret ettiği konum.
START_LOCATION Bu hizmetin başladığı konum, MEETING_LOCATION olarak da kullanılır.
END_LOCATION Bu hizmetin sona erdiği konum.

Satıcı

Toplayıcının platformundaki bir satıcı hakkında bilgiler.

Alanlar
name

string

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

merchant_name

string

merchant_name, telephone, url ve geo, iş ortağı envanterinin Google Haritalar'da zaten bulunan satıcılarla eşleştirilmesini desteklemek için kullanılır. Bu bilgiler gösterilmez.

Satıcının adı.

telephone

string

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

url

string

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

geo

GeoCoordinates

Enlem, boylam ve adres dahil olmak üzere satıcının 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 vergi oranı, baz puan cinsinden (yüzde birin yüzde biri). Örneğin, vergi oranı %7,5 ise bu alan 750 olarak ayarlanmalıdır.

Bu alan ayarlanmazsa 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 zaten içerdiği varsayılır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfırdan farklı bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyata hizmet fiyatı ve burada sağlanan vergi oranı kullanılarak değerlendirilen vergi dahil edilir. En küçük para biriminin kesirleri (örneğin, bir sentin kesirleri) en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alanın desteği sonlandırılmıştır, lütfen bunun yerine tax_rate alanını kullanın.

tax_rate
(deprecated)

TaxRate

Satıcının vergi oranı. Bu alan varsa 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ırlar. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.

payment_restrictions
(deprecated)

PaymentRestrictions

Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar. Bu alan ayarlanmamışsa herhangi bir kısıtlamanın olmadığını varsayarız. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.

payment_option[]
(deprecated)

PaymentOption

Bu satıcı için kullanılabilen ödeme seçenekleri. Bu satıcıya bağlı hizmetler, izin verdikleri ödeme seçeneklerini ayrı ayrı sınırlayabilir. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.

payment_processor_config
(deprecated)

PaymentProcessorConfig

Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma.

tokenization_config
(deprecated)

TokenizationConfig

Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.

terms

Terms

Google ile Rezervasyon üzerinden hizmet rezervasyonu yapılırken kullanıcıya gösterilen ilgili satıcının Hüküm ve Koşulları. Bunlara ek olarak, toplayıcı iş ortağının Hüküm ve Koşulları her zaman kullanıcıya gösterilir ve burada sağlanmamalıdır.

brand_id

string

İş ortağı ilişkilendirmesi gösterilirken kullanılacak tüketiciye yönelik markayı tanımlayan opak bir dize. Bu alan, tüketicilere yönelik birden fazla markası olan iş ortaklarının aynı feed'de tüm markalar için satıcı sağlamasına olanak tanır.

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

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

İş ortağı...

Tüketicilere yönelik birden fazla markası olmamalıdır. --> Bu alanı yoksay

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

Önemli Not: Çoğu iş ortağının bu alanı ayarlaması gerekmez. Bir iş ortağı bu alanı kullanmak istiyorsa önce bizimle iletişime geçerek varsayılan marka da dahil olmak üzere ayrı markaları yapılandırmalıdır.

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 verilen bilgileri kullanarak satıcıları Google Haritalar'daki yerlerle eşleştireceğinden çoğu iş ortağının bu alanı ayarlaması gerekmez. (isteğe bağlı)

service_attribute[]

ServiceAttribute

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

reservation_linkout_template[]

LinkoutTemplate

İsteğe bağlı. Google'ın, iş ortağının platformunda masa ayırtmak için URL'yi nasıl oluşturması gerektiğini belirten yönlendirme bağlantısı şablonu.

Birden fazla değer sağlanırsa şu anda yalnızca ilk değerin kullanılacağını unutmayın.

URI şablonu, kullanıcının rezervasyon seçimlerine göre doldurulacak alanları destekler. Rezervasyon URL'sinin başarılı bir şekilde oluşturulması için tüm zorunlu alanlar gereklidir: * (zorunlu) party_size, int: Kullanıcının rezervasyon isteğinde bulunduğu grup boyutu. * (zorunlu) selected_date_time, ISO 8601 datetime (https://en.wikipedia.org/wiki/ISO_8601): Kullanıcının rezervasyon istediği saat. * (isteğe bağlı) merchant_id, dize: Kullanıcının rezervasyon isteğinde bulunduğu satıcının kimliği. Şablon zaten bir satıcı tanımlayıcı içeriyorsa gerekli değildir. * (isteğe bağlı) room_id, dize: Kullanıcının rezervasyon isteğinde bulunduğu odanın kimliği.

waitlist_advisement

Advisement

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan bir kullanıcı için belirli bir satıcının genel tavsiyeleri. Tavsiye metnindeki her bir alan 100 bayt uzunluğunda olmalıdır.

economic_operator

EconomicOperator

İsteğe bağlı. Yasalara uygunluk için bu satıcıyla ilişkili ekonomik operatör bilgilerinin sağlanması gerekir. (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 Places 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 adresini ziyaret edin.

MerchantStatus

Google ile Rezervasyon platformunda 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 konum bilgilerini sağladı.

processing_status

ProcessingStatus

Satıcı 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 olarak eşleştirilmemişse boş olur.

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şmiyorsa boş olur.

direct_urls[]

DirectUrl

Mevcut satıcı envanterinin içeriğini gösteren URL'lerin listesi. Bunun, envanterin gerçekten yayınlandığı anlamına gelmediğini ve URL'nin herkese açık olanlardan farklı olabileceğini unutmayın.

BookingStatus

Uçtan uca rezervasyon entegrasyonuyla ilgili durum.

Alanlar
has_valid_future_inventory

bool

Satıcının önümüzdeki 30 gün içinde envanteri varsa doğru değerini döndürür. Satıcının gerçekten reklam yayınlayacağı garanti edilmez.

DirectUrl

Satıcıyı gösteren URL.

Alanlar
type

UrlType

Bu URL'nin türü.

url

string

Bu satıcının gösterilebileceği URL.

UrlType

Yüzeye çıkarılan 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 hizmet eşleşmesi bilgileri (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 hizmetleri harici müşteri kimliği.

categories[]

string

Yerel hizmet kategorileri (sektörler) Örneğin, "tesisatçı" ve "halı_temizleme".

PlaceInfo

Eşleşen bir yerin bilgileri.

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ı almak için kullanılabilir. Kullanım örneği için https://developers.google.com/places/web-service/place-id adresine bakın.

ProcessingStatus

Satıcı işleme durumu.

Sıralamalar
PROCESSING_STATUS_UNSPECIFIED Durum belirtilmemiş.
IN_PROGRESS Satıcı, Madden tarafından alınmış ancak işlenmeye devam ediyor. Bu durumdaki satıcıların başka bir durumu doldurulmaz.
COMPLETED Satıcının diğer durumları hesaplanmıştır.

WaitlistStatus

Bekleme listesi entegrasyonuyla ilgili durum.

Alanlar
has_valid_waitlist_service

bool

Satıcının bekleme listesi hizmeti varsa doğru. Satıcının gerçekten reklam yayınlayacağı garanti edilmez.

MoneyRange

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

Alanlar
min_amount

Money

Minimum tutar.

max_amount

Money

Maksimum tutar.

NoShowFee

Kullanıcının rezervasyon yapmasına rağmen gelmemesi durumunda alınabilecek ücret.

Alanlar
fee

Price

Kullanıcının rezervasyonuna katılmaması durumunda tahsil edilebilecek tutar.

fee_type

PriceType

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

Sipariş

Bir satıcıyla hizmet randevusu siparişi.

Alanlar
name

string

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

client_information

ClientInformation

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

payment_information

PaymentInformation

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

merchant_id

string

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

item[]

LineItem

Bu siparişteki satır öğeleri.

OrderOnlineMetadata

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

Alanlar
fulfillment_option[]

FulfillmentOption

Online sipariş işlemi bağlantısı için kullanı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şkili benzersiz işlem kimliğini içerir.

payment_transaction_id

string

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

PaymentOption

Bir satıcı tarafından sağlanan hizmetlerin ödemesini yapmak için kullanılabilecek bir ödeme seçeneği. Ödeme seçenekleri birden fazla satıcı arasında (ör. aynı zincire ait satıcılar) paylaşılabilir.

Alanlar
payment_option_id

string

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

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

Bir kimlik birden fazla satıcıda yeniden kullanıldığında, bir satıcı altındaki ödeme seçeneği için herhangi bir değerin güncellenmesi, farklı bir satıcı altındaki aynı kimliğe sahip diğer ödeme seçeneklerini de günceller. Bu nedenle, tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlere güncellenmesi, olası bir eksiklik davranışını önlemek için en iyi uygulamadır.

name

string

Ödeme seçeneğinin adı. Bu durum kullanıcı 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ıda veya hizmette bulunan tax_rate alanını geçersiz kılar. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfırlar.

payment_option_type

PaymentOptionType

Bu ödeme seçeneğinin türü. Drop-in'ler için tek kullanımlık, paketler için çok kullanımlık, üyelikler için sınırsızdır.

session_count

int64

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

purchase_interval

TimeRange

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

valid_interval

TimeRange

Ödeme seçeneği bu aralıkta kullanılabilir (ör. Ocak 2017 için özel fiyat). Mevcut olduğunda valid_duration ve activation_type özelliklerini 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. Promosyon ödeme seçeneğini bir kullanıcı alt kümesiyle sınırlamak için kullanılabilir. Ayarlanmazsa tüm kullanıcılar uygundur.

ActivationType

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

Sıralamalar
ACTIVATION_TYPE_UNSPECIFIED Kullanılmamış.
ACTIVATION_ON_PURCHASE Geçerlilik süresi, satın alma işlemi sırasında 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ü.

Sıralamalar
PAYMENT_OPTION_TYPE_UNSPECIFIED Kullanılmamış.
PAYMENT_OPTION_SINGLE_USE Ödeme seçeneği yalnızca bir kez kullanılabilir.
PAYMENT_OPTION_MULTI_USE Oturum sayısı > 0 ise ödeme seçeneği kullanılabilir.
PAYMENT_OPTION_UNLIMITED Ödeme seçeneği, geçerli olduğu süre aralığında kullanılabilir. Oturum sayısı geçerli değildir.

PaymentProcessorConfig

Ödeme işleyici yapılandırması, satıcı bazında ayarlanır.

Alanlar
processor

Processor

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

public_key

string

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

Stripe için: https://stripe.com/docs/dashboard#api-keys 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şleme iş ortağını tanımlar.

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

PaymentRestrictions

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

Alanlar
credit_card_restrictions

CreditCardRestrictions

Bu satıcının kabul ettiği kredi kartlarıyla ilgili kısıtlamalar. Bu alan ayarlanmamışsa tüm kredi kartlarının kabul edildiği varsayılır. CreditCardType tarafından desteklenen kartların listesinin zaman içinde genişleyeceğ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

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

processing_fee

Price

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

PerTicketFee

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

Alanlar
service_charge

Price

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

facility_fee

Price

Mekana/tesise ödenen bir ücrettir.

taxes

Price

Bilet başına vergiler.

PostalAddress

Müşterinin veya işletmenin adresi.

Alanlar
address_country

string

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

address_locality

string

Yerleşim yeri (ö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ının rezervasyonunun bir parçası olarak ödemesi gereken tutar.

Alanlar
price_info

PriceInfo

Fiyat ayrıntılarını içeren kapsayıcı.

PrepaymentStatus

Rezervasyonun ön ödeme durumu.

Sıralamalar
PREPAYMENT_STATUS_UNSPECIFIED Belirtilmediyse varsayılan olarak PREPAYMENT_NOT_PROVIDED olur.
PREPAYMENT_PROVIDED Rezervasyon ücreti önceden ödenmişse
PREPAYMENT_NOT_PROVIDED Rezervasyon ücreti önceden ödenmemiştir.
PREPAYMENT_REFUNDED Ücret daha önce PREPAYMENT_PROVIDED olarak belirtilmişti ancak şimdi geri ödendi.

Fiyat

Bir hizmetin veya ücretin fiyatı.

Alanlar
price_micros

int64

Para biriminin mikro birimleri cinsinden fiyat. En küçük para biriminin kesirleri, en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. (Örn. 2,5 ABD doları 2 ABD dolarına, 3,5 ABD doları 4 ABD dolarına, 0,5 ABD doları 0 ABD dolarına, 2,51 ABD doları 3 ABD dolarına yuvarlanır.)

currency_code

string

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

pricing_option_tag

string

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

PriceInfo

Fiyat ayrıntılarını içeren kapsayıcı.

Alanlar
price_type

PriceType

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

price_options birleşik alanı. Fiyat seçenekleri, tam bir fiyat veya bir aralık belirtmek içindir. price_options aşağıdakilerden yalnızca biri olabilir:
price

Price

Bir hizmetin veya ücretin fiyatı.

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 açıklar.

Sıralamalar
PRICE_INTERPRETATION_UNSPECIFIED Fiyat yorumu belirtilmedi, varsayılan olarak EXACT_AMOUNT kullanılır.
EXACT_AMOUNT

Fiyatın belirli bir değer olarak yorumlanması gerektiğinde kullanılır.

Örnekler: yoga dersi için 20 ABD doları, çocuk saç kesimi için 15 ABD doları

STARTS_AT

Bir hizmetin fiyatı değişken olduğunda ancak minimum fiyat bilindiğinde ve tüketicilere gösterildiğinde. Tüketiciler, fiyatı artıran seçimler yapabilir.

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

Örnekler: Köpek bakımı için 30 ABD doları, ancak ek tüketici tercihleri fiyatı artırabilir.

NOT_DISPLAYED

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

Bu PriceInterpretation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED'ı kullanması ve Price'ın boş olması gerektiğini unutmayın.

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

PriceRange

Her iki değer de ayarlanmadığı sürece sınırsız olarak kabul edilen bir dizi parasal tutarın sarmalayıcısı. min_amount ve max_amount değerlerinden en az biri gereklidir.

Alanlar
min_price

Price

Minimum tutar.

max_price

Price

Maksimum tutar. Her zaman min_price değerinden büyük olmalıdır.

PriceType

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

Sıralamalar
FIXED_RATE_DEFAULT

Fiyat sabit bir tutardır. Alan ayarlanmamışsa varsayılan değer budur.

Örnekler: Masa ayırtmak için 50 TL depozito; yoga dersine katılmama durumunda 20 TL ücret

PER_PERSON

Belirtilen fiyat kişi başı fiyattır ve toplam fiyat, Kaynaklar'da belirtilen fiyat_mikros * parti_büyüklüğü olarak hesaplanır. KİŞİ_BAŞI fiyatına, stok durumu kaynaklarında parti boyutu eşlik etmelidir. Aksi takdirde, bir kişilik parti boyutu kullanılır.

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

QuantitativeValue

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

Alanlar
value_options birleşik alanı. (zorunlu) value_options aşağıdakilerden yalnızca biri olabilir:
value

double

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

value_range

RangeValue

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 koşulunu sağlayan değer aralığı. En az bir min_value veya max_value zorunludur.

Alanlar
min_value

double

Minimum değer.

max_value

double

Maksimum değer.

Derecelendirme

Bir varlık için puanı 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 derecelendirme sayısı sıfırsa atlanabilir.

number_of_ratings

uint64

Değeri hesaplarken kullanılan puan sayısı (zorunlu).

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, bu medyaları son kullanıcılara doğru şekilde gösterildiğinden emin olmak için 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

Uluslararasılaştırmayı destekleyen medyanın altyazısı. Yalnızca düz metin desteklenir. HTML bileşenleri kaldırılır. (isteğe bağlı)

attribution

Attribution

Medyanın kaynağıyla ilgili ilişkilendirme 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

Desteği sonlandırıldı. Yerelleştirilmiş altyazı kullanılması tercih edilir.

İlişkilendirme

Bu medya için atıf bilgileri.

Alanlar
localized_text

Text

Uluslararasılaştırmayı destekleyen fotoğrafçıya veya ajansa atıfta bulunmak için kullanılan metin. Bu metin, kaynak medyayla birlikte gösterilir. Bu alan için yalnızca düz metnin desteklendiğini, HTML bileşenlerinin kaldırılacağını (köprü tabanlı ilişkilendirme desteklenmez) unutmayın.

text
(deprecated)

string

Desteği sonlandırıldı. Yerine localized_text kullanılması tercih edilir.

MediaType

Bu medya kaynağının türünü belirten enum. Yalnızca fotoğraflar desteklenir. Fotoğrafların dışında başka medya türlerinin de desteklenmesi gerekiyorsa lütfen Google ile Rezervasyon ekibiyle iletişime geçin.

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

ReplaceServiceAvailabilityRequest

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

Alanlar
service_availability

ServiceAvailability

Mevcut hizmetlerin yerine kullanılacak hizmet kullanılabilirliği.

RequireCreditCard

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

Sıralamalar
REQUIRE_CREDIT_CARD_UNSPECIFIED Kredi kartı şartı açıkça belirtilmiyor ve davranış, KOŞULLU için belirtilen davranışla aynı.
REQUIRE_CREDIT_CARD_CONDITIONAL Aşağıdaki koşullardan herhangi biri karşılanırsa Google, rezervasyon için kredi kartı gerektirir: * Kullanılabilirlik için fiyat belirlenmiş ve prepayment_type değeri REQUIRED olarak ayarlanmışsa * no_show_fee ayarlanmışsa * deposit alanı ayarlanmışsa.
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 üyeleri veya odalar hizmetin bir parçası olduğunda, kullanılabilirlik aralıklarını birbirinden ayırt etmek için kaynak kullanılır. Aynı hizmet ve zaman aralığı için birden fazla yer, farklı kaynaklara sahip olduğunda birlikte bulunabilir.

Alanlar
staff_id

string

Hizmeti sağlayan personel üyesinin isteğe bağlı kimliği. Bu alan, tüm satıcılar, hizmetler ve uygunluk kayıtlarındaki personel üyesini tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirmeye olanak tanımak için zaman içinde sabit kalması gerekir. staff_name varsa bu alan da olmalıdır.

staff_name

string

Hizmeti sunan personel üyesinin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine okunabilir olmalıdır. staff_id mevcutsa 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 kayıtları genelinde odayı tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirmeye olanak tanımak için zaman içinde sabit kalması gerekir. room_name mevcutsa bu alan da mevcut olmalıdır.

room_name

string

Hizmetin bulunduğu oda için isteğe bağlı bir ad. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine okunabilir olmalıdır. (isteğe bağlıdır ancak room_id mevcutsa zorunludur) Yemek alanında oda adı yalnızca bar veya veranda gibi oturma alanları için kullanılmalı, sabit fiyatlı menüler, özel etkinlikler veya oda dışı diğer değerler (ör. rezervasyon veya akşam yemeği) için kullanılmamalıdır. Varsayılan oturma alanının kendisine bağlı bir oda olmaması kesinlikle önerilir.

party_size

int32

Yalnızca yemek için geçerlidir: Bu zaman aralığında ağırlanabilecek grup boyutu. Örneğin, rezervasyonla 2, 3 veya 4 kişi oturabiliyorsa bir restoran aynı saat için birden fazla yerle ilişkilendirilebilir ve her biri farklı bir party_size (gruptaki kişi sayısı) belirtir.

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 yaygın dillerin de sağlanması tercih edilir. (isteğe bağlı)

SchedulingRules

Bir hizmetin planlama kuralları.

Alanlar
min_advance_online_canceling

int64

Online olarak alınan bir randevunun iptal edilmesi için gereken minimum ön bildirim süresi (saniye cinsinden). (isteğe bağlı)

late_cancellation_fee
(deprecated)

Price

Minimum ön bildirim süresi içinde yapılan iptaller için alınan ücret.

noshow_fee
(deprecated)

Price

İptal etmeden rezervasyonu kullanmama ücreti.

admission_policy

AdmissionPolicy

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

cancellation_policy

CancellationPolicy

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

min_booking_buffer birleşik alanı. Son rezervasyonun yapılabileceği zamandan uygunluk aralığının başlayabileceği veya bitebileceği zamana kadar geçen süre (saniye cinsinden).

"min_advance_booking" ayarlanmışsa son rezervasyon yapılabilir zaman (<slot start time> - "min_advance_booking") olarak hesaplanır. "min_booking_buffer_before_end_time" ayarlanmışsa son rezerve edilebilir zaman (<slot end time> - "min_booking_buffer_before_end_time") olarak hesaplanır. "min_booking_buffer_before_end_time" değerinin ayarlanması durumunda pozitif olması gerektiğini unutmayın. Her ikisi de ayarlanmamışsa yuva, yuvanın başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanırsa 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ıç saatinden en az 1 saat önce randevu alınması gereken bir saç kesimi. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Kapanmadan 30 dakika önce son biletin satın alınabileceği bir müze: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

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

min_advance_booking

int64

Son rezervasyonun yapılabileceği zamandan uygunluk aralığının başlayacağı zamana kadar geçen süre (saniye cinsinden).

min_booking_buffer_before_end_time

int64

Son rezervasyonun yapılabileceği zamandan uygunluk aralığının sona ereceği zamana kadar geçen süre (saniye cinsinden). Bu alan ayarlanırsa kullanıcıların satın alınan biletleri zaman aralıkları başladıktan sonra kullanabileceğini belirtmek için "admission_policy" alanı TIME_FLEXIBLE olarak ayarlanmalıdır.

AdmissionPolicy

Bu hizmetin kabul politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmamış.
TIME_STRICT Müşterilerin, uygunluk aralığının başlangıç zamanında orada bulunması gerekir ve hizmetin, aralığın bitiş zamanında tamamlanması beklenir. TIME_STRICT kullanım alanlarına örnekler: * Saat 09:00'da başlayan, tüm katılımcıların başlangıç saatinde gelmesini gerektiren ve yaklaşık 12:00'de dönen bir tur. Cumartesi günü saat 15:00'te yaklaşık 30 dakika sürecek bir saç kesimi randevusu. * 18:00-20:00 arası fitness dersi
TIME_FLEXIBLE

Müşteriler, bu rezervasyonu kullanmak için uygunluk aralığının 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. * Öğleden sonra 12:00-21:00 saatleri arasında kullanılabilecek bir eğlence parkı girişi

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Müşterilerin, uygunluk aralığının başlangıç saatinde satıcıya ulaşması gerekir ancak istedikleri zaman ayrılabilirler.

Örneğin, müze giriş senaryosunda, saat 10:00 için zamanlı giriş bileti olan kullanıcının saat 10:00'da müzede olması gerekir. Bu hizmet için uygunluk aralıklarının başlangıç zamanı, belirlenen giriş zamanını gösterir. Ancak bitiş saati yalnızca rezervasyon için uygunluk aralığını tanımlamak üzere anahtar olarak kullanılır.

Hizmet

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

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"). Desteği sonlandırıldı. Bunun yerine localized_service_name özelliğini kullanın.

localized_service_name

Text

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

description

string

Hizmetin kullanıcı tarafından görülebilen açıklaması. Desteği sonlandırıldı. Bunun yerine localized_description özelliğini kullanın.

localized_description

Text

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

Bu alan hem düz metin hem de HTML benzeri biçimlendirmeyi destekler. Düz metin bölümlerinin aksine, burada başlıklar, paragraflar, listeler ve bazı ifade etiketleri kullanılarak özelleştirilmiş düzenler oluşturulabilir. En iyi kullanıcı deneyimini oluşturmak için lütfen aşağıdaki talimatları ve notları dikkatlice okuyun.

Desteklenen HTML benzeri biçimlendirme etiketleri:

Başlık etiketleri: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
Başlık etiketleri, başlıkları ve alt başlıkları göstermek için kullanılabilir. Örneğin, <h1>Seyahat Planı</h1> satır içi metni bölümün en önemli başlığı olarak gösterir. Tüm iç HTML etiketlerinin, stillerin veya özelliklerin yoksayılacağını unutmayın. Örneğin, <h1 style=".."> ile <h1> aynı şekilde değerlendirilir. Yalnızca düz metin korunur.

Paragraf etiketi: <p>
Paragraf etiketi, ayrıntılı bir giriş veya içeriği vurgulamak için kullanılabilir. <br>, <strong> ve <em> etiketleri hariç olmak üzere tüm iç etiketler, stiller veya özellikler yoksayılır. Daha fazla bilgi için lütfen aşağıdaki ifade etiketi bölümüne bakın.

Liste etiketleri: <ul>, <ol>, <li>
<ul> etiketi, sırasız listeleri göstermek için <li> etiketiyle, <ol> etiketi ise sıralı listeleri göstermek için <li> etiketiyle kullanılabilir. Bu, yapılacaklar listelerini, programları veya kullanım alanlarınıza uygun diğer listeleri görüntülemek için iyi bir yöntemdir.
Örnek: Bir gemi gezisinin özelliklerinin listesini göstermek için:
<ol>
<li>Muhteşem okyanus manzarası ve vahşi yaşamla etkileşim kurma fırsatı.</li>
<li>Özenle tasarlanmış seyahat düzenlemeleri ve hizmetleri.</li>
<li>En düşük fiyat garantisi.</li>
</ol>
Yalnızca <li> öğelerinin <ul> veya <ol> etiketleri dönüştürülecektir. Diğer tüm alt öğeler bırakılır. Ayrıca, tüm iç etiketler, özellikler ve stiller yoksayılır. Yalnızca düz metin içerikleri korunur.

Bölüm etiketi: <div>
<div> etiketinin desteklenen tüm iç etiketleri yukarıda belirtilen kurallarla ayrıştırılır. Bu, <div> etiketinin kendisinin burada herhangi bir gruplandırma veya girintileme anlamına gelmediği anlamına gelir. Ayrıca, tüm iç özellikler ve stiller yoksayılır.

İfade etiketleri: <br>, <strong>, <em>:
Yalnızca yukarıda belirtilen üç etiket desteklenir. <br> paragraflarda satırları bölmek için, <strong>/<em> ise önemli metinleri vurgulamak için kullanılabilir. Diğer tüm ifade etiketleri yoksayılır.

Desteklenmeyen etiketler:

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

Önemli notlar:

  • Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve bu durum istenmeyen bir kullanıcı deneyimine yol açabileceğinden, yukarıda belirtilen desteklenen etiketler dışında başka etiket kullanmamaya çalışın.
  • 3'ten fazla farklı başlık düzeyi veya iç içe geçmiş listeler gibi derin iç içe geçmiş yapılardan kaçınmaya çalışın. Yapıyı düz, basit ve anlaşılır tutmak daha iyi bir kullanıcı deneyimi oluşturmaya yardımcı olur.
  • Şu anda desteklenen düzenler kullanım alanlarınız için yeterli değilse lütfen Google ile Rezervasyon ekibiyle 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. Yemek ve Aktivite Önerileri hariç tüm sektörler tarafından hizmet fiyatının gösterimini yapılandırmak için kullanılabilir.

rules

SchedulingRules

Randevu alma/iptal etme kuralları

prepayment_type

PrepaymentType

Ön ödemenin gerekli, isteğe bağlı veya desteklenmiyor olup olmadığı

prepayment_terms

PrepaymentTerms

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

form[]
(deprecated)

ServiceIntakeForm

Kullanımdan kaldırıldı. Lütfen intake_form ve per_ticket_intake_form'u kullanın.

intake_form

ServiceIntakeForm

Kullanıcı bu hizmeti rezerve ettiğinde ek bilgi isteyen bir form. (isteğe bağlı)

per_ticket_intake_form

ServiceIntakeForm

Kullanıcı bu hizmeti rezerve ettiğinde 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 ayarlanan tüm tax_rate değerlerini geçersiz kılar. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfırlar.

payment_option_id[]

string

Bu hizmet için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine referans veren 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

Depozitonun kullanıcıdan nasıl alınabileceğini tanımlar. Belirtilmişse hizmet depozitosunu geçersiz kılar. Bu ayarı boş bir depozito mesajı olarak ayarlamak, hizmet düzeyindeki tüm depozitoları kaldırır. (isteğe bağlı)

no_show_fee

NoShowFee

Kullanıcıdan alınabilecek bir "gösterilmeme" ücreti tanımlar. Belirtilmişse hizmete gelinmeme ücretini geçersiz kılar. Bu ayarı boş bir NoShowFee mesajına ayarlamak, hizmet düzeyindeki tüm "gösterilmeme" ücretlerini kaldırır. (isteğe bağlı)

require_credit_card

RequireCreditCard

Kullanıcının bu hizmeti rezerve etmek için kredi kartı sağlaması gerekip gerekmediğini gösterir. Bu alan, stok durumu düzeyinde geçersiz kılınabilir. (isteğe bağlı)

type

ServiceType

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

ticket_type[]

TicketType

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

related_media[]

RelatedMedia

Bu hizmetle ilgili fotoğraflar. Google, medyaların son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bunları tarar ve depolar. (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 bilet işlemleri dikeyine özgü ek bilgiler. (isteğe bağlı)

integration_type

IntegrationType

Bu hizmet için desteklediğimiz entegrasyon derinliği. (isteğe bağlı) Başlangıç entegrasyonuna sahip iş ortakları için geçerli değildir. Uçtan uca şifreleme, bu iş ortakları için her zaman devre dışı bırakılır.

per_order_fee

PerOrderFee

Bu hizmetin satın alınmasıyla ilgili sipariş düzeyinde ücretler. (isteğe bağlı)

tours_and_activities_content

ToursAndActivitiesContent

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

location[]

Location

Bu hizmetle ilgili konumlar. ÖNEMLİ NOTLAR: Bu hizmetle ilgili birden fazla ziyaret edilen konum varsa veya START_LOCATION, VISITED_LOCATION'dan farklıysa START_LOCATION belirtilmelidir. Örnek: Üç mekanı ziyaret eden rehberli bir bisiklet turu. Başlangıç mekanı belirtilmelidir. Bir otel lobisinde buluşup ziyaret edilen yere giden bir otobüs turu. Toplantı yeri belirtilmelidir.

rating

Rating

Bu hizmetin tüm yorumlardaki toplu metriği olarak kullanıcı puanı.

home_service_data

HomeServiceData

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

virtual_session

VirtualSession

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

direct_merchant_payment

DirectMerchantPayment

İsteğe bağlı. Hizmetin, kullanıcının doğrudan satıcıya ödeme yapmasını gerektirmesi durumunda eklenmesi gereken ek bilgiler. ÖNEMLİ NOT: RwG bu işleme dahil değildir. virtual_session tanımlanmışsa ve hizmet ücretsiz değilse veya prepayment_type REQUIRED olarak ayarlanmamışsa zorunludur.

uri_template

UriTemplate

İsteğe bağlı. Google'ın harici site URL'lerini nasıl oluşturacağını belirten isteğe bağlı bir şablon.

PrepaymentTerms

Ön ödemenin ne zaman tamamlandığıyla ilgili ayrıntılı bilgi.

Alanlar
charge_timing

ChargeTiming

Ücretin, satın alma zamanına göre ne zaman alınacağı.

charge_time_before_start_time_sec

int64

Kullanıcının ödeme için ücretlendirildiği, hizmetin başlangıç zamanından önceki süre (saniye cinsinden). Bu alan yalnızca ChargeTiming CHARGE_LATER olduğunda ayarlanmalıdır.

ChargeTiming

Ücretin, satın alma zamanına göre ne zaman alınacağını belirten enum.

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

PrepaymentType

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

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak, ön ödemenin NOT_SUPPORTED (desteklenmiyor) olduğu varsayılır.
REQUIRED Kullanıcı, bu hizmetin ödemesini rezervasyon sırasında yapmalıdır.
OPTIONAL Kullanıcı, bu hizmet için rezervasyon sırasında veya daha sonra ön ödeme yapmayı seçebilir ancak rezervasyon yapmak için ön ödeme yapması gerekmez.
NOT_SUPPORTED Bu hizmet için ön ödeme desteklenmiyor.

ServiceType

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

Sıralamalar
SERVICE_TYPE_UNSPECIFIED Kullanılmamış.
SERVICE_TYPE_DINING_RESERVATION Yemek rezervasyonu
SERVICE_TYPE_FOOD_ORDERING Yemek siparişi (adrese teslimat, paket servis veya her ikisi de olabilir)
SERVICE_TYPE_FOOD_DELIVERY Yemek teslimatı
SERVICE_TYPE_FOOD_TAKEOUT Paket yemek servisi
SERVICE_TYPE_EVENT_TICKET Etkinlik bileti.
SERVICE_TYPE_TRIP_TOUR Gezi turu.
SERVICE_TYPE_APPOINTMENT Randevu veya ders hizmeti sunan işletmeler. (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 olarak gerçekleştirilecek bir sınıf veya oturum için online randevu hizmeti sunulmalıdır. Sanal hizmet rezervasyonları etkinleştiriliyorsa ayarlanmalıdır.
SERVICE_TYPE_SHOPPING Kullanıcıların belirtilen satıcıdan alışveriş yapmasına olanak tanıyan hizmet. Teslimat veya teslim alma olabilir.

ServiceAttribute

Hizmet özellikleri, bir satıcının hizmetlerini tanımlayan, iş ortağı tarafından tanımlanmış kategorilerdir. Örneğin, bir banka olası değerleri "Kişisel" ve "İşletme" olan bir "Hesap Türü" hizmet özelliği tanımlayabilir. Bir kuaför ise olası değerleri "Saç Kesimi", "Boyama" ve "Şekillendirme" olan bir "Hizmet Türü" hizmet özelliği tanımlayabilir.

Alanlar
attribute_id

string

Bu hizmet özelliğini aynı satıcının diğer hizmet özellikleri arasında 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 olası tüm değerler.

Değer

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

Alanlar
value_id

string

Bu hizmet özelliği için bu değeri diğerleri arasında 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 hizmet özelliğinin, bir hizmete uygulanacak belirli bir değerini tanımlar.

Alanlar
attribute_id

string

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

value_id

string

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

ServiceAvailability

Kullanılabilirlik listesi ve kimlere/ne zaman uygulanması gerektiği.

Alanlar
name

string

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

start_time_restrict

Timestamp

Sağlanırsa [start_time_restrict, end_time_restrict) aralığında sağlanan Availability öğelerinin tam bir anlık görüntü olduğu kabul edilir. Yani aşağıdaki koşul geçerliyse mevcut tüm uygunluk silinir:

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

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

  availability.duration == duration_restrict

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

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

Bu alanlar genellikle belirli bir zaman aralığında stok durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır.

end_time_restrict ayarlanmadan start_time_restrict ayarlanırsa bu, start_time_restrict ile başlayan tüm zamanlar olarak yorumlanır.

end_time_restrict

Timestamp

start_time_restrict ayarlanmamışken end_time_restrict ayarlanması, end_time_restrict'e kadar olan tüm zamanı ifade eder.

duration_restrict

Duration

Süre ayarlama, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik bloklarıyla daha da kısıtlar.

resources_restrict

Resources

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

availability[]

Availability

Yeni müsaitlik listesi.

ServiceIntakeForm

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

Alanlar
field[]

ServiceIntakeFormField

Kullanıcıya gösterilecek alanlar.

first_time_customers
(deprecated)

bool

Doğruysa bu form, ilk kez alışveriş yapan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez.

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

ServiceIntakeForm'da bulunan 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 her bilet alımı formunda 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. Alan, birden fazla yerel ayarda sağlanabilir. (gerekli)

value[]

string

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

choice_text[]

Text

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

is_required

bool

Bu alana yanıt verilmesinin kullanıcı tarafından zorunlu olup olmadığını gösterir.

allow_custom_answer

bool

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

additional_option[]

Text

Belirtilen 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 kullanılabilir. (isteğe bağlı)

ticket_type_restrict[]

string

Bu soru yalnızca kullanıcı belirli bilet türlerini rezerve ettiğinde gösterilecekse bu alan, geçerli bilet türü kimlikleri kümesi olarak ayarlanmalıdır. Soru her zaman geçerliyse alanı boş bırakın.

hint

Text

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

FieldType

Alan türünü belirten enum.

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

TaxRate

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

Alanlar
micro_percent

int32

Milyonda bir oranında vergi oranı. Bu, 6 ondalık basamak hassasiyeti sağlar. Örneğin, vergi oranı %7,253 ise bu alan 7253000 olarak ayarlanmalıdır.

Bu alan ayarlanmazsa 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 zaten içerdiği varsayılır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfırdan farklı bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyata hizmet fiyatı ve burada sağlanan vergi oranı kullanılarak değerlendirilen vergi dahil edilir. En küçük para biriminin kesirleri (örneğin, bir sentin kesirleri) en yakın çift sayıya yuvarlama yöntemiyle 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 bir dizi kural ve yönerge.

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 öğesini 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ırabilir.

Alanlar
value

string

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

localized_value[]

LocalizedString

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

TicketType

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

Bilet, bir hizmet için rezerve edilebilen en küçük birimdir. Örneğin, rafting gezisinde bir yer, müzeye giriş, tam gün çift kişilik kano kiralama.

Alanlar
ticket_type_id

string

Bilet kimliği, aynı hizmetin farklı bilet türlerini ayırt etmek için kullanılır ve yalnızca 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", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Desteği sonlandırıldı. Bunun yerine localized_short_description özelliğini kullanın.

localized_short_description

Text

Bu TicketType'ın kısa bir açıklaması (uluslararasılaştırma desteğiyle).

Bu, kullanıcı tarafından görülebilir (ör. "yetişkin", "çocuk", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Her yerel ayar için ayrı değerler sağlanabilir.

price

Price

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

per_ticket_fee

PerTicketFee

Bu bileti satın almak için ek ücretler. (isteğe bağlı)

price_display_type

PriceDisplayType

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

option_description

string

Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Desteği sonlandırıldı. Bunun yerine localized_option_description özelliğini 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.

Bilet türü birden fazla boyutu temsil ettiğinde ek seçenekler kullanışlıdır.

1. örnek: "Yetişkin", "çocuk" gibi farklı türlere sahip bir giriş bileti ve ek seçenek olarak dil. Beklenen TicketType listesi şu şekilde olur: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

2. örnek: İsteğe bağlı kuru çanta eklentisiyle çok saatlik kano kiralama. short_description "3 saat", option_description ise "kuru çantalı" veya "kuru çantasız" olabilir: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

İsteğe bağlıdır ancak hizmetteki herhangi bir bilet türünde bu alan ayarlanmışsa diğer tüm bilet türlerinde de bu alanın 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 seçenekler, hem başlık hem de ayrıntılı açıklama içeren seçenekleri belirtmek için kullanılır. Örneğin: "Premium Koltuk
Bu seçenek, tamamen yastıklı koltuklar, özel TV'ler, koltukta yiyecek ve içecek servisi gibi özelliklerin bulunduğu özel localarda koltuk sunar. Bu koltuklardan saha manzarası çok güzel."

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. Toplayıcı (ör. www.bandsintown.com), iş ortağının etkinlik ve bilet bilgileri sağladığı anlamına gelir. Ancak biletler doğrudan iş ortağı tarafından satılmaz. Gerçek bilet satıcısı birincil, doğrulanmış yeniden satış veya yeniden satış olabilir. Artık yalnızca üst düzey iş ortağı envanter türü ayırt ediliyor ve bir toplayıcıdaki gerçek bilet satıcısı envanter türü göz ardı ediliyor.

PriceDisplayType

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

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

Bu alan, Google platformlarının açılış sayfası tarafından kullanılan 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ü belirtilmemiş. Google, hangi biçimin gösterileceğine karar verir.
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 bilet işlemleri dikeyine ö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 kişinin 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 kişi 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 varlığı 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

Özneyi açık bir şekilde tanımlayan web sayfasının URL'si. Bu, varsa iş ortağının web sitesindeki öğeye ait web sayfasıdır. Öğenin diğer herkese açık URL'leri için public_identification_data içinde relevant_url'yi kullanın. (isteğe bağlı)

entity_type

EntityType

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

entity_role

EntityRole

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

public_identification_data

PublicIdentificationData

Varlığın herkese açık referansları. (isteğe bağlı)

EntityRole

Varlığın etkinlikteki rolü.

Sıralamalar
ENTITY_ROLE_UNSPECIFIED Belirtilmedi.
ENTITY_ROLE_HEADLINER Tüzel kişi, etkinlikte sahne alan önemli bir sanatçıyı veya başrol oyuncusunu temsil ediyor.
ENTITY_ROLE_SUPPORTER Varlık, etkinlikte destekleyici bir sanatçıyı temsil ediyor.
ENTITY_ROLE_HOME_TEAM Bu öğe, (spor) etkinliğindeki ev sahibi takımı temsil eder.
ENTITY_ROLE_AWAY_TEAM Varlık, (spor) etkinliğindeki deplasman takımını temsil eder.

EntityType

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

Sıralamalar
ENTITY_TYPE_UNSPECIFIED Belirtilmedi. Kullanmayın.
ENTITY_TYPE_PERFORMER Bu varlık, konserde veya gösteride sahne alan sanatçıyı ya da grubu temsil eder. Yalnızca etkinlik kategorisi CONCERT veya THEATRE 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 CONCERT olduğunda geçerlidir.
ENTITY_TYPE_SPORTS_SERIES Varlık, bu etkinliğin ait olduğu bir spor turnuvasını temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir.
ENTITY_TYPE_PLAY Varlık, etkinlikte sahnelenen oyun türünü (ör. müzikal, komedi, bale vb.) temsil eder. Yalnızca etkinlik kategorisi THEATRE olduğunda geçerlidir.

EventCategory

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

Sıralamalar
EVENT_CATEGORY_UNSPECIFIED Belirtilmedi. Kullanmayın.
EVENT_CATEGORY_CONCERT 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

EventCreator

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

Alanlar
name

string

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

EventState

Etkinliğin durumu.

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

OrganizerType

Düzenleyenin türü.

Sıralamalar
ORGANIZER_TYPE_UNSPECIFIED Belirtilmedi.
PERSON Etkinliği düzenleyen kişi için.
ORGANIZATION Etkinliği düzenleyen kişi bir kuruluşsa

PublicIdentificationData

Bir tüzel kişiye referans veren tanımlayıcılar, web sayfaları veya diğer kamuya 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ı buna örnek olarak verilebilir. Örneğin: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (isteğe bağlı)

musicbrainz_id

string

Sanatçının veya diğer müzik varlıklarının 36 karakterlik MusicBrainz tanımlayıcısı (varsa). https://musicbrainz.org/doc/MusicBrainz_Identifier adresini ziyaret edin. (isteğe bağlı)

TimeRange

Kapalı-açık zaman aralığı, yani [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

Ödeme işleyici jetonlaştırması için satıcı bazında ayarlanan bir yapılandırma.

Alanlar
tokenization_parameter

map<string, string>

Bir belirtekleştirme yapılandırmasında genellikle anahtarı "gateway" ve değeri işlemcinin adı olan bir tokenization_parameter bulunur.

Diğer parametreler işlemciye bağlıdır. Daha fazla bilgi için Google Pay'in belgelerini inceleyin.

Braintree örneği: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

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

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

billing_information_format

BillingInformationFormat

Ödeme tokenına, kullanıcının Google Pay'e FOP'siyle (yukarıya bakın) girdiği fatura bilgilerini ekleyin. Alanı boş bırakmak, MIN değerini belirtmekle aynıdır.

BillingInformationFormat

Kullanıcıdan ne kadar fatura adresi bilgisi isteneceğini ve jetona ne kadarının dahil edileceğini belirler. Numaralandırılmış değerler, Google Pay API'deki parametrelere karşılık gelir (bkz. https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

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

ToursAndActivitiesContent

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

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

İfade etiketleri:
, , , : Yalnızca yukarıda belirtilen üç etiket desteklenir.
, paragraflardaki satırları bölmek için, // ise önemli bir metni vurgulamak için kullanılabilir. Diğer tüm ifade etiketleri yoksayılır.

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

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

Alanlar
highlights[]

Text

Kullanıcıların görebileceği öne çıkanlar listesi.

inclusions[]

Text

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

exclusions[]

Text

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

must_know[]

Text

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

UnsupportedPartySizeOption

Kapsama alanı dışında kalan partiler için seçenekler.

Alanlar
kind birleşik alanı. Kapsama alanı dışında kalan partiler için kullanılabilir seçenekler. kind aşağıdakilerden yalnızca biri olabilir:
call_merchant

CallMerchant

Aralık dışında kalan parti büyüklükleri için işletme aranabilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Gösterilecek örnek metin: {waitlist_rules.max_party_size} kişiden büyük gruplar için lütfen {phone} numaralı telefondan restoranı arayın. CallMerchant ayarlanmalı 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 onaylanan bir rezervasyon isteğinin işlenmesi başarısız olursa ve rezervasyonun durumu BAŞARISIZ olarak güncellenirse bu alan, işletme mantığı hatasını (ör. kullanıcının bu zamana çok yakın bir zamanda mevcut bir rezervasyonu var) yansıtmalıdır. Bu alan yalnızca rezervasyon durumu BAŞARISIZ olarak güncellenirken ayarlanmalı, aksi takdirde yoksayılmalıdır.

UpdateMerchantRequest

Merchant güncelleme isteği.

Alanlar
merchant

Merchant

Yeni satıcı verileri.

update_mask

FieldMask

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

UpdateOrderRequest

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

Alanlar
update_mask

FieldMask

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

order

Order

Güncellenecek sipariş

UpdateServiceRequest

Service güncelleme isteği.

Alanlar
service

Service

Yeni hizmet verileri.

update_mask

FieldMask

Hizmet için güncellenecek alanlar.

UriTemplate

Google'ın harici site URL'lerini nasıl oluşturacağını belirten bir şablon.

Alanlar
uri_template

string

İsteğe bağlı. URI şablonu RFC6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 2. düzey şablonları destekler. Bu parametreler, ilgili öğelerinde belirtilen değerlere dönüştürülür.

Yemek rezervasyonu için yönlendirme bağlantısında kullanılabilen parametreler: 1) (zorunlu) {availability_slot_start_seconds} :: Stok durumu feed'indeki start_sec alanından doldurulur 2) (zorunlu) {resources_party_size} :: Stok durumu feed'indeki party_size alanından doldurulur 3) (isteğe bağlı) {availability_slot_duration_seconds} :: Stok durumu feed'indeki duration_sec alanından doldurulur 4) (isteğe bağlı) {availability_slot_availability_tag} :: Stok durumu feed'indeki availability_tag alanından doldurulur

Kullanım örneği: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

Şu değerlerle: * start_sec = 123456 * party_size = 2

https://example.com/book/restaurant?start=123456&num_guests=2

UserPurchaseRestriction

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

Alanlar
new_to_merchant

bool

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

new_to_payment_option

bool

Daha önce aynı ödeme seçeneğini satın almamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneği.

VirtualSession

Sanal/online oturum hakkında bilgiler. Ör. online yoga dersi, sanal yemek pişirme dersi vb.

Alanlar
session_instructions

Text

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

session_requirements

Text

Belirli bir sanal oturumun şartları. Ör. yoga matı, mutfak gereçleri vb. (Önerilir)

virtual_platform_info

VirtualPlatformInfo

Bu oturumda kullanılan sanal platform hakkında 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 doğru olarak ayarlayın.

VirtualPlatformInfo

Bu sanal oturumda kullanılacak platform hakkında bilgiler.

Alanlar
platform

Platform

Sanal oturum için kullanılan platform.

other_platform_name

Text

Platform OTHER olarak ayarlanmışsa platformun adı. (Platform OTHER olarak ayarlandıysa zorunludur)

Platform

Hangi sanal platformun satıcı tarafından kullanılacağını belirten enum.

Sıralamalar
PLATFORM_UNSPECIFIED Kullanılmamış.
FLEXIBLE Satıcı, hangi video platformunu kullanacağı konusunda esnektir.
GOOGLE_HANGOUTS Google Hangouts ürünü.
GOOGLE_MEET Google Meet ürünü.
ZOOM Zoom Video Communications.
SKYPE Skype.
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 sunan 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 sunmuyorsa bu alan doldurulmamalıdır.

supports_additional_request

bool

Doğruysa kullanıcı, bu hizmetin bekleme listesine katılırken serbest biçimli ek bir metin isteği gönderebilir.

above_max_party_size_options[]

UnsupportedPartySizeOption

Ayarlanan max_party_size değerinden daha büyük partiler için seçenekleri belirleyin. Daha büyük gruplara bekleme listesine katılmak için alternatif seçenekler sunulmaması gerekiyorsa boş bırakın.