REST Resource: inventory.partners.merchants.services

Kaynak: Hizmet

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

JSON gösterimi
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Alanlar
name

string

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

serviceName

string

Hizmetin adı (ör. "Erkek saç kesimi"). Desteği sonlandırıldı. Bunun yerine localizedServiceName kullanın.

localizedServiceName

object (Text)

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

description

string

Hizmetin kullanıcılara görünen açıklaması. Desteği sonlandırıldı. Bunun yerine localizedDescription özelliğini kullanın.

localizedDescription

object (Text)

Hizmetin kullanıcılara görünen açıklaması.

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

HTML benzeri biçimlendirme etiketleri desteklenir:

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

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

Liste etiketleri: <ul>, <ol>, <li>
<ul> etiketi, sırasız listeleri görüntülemek için <li> etiketiyle birlikte kullanılabilir. <ol> etiketi ise sıralı listeleri görüntülemek için <li> etiketiyle birlikte kullanılabilir. Bu, yapılacaklar listelerini, planları veya kullanım alanlarınıza uygun diğer listeleri görüntülemek için iyi bir yöntemdir.
Örnek: Bir kruvaziyer gezisinin özelliklerinin listesini göstermek için:
<ol>
<li>Mükemmel okyanus manzarası ve vahşi yaşamla oynama fırsatları.</li>
<li>İncelikle tasarlanmış seyahat düzenlemeleri ve hizmetleri.</li>
<li>En düşük fiyat garantisi.</li>
</ol>
Yalnızca <ul> veya <ol> etiketlerinin altındaki <li> alt öğelerinin dönüştürüleceğini unutmayın. Diğer tüm alt öğeler bırakılır. Ayrıca, tüm iç etiketler, özellikler ve stiller yoksayılır. Yalnızca saf metin içerikleri korunur.

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

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

Desteklenmeyen etiketler:

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

Önemli notlar:

  • Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve istenmeyen bir kullanıcı deneyimine neden olabileceğinden, yukarıda belirtilen desteklenen etiketler dışında başka etiketler kullanmamaya çalışın.
  • 3'ten fazla farklı başlık düzeyi veya iç içe yerleştirilmiş listeler gibi derin iç içe yerleştirilmiş yapılardan kaçının. Yapıyı düz, basit ve anlaşılır tutmak daha iyi bir kullanıcı deneyimi oluşturmanıza yardımcı olur.
  • Şu anda desteklenen düzenler kullanım alanlarınız için yeterli değilse lütfen Google ile Rezervasyon Ekibi ile iletişime geçin.
  • Önerilen maksimum boyut 32.000 karakterdir.
price

object (Price)

Hizmetin fiyatı.

priceInterpretation

enum (PriceInterpretation)

Fiyatın nasıl yorumlandığını ve kullanıcıya nasıl gösterildiğini açıklar. Yeme-İçme ve Aktivite Önerileri dışındaki tüm sektörler tarafından hizmet fiyatının görüntülenmesini yapılandırmak için kullanılabilir.

rules

object (SchedulingRules)

Randevu alma/iptal etme kuralları.

prepaymentType

enum (PrepaymentType)

Ön ödemenin zorunlu, isteğe bağlı veya desteklenmediği.

prepaymentTerms

object (PrepaymentTerms)

Peşin ödemenin tamamlanmasıyla ilgili şartlar.

form[]
(deprecated)

object (ServiceIntakeForm)

Kullanımdan kaldırıldı. Lütfen intakeForm ve perTicketIntakeForm parametrelerini kullanın.

intakeForm

object (ServiceIntakeForm)

Bu hizmeti rezerve eden kullanıcıdan ek bilgi isteyen bir form. (isteğe bağlı)

perTicketIntakeForm

object (ServiceIntakeForm)

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

taxRate

object (TaxRate)

Hizmetin vergi oranı. Varsa bu alan, satıcı düzeyinde ayarlanan tüm vergi oranlarını geçersiz kılar. Boş bir mesaj (ör. taxRate { }) uygulanan vergi oranını sıfıra sıfırlar.

paymentOptionId[]

string

Bu hizmet için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine atıfta bulunan kimliklerin listesi. Gerçek ödeme seçenekleri satıcı düzeyinde tanımlanır ve birden fazla satıcı arasında paylaşılabilir.

deposit

object (Deposit)

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

noShowFee

object (NoShowFee)

Kullanıcıdan alınabilecek bir gelmeme ücretini tanımlar. Belirtilmişse hizmetin randevuya gelmemesi ücretini geçersiz kılar. Bu özelliği boş bir NoShowFee mesajına ayarlamak, hizmet düzeyinde hiçbir görünmeyen konuk ücretini kaldırır. (isteğe bağlı)

requireCreditCard

enum (RequireCreditCard)

Kullanıcının bu hizmet için rezervasyon yapmak üzere kredi kartı sağlaması gerekip gerekmediğini belirtir. Bu alan, kullanılabilirlik düzeyinde geçersiz kılınabilir. (isteğe bağlı)

type

enum (ServiceType)

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

ticketType[]

object (TicketType)

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

relatedMedia[]

object (RelatedMedia)

Bu hizmetle ilgili fotoğraflar. Google, medya öğelerinin son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bu öğeleri tarar ve saklar. (isteğe bağlı)

serviceAttributeValueId[]

object (ServiceAttributeValueId)

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

waitlistRules

object (WaitlistRules)

Bekleme listesine katılma kuralları.

ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

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

integrationType

enum (IntegrationType)

Bu hizmet için desteklediğimiz entegrasyon derinliği. (isteğe bağlı) Başlatıcı entegrasyonu olan iş ortakları için alakasızdır. Bu iş ortakları için uçtan uca şifreleme her zaman devre dışıdır.

perOrderFee

object (PerOrderFee)

Bu hizmeti satın almayla ilgili sipariş düzeyinde ücretler. (isteğe bağlı)

toursAndActivitiesContent

object (ToursAndActivitiesContent)

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

location[]

object (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 için başlangıç mekanının belirtilmesi gerekir. - Bir otel lobisinde buluşup otobüs turuyla ziyaret edilecek yere gitme Toplantı yeri belirtilmelidir.

rating

object (Rating)

Tüm yorumlar için toplu bir metrik olarak bu hizmetin kullanıcı puanı.

homeServiceData

object (HomeServiceData)

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

virtualSession

object (VirtualSession)

İsteğe bağlı. Sanal oturumla ilgili bilgiler. Sanal hizmetlerin etkinleştirilmesi için gereklidir.

directMerchantPayment

object (DirectMerchantPayment)

İsteğe bağlı. Hizmet, kullanıcının doğrudan satıcıya ödeme yapmasını gerektiriyorsa eklenmesi gereken bilgiler. ÖNEMLİ NOT: RwG bu işleme dahil olmaz. virtualSession tanımlanmışsa ve hizmet ücretsiz değilse veya prepaymentType REQUIRED olarak AYARLANMAMIŞSA gereklidir.

uriTemplate

object (UriTemplate)

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

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 olur.
EXACT_AMOUNT

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

Örnekler: Yoga dersi için 20 TL, çocuk saç kesimi için 15 TL

STARTS_AT

Bir hizmetin fiyatı değişken olsa da minimum fiyat bilinir ve tüketicilere gösterilir. Tüketiciler, fiyatı artıran seçimler yapabilir.

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

Örnekler: Köpek tıraşı için 30 TL, ancak tüketicinin ek 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 özelliğini kullanan tüm hizmetlerin PrepaymentType özelliğini NOT_SUPPORTED olarak ayarlamalı ve Price özelliğinin boş olması gerektiğini unutmayın.

Örnekler: Ev hizmeti için danışma

SchedulingRules

Bir hizmetin planlama kuralları.

JSON gösterimi
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Alanlar
minAdvanceOnlineCanceling

string (int64 format)

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

lateCancellationFee
(deprecated)

object (Price)

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

noshowFee
(deprecated)

object (Price)

Rezervasyonu iptal etmeden kullanmamanız durumunda alınacak ücret.

admissionPolicy

enum (AdmissionPolicy)

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

cancellationPolicy

object (CancellationPolicy)

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

Birlik alanı min_booking_buffer. Son rezervasyonun yapılabileceği zamandan müsaitlik durumu aralığının başladığı veya sona erdiği zamana kadar geçen süre (saniye cinsinden).

"min_advance_booking" 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 rezervasyon yapılabilir zaman (<slot bitiş zamanı> - "min_booking_buffer_before_end_time") olarak hesaplanır. "min_booking_buffer_before_end_time" değeri ayarlanmışsa pozitif olması gerektiğini unutmayın. Her ikisi de ayarlanmazsa slot, slot başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanmışsa yalnızca bir değer seçilir ve diğer değer yoksayılır. Hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz.

Örnekler:

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

  • Son biletin kapanmadan 30 dakika önce satın alınabildiği bir müze: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}'

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

minAdvanceBooking

string (int64 format)

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

minBookingBufferBeforeEndTime

string (int64 format)

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

AdmissionPolicy

Bu hizmetin giriş politikası.

Sıralamalar
ADMISSION_POLICY_UNSPECIFIED Kullanılmamış.
TIME_STRICT Müşterilerin müsaitlik aralığının başlangıç zamanında hazır olması gerekir ve hizmetin, aralığın bitiş zamanında sona ermesi beklenir. TIME_STRICT kullanım alanlarına örnekler: * Saat 9:00'da başlayan ve tüm katılımcıların başlangıç saatinde gelmesini gerektiren ve saat 12:00 civarında geri 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 sınıfı.
TIME_FLEXIBLE

Müşteriler, bu rezervasyonu kullanmak için müsaitlik aralığının başlangıç ve bitiş zamanı arasında istedikleri zaman gelebilir.

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

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

Müşterilerin müsaitlik aralığının başlangıç saatinde satıcıya gelmesi gerekir ancak istedikleri zaman ayrılabilirler.

Örneğin, müze girişi senaryosundaki 10:00 için zamanlanmış giriş bileti, kullanıcının 10:00'da müzede olmasını gerektirir. Bu hizmetin müsaitlik aralıkları için başlangıç zamanı, belirlenen giriş zamanını gösterir. Ancak bitiş zamanı, yalnızca rezervasyon için müsaitlik aralığını tanımlamak amacıyla bir anahtar olarak kullanılır.

CancellationPolicy

Bir hizmetin iptal politikası.

JSON gösterimi
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
Alanlar
refundCondition[]

object (RefundCondition)

Politika için geçerli en az bir geri ödeme koşulu.

RefundCondition

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

JSON gösterimi
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Alanlar
minDurationBeforeStartTime

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

refundPercent

integer (uint32 format)

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

PrepaymentType

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

Sıralamalar
PREPAYMENT_TYPE_UNSPECIFIED Varsayılan olarak ön ödemenin NOT_SUPPORTED olduğunu varsayacağız.
REQUIRED Kullanıcının bu hizmeti rezervasyon sırasında ödemesi gerekir.
OPTIONAL Kullanıcı, bu hizmet için rezervasyon sırasında veya daha sonra ön ödeme yapmayı seçebilir ancak rezervasyon yapmak için bu gerekli değildir.
NOT_SUPPORTED Bu hizmet için ön ödeme desteklenmez.

PrepaymentTerms

Ön ödemenin ne zaman tamamlandığına dair ayrıntılı bilgi.

JSON gösterimi
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Alanlar
chargeTiming

enum (ChargeTiming)

Satın alma zamanına göre ödemenin ne zaman yapılacağı.

chargeTimeBeforeStartTimeSec

string (int64 format)

Hizmetin başlangıç zamanından önce, kullanıcıdan ödeme alınması için geçen süre (saniye cinsinden). Bu alan yalnızca ChargeTiming CHARGE_LATER olduğunda ayarlanmalıdır.

ChargeTiming

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

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

ServiceIntakeForm

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

JSON gösterimi
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Alanlar
field[]

object (ServiceIntakeFormField)

Kullanıcıya gösterilecek alanlar.

firstTimeCustomers
(deprecated)

boolean

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

returningCustomers
(deprecated)

boolean

Doğru ise bu form tekrarlanan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, kayıt formlarında desteklenmez.

ServiceIntakeFormField

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

JSON gösterimi
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
Alanlar
id

string

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

type

enum (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 localizedLabel kullanın.

localizedLabel

object (Text)

Bu alan için kullanıcıya gösterilen metin. Alan birden fazla yerel ayara sahip olabilir. (gerekli)

value[]

string

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

choiceText[]

object (Text)

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

isRequired

boolean

Bu alanın yanıtının kullanıcı tarafından zorunlu tutulup tutulmadığını belirtir.

allowCustomAnswer

boolean

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

additionalOption[]

object (Text)

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

ticketTypeRestrict[]

string

Bu soru yalnızca kullanıcı belirli bilet türleri için rezervasyon yaptığında 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

object (Text)

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

FieldType

Alanın türünü belirten bir enum.

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

ServiceType

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

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

TicketType

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

Bilet, bir hizmet için rezervasyon yapılabilen en küçük birimdir (ör. rafting gezisinde yer, müzeye giriş, tam gün çift kişilik kano kiralama).

JSON gösterimi
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Alanlar
ticketTypeId

string

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

shortDescription

string

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

Bu, kullanıcı tarafından görülebilir (ör. "Yetişkin", "Çocuk", "Eski asker", "J Satırı" vb. Zorunlu. Her bilet türünün, kullanıcı tarafından görülebilecek bir açıklaması olmalıdır. Desteği sonlandırıldı. Bunun yerine localizedShortDescription özelliğini kullanın.

localizedShortDescription

object (Text)

i18n desteğine sahip bu TicketType için kısa bir açıklama.

Bu, kullanıcı tarafından görülebilir (ör. "Yetişkin", "Çocuk", "Eski asker", "J Sıra" vb. Zorunlu. Her bilet türünün kullanıcı tarafından görülebilmesi için bir açıklaması olmalıdır. Her yerel ayar için ayrı değerler sağlanabilir.

price

object (Price)

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

perTicketFee

object (PerTicketFee)

Bu bileti satın almayla ilgili ek ücretler. (isteğe bağlı)

priceDisplayType

enum (PriceDisplayType)

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

optionDescription

string

Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Desteği sonlandırıldı. Bunun yerine localizedOptionDescription parametresini kullanın.

localizedOptionDescription

object (Text)

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

Ek seçenekler, bilet türü birden fazla boyutu temsil ettiğinde kullanışlıdır.

1. örnek: "yetişkin" ve "çocuk" gibi farklı türlere ve ek seçenek olarak dile sahip bir giriş bileti için beklenen TicketType listesi şu şekilde olur: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

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

İsteğe bağlıdır ancak hizmetteki herhangi bir destek kaydı türünde bu alan ayarlanmışsa diğer tüm destek kaydı türlerinde de bu alanın ayarlanmış olmasını bekleriz (varsayılan bir optionDescription kullanılabilir). Örneğin, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] geçerli bir liste değildir.

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

inventoryType

enum (InventoryType)

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

PerTicketFee

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

JSON gösterimi
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Alanlar
serviceCharge

object (Price)

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

facilityFee

object (Price)

Mekana/tesise ödenen ücret.

taxes

object (Price)

Bilet başına vergiler.

PriceDisplayType

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

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

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

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

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.

RelatedMedia

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

JSON gösterimi
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Alanlar
url

string

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

type

enum (MediaType)

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

localizedCaption

object (Text)

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

attribution

object (Attribution)

Medyanın kaynağıyla ilgili ilişkilendirme bilgileri. Fotoğrafçıya veya ajansa kredi vermek 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ı. localizedCaption özelliğini kullanmayı tercih edin.

MediaType

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

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

İlişkilendirme

Bu medya için ilişkilendirme bilgileri.

JSON gösterimi
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
Alanlar
localizedText

object (Text)

i18n'yi destekleyen fotoğrafçıya veya ajansa atıfta bulunulan metin. Bu metin, kaynak medyayla birlikte gösterilir. Bu alanda 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ı. localizedText özelliğini kullanmayı tercih edin.

ServiceAttributeValueId

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

JSON gösterimi
{
  "attributeId": string,
  "valueId": string
}
Alanlar
attributeId

string

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

valueId

string

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

WaitlistRules

Bekleme listesine katılmayla ilgili kurallar.

JSON gösterimi
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Alanlar
minPartySize

integer

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.

maxPartySize

integer

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.

supportsAdditionalRequest

boolean

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

aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Ayarlanan maxPartySize 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 sunulmamalıdır.

UnsupportedPartySizeOption

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

JSON gösterimi
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Alanlar
Birlik alanı kind. Kapsama alanı dışındaki partiler için kullanılabilen seçenekler. kind yalnızca aşağıdakilerden biri olabilir:
callMerchant

object (CallMerchant)

Bu sınırın dışındaki gruplar işletmeyi arayabilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Gösterilecek örnek metin: "{waitlistRules.max_party_size} kişiden fazla gruplar için lütfen {phone} numaralı telefondan restoranı arayın." CallMerchant ayarlanmalıdır ancak boş olacaktır.

CallMerchant

Bu türde alan yoktur.

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

TicketingVerticalSpecificData

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

JSON gösterimi
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Alanlar
eventCategory

enum (EventCategory)

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

eventUrl

string

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

entity[]

object (Entity)

Etkinlikle ilgili öğelerin listesi. (isteğe bağlı)

eventAttendanceMode

enum (AttendanceMode)

Zorunlu. Etkinlik katılımının türü.

eventVirtualLocationUrl[]

string

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

eventOrganizer

object (Text)

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

eventOrganizerUrl

string

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

eventOrganizerType

enum (OrganizerType)

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

eventSourceUrl[]

string

Zorunlu. Etkinlik bilgilerinin veya açıklamalarının bulunabileceği sayfaların URL'si.

eventState

enum (EventState)

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

brandName

object (Text)

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

eventCreator

object (EventCreator)

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

EventCategory

Ürün deneyimini özelleştirdiğimiz etkinlik kategorilerinin alt kümesi. Not: Etkinlikler için evrensel bir ontoloji olarak tasarlanmamıştır.

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

Varlık

Etkinlikle ilgili bir öğeyi temsil eder.

JSON gösterimi
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Alanlar
id

string

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

name

string

Varlığın adı. (gerekli)

url

string

Varlık hakkında net bilgi veren web sayfasının URL'si. Bu, iş ortağının web sitesinde varlık için bulunan web sayfasıdır (varsa). Varlıkla ilgili diğer herkese açık URL'ler için publicIdentificationData'daki relevantUrl değerini kullanın. (isteğe bağlı)

entityType

enum (EntityType)

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

entityRole

enum (EntityRole)

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

publicIdentificationData

object (PublicIdentificationData)

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

EntityType

Varlığın türü. Not: Evrensel bir ontoloji olarak tasarlanmamıştır.

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

EntityRole

Varlığın etkinlikteki rolü.

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

PublicIdentificationData

Tanımlayıcılar, web sayfaları veya bir tüzel kişiye atıfta bulunan diğer herkese açık kaynaklar.

JSON gösterimi
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
Alanlar
relevantUrl[]

string

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

musicbrainzId

string

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

AttendanceMode

Etkinlik katılımının 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.

OrganizerType

Düzenleyenin türü.

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

EventState

Etkinliğin durumu.

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

EventCreator

Etkinliği oluşturan kullanıcıyla ilgili bilgiler. Yalnızca kullanıcı tarafından oluşturulan içerik etkinlikleri içeren platformlar için geçerlidir.

JSON gösterimi
{
  "name": string
}
Alanlar
name

string

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

IntegrationType

Entegrasyon derinliği desteklenir.

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

PerOrderFee

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

JSON gösterimi
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Alanlar
deliveryFee

object (Price)

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

processingFee

object (Price)

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

ToursAndActivitiesContent

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

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

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

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

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

JSON gösterimi
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Alanlar
highlights[]

object (Text)

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

inclusions[]

object (Text)

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

exclusions[]

object (Text)

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

mustKnow[]

object (Text)

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

Konum

Bir konumla ilgili coğrafi bilgiler.

JSON gösterimi
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Alanlar
placeId

string

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

name

string

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

Bu alan isteğe bağlıdır ancak bazı bağlamlarda zorunlu olabilir. Örneğin, adı olmayan bir Service.location, aynı adreste olsa bile bir ticari tüzel kişiyle eşleşmez. (isteğe bağlı)

telephone

string

Ü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

object (GeoCoordinates)

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

locationType

enum (LocationType)

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

locationId

string

Hizmet içindeki konumun benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konuma referans vermek için kullanılabilir. Örneğin, özel kayıt formunda teslim alma yeri seçeneklerini belirtmek için bir dizi konum kimliği kullanılabilir. Ayarlanmışsa bu kimlik aynı hizmet içinde benzersiz olmalıdır. (isteğe bağlı)

LocationType

Bu konumun türü.

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

Derecelendirme

Bir öğenin derecelendirmesini tanımlar.

JSON gösterimi
{
  "value": number,
  "numberOfRatings": string
}
Alanlar
value

number

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

numberOfRatings

string

Değeri hesaplamak için kullanılan puan sayısı (zorunlu).

HomeServiceData

Ev hizmetleri sektörü için ek bilgi sağlamanız gerekir.

JSON gösterimi
{
  "categoryType": string,
  "jobType": string
}
Alanlar
categoryType

string

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

jobType

string

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

VirtualSession

Sanal/online oturumla ilgili bilgiler. Ör. online yoga dersi, sanal yemek pişirme dersi vb.

JSON gösterimi
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Alanlar
sessionInstructions

object (Text)

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

sessionRequirements

object (Text)

Belirtilen sanal oturumla ilgili koşullar. Ör. yoga matı, pişirme aletleri vb. (Önerilir)

virtualPlatformInfo

object (VirtualPlatformInfo)

Bu oturumda kullanılan sanal platformla ilgili bilgiler. (Sanal hizmetleri etkinleştirmek için gereklidir)

isSessionPrerecorded

boolean

Zorunlu. Sanal oturum canlı değilse ve önceden kaydedilmişse bu değeri doğru olarak ayarlayın.

VirtualPlatformInfo

Bu sanal oturumda kullanılacak platformla ilgili bilgiler.

JSON gösterimi
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Alanlar
platform

enum (Platform)

Sanal oturum için kullanılan platform.

otherPlatformName

object (Text)

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

Platform

Satıcının hangi sanal platformu kullanacağını belirten bir 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.

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.

JSON gösterimi
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Alanlar
paymentMethods[]

object (Text)

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

UriTemplate

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

JSON gösterimi
{
  "uriTemplate": string
}
Alanlar
uriTemplate

string

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

Yemek rezervasyonu bağlantısı için kullanılabilen 5 parametre: 1) (zorunlu) {availability_slot_start_seconds} :: müsaitlik durumu feed'indeki startSec alanından doldurulur 2) (zorunlu) {availability_slot_duration_seconds} :: müsaitlik durumu feed'indeki durationSec alanından doldurulur 3) (isteğe bağlı) {resources_party_size} :: müsaitlik durumu feed'indeki partySize alanından doldurulur 4) (isteğe bağlı) {availability_availability_tag} :: müsaitlik durumu feed'indeki availabilityTag alanından doldurulur 5) (isteğe bağlı) {resources_room_id} :: müsaitlik durumu feed'indeki roomId alanından doldurulur

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

Yöntemler

create

Belirtilen toplayıcı tarafından yönetilen bir satıcının yeni bir Service'sini oluşturur ve döndürür.

delete

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesini siler.

patch

Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut Service öğesini günceller ve döndürür.