REST Resource: inventory.partners.merchants.services

Kaynak: Hizmet

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

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)
  }
}
Alanlar
name

string

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

serviceName

string

Hizmetin adı; ör. "Erkek saç kesimi". Kullanımdan kaldı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ılar tarafından görülebilen açıklaması. Kullanımdan kaldırıldı, bunun yerine localizedDescription kullanın.

localizedDescription

object (Text)

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

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

Desteklenen HTML benzeri biçimlendirme etiketleri:

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

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

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

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

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

Desteklenmeyen etiketler:

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

Önemli notlar:

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

object (Price)

Hizmetin fiyatı.

priceInterpretation

enum (PriceInterpretation)

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

rules

object (SchedulingRules)

Randevu alma/iptal etme kuralları.

prepaymentType

enum (PrepaymentType)

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

prepaymentTerms

object (PrepaymentTerms)

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

form[]
(deprecated)

object (ServiceIntakeForm)

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

intakeForm

object (ServiceIntakeForm)

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

perTicketIntakeForm

object (ServiceIntakeForm)

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

taxRate

object (TaxRate)

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

paymentOptionId[]

string

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

deposit

object (Deposit)

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

noShowFee

object (NoShowFee)

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

requireCreditCard

enum (RequireCreditCard)

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

type

enum (ServiceType)

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

ticketType[]

object (TicketType)

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

relatedMedia[]

object (RelatedMedia)

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

serviceAttributeValueId[]

object (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ı)

waitlistRules

object (WaitlistRules)

Bekleme listesine katılma kuralları.

ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

Etkinlik bileti satışına özel 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ı entegrasyonuna sahip iş ortakları için alakasızdır. Bu iş ortakları için uçtan uca devre dışı bırakılır.

perOrderFee

object (PerOrderFee)

Bu hizmeti satın alırken sipariş düzeyinde alınan ü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 olarak ziyaret edilen birden fazla konum varsa veya START_LOCATION, VISITED_LOCATION konumundan farklıysa, START_LOCATION belirtilmelidir. Örnek: - Üç mekanın ziyaret edildiği rehberli bir bisiklet turu için başlangıç yerinin belirtilmesi gerekir. - Otel lobisinde otobüs turu toplantısı ve ardından ziyaret edilen mekana gitme. Toplantı yerinin belirtilmesi gerekir.

rating

object (Rating)

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

homeServiceData

object (HomeServiceData)

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

virtualSession

object (VirtualSession)

İsteğe bağlı. Sanal oturum hakkında bilgi. 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 ek bilgiler. ÖNEMLİ NOT: Bu işlemde RwG yer almaz. virtualSession tanımlanmışsa ve hizmet ücretsiz değilse veya prepaymentType, GEREKLİ olarak ayarlanmadıysa gereklidir.

PriceInterpretation

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

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

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

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

STARTS_AT

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

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

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

NOT_DISPLAYED

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

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

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

SchedulingRules

Bir hizmetin zamanlama 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)

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

lateCancellationFee
(deprecated)

object (Price)

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

noshowFee
(deprecated)

object (Price)

İptal etmeden katılmama ücreti.

admissionPolicy

enum (AdmissionPolicy)

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

cancellationPolicy

object (CancellationPolicy)

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

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

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

Örnekler:

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

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

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

minAdvanceBooking

string (int64 format)

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

minBookingBufferBeforeEndTime

string (int64 format)

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

AdmissionPolicy

Bu hizmete giriş politikası.

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

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

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

TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

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

CancellationPolicy

Bir hizmet için iptal politikası.

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

object (RefundCondition)

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

RefundCondition

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

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

string (Duration format)

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

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir 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 (varsayılan) değerine ayarlandığında hizmet için geri ödeme yapılmaz. 100 olarak ayarlandığında bu hizmet için tamamen geri ödeme yapılabilir.

PrepaymentType

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

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

PrepaymentTerms

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

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

enum (ChargeTiming)

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

chargeTimeBeforeStartTimeSec

string (int64 format)

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

ChargeTiming

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

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

ServiceIntakeForm

Satıcı tarafından sağlanan hizmeti özelleştiren bir kabul 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

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

returningCustomers
(deprecated)

boolean

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

ServiceIntakeFormField

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

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

type

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. Bu alan birden fazla yerel ayarda sağlanabilir. (zorunlu)

value[]

string

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

choiceText[]

object (Text)

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

isRequired

boolean

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

allowCustomAnswer

boolean

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

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" başka bir seçenek de olabilir. (isteğe bağlı)

ticketTypeRestrict[]

string

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

hint

object (Text)

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

FieldType

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

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

ServiceType

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

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

TicketType

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

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

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

string

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

shortDescription

string

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

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

localizedShortDescription

object (Text)

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

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

price

object (Price)

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

perTicketFee

object (PerTicketFee)

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

optionDescription

string

Bu bilet türünün temsil ettiği ek seçeneklerin (varsa) açıklaması. Kullanımdan kaldırıldı. Bunun yerine localizedOptionDescription öğesini kullanın.

localizedOptionDescription

object (Text)

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

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

Örnek 1: Ek seçenek olarak farklı 'adult', 'child' ve dil içeren 'adult' {adult_value' ve 'dil' içeren giriş bileti {adult_value'

Örnek 2: "Option_type: localized_value} "Option_type} {localized_value} "Option_type} "Option_type} "Option_type} "Option_type} {localized_value} "shortDescription}

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

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

PerTicketFee

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

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/tesis için ödenen ücret.

taxes

object (Price)

Bilet vergileri başına.

RelatedMedia

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

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 çıkarılacaktır. (isteğe bağlı)

attribution

object (Attribution)

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

caption
(deprecated)

string

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

MediaType

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

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

İlişkilendirme

Bu medyayla ilgili 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 bulunulacak metin. Bu metin, kaynak medya ile birlikte görüntülenir. Bu alan için yalnızca düz metnin desteklendiğini, tüm HTML bileşenlerinin çıkarılacağını unutmayın (köprü tabanlı ilişkilendirme desteklenmez).

text
(deprecated)

string

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

ServiceAttributeValueId

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

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

string

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

valueId

string

Bu özelliğin değerinin kimliği, ör. "saç kesimi". 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 sağlayan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevini sağlamıyorsa bu alan doldurulmamalıdır.

maxPartySize

integer

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

supportsAdditionalRequest

boolean

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

aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

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

JSON gösterimi
{
  "callMerchant": {
    object (CallMerchant)
  }
}
Alanlar
callMerchant

object (CallMerchant)

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

CallMerchant

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

TicketingVerticalSpecificData

Etkinlik bileti satışına özel 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)
}
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

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

entity[]

object (Entity)

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

eventAttendanceMode

enum (AttendanceMode)

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

eventVirtualLocationUrl[]

string

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

eventOrganizer

object (Text)

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

eventOrganizerUrl

string

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

eventOrganizerType

enum (OrganizerType)

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

eventSourceUrl[]

string

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

eventState

enum (EventState)

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

EventCategory

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

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

Varlık

Etkinlikle ilgili bir varlığı 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 tüzel kişinin benzersiz tanımlayıcısı. (isteğe bağlı)

name

string

Varlığın adı. (zorunlu)

url

string

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

entityType

enum (EntityType)

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

entityRole

enum (EntityRole)

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

publicIdentificationData

object (PublicIdentificationData)

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

EntityType

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

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

EntityRole

Etkinlikteki varlığın rolü.

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

PublicIdentificationData

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

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

string

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

musicbrainzId

string

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

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.

OrganizerType

Düzenleyenin türü.

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

EventState

Etkinliğin durumu.

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

IntegrationType

Entegrasyon derinliği desteklenir.

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

PerOrderFee

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

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

object (Price)

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

processingFee

object (Price)

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

ToursAndActivitiesContent

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

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

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

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

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

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

object (Text)

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

inclusions[]

object (Text)

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

exclusions[]

object (Text)

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

mustKnow[]

object (Text)

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

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ğlanmışsa Google, konumu bu yerle eşleştirir.

name

string

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

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

telephone

string

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

url

string

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

geo

object (GeoCoordinates)

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

locationType

enum (LocationType)

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

locationId

string

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

LocationType

Bu konumun türü.

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

Derecelendirme

Bir varlık için Derecelendirme'yi 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 sadece numberOfRatings sıfır olduğunda atlanabilir.

numberOfRatings

string

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

HomeServiceData

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

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

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

VirtualSession

Sanal/online oturum hakkında bilgi. Ör. Online yoga dersi, sanal aşçılık 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ğına ilişkin talimatlar. İş ortağı, video URL'sini rezervasyona eklemezse bu metinde video URL'sinin kullanıcıyla ne zaman paylaşılacağı belirtilmelidir. Ör. "Zoom URL'si, dersten 30 dakika önce gönderilecek." (Önerilir)

sessionRequirements

object (Text)

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

virtualPlatformInfo

object (VirtualPlatformInfo)

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

isSessionPrerecorded

boolean

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

VirtualPlatformInfo

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

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 ayarlandıysa platformun adı. (Platform OTHER olarak ayarlanmışsa gerekli)

Platform

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

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

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ılara yalnızca aşağıda belirtilen ödeme yöntemlerini kullanarak ödeme yapmaları önerilir.

Yöntemler

create

Belirtilen toplayıcı tarafından yönetilen bir satıcı için yeni Service oluşturur ve bunu 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 değerini günceller ve bu öğeyi geri gönderir.