Dizin
AdsAccountLinkingService(arayüz)BookingNotification(arayüz)Feed(arayüz)InvalidationService(arayüz)InventoryStatus(arayüz)InventoryUpdate(arayüz)ActionLink(mesaj)ActionLink.ActionLinkType(enum)ActionLink.EventMetadata(mesaj)ActionLink.EventMetadata.Surface(enum)ActionPlatform(enum)AdsAccountLink(mesaj)AdsAccountLink.State(enum)Advisement(mesaj)Availability(message)Availability.ConfirmationMode(enum)Availability.DurationRequirement(enum)Availability.LinkoutRequiredReason(enum)Availability.Recurrence(mesaj)Availability.ScheduleException(message)Availability.SchedulingRuleOverrides(message)BatchDeleteGenericRecordsRequest(message)BatchPushGenericRecordRequest(message)BatchReplaceServiceAvailabilityRequest(message)BatchReplaceServiceAvailabilityResponse(message)Booking(message)BookingFailure(message)BookingFailure.Cause(enum)BookingFailure.PaymentFailureInformation(mesaj)BookingFailure.PaymentFailureInformation.ThreeDS1Parameters(message)BookingStatus(enum)CallMerchant(mesaj)CancellationPolicy(message)CancellationPolicy.RefundCondition(message)ClientInformation(message)CreateAdsAccountLinkRequest(message)CreateMerchantRequest(message)CreateServiceRequest(message)CreditCardRestrictions(message)CreditCardRestrictions.CreditCardType(enum)DeleteAdsAccountLinkRequest(mesaj)DeleteMerchantRequest(message)DeleteServiceRequest(message)Deposit(message)DirectMerchantPayment(message)DurationRange(message)EconomicOperator(message)ExtendedServiceAvailability(message)FeedStatistics(message)FeedStatus(message)FeedStatus.State(enum)FoodOrderingMetadata(mesaj)FoodOrderingMetadata.AdvanceOrderDetails(message)FoodOrderingMetadata.FeeDetails(message)FoodOrderingMetadata.FeeDetails.FeeAmount(message)FoodOrderingMetadata.FeeDetails.FeeType(enum)FulfillmentOption(mesaj)FulfillmentOption.AvailableDay(message)FulfillmentOption.FeeDetails(message)FulfillmentOption.FixedFee(message)FulfillmentOption.FulfillmentType(enum)FulfillmentOption.MinimumFee(mesaj)FulfillmentOption.NoFee(message)GenericDeleteRecord(message)GenericRecord(message)GeoCoordinates(message)GetAdsAccountLinkRequest(message)GetMerchantStatusRequest(message)GetStatusRequest(message)HomeServiceData(message)IntegrationType(enum)InvalidateResourceRequest(mesaj)LineItem(message)LineItem.OrderedTickets(message)LinkoutTemplate(message)ListMerchantStatusesRequest(message)ListMerchantStatusesRequest.BookingInventoryStatus(enum)ListMerchantStatusesRequest.GeoMatchingStatus(enum)ListMerchantStatusesRequest.WaitlistInventoryStatus(enum)ListMerchantStatusesResponse(mesaj)ListStatusRequest(message)ListStatusResponse(message)LocalizedString(message)Location(message)LocationType(enum)Merchant(mesaj)MerchantMatchingHints(message)MerchantStatus(message)MerchantStatus.BookingStatus(message)MerchantStatus.DirectUrl(message)MerchantStatus.DirectUrl.UrlType(enum)MerchantStatus.LocalServicesMatchInfo(mesaj)MerchantStatus.LocalServicesMatchInfo.MatchedProvider(message)MerchantStatus.PlaceInfo(message)MerchantStatus.ProcessingStatus(enum)MerchantStatus.WaitlistStatus(mesaj)MoneyRange(message)NoShowFee(message)Order(message)OrderOnlineMetadata(message)PaymentInformation(message)PaymentOption(message)PaymentOption.ActivationType(enum)PaymentOption.PaymentOptionType(enum)PaymentProcessorConfig(mesaj)PaymentProcessorConfig.Processor(enum)PaymentRestrictions(mesaj)PerOrderFee(message)PerTicketFee(message)PostalAddress(message)Prepayment(message)PrepaymentStatus(enum)Price(mesaj)PriceInfo(message)PriceInterpretation(enum)PriceRange(mesaj)PriceType(enum)QuantitativeValue(mesaj)QuantitativeValue.RangeValue(message)Rating(message)RelatedMedia(message)RelatedMedia.Attribution(message)RelatedMedia.MediaType(enum)ReplaceServiceAvailabilityRequest(mesaj)RequireCreditCard(enum)Resources(mesaj)SchedulingRules(message)SchedulingRules.AdmissionPolicy(enum)Service(mesaj)Service.PrepaymentTerms(message)Service.PrepaymentTerms.ChargeTiming(enum)Service.PrepaymentType(enum)Service.ServiceType(enum)ServiceAttribute(mesaj)ServiceAttribute.Value(message)ServiceAttributeValueId(message)ServiceAvailability(message)ServiceIntakeForm(message)ServiceIntakeFormField(message)ServiceIntakeFormField.FieldType(enum)TaxRate(mesaj)Terms(message)Text(message)TicketType(message)TicketType.InventoryType(enum)TicketType.PriceDisplayType(enum)TicketingVerticalSpecificData(mesaj)TicketingVerticalSpecificData.AttendanceMode(enum)TicketingVerticalSpecificData.Entity(mesaj)TicketingVerticalSpecificData.Entity.EntityRole(enum)TicketingVerticalSpecificData.Entity.EntityType(enum)TicketingVerticalSpecificData.EventCategory(enum)TicketingVerticalSpecificData.EventCreator(mesaj)TicketingVerticalSpecificData.EventState(enum)TicketingVerticalSpecificData.OrganizerType(enum)TicketingVerticalSpecificData.PublicIdentificationData(mesaj)TimeRange(message)TokenizationConfig(message)TokenizationConfig.BillingInformationFormat(enum)ToursAndActivitiesContent(mesaj)UnsupportedPartySizeOption(message)UpdateAdsAccountLinkRequest(message)UpdateBookingRequest(message)UpdateMerchantRequest(message)UpdateOrderRequest(message)UpdateServiceRequest(message)UriTemplate(message)UserPurchaseRestriction(message)VirtualSession(message)VirtualSession.VirtualPlatformInfo(message)VirtualSession.VirtualPlatformInfo.Platform(enum)WaitlistRules(mesaj)
AdsAccountLinkingService
Google Ads ile İş Ortağı Merkezi arasındaki hesap bağlantısını yönetmek için kullanılan hizmet.
| CreateAdsAccountLink |
|---|
|
Ads hesabı bağlantısı oluşturur. Bu işlem, Google Ads hesabı ile İş Ortağı Merkezi arasında bağlantı oluşturur. Bağlantı, Ads portalından onaylanana kadar
|
| DeleteAdsAccountLink |
|---|
|
Ads hesabı bağlantısını siler. Bu işlem, Google Ads hesabı ile İş Ortağı Merkezi hesabının bağlantısını kaldırır.
|
| GetAdsAccountLink |
|---|
|
Ads hesabı bağlantısını alır.
|
| UpdateAdsAccountLink |
|---|
|
Ads hesabı bağlantısını envanter öğeleriyle günceller. Bu işlem, sağlanan envanter öğeleriyle Ads hesabı bağlantısını günceller.
|
BookingNotification
Harici planlama iş ortaklarından gelen randevularla ilgili bildirimler alır. İş ortağı, CreateBooking ve CheckAvailability gibi rezervasyona dayalı UPÇ'leri mi yoksa CreateOrder ve CheckOrderFulfillability gibi siparişe dayalı UPÇ'leri mi uyguladığına bağlı olarak UpdateBooking veya UpdateOrder'ı çağırmalıdır.
| UpdateBooking |
|---|
|
Mevcut bir
|
| UpdateOrder |
|---|
|
Mevcut bir
|
Feed
Harici toplayıcı iş ortakları tarafından yüklenen feed'lerin işleme durumunu alın.
| GetStatus |
|---|
|
Daha önce yüklenen bir feed'in belirtilen toplayıcıya göre
|
| ListStatus |
|---|
|
Belirtilen toplayıcı tarafından daha önce yüklenmiş birden fazla satıcı, hizmet veya stok durumu feed'inin
|
InvalidationService
Harici iş ortaklarından kaynak geçersiz kılma istekleri alır.
| InvalidateResource |
|---|
|
Mevcut bir kaynağı geçersiz kılar. İstenen kaynak Google hizmetine abone değilse istek yoksayılır. Desteklenen kaynak türleri: - Teslim alma
|
InventoryStatus
Yüklenen satıcıların envanterini ve eşleşme durumunu alın.
| GetMerchantStatus |
|---|
|
|
| ListMerchantStatuses |
|---|
|
Filtre koşullarını karşılayan bir iş ortağının tüm
|
InventoryUpdate
Harici toplayıcılardan envanter güncellemeleri alır.
| BatchDeleteGenericRecords |
|---|
|
Belirtilen feed türündeki kayıtları siler. Yalnızca temel doğrulama (ör. hatalı biçimlendirilmiş istek) gerçekleştirir. Ardından, iş ortağına uygun bir yanıt hemen döndürülür. Google, istek üzerinde işletme mantığı doğrulamasını eşzamansız olarak gerçekleştirir. Bu toplu çağrı, atomikliği garanti etmez.
|
| BatchPushGenericRecord |
|---|
|
Belirtilen feed türündeki kayıtları ekler ve/veya günceller. Yalnızca temel doğrulama (ör. hatalı biçimlendirilmiş istek) gerçekleştirir. Ardından, iş ortağına uygun bir yanıt hemen döndürülür. Google, istek üzerinde işletme mantığı doğrulamasını eşzamansız olarak gerçekleştirir. Bu toplu çağrı, atomikliği garanti etmez.
|
| BatchReplaceServiceAvailability |
|---|
|
Mevcut
|
| CreateMerchant |
|---|
|
Belirtilen toplayıcı tarafından yönetilen yeni bir
|
| CreateService |
|---|
|
Belirtilen toplayıcı tarafından yönetilen bir satıcının yeni bir
|
| DeleteMerchant |
|---|
|
Belirtilen toplayıcı tarafından yönetilen mevcut bir
|
| DeleteService |
|---|
|
Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut
|
| ReplaceServiceAvailability |
|---|
|
Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut
|
| UpdateMerchant |
|---|
|
Belirtilen toplayıcı tarafından yönetilen mevcut bir
|
| UpdateService |
|---|
|
Belirtilen toplayıcı tarafından yönetilen bir satıcının mevcut
|
ActionLink
İlişkili dil, erişimin kısıtlandığı ülkelerin listesi ve bu işlemin hangi platformda gerçekleştirilmesi gerektiğini belirten isteğe bağlı platform içeren bir işlem URL'si.
| Alanlar | |
|---|---|
url |
Bu işlem bağlantısının giriş noktası URL'si. |
language |
Bu URI'deki içeriğin kullanılabildiği dili tanımlayan BCP-47 dil etiketi. |
restricted_country[] |
ISO 3166-1 alfa-2 ülke kodu. Kısıtlanmamış görünürlük için boş bırakın. |
platform |
Bu işlemin gerçekleştirilmesi gereken platform. Bu alan ayarlanmamışsa yedek olarak ACTION_PLATFORM_WEB_APPLICATION kullanılır. |
action_link_type |
Önceden belirlenmiş işlem türü. |
order_online_metadata |
Online sipariş bağlantısının meta verileri. ACTION_LINK_TYPE_SHOP_ONLINE ActionLinkType'a sahip işlemi destekler. |
food_ordering_metadata |
Yemek siparişi bağlantılarıyla ilgili meta veriler. Desteklenen işlem türleri: * |
event_metadata |
Etkinlikler dikeyine özgü işlem bağlantısı hakkında ek bilgiler. |
ActionLinkType
Bir işlem bağlantısıyla ilişkili önceden belirlenmiş işlem türü.
| Sıralamalar | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
İşlem bağlantısı türü belirtilmedi. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
İşlem bağlantısı türü, randevu alma işlemidir. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
İşlem bağlantısı türü, online randevu alma işlemidir. |
ACTION_LINK_TYPE_ORDER_FOOD |
İşlem bağlantısı türü, teslimat veya paket servis ya da her ikisi için yemek siparişi verme işlemidir. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
İşlem bağlantısı türü, teslimat için yemek siparişi verme işlemidir. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
İşlem bağlantısı türü, paket servis için yemek siparişi verme işlemidir. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
İşlem bağlantısı türü, yemek rezervasyonu yapmaktır. |
ACTION_LINK_TYPE_SHOP_ONLINE |
İşlem bağlantısı türü, alışveriş için sipariş verme işlemidir. Teslimat veya teslim alma ya da her ikisi de olabilir. |
EventMetadata
Etkinlikler dikeyine özgü işlem bağlantısı hakkında ek bilgiler.
| Alanlar | |
|---|---|
surface |
Bir işlem bağlantısıyla ilişkili önceden belirlenmiş etkinlik yüzeyi. Bu yalnızca Etkinlikler dikeyinde kullanılır. |
Platform
Bir işlem bağlantısıyla ilişkili önceden belirlenmiş etkinlik yüzeyi. Bu yalnızca Etkinlikler dikeyinde kullanılır.
| Sıralamalar | |
|---|---|
SURFACE_UNSPECIFIED |
Yüzey belirtilmemiş. |
SURFACE_SEARCH |
İşlem bağlantısı, Arama'da etkinlik bileti rezervasyonu yapmaktır. |
SURFACE_YOUTUBE |
İşlem bağlantısı, YouTube'da etkinlik bileti rezervasyonu yapmaktır. |
SURFACE_ADS |
İşlem bağlantısı, etkinlik reklamının tıklanmasıdır. |
ActionPlatform
İşlemin gerçekleştirildiği platform. Web uygulaması genel yedekleme yöntemidir. ACTION_PLATFORM_WEB_APPLICATION ile en az bir ActionLink'e sahip olmanız önerilir. Platform olarak Android ve iOS'in belirtildiği bağlantılar yalnızca ilgili sistemde kullanılır.
| Sıralamalar | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
Platform belirtilmemiş. |
ACTION_PLATFORM_WEB_APPLICATION |
İşlem platformu genel olarak web'dir. |
ACTION_PLATFORM_MOBILE_WEB |
İşlem platformu, mobil cihazlarda web'dir. |
ACTION_PLATFORM_ANDROID |
İşlem platformu Android OS'dir. |
ACTION_PLATFORM_IOS |
İşlem platformu iOS'tir. |
AdsAccountLink
AdsAccountLink, bir Ads hesabı ile bir İş Ortağı Merkezi hesabı arasındaki bağlantıdır ve envanter öğelerini de içerir.
| Alanlar | |
|---|---|
name |
Tanımlayıcı. AdsAccountLink'in kaynak adı. Biçim: |
item_ids[] |
Zorunlu. Google Ads hesabıyla ilişkilendirilecek envanter öğesi kimliklerinin listesi. |
state |
Yalnızca çıkış. Ads hesabı bağlantısının durumu. |
Eyalet
Ads hesabı bağlantısının durumu.
| Sıralamalar | |
|---|---|
STATE_UNSPECIFIED |
Durum bilinmiyor. |
LINKED |
Hesap, İş Ortağı Merkezi ile Ads Portal arasında bağlı olmalıdır. |
PENDING |
Hesap, İş Ortağı Merkezi'nde veya Ads portalında onay bekliyor. |
DELETED |
Hesap bağlantısı silinir. |
REJECTED |
Hesap bağlantısı isteği, İş Ortağı Merkezi veya Ads Portal tarafından reddedilir. |
Tavsiye
Google ile Rezervasyon üzerinden rezervasyon yaparken kullanıcıya gösterilen tavsiyeler.
| Alanlar | |
|---|---|
text |
Google ile Rezervasyon üzerinden rezervasyon yaparken kullanıcıya gösterilecek özel mesaj. |
Kullanılabilirlik
Satıcının hizmetinin uygunluk aralığı (saat ve yer sayısı belirtilir).
| Alanlar | |
|---|---|
start_time |
Randevu aralığının başlangıç saati. |
duration |
Randevu aralığının süresi |
spots_total |
Bu uygunluk için toplam yer sayısı ve boş yer sayısı. Örnekler:
Not: Aşağıda tanımlanan kullanılabilirlik sıkıştırma biçimi kullanılarak istek gönderiliyorsa bu iki alan çıkarılır.
|
spots_open |
Açık yer sayısı. |
availability_tag |
Bu stok durumu aralığını tanımlamak için isteğe bağlı olarak kullanılan opak dize. Ayarlandığında, randevu alma/güncelleme/iptal etme isteklerine dahil edilir. |
resources |
Farklı personel üyeleri veya odalar hizmetin bir parçası olduğunda bu uygunluk aralığını diğerlerinden ayırt etmek için kullanılan isteğe bağlı kaynaklar. Örneğin, iki eğitmenin verdiği aynı yoga dersi: |
payment_option_id[] |
Bu yer için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine referans veren kimliklerin listesi. Gerçek ödeme seçenekleri satıcı düzeyinde tanımlanır ve birden fazla satıcı arasında da paylaşılabilir. Bu alan, hizmet mesajında belirtilen tüm payment_option_ids değerlerini geçersiz kılar. Benzer şekilde, burada belirtilen payment_option_ids değerlerinin hizmet mesajında bulunması GEREKMEZ ancak satıcı düzeyinde tanımlanması gerekir. |
recurrence |
Kullanılabilirlik için yinelenme bilgileri (birden fazla başlangıç zamanını temsil eder). Bir tekrar, bir iş gününe ait randevuları içermelidir. |
schedule_exception[] |
Bu hizmetin planlanamayacağı zamanlar. schedule_exception mesajlarının sayısını sınırlamak için bitişik istisnaları birleştirebilirsiniz. |
deposit |
Bu uygunluk için isteğe bağlı depozito. Belirtilmişse hizmet depozitosunu geçersiz kılar. |
no_show_fee |
Bu müsaitlik için isteğe bağlı olarak "rezervasyonu iptal etmeme" ücreti alınabilir. Belirtilmişse hizmete gelinmeme ücretini geçersiz kılar. |
prepayment |
İsteğe bağlı. Bu müsaitlik durumu için isteğe bağlı ön ödeme bilgileri. |
require_credit_card |
Kullanıcının bu uygunluk aralığına rezervasyon yaptırmak için kredi kartı bilgisi vermesi gerekip gerekmediğini gösterir. Değer ayarlanmamışsa hizmet düzeyinde ayarlanmışsa oradan devralınır. (isteğe bağlı) |
ticket_type_id[] |
Bu uygunluk aralığı için desteklenen bilet türlerinin listesini gösterir. Ayarlanmamışsa üst hizmetteki tüm bilet türleri bu zaman aralığı için kullanılabilir. Bu alanın değerlerinin üst hizmette tanımlanması gerektiğini unutmayın. Örnekler:
Hafta içi envanteri temsil etmek için:
Bu zaman aralığı için üç bilet türünün de mevcut olduğunu belirtmek üzere (isteğe bağlı) |
duration_requirement |
Seans süresini ve/veya bitiş zamanını gösterme zorunluluğu. Yuva kullanılamıyorsa bu alan yoksayılır. Aktiviteler dikeyinde kullanılmaz. (isteğe bağlı) |
scheduling_rule_overrides |
Kullanılabilirlik planlama kuralları. Alanlar doldurulursa hizmet düzeyindeki SchedulingRules'da bulunan ilgili planlama kurallarını geçersiz kılarlar. |
confirmation_mode |
Bu müsaitlik durumu için rezervasyon yapılırken kullanılacak onay modu. CONFIRMATION_MODE_SYNCHRONOUS onay moduna sahip uygunluk durumları için rezervasyon oluşturma girişimleri hemen onaylanmalı veya reddedilmelidir. CONFIRMATION_MODE_ASYNCHRONOUS onay moduna sahip müsaitlik durumları için rezervasyon oluşturma girişimleri hemen reddedilmeli veya PENDING durumuyla oluşturulmalıdır. |
linkout_required_reason |
İsteğe bağlı. Bu alan için yönlendirme bağlantısı gerekmesinin nedeni. Ayarlanırsa bu yer için satıcı kaynağının geçerli bir LinkoutTemplate'i olmalıdır. (isteğe bağlı) |
ConfirmationMode
Uygunluk rezervasyonu yapılırken kullanılan onay modları.
| Sıralamalar | |
|---|---|
CONFIRMATION_MODE_UNSPECIFIED |
Onay modu belirtilmedi. Eşzamanlı onay varsayılır. |
CONFIRMATION_MODE_SYNCHRONOUS |
Bu müsaitlik durumu için yapılan rezervasyonlar eşzamanlı olarak onaylanır. |
CONFIRMATION_MODE_ASYNCHRONOUS |
Bu müsaitlik için yapılan rezervasyonlar asenkron olarak onaylanır. |
DurationRequirement
Bu enum, kullanıcının istenen yuvaların süresini/bitiş zamanını onaylaması veya görüntülemesi için hangi şartların geçerli olduğunu gösterir.
| Sıralamalar | |
|---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
Bitiş zamanının nasıl işleneceği belirtilmemiştir. Bu, varsayılan seçenektir. |
DO_NOT_SHOW_DURATION |
Bitiş saati kullanıcıya gösterilmez. |
MUST_SHOW_DURATION |
Randevu oluşturulabilmesi için bitiş saati kullanıcıya gösterilmelidir. |
LinkoutRequiredReason
Bir alanın neden yönlendirme deneyimi içerdiği.
| Sıralamalar | |
|---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED |
Varsayılan değer: Kullanmayın, bilinmiyor anlamına gelir. |
PAYMENT_REQUIRED |
Slotun rezerve edilmesi için iş ortağı platformunda ödeme yapılması gerekir. |
Yinelenme
Tekrar mesajları isteğe bağlıdır ancak sürekli olarak tekrarlanan uygunluk aralıklarının daha kompakt bir şekilde gösterilmesine olanak tanır. Genellikle bir günlük çalışma programını temsil eder. Ardından, ScheduleException iletileri, iş günü içindeki ayrılmış/kullanılamayan zaman aralıklarını göstermek için kullanılır.
Koşullar:
- Kullanılabilirlik aralıklarının veya tekrarların genişletilmesi, aynı aralıkları oluşturmamalıdır. Kimlikler, start_time, duration ve resources eşleşiyorsa yuvalar aynı kabul edilir.
- Tek bir hizmetin zaman aralıklarında standart kullanılabilirlik biçimini ve tekrarı KARIŞTIRMAYIN. Tekrarlama, randevu sunan satıcılar/hizmetler için avantaj sağlar. Standart biçim, düzenli olarak planlanmış dersleri olan satıcılara/hizmetlere yöneliktir.
- Tekrarlar 24 saatten uzun sürmemelidir.
| Alanlar | |
|---|---|
repeat_until |
Kullanılabilirliğin tekrarlandığı maksimum UTC zaman damgası (dahil). |
repeat_every |
Birbiri ardına gelen müsaitlik aralıkları arasındaki süreyi tanımlar. Örnek: Süresi 20 dakika, repeat_every değeri 30 dakika, start_time değeri 09:00 ve repeat_until değeri 11:00 olan bir uygunluk, 09:00-09:20, 09:30-09:50, 10:00-10:20, 10:30-10:50 ve 11:00-11:20 saatleri arasında aralıklar oluşturur. (gerekli) |
ScheduleException
ScheduleException iletileri, iş günü içinde ayrılmış/kullanılamayan zaman aralıklarını temsil eder. Bu aralıklar, yukarıda açıklanan tekrarlama durumunun istisnalarıdır. Zaman aralıkları rezerve edildikçe, istisnalar listesi yeni kullanılamayan zaman aralıklarını yansıtacak şekilde güncellenmelidir. Tekrarlama değiştirilmemelidir.
| Alanlar | |
|---|---|
time_range |
İstisnanın zaman aralığı. Tekrarlama ile açıklanan ve bu kapalı-açık zaman aralığıyla çakışan tüm aralıklar kullanılamaz olarak kabul edilir. Örnek: Tekrarlama 20 dakika süre, 30 dakika repeat_every, 09:00 start_time ve 11:00 repeat_until olarak belirtilmişse 09:45-11:00 time_range değerine sahip bir ScheduleException, 09:30-09:50, 10:00-10:20 ve 10:30-10:50 saatleri arasındaki aralıkları kullanılamaz hale getirir. Zaman aralığı kapalı-açık olduğundan saat 11:00'de başlayan zaman aralığının etkilenmeyeceğini unutmayın. |
SchedulingRuleOverrides
Kullanılabilirlik düzeyi planlama kuralları.
| Alanlar | |
|---|---|
last_bookable_sec |
Bu aralığın son rezervasyon tarihi (saniye cinsinden). Bu zaman damgası, yuvanın start_sec değerinden önce olmalıdır (kullanıcıların başlangıç zamanından sonra rezervasyon yapabilmesi gerekiyorsa hizmet düzeyinde SchedulingRules.min_booking_before_end_time kullanılmalıdır). Varsa ilgili hizmetin SchedulingRules özelliğinin min_booking_buffer bölümünde belirtilenleri geçersiz kılar. |
first_bookable_sec |
Bu aralığın ilk kez rezerve edilebileceği zaman (saniye cinsinden). Bu zaman damgası, alanın start_sec değerinden veya belirtilmişse last_bookable_sec değerinden önce olmalıdır. |
last_online_cancellable_sec |
Ayarlandıysa bu randevu aralığının Google ile Rezervasyon üzerinden iptal edilebileceği son zaman (Unix döneminden bu yana geçen saniye cinsinden). Bu alan, hizmet düzeyindeki tüm iptal kurallarını geçersiz kılar. (isteğe bağlı) |
BatchDeleteGenericRecordsRequest
Belirtilen feed türündeki kayıtları silme toplu isteği.
| Alanlar | |
|---|---|
parent |
Kaynak adı, |
records[] |
Silinecek kayıtlar. Bir API çağrısında en fazla 1.000 kayda izin verilir. |
BatchPushGenericRecordRequest
İstek URL'sinde belirtilen feed türünün kayıtlarını eklemek ve/veya güncellemek için toplu istek.
| Alanlar | |
|---|---|
parent |
Kaynak adı, |
records[] |
Eklenecek ve/veya güncellenecek kayıtlar. Bir API çağrısında en fazla 1.000 kayda izin verilir. |
BatchReplaceServiceAvailabilityRequest
Birden fazla Service müsaitlik aralığını değiştirmek için toplu istek.
| Alanlar | |
|---|---|
parent |
|
extended_service_availability[] |
Mevcut müsaitlik aralıklarının yerine kullanılan genişletilmiş hizmet müsaitliği. |
BatchReplaceServiceAvailabilityResponse
Birden fazla Service müsaitlik durumu aralığını değiştirmek için toplu yanıt. Bu iletiye yalnızca başarıyla güncellenen zaman aralıkları dahil edilir.
| Alanlar | |
|---|---|
extended_service_availability[] |
Mevcut uygunluk aralıklarının yerine kullanılan, başarıyla güncellenmiş genişletilmiş hizmet uygunluğu mesajları. |
Rezervasyon
Envanter aralığı için rezervasyon
| Alanlar | |
|---|---|
name |
Rezervasyonun kaynak adı: |
merchant_id |
Slot için satıcının kimliği |
service_id |
Satıcı hizmetinin kimliği |
start_time |
Randevu aralığının başlangıç saati |
duration |
Randevu aralığının süresi |
client_information |
Randevu alan müşterinin kişisel bilgileri |
status |
Rezervasyonun durumu |
payment_information |
Rezervasyonla ilgili ödeme işlemleri hakkında bilgiler. |
party_size |
Rezervasyonun kişi sayısı |
BookingFailure
Bir rezervasyonun neden eşzamansız olarak işlenemediğini belirten durum verileri. BookingFailure, öncelikle iş mantığı hatalarını yakalamak için tasarlanmıştır.
| Alanlar | |
|---|---|
cause |
Rezervasyonun neden başarısız olduğu. (gerekli) |
rejected_card_type |
(Yalnızca neden PAYMENT_ERROR_CARD_TYPE_REJECTED ise gereklidir) |
description |
Bu isteğe bağlı alan, iş ortağının yalnızca hata ayıklama amacıyla ek bilgiler eklemesi için kullanılır. (isteğe bağlı) |
payment_failure |
Ödeme hataları hakkında bilgi |
Neden
Hata nedenlerinin listesi.
| Sıralamalar | |
|---|---|
CAUSE_UNSPECIFIED |
Varsayılan değer: Kullanılmaz. "Bilinmeyen bir hata"ya eşittir. |
SLOT_UNAVAILABLE |
Başvurulan uygunluk aralığı artık kullanılamıyor. |
SLOT_ALREADY_BOOKED_BY_USER |
Kullanıcı, söz konusu uygunluk aralığı için zaten randevu almış. |
LEASE_EXPIRED |
Kiralama sözleşmesinin (varsa) süresi dolmuştur ve istenen rezervasyonu tamamlamak için artık kullanılamaz. |
OUTSIDE_CANCELLATION_WINDOW |
Satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle, istenen iptal işlemi şu anda gerçekleştirilemiyor. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Sağlanan kredi kartı türü satıcı tarafından kabul edilmediği için ödeme işlenirken bir hata oluştu. Kredi kartı türü, rejected_card_type içinde sağlanmalıdır. |
PAYMENT_ERROR_CARD_DECLINED |
Belirtilen kredi kartı reddedildiği için ödeme işlenirken bir hata oluştu. |
PAYMENT_OPTION_NOT_VALID |
Rezervasyonun ödemesi için kullanılan paket/üyelikle ilgili bir hata oluştu. Geçerli kullanım kalmamış olabilir, kuponun geçerlilik süresi dolmuş olabilir vb. |
PAYMENT_ERROR |
Bu rezervasyonun ödemesi işlenirken bir hata oluştu. Bu değeri, yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmiyorsa genel bir ödemeyle ilgili hatayı belirtmek için kullanın. |
USER_CANNOT_USE_PAYMENT_OPTION |
Kullanıcı, belirtilen ödeme seçeneğini kullanamıyor (ör. kullanıcı, ilk kez sunulan fiyatı ikinci kez kullanmaya çalışıyor). |
BOOKING_ALREADY_CANCELLED |
Kullanıcının iptal etmeye çalıştığı rezervasyon zaten iptal edilmiş. |
BOOKING_NOT_CANCELLABLE |
Kullanıcının iptal etmeye çalıştığı rezervasyon iptal edilemiyor. |
OVERLAPPING_RESERVATION |
Kullanıcının bu saate çok yakın bir rezervasyonu var. |
USER_OVER_BOOKING_LIMIT |
Kullanıcı, toplayıcının kullanıcı başına rezervasyon sınırını aştığı için rezervasyon yapılamadı. |
PAYMENT_REQUIRES_3DS1 |
İşlemin tekrar denenmesini istediğiniz için ödemenin reddedildiği zamanı ayarlayın. Ancak bu kez 3DS1 doğrulama/yanıtı uygulandıktan sonra denenmesini isteyin. Mevcut işlemin başarısızlık durumunun başarısız olarak kalacağını unutmayın. Yeniden deneme işlemi tamamen ayrıdır. Bu, hata nedeni olduğunda payment_failure.3DS1_parameters ayarlanmalıdır. Aksi takdirde, mevcut neden PAYMENT_ERROR olarak değerlendirilir. |
PaymentFailureInformation
Ödeme hataları hakkında bilgi
| Alanlar | |
|---|---|
threeds1_parameters |
Bir RwG toplayıcısı tarafından kullanıcıyla 3DS1 kimlik doğrulama protokolünü başlatmak için kullanılan parametreler. BookingFailure.cause, PAYMENT_REQUIRES_3DS1 olarak ayarlanmadığı sürece yoksayılır. |
ThreeDS1Parameters
RwG'nin 3DS1 zorluğu gerçekleştirmesini isteyen parametreler.
Parametreler, EMVCo'nun 3DS1 protokolü açıklamasına göre ayarlanır.
| Alanlar | |
|---|---|
acs_url |
Kullanıcıya kimlik doğrulama için sunulacak bir formun yükleneceği URL. |
pa_req |
PaymentAuthentication Request. Sağlanırsa ACSUrl formuna gönderilir. |
transaction_id |
ACS sağlayıcısı tarafından kullanılan bir tanımlayıcı. Sağlanırsa ACSUrl formuna gönderilir. |
md_merchant_data |
Satıcı verileri Sağlanırsa ACSUrl formuna gönderilir. |
BookingStatus
Rezervasyonun durumu
| Sıralamalar | |
|---|---|
BOOKING_STATUS_UNSPECIFIED |
Belirtilmedi. |
CONFIRMED |
Rezervasyon onaylandı |
PENDING_MERCHANT_CONFIRMATION |
Rezervasyonun CONFIRMED durumuna geçebilmesi için satıcı tarafından onaylanması bekleniyor (bu özellik şu anda desteklenmemektedir). |
PENDING_CLIENT_CONFIRMATION |
Rezervasyonun CONFIRMED durumuna geçebilmesi için müşterinin onayı bekleniyor (bu özellik şu anda desteklenmemektedir). |
CANCELED |
Rezervasyon, kullanıcı adına iptal edildi. |
NO_SHOW |
Müşteri randevuya gelmedi |
NO_SHOW_PENALIZED |
Müşteri, iptal politikasını ihlal ederek randevuya gelmedi. |
FAILED |
İşleme hatası nedeniyle rezervasyon tamamlanamadı. |
DECLINED_BY_MERCHANT |
Rezervasyon, satıcı tarafından eşzamansız olarak reddedildi. |
CallMerchant
Bu türde alan yok.
UnsupportedPartySizeOption'da kullanılacak boş mesaj. Bu ayar, kullanıcılara rezervasyon için işletmeyi arama seçeneğini gösterir.
CancellationPolicy
Bir hizmetin iptal politikası.
| Alanlar | |
|---|---|
refund_condition[] |
Politika için geçerli olan sıfır veya daha fazla geri ödeme koşulu. |
RefundCondition
Tek bir geri ödeme koşulu tanımlar. "Geri ödeme adımlarını" hizmetin başlangıç zamanından önceki çeşitli süreler olarak tanımlamak için birden fazla geri ödeme koşulu birlikte kullanılabilir.
| Alanlar | |
|---|---|
min_duration_before_start_time |
Başlangıç zamanından önceki süre. Müşteri, |
refund_percent |
Hizmet rezervasyonu, hizmetin başlangıç saatinden en az |
ClientInformation
Rezervasyon yapan kişiyle ilgili kişisel bilgiler
| Alanlar | |
|---|---|
given_name |
Müşterinin adı |
family_name |
Müşterinin soyadı |
address |
Müşterinin adresi |
telephone |
Müşterinin telefon numarası |
email |
Müşterinin e-posta adresi |
CreateAdsAccountLinkRequest
AdsAccountLinkingService.CreateAdsAccountLink için istek mesajı.
| Alanlar | |
|---|---|
parent |
Zorunlu. Bu Ads hesabı bağlantısının oluşturulacağı üst kaynak. Bu, İş Ortağı Merkezi hesap kimliğiyle aynıdır. Biçim: partners/{partner} |
ads_account_link_id |
Zorunlu. Reklam hesabı bağlantısı için kullanılacak kimlik. Bu, Google Ads müşteri kimliğiyle aynıdır. Ayrıntılar için https://support.google.com/google-ads/answer/1704344 adresini inceleyin. Biçim : xxx-xxx-xxxx. |
ads_account_link |
Zorunlu. Oluşturulacak AdsAccountLink. |
CreateMerchantRequest
Merchant oluşturma isteği.
| Alanlar | |
|---|---|
parent |
Bu satıcının sahibi olan iş ortağının üst kaynak adı ( |
merchant_id |
Bu satıcı için kullanılacak satıcı kimliği. |
merchant |
Oluşturulacak satıcı. |
CreateServiceRequest
Yeni bir Service oluşturma isteği.
| Alanlar | |
|---|---|
parent |
Bu hizmetin sahibi olan satıcının üst kaynak adı ( |
service_id |
Bu hizmet için kullanılacak hizmet kimliği. |
service |
Oluşturulacak hizmet. |
CreditCardRestrictions
Bu satıcının kabul ettiği kredi kartı türleriyle ilgili kısıtlamalar.
| Alanlar | |
|---|---|
credit_card_type[] |
Desteklenen kredi kartlarının listesi. Boşsa kredi kartları desteklenmez. |
CreditCardType
Kredi kartı türü.
| Sıralamalar | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Kullanılmamış. |
VISA |
Visa kredi kartı |
MASTERCARD |
Mastercard kredi kartı |
AMERICAN_EXPRESS |
American Express kredi kartı |
DISCOVER |
Bir Discover kredi kartı. |
JCB |
JCB kredi kartı |
DeleteAdsAccountLinkRequest
AdsAccountLinkingService.DeleteAdsAccountLink için istek mesajı.
| Alanlar | |
|---|---|
name |
Zorunlu. Silinecek AdsAccountLink'in adı. Biçim: partners/{partner}/adsAccountLinks/{ads_account_link} |
DeleteMerchantRequest
Merchant silme isteği
| Alanlar | |
|---|---|
name |
Silinecek satıcının kaynak adı. partners/{partner_id}/merchants/{merchant_id} biçiminde |
DeleteServiceRequest
Service silme isteği
| Alanlar | |
|---|---|
name |
Silinecek hizmetin kaynak adı. |
Ödeme
Kullanıcının kredi kartından alınabilecek veya kredi kartında bekletilebilecek bir depozito.
| Alanlar | |
|---|---|
deposit |
Yatırılan tutar. |
min_advance_cancellation_sec |
Depozito için minimum erken iptal süresi. |
deposit_type |
Depozitonun müsaitlik durumuna göre nasıl belirleneceğini tanımlar. |
DirectMerchantPayment
Kullanıcının, hizmet için RwG üzerinden ön ödeme yapmak yerine doğrudan satıcıya nasıl ödeme yapabileceği hakkında bilgi.
| Alanlar | |
|---|---|
payment_methods[] |
Kullanıcıların yalnızca aşağıda belirtilen ödeme yöntemleriyle ödeme yapmaları önerilir. |
DurationRange
Sınırlı veya sınırsız olabilen bir süre aralığı için sarmalayıcı. En az bir min_duration ve max_duration süresi gereklidir.
| Alanlar | |
|---|---|
min_duration |
Minimum süre. |
max_duration |
Maksimum süre. |
EconomicOperator
Toplayıcı için ekonomik operatör bilgileri.
| Alanlar | |
|---|---|
text |
Zorunlu. Üretici, yetkili temsilci, ithalatçı, distribütör, sipariş karşılama hizmeti sağlayıcı veya ürünlerin üretimi, kullanıma sunulması ya da hizmete alınmasıyla ilgili yükümlülüklere tabi olan diğer gerçek veya tüzel kişiler olarak tanımlanan ekonomik operatörün adı, adresi, telefon numarası ve e-posta adresi. economic_operator'ın serbest biçimli dize gösterimi. Bu bilgiler " " ve "\n" kullanılarak biçimlendirilebilir. |
ExtendedServiceAvailability
Kullanılabilirlik listesi ve kimlere/ne zaman uygulanması gerektiği.
| Alanlar | |
|---|---|
merchant_id |
Bu alan, aşağıdaki stok durumu mesajlarının hangi satıcıya ait olduğunu belirtmek için zorunludur. |
service_id |
Bu, aşağıdaki müsaitlik durumu mesajlarının hangi hizmete ait olduğunu belirtmek için zorunlu bir alandır. |
start_time_restrict |
Sağlanırsa [start_time_restrict, end_time_restrict) aralığında sağlanan Availability öğelerinin tam bir anlık görüntü olduğu kabul edilir. Yani aşağıdaki koşul geçerliyse mevcut tüm uygunluk silinir: Süre mesajı ayarlanırsa koşul daha da kısıtlanır: resources_restrict mesajı ayarlanırsa koşul daha da kısıtlanır: Bu alanlar genellikle belirli bir zaman aralığında stok durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır. end_time_restrict ayarlanmadan start_time_restrict ayarlanırsa bu, start_time_restrict ile başlayan tüm zamanlar olarak yorumlanır. |
end_time_restrict |
start_time_restrict ayarlanmamışken end_time_restrict ayarlanması, end_time_restrict'e kadar olan tüm zamanı ifade eder. |
duration_restrict |
Süre ayarlama, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik bloklarıyla daha da kısıtlar. |
resources_restrict |
resources_restrict ayarı, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir. |
availability[] |
Yeni müsaitlik listesi. |
FeedStatistics
Yüklenen feed işlenirken elde edilen istatistikler.
| Alanlar | |
|---|---|
new_items |
Bu feed'e yeni eklenen öğeler. Feed'in türüne bağlı olarak öğeler; satıcılar, hizmetler veya uygunluk zaman aralıkları olabilir. |
existing_items |
Feed'deki yeni bilgilerden gerektiği şekilde güncellenen mevcut öğeler. |
deleted_items |
Bu feed'de artık bulunmayan ve bu nedenle kaldırılan öğeler. |
FeedStatus
Toplayıcının platformu tarafından yüklenen feed'in durumu.
| Alanlar | |
|---|---|
name |
Feed kaynak adı şu biçimdedir:
|
state |
Bu feed'in işleme durumu. |
error_details |
Bu feed'i işlemeyi başaramadığımız takdirde daha fazla ayrıntı sağlayan, insanlar tarafından okunabilir dize. |
statistics |
Bu feed'e özgü istatistikler. |
Eyalet
Feed'in işleme durumunu gösteren enum.
| Sıralamalar | |
|---|---|
STATE_UNSPECIFIED |
Varsayılan değer. Kullanılmamış. |
IN_PROGRESS |
Feed'in işlenmesi devam ediyor. |
SUCCESS |
Feed başarıyla işlendi. |
FAILURE |
Feed işlenirken bir hatayla karşılaştık. |
FoodOrderingMetadata
Yemek siparişi işlemi bağlantılarıyla ilgili meta veriler.
| Alanlar | |
|---|---|
fee_details[] |
Öğe toplamına ek olarak kullanıcıdan alınan ücretlerin ayrıntıları. Hizmet ücreti, teslimat ücreti vb. gibi farklı ücret türleri için tekrarlanır. |
advance_order_details |
Kullanıcının şu andan daha sonraki bir zamanda yerine getirilmek üzere sipariş verebileceği, önceden sipariş olarak da bilinen gelişmiş sipariş desteği hakkında ayrıntılar. |
fulfillment_duration_options birleşik alanı. Sipariş onayından itibaren sipariş karşılama süresi. Teslimat siparişlerinde, yemeğin teslim edilmesine kadar geçen süre. Teslim alma siparişlerinde, yemeğin teslim alınmaya hazır olacağı süre. fulfillment_duration_options aşağıdakilerden yalnızca biri olabilir: |
|
fulfillment_lead_time_duration |
Sabit süre. Örneğin: 30 dakika. |
fulfillment_lead_time_duration_range |
Süre aralığı. Örnekler: * 30 dakika ile 45 dakika arası * 30 dakikadan uzun * 50 dakikadan kısa |
AdvanceOrderDetails
Önceden sipariş desteği için.
| Alanlar | |
|---|---|
is_supported |
Önceden Sipariş olarak da bilinen Gelişmiş Siparişler destekleniyorsa doğru değerini alır. (gerekli) |
FeeDetails
Ücret ayrıntıları.
| Alanlar | |
|---|---|
type |
Ücret türü. (gerekli) |
fee_amount |
Ücret tutarı, birim para biriminde, alışveriş sepeti değerinin yüzdesi olarak veya her ikisinin kombinasyonu şeklinde olabilir. (gerekli) |
FeeAmount
FeeAmount örnekleri: * Sabit ücret: 0 TL (ücretsiz), 1,5 TL * Sabit ücret aralığı: 1 TL (minimum), 3 TL (maksimum), 5-6 TL * Sepet boyutunun yüzdesi: %15,5, %10-20, %10 (minimum), %15 (maksimum) * Aralık ve yüzde bileşimi: %25,5 ve 2,5 TL (minimum), %25,5 ve 4,5 TL (maksimum), %10 ve 1,5-2,5 TL, %10,5-20 ve 2,5-3,5 TL
| Alanlar | |
|---|---|
cart_percentage |
Alışveriş sepeti değerinin yüzdesi olarak ücret. Bir aralığı (sınırlı ve sınırsız) veya sabit bir yüzdeyi destekler. Değer 0 ile 100 arasında olmalıdır. Örnekler: * Sabit %5,5 * En az %5,5 * En fazla %5,5 * %4,5 ila %5,5 |
amount_options birleşik alanı. Parasal tutarı belirtme seçenekleri. amount_options aşağıdakilerden yalnızca biri olabilir: |
|
amount |
Sabit tutar. Örneğin, 3,5 TRY. |
amount_range |
Tutar aralığı. Örnekler: * 3,5 TRY - 5,5 TRY * En az 3,5 TRY * En fazla 5,5 TRY |
amount_unknown |
Bilinmeyen tutar. |
FeeType
Ücret türü.
| Sıralamalar | |
|---|---|
FEE_TYPE_UNSPECIFIED |
Ücret türü belirtilmemiş. |
DELIVERY |
Teslimat ücretleri için. |
SERVICE |
Hizmet ücretleri için. |
FulfillmentOption
Online sipariş işlemi bağlantısı için karşılama seçeneği.
| Alanlar | |
|---|---|
fulfillment_type |
Zorunlu. Sipariş karşılama türü. |
available_day[] |
Zorunlu. Bu karşılama yönteminin kullanılabildiği günlerin listesi (tercihen en az 2 gün). |
fee_details |
Zorunlu. Karşılama yöntemiyle ilgili ücret ayrıntıları. |
minimum_order |
Zorunlu. İşlem bağlantısıyla ilişkili karşılama yöntemi için minimum sipariş tutarı. |
AvailableDay
Gün düzeyinde kullanılabilirlik.
| Alanlar | |
|---|---|
fulfillment_date |
Zorunlu. Bir karşılama yöntemi için uygun tarih. Satıcının saat diliminde olduğu varsayılır. |
last_ordering_time |
Zorunlu. Unix zaman damgası. Kullanıcının Örneğin, fulfillment_date 2020-08-10 ise: - last_ordering_time değeri 2020-08-10 18:00 olduğunda müşterinin siparişini 2020-08-10 tarihinde alabilmesi için aynı gün saat 18:00'a kadar sipariş vermesi gerekir. - 2020-08-08 20:00 son sipariş saati değeri, müşterinin siparişini 2020-08-10 tarihinde teslim alabilmesi için iki gün öncesinde saat 20:00'ye kadar vermesi gerektiği anlamına gelir. |
FeeDetails
İşlem bağlantısıyla ilişkili karşılama yönteminin ücret ayrıntıları.
| Alanlar | |
|---|---|
fee_details birleşik alanı. Karşılama yönteminin ücret modeli. fee_details aşağıdakilerden yalnızca biri olabilir: |
|
no_fee |
Karşılama yöntemi için ücret alınmaz. |
base_fee |
Karşılanma yöntemiyle ilişkili temel ücret. |
fixed_fee |
Karşılanma yöntemiyle ilişkili sabit ücret. |
FixedFee
İşlem bağlantısıyla ilişkili karşılama yöntemi için gereken sabit ücret.
| Alanlar | |
|---|---|
amount |
Zorunlu. Karşılanma yöntemi için sabit ücret tutarı. |
FulfillmentType
Bir işlem bağlantısıyla ilişkili karşılama türü.
| Sıralamalar | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Karşılama türü belirtilmedi. |
FULFILLMENT_TYPE_DELIVERY |
Karşılama türü teslimattır. |
FULFILLMENT_TYPE_PICKUP |
Karşılama türü teslim alma olmalıdır. |
MinimumFee
İşlem bağlantısıyla ilişkili karşılama yöntemi için gereken minimum ücret.
| Alanlar | |
|---|---|
base_fee_amount |
Zorunlu. Karşılama yönteminin temel ücret tutarı. |
NoFee
Bu türde alan yok.
İşlem bağlantısıyla ilişkili karşılama yöntemi için ücret alınmaz.
GenericDeleteRecord
URL isteğinde belirtilen feed türünün silinecek kaydı.
| Alanlar | |
|---|---|
delete_time |
Zorunlu. Bu zaman damgası, silme işleminin envantere uygulanacağı sırayı belirlemek için kullanılır. |
record_type birleşik alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsar. İş ortağı, bir feed'de veya BatchPush API'de sağlanan kayda benzer şekilde tam bir kayıt sağlayabilir. İş ortakları, bir kaydı benzersiz şekilde tanımlamak için gereken temel alanları dahil etme seçeneğine de sahiptir. record_type aşağıdakilerden yalnızca biri olabilir: |
|
data_record |
Proto tabanlı olmayan feed'ler için. |
proto_record |
Proto tabanlı feed'ler için. |
GenericRecord
URL isteğinde belirtilen feed türünün kaydı.
| Alanlar | |
|---|---|
generation_timestamp |
Zorunlu. Bu zaman damgası, envanter güncellemelerinin doğru sırayla yapılmasını sağlamak için kullanılır. |
record_type birleşik alanı. Farklı feed türlerini (ndjson, proto tabanlı vb.) kapsar. record_type aşağıdakilerden yalnızca biri olabilir: |
|
data_record |
Proto tabanlı olmayan feed'ler için. |
proto_record |
Proto tabanlı feed'ler için. |
GeoCoordinates
Enlem, boylam ve adres dahil olmak üzere bir konumun coğrafi verileri.
| Alanlar | |
|---|---|
latitude |
Enlem (derece). (isteğe bağlı) |
longitude |
Derece cinsinden boylam. (isteğe bağlı) |
addresses birleşik alanı. Bir konumun adresi, yapılandırılmış veya yapılandırılmamış olabilir. addresses aşağıdakilerden yalnızca biri olabilir: |
|
address |
Konumun posta adresi (tercih edilir). |
unstructured_address |
Yedek olarak yapılandırılmamış bir adres de sağlanabilir. Ör. "1600 amphitheatre parkway mountain view, ca 94043" |
GetAdsAccountLinkRequest
AdsAccountLinkingService.GetAdsAccountLink için istek mesajı.
| Alanlar | |
|---|---|
name |
Zorunlu. Alınacak Ads hesabı bağlantısının adı. Biçim: |
GetMerchantStatusRequest
MerchantStatus alma isteği
| Alanlar | |
|---|---|
name |
Zorunlu. Kaynak adı, partners/{partner_id}/merchants/{merchant_id}/status biçiminde. |
GetStatusRequest
Toplayıcının platformu tarafından yüklenen belirli bir feed için Status'nın alınması isteği.
| Alanlar | |
|---|---|
name |
Feed kaynak adı şu biçimdedir:
|
HomeServiceData
Ev hizmetleri sektörü için sağlanması gereken ek bilgiler.
| Alanlar | |
|---|---|
category_type |
Bu ev hizmetinin ait olduğu üst düzey kategori. Ör. tesisatçı, elektrikçi vb. |
job_type |
Belirli bir ev hizmetinin ait olduğu kategori altındaki iş türü. Örneğin, unclog_drain ve install_faucet, tesisatçı kategorisindeki iş türleridir. |
IntegrationType
Desteklenen entegrasyon derinliği.
| Sıralamalar | |
|---|---|
INTEGRATION_TYPE_UNSPECIFIED |
Varsayılan olarak END_TO_END değerine ayarlanır. |
INTEGRATION_TYPE_END_TO_END |
Google üzerinden uçtan uca rezervasyon yapılmasına olanak tanıyan tam entegrasyon. |
INTEGRATION_TYPE_INVENTORY_ONLY |
Rezervasyon sunucusunun bu hizmeti desteklemesi gerekmez. Yalnızca satıcı, hizmet ve (isteğe bağlı olarak) stok durumu verilerinin gönderilmesi gerekir. |
InvalidateResourceRequest
Bir kaynağın geçersiz kılınması isteği.
| Alanlar | |
|---|---|
resource_id |
Geçersiz kılınacak kaynağın adı. Örneğin, bir Pickup kaynağı için ad, |
LineItem
Bir siparişteki tek bir öğe (tek bir zaman aralığında tek bir hizmetin rezervasyonu).
| Alanlar | |
|---|---|
service_id |
Satıcı hizmetinin kimliği. |
start_sec |
Randevu aralığının başlangıç zamanı (Unix sıfır zamanından itibaren UTC zamanı saniye cinsinden). |
duration_sec |
Randevu aralığının saniye cinsinden süresi. |
tickets[] |
Bilet türüne göre sipariş edilen bilet sayısı. |
price |
Bu satır öğesinin toplam fiyatı (vergiler hariç). |
status |
Satır öğesinin durumu. |
OrderedTickets
Bilet türüne göre sipariş edilen bilet sayısı.
| Alanlar | |
|---|---|
ticket_id |
Bilet türünün kimliği. |
count |
Bu tür için sipariş edilen bilet sayısı. |
LinkoutTemplate
Google'ın bir iş ortağının sitesine yönelik URL'leri nasıl oluşturacağını belirten bir şablon.
| Alanlar | |
|---|---|
uri_template |
URI şablonu RFC 6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 1. düzey şablonları ve tüm 4.düzey birleşik şablonları destekler. Örneğin: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc |
ListMerchantStatusesRequest
MerchantStatus listesini alma isteği
| Alanlar | |
|---|---|
parent |
Zorunlu. Bu satıcı durumu koleksiyonunun sahibi olan üst öğe. Biçim: |
page_size |
Zorunlu. Döndürülecek maksimum öğe sayısı. Sunucunun sayfa boyutunu küçültebileceğini unutmayın. |
page_token |
İsteğe bağlı. Önceki bir ListMerchantStatusResponse'tan döndürülen nextPageToken değeri (varsa). |
booking_inventory_status_restrict |
İsteğe bağlı. Sonuçları rezervasyon envanter durumuna göre filtrelemek için isteğe bağlı kısıtlama. |
waitlist_inventory_status_restrict |
İsteğe bağlı. Sonuçları bekleme listesi stok durumuna göre filtrelemek için isteğe bağlı kısıtlama. |
geo_match_restrict |
İsteğe bağlı. Sonuçları coğrafi eşleşme durumuna göre filtrelemek için isteğe bağlı kısıtlama. |
BookingInventoryStatus
Uçtan uca rezervasyon envanter durumu.
| Sıralamalar | |
|---|---|
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Belirtilmedi. |
NO_VALID_FUTURE_INVENTORY |
Satıcının önümüzdeki 30 gün içinde rezervasyon envanteri yok. |
HAS_VALID_FUTURE_INVENTORY |
Satıcının önümüzdeki 30 gün içinde rezervasyon envanteri olmalıdır. |
GeoMatchingStatus
Satıcının coğrafi eşleşme durumu.
| Sıralamalar | |
|---|---|
GEO_MATCHING_STATUS_UNSPECIFIED |
Belirtilmedi. |
GEO_UNMATCHED |
Satıcı coğrafi olarak eşleştirilmemiş. |
GEO_MATCHED |
Satıcı coğrafi olarak eşleştirilir. |
WaitlistInventoryStatus
Uçtan uca bekleme listesi envanter durumu.
| Sıralamalar | |
|---|---|
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Belirtilmedi. |
NO_VALID_WAITLIST_SERVICE |
Satıcı, bekleme listesini destekleyen bir hizmete sahip değil. |
HAS_VALID_WAITLIST_SERVICE |
Satıcının bekleme listesini destekleyen bir hizmeti olmalıdır. |
ListMerchantStatusesResponse
MerchantStatus listesine verilen yanıt.
| Alanlar | |
|---|---|
merchant_statuses[] |
Filtre koşullarını karşılayan satıcı durumlarının listesi. |
next_page_token |
Sonuçların sonraki sayfasını almak için kullanılan jeton. Liste boşsa başka sonuç yoktur. |
ListStatusRequest
Toplayıcının platformu tarafından yüklenen birden fazla feed için Status alma isteği.
| Alanlar | |
|---|---|
name |
Feed kaynak adı şu biçimdedir:
|
page_size |
Döndürülecek maksimum öğe sayısı. |
page_token |
Önceki bir List isteğinden döndürülen next_page_token değeri (varsa). |
state_restrict |
Sonuçları feed durumuna göre filtrelemek için isteğe bağlı olarak sınırlama uygulayabilirsiniz. |
time_range_restrict |
Sonuçları üst ve alt sınıra göre filtrelemek için isteğe bağlı olarak sınırlama uygulayın. start_time ayarlanmamışsa varsayılan olarak Unix zamanının başlangıcı kullanılır. end_time ayarlanmamışsa varsayılan olarak şu anki zaman kullanılır. |
ListStatusResponse
Toplayıcının platformu tarafından yüklenen birden fazla feed için Status alma isteği.
| Alanlar | |
|---|---|
status[] |
Yüklenen feed'lerin durumlarının ters kronolojik listesi. Döndürülen maksimum öğe sayısı, istekteki page_size alanına göre belirlenir. |
next_page_token |
Sonuçların sonraki sayfasını almak için kullanılan jeton. Liste boşsa başka sonuç yoktur. |
LocalizedString
Bir yerel ayardaki dize örneği.
| Alanlar | |
|---|---|
locale |
"en", "mas", "zh-Hant", "de-CH-1901" gibi IETF BCP 47 dil kodu. http://www.w3.org/International/articles/language-tags/ adresine bakın. |
value |
Yukarıdaki yerel ayarda mesaj (UTF-8). |
Konum
Bir konumla ilgili coğrafi bilgiler.
| Alanlar | |
|---|---|
place_id |
Google Places veritabanında ve Google Haritalar'da bir yerin yer kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresini ziyaret edin. Bu bilgi sağlanırsa Google, konumu bu yerle eşleştirir. |
name |
Konumun adı, telefonu, URL'si ve coğrafi bilgisi, konumun Google Haritalar'da mevcut yerlerle eşleştirilmesini desteklemek için kullanılır. Bu alan isteğe bağlıdır ancak bazı durumlarda zorunlu olabilir. Örneğin, aynı adreste bulunsa bile adı olmayan bir Service.location, bir ticari işletmeyle eşleştirilmez. (isteğe bağlı) |
telephone |
Ülke ve alan kodları dahil olmak üzere konumun herkese açık telefon numarası (ör. +14567891234). (isteğe bağlı) |
url |
Konumun herkese açık web sitesinin URL'si. (isteğe bağlı) |
geo |
Enlem, boylam ve adres dahil olmak üzere konumun coğrafi bilgileri. (isteğe bağlı) |
location_type |
Bu konum bir hizmet için sağlanıyorsa konum türü belirtilmelidir. |
location_id |
Konumun hizmet içindeki benzersiz referansı. Bu kimlik, diğer hizmet alanlarında bu konuma başvurmak için kullanılabilir. Örneğin, özel alım formunda, teslim alma konumu seçeneklerini belirtmek için bir dizi konum kimliği kullanılabilir. Ayarlanırsa bu kimlik aynı hizmet içinde benzersiz olmalıdır. (isteğe bağlı) |
LocationType
Bu konumun türü.
| Sıralamalar | |
|---|---|
LOCATION_TYPE_UNSPECIFIED |
Konum türü belirtilmedi. |
VISITED_LOCATION |
Bu hizmetin ziyaret ettiği konum. |
START_LOCATION |
Bu hizmetin başladığı konum, MEETING_LOCATION olarak da kullanılır. |
END_LOCATION |
Bu hizmetin sona erdiği konum. |
Satıcı
Toplayıcının platformundaki bir satıcı hakkında bilgiler.
| Alanlar | |
|---|---|
name |
|
merchant_name |
merchant_name, telephone, url ve geo, iş ortağı envanterinin Google Haritalar'da zaten bulunan satıcılarla eşleştirilmesini desteklemek için kullanılır. Bu bilgiler gösterilmez. Satıcının adı. |
telephone |
Ülke ve alan kodları dahil olmak üzere satıcının herkese açık telefon numarası (ör. +14567891234). |
url |
Satıcının herkese açık web sitesinin URL'si. |
geo |
Enlem, boylam ve adres dahil olmak üzere satıcının coğrafi bilgileri. |
category |
Toplayıcının platformundaki işletmenin kategorisi. |
num_bookings_30d |
Bu alan kullanımdan kaldırılmıştır. |
tax_rate_basis_points |
Satıcının vergi oranı, baz puan cinsinden (yüzde birin yüzde biri). Örneğin, vergi oranı %7,5 ise bu alan 750 olarak ayarlanmalıdır. Bu alan ayarlanmazsa veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, Service.price tarafından belirtilen fiyatın aynısıdır. Hizmet fiyatının, geçerli vergilerden muaf olduğu veya bu vergileri zaten içerdiği varsayılır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilmez. Bu alan sıfırdan farklı bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyata hizmet fiyatı ve burada sağlanan vergi oranı kullanılarak değerlendirilen vergi dahil edilir. En küçük para biriminin kesirleri (örneğin, bir sentin kesirleri) en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilir. Bu alanın desteği sonlandırılmıştır, lütfen bunun yerine tax_rate alanını kullanın. |
tax_rate |
Satıcının vergi oranı. Bu alan varsa kullanımdan kaldırılan tax_rate_basis_points alanını geçersiz kılar. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfırlar. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı. |
payment_restrictions |
Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar. Bu alan ayarlanmamışsa herhangi bir kısıtlamanın olmadığını varsayarız. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı. |
payment_option[] |
Bu satıcı için kullanılabilen ödeme seçenekleri. Bu satıcıya bağlı hizmetler, izin verdikleri ödeme seçeneklerini ayrı ayrı sınırlayabilir. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı. |
payment_processor_config |
Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma. |
tokenization_config |
Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı. |
terms |
Google ile Rezervasyon üzerinden hizmet rezervasyonu yapılırken kullanıcıya gösterilen ilgili satıcının Hüküm ve Koşulları. Bunlara ek olarak, toplayıcı iş ortağının Hüküm ve Koşulları her zaman kullanıcıya gösterilir ve burada sağlanmamalıdır. |
brand_id |
İş ortağı ilişkilendirmesi gösterilirken kullanılacak tüketiciye yönelik markayı tanımlayan opak bir dize. Bu alan, tüketicilere yönelik birden fazla markası olan iş ortaklarının aynı feed'de tüm markalar için satıcı sağlamasına olanak tanır. Marka; ad, logo, Hizmet Şartları ve Gizlilik Politikası gibi tüketicilere yönelik özelliklerden oluşur. Tüketicilere yönelik tek bir iş ortağı markası varsa bu alanın ayarlanması gerekmez ve yoksayılabilir. İş ortağı... Tüketicilere yönelik birden fazla markası olmamalıdır. --> Bu alanı yoksay Yapılandırılmış birden fazla markası var mı? Önemli Not: Çoğu iş ortağının bu alanı ayarlaması gerekmez. Bir iş ortağı bu alanı kullanmak istiyorsa önce bizimle iletişime geçerek varsayılan marka da dahil olmak üzere ayrı markaları yapılandırmalıdır. |
matching_hints |
Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olacak ipuçları. Not: Google, yukarıda verilen bilgileri kullanarak satıcıları Google Haritalar'daki yerlerle eşleştireceğinden çoğu iş ortağının bu alanı ayarlaması gerekmez. (isteğe bağlı) |
service_attribute[] |
Bu Satıcı için Hizmetleri açıklamak üzere kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı) |
action_link[] |
İsteğe bağlı. İlişkili dil, kısıtlanmış ülkelerin listesi, tür ve bu işlemin hangi platformda gerçekleştirilmesi gerektiğini belirten isteğe bağlı platform içeren bir işlem URL'si, |
reservation_linkout_template[] |
İsteğe bağlı. Google'ın, iş ortağının platformunda masa ayırtmak için URL'yi nasıl oluşturması gerektiğini belirten yönlendirme bağlantısı şablonu. Birden fazla değer sağlanırsa şu anda yalnızca ilk değerin kullanılacağını unutmayın. URI şablonu, kullanıcının rezervasyon seçimlerine göre doldurulacak alanları destekler. Rezervasyon URL'sinin başarılı bir şekilde oluşturulması için tüm zorunlu alanlar gereklidir: * (zorunlu) party_size, int: Kullanıcının rezervasyon isteğinde bulunduğu grup boyutu. * (zorunlu) selected_date_time, ISO 8601 datetime (https://en.wikipedia.org/wiki/ISO_8601): Kullanıcının rezervasyon istediği saat. * (isteğe bağlı) merchant_id, dize: Kullanıcının rezervasyon isteğinde bulunduğu satıcının kimliği. Şablon zaten bir satıcı tanımlayıcı içeriyorsa gerekli değildir. * (isteğe bağlı) room_id, dize: Kullanıcının rezervasyon isteğinde bulunduğu odanın kimliği. |
waitlist_advisement |
İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan bir kullanıcı için belirli bir satıcının genel tavsiyeleri. Tavsiye metnindeki her bir alan 100 bayt uzunluğunda olmalıdır. |
economic_operator |
İsteğe bağlı. Yasalara uygunluk için bu satıcıyla ilişkili ekonomik operatör bilgilerinin sağlanması gerekir. (isteğe bağlı) |
MerchantMatchingHints
Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olmak için kullanılan ipuçları.
| Alanlar | |
|---|---|
place_id |
Google Places veritabanında ve Google Haritalar'da bir yerin yer kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresini ziyaret edin. |
MerchantStatus
Google ile Rezervasyon platformunda satıcının durumu.
| Alanlar | |
|---|---|
name |
|
merchant_name |
İş ortakları tarafından sağlanan satıcının adı. |
input_geo_info |
İş ortakları, satıcının coğrafi konum bilgilerini sağladı. |
processing_status |
Satıcı işleme durumu. |
booking_status |
Uçtan uca rezervasyon entegrasyonuyla ilgili durum. |
waitlist_status |
Bekleme listesi entegrasyonuyla ilgili durum. |
geo_match |
Bu satıcının eşleşen coğrafi konumu. Satıcı coğrafi olarak eşleştirilmemişse boş olur. |
local_services_match |
Bu satıcının yerel hizmetler eşleşmesi. Yerel hizmet satıcısı değilse veya herhangi bir sağlayıcıyla eşleşmiyorsa boş olur. |
direct_urls[] |
Mevcut satıcı envanterinin içeriğini gösteren URL'lerin listesi. Bunun, envanterin gerçekten yayınlandığı anlamına gelmediğini ve URL'nin herkese açık olanlardan farklı olabileceğini unutmayın. |
BookingStatus
Uçtan uca rezervasyon entegrasyonuyla ilgili durum.
| Alanlar | |
|---|---|
has_valid_future_inventory |
Satıcının önümüzdeki 30 gün içinde envanteri varsa doğru değerini döndürür. Satıcının gerçekten reklam yayınlayacağı garanti edilmez. |
DirectUrl
Satıcıyı gösteren URL.
| Alanlar | |
|---|---|
type |
Bu URL'nin türü. |
url |
Bu satıcının gösterilebileceği URL. |
UrlType
Yüzeye çıkarılan URL'nin türü.
| Sıralamalar | |
|---|---|
URL_TYPE_UNSPECIFIED |
Belirtilmedi. |
BOOKING |
Uçtan uca rezervasyon URL'si. |
WAITLIST |
Uçtan uca bekleme listesi URL'si. |
LOCAL_SERVICES |
Google Yerel Hizmetler URL'si. |
LocalServicesMatchInfo
Google yerel hizmet eşleşmesi bilgileri (yalnızca yerel hizmet satıcısı için ayarlanır).
| Alanlar | |
|---|---|
matched_providers[] |
Eşleşen servis sağlayıcılar. Bir satıcı, birden fazla servis sağlayıcıyla eşleştirilebilir. |
MatchedProvider
Yerel hizmet sağlayıcı
| Alanlar | |
|---|---|
customer_id |
Google yerel hizmetleri harici müşteri kimliği. |
categories[] |
Yerel hizmet kategorileri (sektörler) Örneğin, "tesisatçı" ve "halı_temizleme". |
PlaceInfo
Eşleşen bir yerin bilgileri.
| Alanlar | |
|---|---|
name |
Yerin adı. |
formatted_address |
Yerel dilde biçimlendirilmiş adres. |
place_id |
Bu yerin Google yer kimliği. Google Haritalar URL'si oluşturmak veya yerle ilgili daha fazla ayrıntı almak için kullanılabilir. Kullanım örneği için https://developers.google.com/places/web-service/place-id adresine bakın. |
ProcessingStatus
Satıcı işleme durumu.
| Sıralamalar | |
|---|---|
PROCESSING_STATUS_UNSPECIFIED |
Durum belirtilmemiş. |
IN_PROGRESS |
Satıcı, Madden tarafından alınmış ancak işlenmeye devam ediyor. Bu durumdaki satıcıların başka bir durumu doldurulmaz. |
COMPLETED |
Satıcının diğer durumları hesaplanmıştır. |
WaitlistStatus
Bekleme listesi entegrasyonuyla ilgili durum.
| Alanlar | |
|---|---|
has_valid_waitlist_service |
Satıcının bekleme listesi hizmeti varsa doğru. Satıcının gerçekten reklam yayınlayacağı garanti edilmez. |
MoneyRange
Sınırlı veya sınırsız olabilecek bir dizi parasal tutarın sarmalayıcısı. min_amount ve max_amount değerlerinden en az biri gereklidir.
| Alanlar | |
|---|---|
min_amount |
Minimum tutar. |
max_amount |
Maksimum tutar. |
NoShowFee
Kullanıcının rezervasyon yapmasına rağmen gelmemesi durumunda alınabilecek ücret.
| Alanlar | |
|---|---|
fee |
Kullanıcının rezervasyonuna katılmaması durumunda tahsil edilebilecek tutar. |
fee_type |
Ücretin müsaitlik durumuna göre nasıl belirleneceğini tanımlar. |
Sipariş
Bir satıcıyla hizmet randevusu siparişi.
| Alanlar | |
|---|---|
name |
Siparişin kaynak adı: |
client_information |
Siparişi veren müşterinin kişisel bilgileri. |
payment_information |
Siparişle ilgili ödeme işlemleri hakkında bilgiler. |
merchant_id |
Bu siparişteki tüm hizmetlerin ait olduğu satıcının kimliği. |
item[] |
Bu siparişteki satır öğeleri. |
OrderOnlineMetadata
Online sipariş işlemi bağlantısının meta verileri.
| Alanlar | |
|---|---|
fulfillment_option[] |
Online sipariş işlemi bağlantısı için kullanılabilen sipariş karşılama seçenekleri. |
PaymentInformation
Rezervasyonla ilgili ödeme ayrıntıları
| Alanlar | |
|---|---|
prepayment_status |
Rezervasyonun ön ödeme durumu. prepayment_status PREPAYMENT_PROVIDED veya PREPAYMENT_REFUNDED ise payment_transaction_id, ilişkili benzersiz işlem kimliğini içerir. |
payment_transaction_id |
Rezervasyonla ilişkili bir ödeme işleminin benzersiz tanımlayıcısı. Geçerli değilse boştur. |
PaymentOption
Bir satıcı tarafından sağlanan hizmetlerin ödemesini yapmak için kullanılabilecek bir ödeme seçeneği. Ödeme seçenekleri birden fazla satıcı arasında (ör. aynı zincire ait satıcılar) paylaşılabilir.
| Alanlar | |
|---|---|
payment_option_id |
Bu kimlik, ödeme seçeneğini tanımlamak için kullanılır. Bu kimlik, toplayıcının tamamı için geçerlidir ve birden fazla satıcıda aynı değerin yeniden kullanılması, kullanıcının bu satıcılarda ilgili ödeme seçeneğiyle ödeme yapmasına olanak tanır. Bir kimlik birden fazla satıcıda yeniden kullanıldığında, bir satıcı altındaki ödeme seçeneği için herhangi bir değerin güncellenmesi, farklı bir satıcı altındaki aynı kimliğe sahip diğer ödeme seçeneklerini de günceller. Bu nedenle, tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlere güncellenmesi, olası bir eksiklik davranışını önlemek için en iyi uygulamadır. |
name |
Ödeme seçeneğinin adı. Bu durum kullanıcı tarafından görülebilir. |
description |
Ödeme seçeneğinin açıklaması. Bu durum kullanıcı tarafından görülebilir. |
price |
Ödeme seçeneğinin fiyatı. |
tax_rate |
Bu ödeme seçeneğinin vergi oranı. Bu alan varsa satıcıda veya hizmette bulunan tax_rate alanını geçersiz kılar. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfırlar. |
payment_option_type |
Bu ödeme seçeneğinin türü. Drop-in'ler için tek kullanımlık, paketler için çok kullanımlık, üyelikler için sınırsızdır. |
session_count |
Bu ödeme seçeneğinin kaç oturum için kullanılabileceği. Yalnızca değerin > 1 olması gereken çok oturumlu / paketler için geçerlidir. |
purchase_interval |
Ödeme seçeneği bu aralıkta satın alınabilir. |
valid_interval |
Ödeme seçeneği bu aralıkta kullanılabilir (ör. Ocak 2017 için özel fiyat). Mevcut olduğunda valid_duration ve activation_type özelliklerini geçersiz kılar. |
valid_duration |
Ödeme seçeneğinin geçerlilik süresi (ör. 30 günlük üyelik). |
activation_type |
Bu ödeme seçeneği için geçerlilik başlangıç tarihinin nasıl belirleneceğini tanımlar. |
user_restriction |
Bu ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar. Promosyon ödeme seçeneğini bir kullanıcı alt kümesiyle sınırlamak için kullanılabilir. Ayarlanmazsa tüm kullanıcılar uygundur. |
ActivationType
Geçerlilik başlangıç tarihinin nasıl belirleneceğini tanımlar.
| Sıralamalar | |
|---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Kullanılmamış. |
ACTIVATION_ON_PURCHASE |
Geçerlilik süresi, satın alma işlemi sırasında başlar. |
ACTIVATION_ON_FIRST_USE |
Geçerlilik, ödeme seçeneği ilk kez kullanıldığında başlar. |
PaymentOptionType
Ödeme seçeneği türü.
| Sıralamalar | |
|---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Kullanılmamış. |
PAYMENT_OPTION_SINGLE_USE |
Ödeme seçeneği yalnızca bir kez kullanılabilir. |
PAYMENT_OPTION_MULTI_USE |
Oturum sayısı > 0 ise ödeme seçeneği kullanılabilir. |
PAYMENT_OPTION_UNLIMITED |
Ödeme seçeneği, geçerli olduğu süre aralığında kullanılabilir. Oturum sayısı geçerli değildir. |
PaymentProcessorConfig
Ödeme işleyici yapılandırması, satıcı bazında ayarlanır.
| Alanlar | |
|---|---|
processor |
Bu yapılandırmanın geçerli olduğu ödeme işleme iş ortağını tanımlar. |
public_key |
Bu satıcıyı ödeme işleyicisiyle tanımlamak için kullanılan anahtar. Stripe için: https://stripe.com/docs/dashboard#api-keys Braintree için: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Ödeme istekleriyle birlikte ödeme işleyiciye gönderilen API sürüm numarası. |
İşlemci
Belirli bir ödeme işleme iş ortağını tanımlar.
| Sıralamalar | |
|---|---|
PROCESSOR_UNSPECIFIED |
Kullanılmamış |
PROCESSOR_STRIPE |
Stripe ile ödemeler için yapılandırma. |
PROCESSOR_BRAINTREE |
Braintree ile ödemeler için yapılandırma. |
PaymentRestrictions
Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar.
| Alanlar | |
|---|---|
credit_card_restrictions |
Bu satıcının kabul ettiği kredi kartlarıyla ilgili kısıtlamalar. Bu alan ayarlanmamışsa tüm kredi kartlarının kabul edildiği varsayılır. CreditCardType tarafından desteklenen kartların listesinin zaman içinde genişleyeceğini unutmayın. Bu nedenle, bu alanı boş bırakmak yapılandırmayı gelecekteki değişikliklere tabi kılar. |
PerOrderFee
Bilet sayısından bağımsız olarak sipariş başına bir kez ödenmesi gereken ücretler.
| Alanlar | |
|---|---|
delivery_fee |
Yayınlanma yöntemine göre değişebilen bir ücret. |
processing_fee |
Kullanıcının ödeme yönteminin işlenmesi için alınan ücret. |
PerTicketFee
Kullanıcının satın aldığı her bilet için ödenmesi gereken ücretler.
| Alanlar | |
|---|---|
service_charge |
Bir hizmet için alınan ek ücret. |
facility_fee |
Mekana/tesise ödenen bir ücrettir. |
taxes |
Bilet başına vergiler. |
PostalAddress
Müşterinin veya işletmenin adresi.
| Alanlar | |
|---|---|
address_country |
ISO 3166-1 alfa-2 ülke kodu kullanılarak belirtilen ülke (ör. "US") (zorunlu) |
address_locality |
Yerleşim yeri (ör. "Mountain View"). (gerekli) |
address_region |
Bölge (ör. "CA"). Bu alan yalnızca bölgenin genellikle adresin bir parçası olduğu ülkelerde zorunludur. (isteğe bağlı) |
postal_code |
Posta kodu (ör. "94043"). (gerekli) |
street_address |
Açık adres (ör. "1600 Amphitheatre Pkwy"). (gerekli) |
Ön Ödeme
Kullanıcının rezervasyonunun bir parçası olarak ödemesi gereken tutar.
| Alanlar | |
|---|---|
price_info |
Fiyat ayrıntılarını içeren kapsayıcı. |
PrepaymentStatus
Rezervasyonun ön ödeme durumu.
| Sıralamalar | |
|---|---|
PREPAYMENT_STATUS_UNSPECIFIED |
Belirtilmediyse varsayılan olarak PREPAYMENT_NOT_PROVIDED olur. |
PREPAYMENT_PROVIDED |
Rezervasyon ücreti önceden ödenmişse |
PREPAYMENT_NOT_PROVIDED |
Rezervasyon ücreti önceden ödenmemiştir. |
PREPAYMENT_REFUNDED |
Ücret daha önce PREPAYMENT_PROVIDED olarak belirtilmişti ancak şimdi geri ödendi. |
Fiyat
Bir hizmetin veya ücretin fiyatı.
| Alanlar | |
|---|---|
price_micros |
Para biriminin mikro birimleri cinsinden fiyat. En küçük para biriminin kesirleri, en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. (Örn. 2,5 ABD doları 2 ABD dolarına, 3,5 ABD doları 4 ABD dolarına, 0,5 ABD doları 0 ABD dolarına, 2,51 ABD doları 3 ABD dolarına yuvarlanır.) |
currency_code |
ISO 4217'de tanımlanan fiyatın para birimi. |
pricing_option_tag |
Genişletilmiş fiyatla ilişkili fiyatlandırma seçeneğini tanımlayan isteğe bağlı ve opak bir dize. |
PriceInfo
Fiyat ayrıntılarını içeren kapsayıcı.
| Alanlar | |
|---|---|
price_type |
Fiyatın veya fiyat aralığının nasıl uygulandığını (kişi başına veya sabit) tanımlar. |
price_options birleşik alanı. Fiyat seçenekleri, tam bir fiyat veya bir aralık belirtmek içindir. price_options aşağıdakilerden yalnızca biri olabilir: |
|
price |
Bir hizmetin veya ücretin fiyatı. |
price_range |
Bir hizmetin veya ücretin üst ve/veya alt sınırı. |
PriceInterpretation
Bir fiyatın nasıl yorumlanması ve kullanıcıya nasıl gösterilmesi gerektiğini açıklar.
| Sıralamalar | |
|---|---|
PRICE_INTERPRETATION_UNSPECIFIED |
Fiyat yorumu belirtilmedi, varsayılan olarak EXACT_AMOUNT kullanılır. |
EXACT_AMOUNT |
Fiyatın belirli bir değer olarak yorumlanması gerektiğinde kullanılır. Örnekler: yoga dersi için 20 ABD doları, çocuk saç kesimi için 15 ABD doları |
STARTS_AT |
Bir hizmetin fiyatı değişken olduğunda ancak minimum fiyat bilindiğinde ve tüketicilere gösterildiğinde. Tüketiciler, fiyatı artıran seçimler yapabilir. Bu PriceInterpretation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED'ı kullanması gerektiğini unutmayın. Örnekler: Köpek bakımı için 30 ABD doları, ancak ek tüketici tercihleri fiyatı artırabilir. |
NOT_DISPLAYED |
Bir hizmetin fiyatı değişken olduğunda ve tüketicilere önceden fiyat bilgisi gösterilmediğinde. Bu PriceInterpretation'ı kullanan tüm hizmetlerin PrepaymentType NOT_SUPPORTED'ı kullanması ve Price'ın boş olması gerektiğini unutmayın. Örnekler: Ev hizmeti için danışmanlık |
PriceRange
Her iki değer de ayarlanmadığı sürece sınırsız olarak kabul edilen bir dizi parasal tutarın sarmalayıcısı. min_amount ve max_amount değerlerinden en az biri gereklidir.
| Alanlar | |
|---|---|
min_price |
Minimum tutar. |
max_price |
Maksimum tutar. Her zaman min_price değerinden büyük olmalıdır. |
PriceType
Toplam fiyatın stok durumuna göre nasıl belirleneceğini tanımlar.
| Sıralamalar | |
|---|---|
FIXED_RATE_DEFAULT |
Fiyat sabit bir tutardır. Alan ayarlanmamışsa varsayılan değer budur. Örnekler: Masa ayırtmak için 50 TL depozito; yoga dersine katılmama durumunda 20 TL ücret |
PER_PERSON |
Belirtilen fiyat kişi başı fiyattır ve toplam fiyat, Kaynaklar'da belirtilen fiyat_mikros * parti_büyüklüğü olarak hesaplanır. KİŞİ_BAŞI fiyatına, stok durumu kaynaklarında parti boyutu eşlik etmelidir. Aksi takdirde, bir kişilik parti boyutu kullanılır. Örnekler: Müze biletleri için her biri 10 TL |
QuantitativeValue
Aralık veya sabit değer olabilecek sayısal değer için sarmalayıcı. QuantitativeValue örnekleri: * Tek değer: value: 10.5 * Sınırlı aralık: value_range {min_value: 5.5, max_value 10.5} * Alt sınır: value_range {min_value: 5.5} * Üst sınır: value_range {max_value: 10.5}
| Alanlar | |
|---|---|
value_options birleşik alanı. (zorunlu) value_options aşağıdakilerden yalnızca biri olabilir: |
|
value |
Tek bir değer. Örneğin: 5,6 |
value_range |
Açık uçlu veya sınırlı olabilen bir değer aralığı. Örnekler: * En az 5,5 * En fazla 5,5 * 5,5 ila 6,5 |
RangeValue
min_value < max_value koşulunu sağlayan değer aralığı. En az bir min_value veya max_value zorunludur.
| Alanlar | |
|---|---|
min_value |
Minimum değer. |
max_value |
Maksimum değer. |
Derecelendirme
Bir varlık için puanı tanımlar.
| Alanlar | |
|---|---|
value |
Ortalama puan değeri (number_of_ratings > 0 olduğunda zorunludur). Değer [1, 5] aralığında olmalıdır ve yalnızca derecelendirme sayısı sıfırsa atlanabilir. |
number_of_ratings |
Değeri hesaplarken kullanılan puan sayısı (zorunlu). |
RelatedMedia
Bu hizmetle ilgili fotoğraflar. Google, bu medyaları son kullanıcılara doğru şekilde gösterildiğinden emin olmak için tarar. (isteğe bağlı)
| Alanlar | |
|---|---|
url |
Bu medya kaynağının URL'si. Google, bu URL'de barındırılan medyayı tarar. |
type |
Bu medya kaynağının türü. |
localized_caption |
Uluslararasılaştırmayı destekleyen medyanın altyazısı. Yalnızca düz metin desteklenir. HTML bileşenleri kaldırılır. (isteğe bağlı) |
attribution |
Medyanın kaynağıyla ilgili ilişkilendirme bilgileri. Fotoğrafçıya veya ajansa atıfta bulunmak için ilişkilendirmenin medyayla birlikte gösterilmesi gerekiyorsa bu alanın ayarlanması gerektiğini unutmayın. (isteğe bağlı) |
caption |
Desteği sonlandırıldı. Yerelleştirilmiş altyazı kullanılması tercih edilir. |
İlişkilendirme
Bu medya için atıf bilgileri.
| Alanlar | |
|---|---|
localized_text |
Uluslararasılaştırmayı destekleyen fotoğrafçıya veya ajansa atıfta bulunmak için kullanılan metin. Bu metin, kaynak medyayla birlikte gösterilir. Bu alan için yalnızca düz metnin desteklendiğini, HTML bileşenlerinin kaldırılacağını (köprü tabanlı ilişkilendirme desteklenmez) unutmayın. |
text |
Desteği sonlandırıldı. Yerine localized_text kullanılması tercih edilir. |
MediaType
Bu medya kaynağının türünü belirten enum. Yalnızca fotoğraflar desteklenir. Fotoğrafların dışında başka medya türlerinin de desteklenmesi gerekiyorsa lütfen Google ile Rezervasyon ekibiyle iletişime geçin.
| Sıralamalar | |
|---|---|
TYPE_UNSPECIFIED |
Kullanılmamış. |
PHOTO |
URL tarafından sağlanan medyanın fotoğraf olduğunu gösterir. |
ReplaceServiceAvailabilityRequest
Service müsaitlik durumunu değiştirme isteği.
| Alanlar | |
|---|---|
service_availability |
Mevcut hizmetlerin yerine kullanılacak hizmet kullanılabilirliği. |
RequireCreditCard
Randevu almak için kredi kartı gerekip gerekmediğini tanımlar.
| Sıralamalar | |
|---|---|
REQUIRE_CREDIT_CARD_UNSPECIFIED |
Kredi kartı şartı açıkça belirtilmiyor ve davranış, KOŞULLU için belirtilen davranışla aynı. |
REQUIRE_CREDIT_CARD_CONDITIONAL |
Aşağıdaki koşullardan herhangi biri karşılanırsa Google, rezervasyon için kredi kartı gerektirir: * Kullanılabilirlik için fiyat belirlenmiş ve prepayment_type değeri REQUIRED olarak ayarlanmışsa * no_show_fee ayarlanmışsa * deposit alanı ayarlanmışsa. |
REQUIRE_CREDIT_CARD_ALWAYS |
Diğer alan değerlerinden bağımsız olarak, bu müsaitlik durumunu rezerve etmek için her zaman kredi kartı gerekir. |
Kaynaklar
Farklı personel üyeleri veya odalar hizmetin bir parçası olduğunda, kullanılabilirlik aralıklarını birbirinden ayırt etmek için kaynak kullanılır. Aynı hizmet ve zaman aralığı için birden fazla yer, farklı kaynaklara sahip olduğunda birlikte bulunabilir.
| Alanlar | |
|---|---|
staff_id |
Hizmeti sağlayan personel üyesinin isteğe bağlı kimliği. Bu alan, tüm satıcılar, hizmetler ve uygunluk kayıtlarındaki personel üyesini tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirmeye olanak tanımak için zaman içinde sabit kalması gerekir. staff_name varsa bu alan da olmalıdır. |
staff_name |
Hizmeti sunan personel üyesinin isteğe bağlı adı. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine okunabilir olmalıdır. staff_id mevcutsa bu alan da mevcut olmalıdır. |
room_id |
Hizmetin bulunduğu oda için isteğe bağlı bir kimlik. Bu alan, tüm satıcılar, hizmetler ve müsaitlik kayıtları genelinde odayı tanımlar. Ayrıca, geçmiş rezervasyonlarla ilişkilendirmeye olanak tanımak için zaman içinde sabit kalması gerekir. room_name mevcutsa bu alan da mevcut olmalıdır. |
room_name |
Hizmetin bulunduğu oda için isteğe bağlı bir ad. Bu alan, rezervasyon yapan kullanıcılara gösterilir ve opak bir tanımlayıcı yerine okunabilir olmalıdır. (isteğe bağlıdır ancak room_id mevcutsa zorunludur) Yemek alanında oda adı yalnızca bar veya veranda gibi oturma alanları için kullanılmalı, sabit fiyatlı menüler, özel etkinlikler veya oda dışı diğer değerler (ör. rezervasyon veya akşam yemeği) için kullanılmamalıdır. Varsayılan oturma alanının kendisine bağlı bir oda olmaması kesinlikle önerilir. |
party_size |
Yalnızca yemek için geçerlidir: Bu zaman aralığında ağırlanabilecek grup boyutu. Örneğin, rezervasyonla 2, 3 veya 4 kişi oturabiliyorsa bir restoran aynı saat için birden fazla yerle ilişkilendirilebilir ve her biri farklı bir party_size (gruptaki kişi sayısı) belirtir. |
room_description |
İsteğe bağlı. Yerelleştirilmiş oda açıklaması. Ayarlanırsa varsayılan bir değer sağlanmalıdır. Satıcının yerel ayarı için yaygın dillerin de sağlanması tercih edilir. (isteğe bağlı) |
SchedulingRules
Bir hizmetin planlama kuralları.
| Alanlar | |
|---|---|
min_advance_online_canceling |
Online olarak alınan bir randevunun iptal edilmesi için gereken minimum ön bildirim süresi (saniye cinsinden). (isteğe bağlı) |
late_cancellation_fee |
Minimum ön bildirim süresi içinde yapılan iptaller için alınan ücret. |
noshow_fee |
İptal etmeden rezervasyonu kullanmama ücreti. |
admission_policy |
Bu hizmet için geçerli olan kabul politikası. Ayarlanmamışsa varsayılan olarak TIME_STRICT olur. (isteğe bağlı) |
cancellation_policy |
Planlama kuralları iptal politikası. (Yapılacaklar için zorunlu) |
"min_advance_booking" ayarlanmışsa son rezervasyon yapılabilir zaman (<slot start time> - "min_advance_booking") olarak hesaplanır. "min_booking_buffer_before_end_time" ayarlanmışsa son rezerve edilebilir zaman (<slot end time> - "min_booking_buffer_before_end_time") olarak hesaplanır. "min_booking_buffer_before_end_time" değerinin ayarlanması durumunda pozitif olması gerektiğini unutmayın. Her ikisi de ayarlanmamışsa yuva, yuvanın başlangıç zamanına kadar rezerve edilebilir. Her iki alan da ayarlanırsa yalnızca bir değer seçilir ve diğer değer yoksayılır. Hangi değerin seçileceğini güvenilir bir şekilde tahmin edemeyiz. Örnekler:
|
|
min_advance_booking |
Son rezervasyonun yapılabileceği zamandan uygunluk aralığının başlayacağı zamana kadar geçen süre (saniye cinsinden). |
min_booking_buffer_before_end_time |
Son rezervasyonun yapılabileceği zamandan uygunluk aralığının sona ereceği zamana kadar geçen süre (saniye cinsinden). Bu alan ayarlanırsa kullanıcıların satın alınan biletleri zaman aralıkları başladıktan sonra kullanabileceğini belirtmek için "admission_policy" alanı TIME_FLEXIBLE olarak ayarlanmalıdır. |
AdmissionPolicy
Bu hizmetin kabul politikası.
| Sıralamalar | |
|---|---|
ADMISSION_POLICY_UNSPECIFIED |
Kullanılmamış. |
TIME_STRICT |
Müşterilerin, uygunluk aralığının başlangıç zamanında orada bulunması gerekir ve hizmetin, aralığın bitiş zamanında tamamlanması beklenir. TIME_STRICT kullanım alanlarına örnekler: * Saat 09:00'da başlayan, tüm katılımcıların başlangıç saatinde gelmesini gerektiren ve yaklaşık 12:00'de dönen bir tur. Cumartesi günü saat 15:00'te yaklaşık 30 dakika sürecek bir saç kesimi randevusu. * 18:00-20:00 arası fitness dersi |
TIME_FLEXIBLE |
Müşteriler, bu rezervasyonu kullanmak için uygunluk aralığının başlangıç ve bitiş zamanı arasında herhangi bir zamanda gelebilir. TIME_FLEXIBLE kullanım alanlarına örnekler: * Satın alma tarihinde herhangi bir zamanda kullanılabilen müze bileti. * Öğleden sonra 12:00-21:00 saatleri arasında kullanılabilecek bir eğlence parkı girişi |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
Müşterilerin, uygunluk aralığının başlangıç saatinde satıcıya ulaşması gerekir ancak istedikleri zaman ayrılabilirler. Örneğin, müze giriş senaryosunda, saat 10:00 için zamanlı giriş bileti olan kullanıcının saat 10:00'da müzede olması gerekir. Bu hizmet için uygunluk aralıklarının başlangıç zamanı, belirlenen giriş zamanını gösterir. Ancak bitiş saati yalnızca rezervasyon için uygunluk aralığını tanımlamak üzere anahtar olarak kullanılır. |
Hizmet
Satıcı tarafından sağlanan bir hizmetle ilgili bilgiler (ör. saç kesimi).
| Alanlar | |
|---|---|
name |
|
service_name |
Hizmetin adı (ör. "Erkek saç kesimi"). Desteği sonlandırıldı. Bunun yerine localized_service_name özelliğini kullanın. |
localized_service_name |
Hizmetin adı (ör. "Erkek saç kesimi"). Muhtemelen birkaç yerel ayarda. |
description |
Hizmetin kullanıcı tarafından görülebilen açıklaması. Desteği sonlandırıldı. Bunun yerine localized_description özelliğini kullanın. |
localized_description |
Hizmetin kullanıcı tarafından görülebilen açıklaması. Bu alan hem düz metin hem de HTML benzeri biçimlendirmeyi destekler. Düz metin bölümlerinin aksine, burada başlıklar, paragraflar, listeler ve bazı ifade etiketleri kullanılarak özelleştirilmiş düzenler oluşturulabilir. En iyi kullanıcı deneyimini oluşturmak için lütfen aşağıdaki talimatları ve notları dikkatlice okuyun. Desteklenen HTML benzeri biçimlendirme etiketleri: Başlık etiketleri: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Paragraf etiketi: <p> Liste etiketleri: <ul>, <ol>, <li> Bölüm etiketi: <div> İfade etiketleri: <br>, <strong>, <em>: Desteklenmeyen etiketler:
Önemli notlar:
|
price |
Hizmetin fiyatı. |
price_interpretation |
Fiyatın nasıl yorumlandığını ve kullanıcıya nasıl gösterildiğini açıklar. Yemek ve Aktivite Önerileri hariç tüm sektörler tarafından hizmet fiyatının gösterimini yapılandırmak için kullanılabilir. |
rules |
Randevu alma/iptal etme kuralları |
prepayment_type |
Ön ödemenin gerekli, isteğe bağlı veya desteklenmiyor olup olmadığı |
prepayment_terms |
Ön ödemenin ne zaman tamamlanacağıyla ilgili şartlar. |
form[] |
Kullanımdan kaldırıldı. Lütfen intake_form ve per_ticket_intake_form'u kullanın. |
intake_form |
Kullanıcı bu hizmeti rezerve ettiğinde ek bilgi isteyen bir form. (isteğe bağlı) |
per_ticket_intake_form |
Kullanıcı bu hizmeti rezerve ettiğinde ek bilgi isteyen bir form. Bu form, kullanıcının rezervasyon yaptığı her bilet için bir kez doldurulmalıdır. (isteğe bağlı) |
tax_rate |
Hizmetin vergi oranı. Bu alan varsa satıcı düzeyinde ayarlanan tüm tax_rate değerlerini geçersiz kılar. Boş bir mesaj (ör. tax_rate { }) uygulanan vergi oranını sıfırlar. |
payment_option_id[] |
Bu hizmet için ödeme yapmak üzere kullanılabilecek ödeme seçeneklerine referans veren kimliklerin listesi. Gerçek ödeme seçenekleri satıcı düzeyinde tanımlanır ve birden fazla satıcı arasında da paylaşılabilir. |
deposit |
Depozitonun kullanıcıdan nasıl alınabileceğini tanımlar. Belirtilmişse hizmet depozitosunu geçersiz kılar. Bu ayarı boş bir depozito mesajı olarak ayarlamak, hizmet düzeyindeki tüm depozitoları kaldırır. (isteğe bağlı) |
no_show_fee |
Kullanıcıdan alınabilecek bir "gösterilmeme" ücreti tanımlar. Belirtilmişse hizmete gelinmeme ücretini geçersiz kılar. Bu ayarı boş bir NoShowFee mesajına ayarlamak, hizmet düzeyindeki tüm "gösterilmeme" ücretlerini kaldırır. (isteğe bağlı) |
require_credit_card |
Kullanıcının bu hizmeti rezerve etmek için kredi kartı sağlaması gerekip gerekmediğini gösterir. Bu alan, stok durumu düzeyinde geçersiz kılınabilir. (isteğe bağlı) |
action_link[] |
Bu hizmetle ilgili bir işlem bağlantısı. İşlem bağlantısı varsa Hizmet'te tür (aşağıya bakın) ayarlanmalıdır. |
type |
Bu hizmetin önceden tanımlanmış türü. (isteğe bağlı) |
ticket_type[] |
Biletler destekleniyorsa bu hizmet için rezerve edilebilen/satın alınabilen bilet türleri. (isteğe bağlı) |
related_media[] |
Bu hizmetle ilgili fotoğraflar. Google, medyaların son kullanıcılara en verimli şekilde gösterilmesini sağlamak için bunları tarar ve depolar. (isteğe bağlı) |
service_attribute_value_id[] |
Bu hizmet için geçerli olan hizmet özelliği değerleri (isteğe bağlı). Her Hizmet, ilgili satıcıda tanımlanan her hizmet özelliği için sıfır veya daha fazla değere sahip olabilir. (isteğe bağlı) |
waitlist_rules |
Bekleme listesine katılma kuralları |
ticketing_vertical_specific_data |
Etkinlik bilet işlemleri dikeyine özgü ek bilgiler. (isteğe bağlı) |
integration_type |
Bu hizmet için desteklediğimiz entegrasyon derinliği. (isteğe bağlı) Başlangıç entegrasyonuna sahip iş ortakları için geçerli değildir. Uçtan uca şifreleme, bu iş ortakları için her zaman devre dışı bırakılır. |
per_order_fee |
Bu hizmetin satın alınmasıyla ilgili sipariş düzeyinde ücretler. (isteğe bağlı) |
tours_and_activities_content |
Turlar ve Aktiviteler'e özgü içerik alanları. |
location[] |
Bu hizmetle ilgili konumlar. ÖNEMLİ NOTLAR: Bu hizmetle ilgili birden fazla ziyaret edilen konum varsa veya START_LOCATION, VISITED_LOCATION'dan farklıysa START_LOCATION belirtilmelidir. Örnek: Üç mekanı ziyaret eden rehberli bir bisiklet turu. Başlangıç mekanı belirtilmelidir. Bir otel lobisinde buluşup ziyaret edilen yere giden bir otobüs turu. Toplantı yeri belirtilmelidir. |
rating |
Bu hizmetin tüm yorumlardaki toplu metriği olarak kullanıcı puanı. |
home_service_data |
Ev hizmetleri sektörüne özgü ek bilgiler. (isteğe bağlı) |
virtual_session |
İsteğe bağlı. Sanal oturum hakkında bilgiler. Sanal hizmetlerin etkinleştirilmesi için gereklidir. |
direct_merchant_payment |
İsteğe bağlı. Hizmetin, kullanıcının doğrudan satıcıya ödeme yapmasını gerektirmesi durumunda eklenmesi gereken ek bilgiler. ÖNEMLİ NOT: RwG bu işleme dahil değildir. virtual_session tanımlanmışsa ve hizmet ücretsiz değilse veya prepayment_type REQUIRED olarak ayarlanmamışsa zorunludur. |
uri_template |
İsteğe bağlı. Google'ın harici site URL'lerini nasıl oluşturacağını belirten isteğe bağlı bir şablon. |
PrepaymentTerms
Ön ödemenin ne zaman tamamlandığıyla ilgili ayrıntılı bilgi.
| Alanlar | |
|---|---|
charge_timing |
Ücretin, satın alma zamanına göre ne zaman alınacağı. |
charge_time_before_start_time_sec |
Kullanıcının ödeme için ücretlendirildiği, hizmetin başlangıç zamanından önceki süre (saniye cinsinden). Bu alan yalnızca ChargeTiming CHARGE_LATER olduğunda ayarlanmalıdır. |
ChargeTiming
Ücretin, satın alma zamanına göre ne zaman alınacağını belirten enum.
| Sıralamalar | |
|---|---|
CHARGE_TIMING_UNSPECIFIED |
Kullanılmamış. |
CHARGE_NOW |
Müşteriden hemen ödeme alınır. |
CHARGE_LATER |
Müşteriden daha sonra ödeme alınacak. |
PrepaymentType
Ön ödeme türünü belirten enum.
| Sıralamalar | |
|---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Varsayılan olarak, ön ödemenin NOT_SUPPORTED (desteklenmiyor) olduğu varsayılır. |
REQUIRED |
Kullanıcı, bu hizmetin ödemesini rezervasyon sırasında yapmalıdır. |
OPTIONAL |
Kullanıcı, bu hizmet için rezervasyon sırasında veya daha sonra ön ödeme yapmayı seçebilir ancak rezervasyon yapmak için ön ödeme yapması gerekmez. |
NOT_SUPPORTED |
Bu hizmet için ön ödeme desteklenmiyor. |
ServiceType
Önceden tanımlanmış hizmet türleri.
| Sıralamalar | |
|---|---|
SERVICE_TYPE_UNSPECIFIED |
Kullanılmamış. |
SERVICE_TYPE_DINING_RESERVATION |
Yemek rezervasyonu |
SERVICE_TYPE_FOOD_ORDERING |
Yemek siparişi (adrese teslimat, paket servis veya her ikisi de olabilir) |
SERVICE_TYPE_FOOD_DELIVERY |
Yemek teslimatı |
SERVICE_TYPE_FOOD_TAKEOUT |
Paket yemek servisi |
SERVICE_TYPE_EVENT_TICKET |
Etkinlik bileti. |
SERVICE_TYPE_TRIP_TOUR |
Gezi turu. |
SERVICE_TYPE_APPOINTMENT |
Randevu veya ders hizmeti sunan işletmeler. (1) Sağlık ve fitness, (2) spa ve güzellik, (3) finansal danışmanlık ve değerlendirme hizmetleri için önerilir. Lütfen desteklenen hizmet türlerine bakın: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Tamamen sanal olarak gerçekleştirilecek bir sınıf veya oturum için online randevu hizmeti sunulmalıdır. Sanal hizmet rezervasyonları etkinleştiriliyorsa ayarlanmalıdır. |
SERVICE_TYPE_SHOPPING |
Kullanıcıların belirtilen satıcıdan alışveriş yapmasına olanak tanıyan hizmet. Teslimat veya teslim alma olabilir. |
ServiceAttribute
Hizmet özellikleri, bir satıcının hizmetlerini tanımlayan, iş ortağı tarafından tanımlanmış kategorilerdir. Örneğin, bir banka olası değerleri "Kişisel" ve "İşletme" olan bir "Hesap Türü" hizmet özelliği tanımlayabilir. Bir kuaför ise olası değerleri "Saç Kesimi", "Boyama" ve "Şekillendirme" olan bir "Hizmet Türü" hizmet özelliği tanımlayabilir.
| Alanlar | |
|---|---|
attribute_id |
Bu hizmet özelliğini aynı satıcının diğer hizmet özellikleri arasında benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "account-type"). |
attribute_name |
Bu özelliğin kullanıcı tarafından görülebilen adı (ör. "Hesap Türü"). |
value[] |
Bu hizmet özelliği için olası tüm değerler. |
Değer
Belirli bir hizmet özelliği için olası bir değeri temsil eder.
| Alanlar | |
|---|---|
value_id |
Bu hizmet özelliği için bu değeri diğerleri arasında benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "kişisel"). |
value_name |
Değer için kullanıcı tarafından görülebilen bir ad (ör. "Kişisel"). |
ServiceAttributeValueId
Bir hizmet özelliğinin, bir hizmete uygulanacak belirli bir değerini tanımlar.
| Alanlar | |
|---|---|
attribute_id |
Merchant.service_attribute içinde tanımlanan bir özelliğin kimliği (ör. "service-type"). |
value_id |
Bu özelliğin değerinin kimliği (ör. "saç kesimi"). Hizmet özelliği tanımındaki bir value_id ile eşleşmelidir. |
ServiceAvailability
Kullanılabilirlik listesi ve kimlere/ne zaman uygulanması gerektiği.
| Alanlar | |
|---|---|
name |
Bunun uygulanacağı hizmetin kaynak adı. |
start_time_restrict |
Sağlanırsa [start_time_restrict, end_time_restrict) aralığında sağlanan Availability öğelerinin tam bir anlık görüntü olduğu kabul edilir. Yani aşağıdaki koşul geçerliyse mevcut tüm uygunluk silinir: Süre mesajı ayarlanırsa koşul daha da kısıtlanır: resources_restrict mesajı ayarlanırsa koşul daha da kısıtlanır: Bu alanlar genellikle belirli bir zaman aralığında stok durumuyla ilgili eksiksiz bir güncelleme sağlamak için kullanılır. end_time_restrict ayarlanmadan start_time_restrict ayarlanırsa bu, start_time_restrict ile başlayan tüm zamanlar olarak yorumlanır. |
end_time_restrict |
start_time_restrict ayarlanmamışken end_time_restrict ayarlanması, end_time_restrict'e kadar olan tüm zamanı ifade eder. |
duration_restrict |
Süre ayarlama, güncellemenin kapsamını yalnızca eşleşen süreye sahip müsaitlik bloklarıyla daha da kısıtlar. |
resources_restrict |
resources_restrict ayarı, güncellemenin kapsamını yalnızca bu kaynak grubuyla daha da kısıtlar. Kaynakların tüm kimlik alanları tam olarak eşleşmelidir. |
availability[] |
Yeni müsaitlik listesi. |
ServiceIntakeForm
Satıcı tarafından sağlanan hizmeti özelleştiren bir giriş formu tanımlar.
| Alanlar | |
|---|---|
field[] |
Kullanıcıya gösterilecek alanlar. |
first_time_customers |
Doğruysa bu form, ilk kez alışveriş yapan müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez. |
returning_customers |
True (doğru) ise bu form, tekrar eden müşterilere gösterilir. Kullanımdan kaldırıldı. Bu işlev, giriş formlarında desteklenmez. |
ServiceIntakeFormField
ServiceIntakeForm'da bulunan bir alanı tanımlar.
| Alanlar | |
|---|---|
id |
Bir form alanını benzersiz şekilde tanımlayan, toplayıcı iş ortağından alınan bir dize. Bu kimlik, ilgili form alanı yanıtındaki kimlikle aynı olmalı ve hem hizmet düzeyinde hem de her bilet alımı formunda benzersiz olmalıdır. (gerekli) |
type |
Bu alanın türü. |
label |
Bu alan için kullanıcıya gösterilen metin. Kullanımdan kaldırıldı. Lütfen bunun yerine |
localized_label |
Bu alan için kullanıcıya gösterilen metin. Alan, birden fazla yerel ayarda sağlanabilir. (gerekli) |
value[] |
Yalnızca alan türü LOCATION_SEARCH ise ayarlayın. Konum değerini belirtmek için lütfen "konum" alanında "location_id"yi kullanın. |
choice_text[] |
Yalnızca alan türü MULTIPLE_CHOICE, CHECKBOXES veya DROPDOWN ise ayarlayın. Olası seçenekleri listelemek için kullanılır. |
is_required |
Bu alana yanıt verilmesinin kullanıcı tarafından zorunlu olup olmadığını gösterir. |
allow_custom_answer |
Önceden tanımlanmış yanıtlara ek olarak özel bir değere izin verilip verilmediğini gösterir. Bu yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. (isteğe bağlı) |
additional_option[] |
Belirtilen değerlere ek olarak sunulan ek seçenekler. Yalnızca alan türü LOCATION_SEARCH olduğunda geçerlidir. Örneğin, sağlanan konum listesine ek olarak "Tedarikçiyle daha sonra iletişime geçeceğim" seçeneği de kullanılabilir. (isteğe bağlı) |
ticket_type_restrict[] |
Bu soru yalnızca kullanıcı belirli bilet türlerini rezerve ettiğinde gösterilecekse bu alan, geçerli bilet türü kimlikleri kümesi olarak ayarlanmalıdır. Soru her zaman geçerliyse alanı boş bırakın. |
hint |
Giriş için ipucu metni, metin yer tutucusu olarak gösterilir. Bu yalnızca alan türü SHORT_ANSWER veya PARAGRAPH olduğunda geçerlidir. (isteğe bağlı) |
FieldType
Alan türünü belirten enum.
| Sıralamalar | |
|---|---|
FIELD_TYPE_UNSPECIFIED |
Belirtilmemiş veya bilinmeyen türdeki alanlar yoksayılır. |
SHORT_ANSWER |
Metin için tek satırlık giriş alanı. |
PARAGRAPH |
Metin için çok satırlı bir giriş alanı. |
MULTIPLE_CHOICE |
Birçok seçenek arasından bir seçim yapılması gereken bir grup radyo düğmesi. |
CHECKBOXES |
Onay kutularıyla birlikte bir veya daha fazla numaralandırılmış öğe. |
DROPDOWN |
Açılır listeden yapılan seçim. |
BOOLEAN |
Evet/hayır düğmesi. |
LOCATION_SEARCH |
Sağlanan konum listesindeki kullanıcı girişine göre eşleşen konumun bulunmasını destekleyen bir arama kutusu. |
TaxRate
Kullanıcıdan bir hizmet için ödeme alınırken uygulanan ve satıcı veya hizmet bazında ayarlanabilen vergi oranı.
| Alanlar | |
|---|---|
micro_percent |
Milyonda bir oranında vergi oranı. Bu, 6 ondalık basamak hassasiyeti sağlar. Örneğin, vergi oranı %7,253 ise bu alan 7253000 olarak ayarlanmalıdır. Bu alan ayarlanmazsa veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, Service.price tarafından belirtilen fiyatın aynısıdır. Hizmet fiyatının, geçerli vergilerden muaf olduğu veya bu vergileri zaten içerdiği varsayılır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilmez. Bu alan sıfırdan farklı bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyata hizmet fiyatı ve burada sağlanan vergi oranı kullanılarak değerlendirilen vergi dahil edilir. En küçük para biriminin kesirleri (örneğin, bir sentin kesirleri) en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilir. |
Şartlar
Google ile Rezervasyon üzerinden rezervasyon yapmak için kullanıcıya gösterilen bir dizi kural ve yönerge.
| Alanlar | |
|---|---|
url |
İsteğe bağlı olarak, Hükümler ve Koşullar'ın URL'si. |
text |
Kullanıcıya gösterilecek metin. Yeni entegrasyonlar için aşağıdaki localized_text öğesini kullanın. |
localized_text |
Kullanıcıya gösterilecek yerelleştirilmiş metin. |
Metin
Yerelleştirilmiş olabilecek bir metin yükü. Bazı metin alanları, işaretlenmiş içerik barındırabilir.
| Alanlar | |
|---|---|
value |
Bilinmeyen bir yerel ayarda metin değeri. Yalnızca |
localized_value[] |
Yerel ayara göre metin değerleri. İsteğe bağlı. |
TicketType
TicketType, farklı kullanıcı türleri, farklı hizmet özellikleri veya farklı seçenekler/eklentiler nedeniyle farklı fiyatlara ve/veya stok durumlarına sahip biletler arasında ayrım yapmak için kullanılır.
Bilet, bir hizmet için rezerve edilebilen en küçük birimdir. Örneğin, rafting gezisinde bir yer, müzeye giriş, tam gün çift kişilik kano kiralama.
| Alanlar | |
|---|---|
ticket_type_id |
Bilet kimliği, aynı hizmetin farklı bilet türlerini ayırt etmek için kullanılır ve yalnızca hizmet içinde benzersiz olması beklenir. |
short_description |
Bu TicketType için kısa bir açıklama. Bu, kullanıcı tarafından görülebilir (ör. "yetişkin", "çocuk", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Desteği sonlandırıldı. Bunun yerine localized_short_description özelliğini kullanın. |
localized_short_description |
Bu TicketType'ın kısa bir açıklaması (uluslararasılaştırma desteğiyle). Bu, kullanıcı tarafından görülebilir (ör. "yetişkin", "çocuk", "gazi", "J Sırası" vb.) olmalıdır. Her bilet türü için kullanıcı tarafından görülebilir bir açıklama eklenmesi zorunludur. Her yerel ayar için ayrı değerler sağlanabilir. |
price |
Bu türdeki tek bir biletin, vergiler hariç fiyatı. Hizmetin vergi oranı, biletlerine uygulanır. |
per_ticket_fee |
Bu bileti satın almak için ek ücretler. (isteğe bağlı) |
price_display_type |
İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş fiyat gösterimi türü. |
option_description |
Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Desteği sonlandırıldı. Bunun yerine localized_option_description özelliğini kullanın. |
localized_option_description |
Bu bilet türünün temsil ettiği ek seçeneklerin açıklaması (varsa). Her yerel ayar için ayrı değerler sağlanabilir. Bilet türü birden fazla boyutu temsil ettiğinde ek seçenekler kullanışlıdır. 1. örnek: "Yetişkin", "çocuk" gibi farklı türlere sahip bir giriş bileti ve ek seçenek olarak dil. Beklenen TicketType listesi şu şekilde olur: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } } 2. örnek: İsteğe bağlı kuru çanta eklentisiyle çok saatlik kano kiralama. short_description "3 saat", option_description ise "kuru çantalı" veya "kuru çantasız" olabilir: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } } İsteğe bağlıdır ancak hizmetteki herhangi bir bilet türünde bu alan ayarlanmışsa diğer tüm bilet türlerinde de bu alanın ayarlanmasını bekleriz (varsayılan bir option_description kullanılabilir). Örneğin, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] geçerli bir liste değildir. Yalnızca iki HTML biçimlendirme etiketi desteklenir: ve |
inventory_type |
İsteğe bağlı. Bu türdeki tek bir biletin önceden belirlenmiş envanter türü. |
InventoryType
Bu türdeki tek bir biletin önceden belirlenmiş envanter türü.
| Sıralamalar | |
|---|---|
INVENTORY_TYPE_UNSPECIFIED |
Envanter türü belirtilmedi. |
INVENTORY_TYPE_PRIMARY |
Birincil envanter. |
INVENTORY_TYPE_VERIFIED_RESALE |
Doğrulanmış yeniden satış envanteri. |
INVENTORY_TYPE_RESALE |
Yeniden satış envanteri. |
INVENTORY_TYPE_AGGREGATOR |
Toplayıcı envanteri. Toplayıcı (ör. www.bandsintown.com), iş ortağının etkinlik ve bilet bilgileri sağladığı anlamına gelir. Ancak biletler doğrudan iş ortağı tarafından satılmaz. Gerçek bilet satıcısı birincil, doğrulanmış yeniden satış veya yeniden satış olabilir. Artık yalnızca üst düzey iş ortağı envanter türü ayırt ediliyor ve bir toplayıcıdaki gerçek bilet satıcısı envanter türü göz ardı ediliyor. |
PriceDisplayType
Açılış sayfasında gösterilen fiyat biçimini belirtir.
Bu alan, bağlantı içermeyen envanter için yoksayılır.
Bu alan, Google platformlarının açılış sayfası tarafından kullanılan fiyat biçimini göstermesine olanak tanır. Tutarlı fiyat biçimleri, dönüşüm oranını artırır ve kafa karışıklığını azaltır.
| Sıralamalar | |
|---|---|
PRICE_DISPLAY_TYPE_UNSPECIFIED |
Fiyat görüntüleme türü belirtilmemiş. Google, hangi biçimin gösterileceğine karar verir. |
PRICE_DISPLAY_TYPE_BASE |
Açılış sayfasında gösterilen fiyat, taban fiyattır. |
PRICE_DISPLAY_TYPE_ALL_IN |
Açılış sayfasında gösterilen fiyata tüm ücretler ve vergiler dahildir. |
TicketingVerticalSpecificData
Etkinlik bilet işlemleri dikeyine özgü ek bilgiler.
| Alanlar | |
|---|---|
event_category |
Etkinliğin kategorisi. Yalnızca etkinlik önceden tanımlanmış kategorilerden birine girdiğinde ayarlanır. (isteğe bağlı) |
event_url |
İş ortağının web sitesindeki etkinliğin URL'si. (isteğe bağlı) |
entity[] |
Etkinlikle ilgili öğelerin listesi. (isteğe bağlı) |
event_attendance_mode |
Zorunlu. Etkinliğe katılım türü. |
event_virtual_location_url[] |
İsteğe bağlı. Etkinliğin izlenebileceği URL. |
event_organizer |
İsteğe bağlı. Etkinliği düzenleyen kullanıcı. |
event_organizer_url |
İsteğe bağlı. Etkinliği düzenleyen kişinin URL'si. |
event_organizer_type |
İsteğe bağlı. Düzenleyenin türü. |
event_source_url[] |
Zorunlu. Etkinlik bilgilerinin veya açıklamalarının bulunabileceği sayfaların URL'si. |
event_state |
İsteğe bağlı. Etkinliğin durumu. |
brand_name |
İsteğe bağlı. Yerelleştirilmiş marka adı. |
event_creator |
İsteğe bağlı. Etkinliği oluşturan kişi hakkında bilgiler. |
AttendanceMode
Etkinliğe katılım türü.
| Sıralamalar | |
|---|---|
ATTENDANCE_MODE_UNSPECIFIED |
Belirtilmedi. |
ONLINE |
Sanal etkinlikler için. |
PHYSICAL |
Fiziksel etkinlikler için. |
PHYSICAL_ONLINE_MIXED |
Hem fiziksel hem de sanal etkinlikler için. |
Varlık
Etkinlikle ilgili bir varlığı temsil eder.
| Alanlar | |
|---|---|
id |
İş ortağının veritabanındaki öğenin benzersiz tanımlayıcısı. (isteğe bağlı) |
name |
Varlığın adı. (gerekli) |
url |
Özneyi açık bir şekilde tanımlayan web sayfasının URL'si. Bu, varsa iş ortağının web sitesindeki öğeye ait web sayfasıdır. Öğenin diğer herkese açık URL'leri için public_identification_data içinde relevant_url'yi kullanın. (isteğe bağlı) |
entity_type |
Varlığın türü. (isteğe bağlı) |
entity_role |
Varlığın etkinlikteki rolü. (isteğe bağlı) |
public_identification_data |
Varlığın herkese açık referansları. (isteğe bağlı) |
EntityRole
Varlığın etkinlikteki rolü.
| Sıralamalar | |
|---|---|
ENTITY_ROLE_UNSPECIFIED |
Belirtilmedi. |
ENTITY_ROLE_HEADLINER |
Tüzel kişi, etkinlikte sahne alan önemli bir sanatçıyı veya başrol oyuncusunu temsil ediyor. |
ENTITY_ROLE_SUPPORTER |
Varlık, etkinlikte destekleyici bir sanatçıyı temsil ediyor. |
ENTITY_ROLE_HOME_TEAM |
Bu öğe, (spor) etkinliğindeki ev sahibi takımı temsil eder. |
ENTITY_ROLE_AWAY_TEAM |
Varlık, (spor) etkinliğindeki deplasman takımını temsil eder. |
EntityType
Varlığın türü. Not: Evrensel bir ontoloji olması amaçlanmamıştır.
| Sıralamalar | |
|---|---|
ENTITY_TYPE_UNSPECIFIED |
Belirtilmedi. Kullanmayın. |
ENTITY_TYPE_PERFORMER |
Bu varlık, konserde veya gösteride sahne alan sanatçıyı ya da grubu temsil eder. Yalnızca etkinlik kategorisi CONCERT veya THEATRE olduğunda geçerlidir. |
ENTITY_TYPE_PLAYER |
Varlık, etkinlikteki spor takımını veya oyuncuyu temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir. |
ENTITY_TYPE_CONCERT_TOUR |
Varlık, bu etkinliğin ait olduğu turu temsil eder. Yalnızca etkinlik kategorisi CONCERT olduğunda geçerlidir. |
ENTITY_TYPE_SPORTS_SERIES |
Varlık, bu etkinliğin ait olduğu bir spor turnuvasını temsil eder. Yalnızca etkinlik kategorisi SPOR olduğunda geçerlidir. |
ENTITY_TYPE_PLAY |
Varlık, etkinlikte sahnelenen oyun türünü (ör. müzikal, komedi, bale vb.) temsil eder. Yalnızca etkinlik kategorisi THEATRE olduğunda geçerlidir. |
EventCategory
Ürün deneyimini özelleştirdiğimiz etkinlik kategorilerinin bir alt kümesi. Not: Etkinliklerin evrensel bir ontolojisi olması amaçlanmamıştır.
| Sıralamalar | |
|---|---|
EVENT_CATEGORY_UNSPECIFIED |
Belirtilmedi. Kullanmayın. |
EVENT_CATEGORY_CONCERT |
Konserler |
EVENT_CATEGORY_SPORTS |
Spor etkinlikleri |
EVENT_CATEGORY_THEATRE |
Tiyatro etkinlikleri |
EVENT_CATEGORY_EXHIBITS |
Sergiler. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Atölyeler ve sınıflar |
EventCreator
Etkinliği oluşturan kişi hakkında bilgiler. Yalnızca kullanıcı tarafından oluşturulan içerik etkinliklerini içeren platformlar için geçerlidir.
| Alanlar | |
|---|---|
name |
İsteğe bağlı. Etkinliği oluşturanın adı. Karakter kısıtlaması yoktur. |
EventState
Etkinliğin durumu.
| Sıralamalar | |
|---|---|
EVENT_STATE_UNSPECIFIED |
Belirtilmedi. |
SCHEDULED |
Etkinlik planlandı. |
RESCHEDULED |
Etkinlik yeniden planlandı. |
CANCELLED |
Etkinlik iptal edildi. |
POSTPONED |
Etkinlik ertelendi. |
OrganizerType
Düzenleyenin türü.
| Sıralamalar | |
|---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Belirtilmedi. |
PERSON |
Etkinliği düzenleyen kişi için. |
ORGANIZATION |
Etkinliği düzenleyen kişi bir kuruluşsa |
PublicIdentificationData
Bir tüzel kişiye referans veren tanımlayıcılar, web sayfaları veya diğer kamuya açık kaynaklar.
| Alanlar | |
|---|---|
relevant_url[] |
Yalnızca konuya ayrılmış herhangi bir web sayfasının herkese açık URL'si. Resmi web siteleri, Discogs, sosyal medya platformları, Wikipedia veya IMDb sayfaları buna örnek olarak verilebilir. Örneğin: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (isteğe bağlı) |
musicbrainz_id |
Sanatçının veya diğer müzik varlıklarının 36 karakterlik MusicBrainz tanımlayıcısı (varsa). https://musicbrainz.org/doc/MusicBrainz_Identifier adresini ziyaret edin. (isteğe bağlı) |
TimeRange
Kapalı-açık zaman aralığı, yani [start_time, end_time).
| Alanlar | |
|---|---|
start_time |
Zaman aralığının alt sınırı. |
end_time |
Zaman aralığının üst sınırı. |
TokenizationConfig
Ödeme işleyici jetonlaştırması için satıcı bazında ayarlanan bir yapılandırma.
| Alanlar | |
|---|---|
tokenization_parameter |
Bir belirtekleştirme yapılandırmasında genellikle anahtarı "gateway" ve değeri işlemcinin adı olan bir tokenization_parameter bulunur. Diğer parametreler işlemciye bağlıdır. Daha fazla bilgi için Google Pay'in belgelerini inceleyin. Braintree örneği: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" } Stripe örneği: tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" } Adyen örneği: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" } |
billing_information_format |
Ödeme tokenına, kullanıcının Google Pay'e FOP'siyle (yukarıya bakın) girdiği fatura bilgilerini ekleyin. Alanı boş bırakmak, MIN değerini belirtmekle aynıdır. |
BillingInformationFormat
Kullanıcıdan ne kadar fatura adresi bilgisi isteneceğini ve jetona ne kadarının dahil edileceğini belirler. Numaralandırılmış değerler, Google Pay API'deki parametrelere karşılık gelir (bkz. https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
| Sıralamalar | |
|---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Belirtilmedi. Varsayılan olarak MIN değerine ayarlanır. |
MIN |
ad, ülke kodu ve posta kodu (Google Pay varsayılan ayarı). |
FULL |
ad, açık adres, yerleşim yeri, bölge, ülke kodu ve posta kodu. |
ToursAndActivitiesContent
Turlar ve Aktiviteler'e özgü içerik alanları. Tekrarlanan alandaki her öğe, ayrı oluşturmaya (ör. madde işareti olarak) izin verecek şekilde bağımsız olmalıdır.
Turlar ve aktiviteler için ToursAndActivitiesContent'in doldurulması kesinlikle önerilir ancak zorunlu değildir. Tüm alanlar, temel biçimlendirme için hem düz metni hem de HTML benzeri metni destekler. Desteklenen HTML benzeri biçimlendirme etiketleri:
İfade etiketleri:
, , , : Yalnızca yukarıda belirtilen üç etiket desteklenir.
, paragraflardaki satırları bölmek için, // ise önemli bir metni vurgulamak için kullanılabilir. Diğer tüm ifade etiketleri yoksayılır.
Diğer tüm etiketlere ve özel stillere izin verilmez ve bunlar kaldırılır. Tüm URL'ler, bağlantılar ve köprüler kaldırılır ve hiçbir zaman son kullanıcılara gösterilmez.
Önemli notlar: * highlights, exclusion ve hizmet açıklamasındaki diğer daha ayrıntılı alanlarda zaten sağlanan verileri kopyalamayın. * Desteklenmeyen etiketlerdeki içerikler kaldırılacağından ve bu durum istenmeyen bir kullanıcı deneyimine yol açabileceğinden, yukarıda belirtilen desteklenen etiketler dışında etiket kullanmaktan kaçının.
| Alanlar | |
|---|---|
highlights[] |
Kullanıcıların görebileceği öne çıkanlar listesi. |
inclusions[] |
Kullanıcıların görebileceği dahil etme listesi. |
exclusions[] |
Kullanıcıların görebileceği hariç tutma listesi. |
must_know[] |
Önemli notların kullanıcı tarafından görülebilen listesi. Yaş kısıtlamaları veya bu hizmeti uygunsuz kılan diğer koşullar gibi ayrıntılar için kullanılır. |
UnsupportedPartySizeOption
Kapsama alanı dışında kalan partiler için seçenekler.
| Alanlar | |
|---|---|
kind birleşik alanı. Kapsama alanı dışında kalan partiler için kullanılabilir seçenekler. kind aşağıdakilerden yalnızca biri olabilir: |
|
call_merchant |
Aralık dışında kalan parti büyüklükleri için işletme aranabilir. Kullanıcıya önceden tanımlanmış bir mesaj gösterilir. Gösterilecek örnek metin: {waitlist_rules.max_party_size} kişiden büyük gruplar için lütfen {phone} numaralı telefondan restoranı arayın. CallMerchant ayarlanmalı ancak boş olacaktır. |
UpdateAdsAccountLinkRequest
AdsAccountLinkingService.UpdateAdsAccountLink için istek mesajı.
| Alanlar | |
|---|---|
ads_account_link |
Zorunlu. Güncellenecek Ads hesabı bağlantısı. Güncellenecek AdsAccountLink'i tanımlamak için AdsAccountLink'in |
update_mask |
İsteğe bağlı. Güncellenecek alanların listesi. |
UpdateBookingRequest
google.maps.booking.v1alpha.Booking güncelleme isteği
| Alanlar | |
|---|---|
update_mask |
Güncellenecek tüm rezervasyon alanlarının alan maskesi |
booking |
Güncellenecek rezervasyon |
booking_failure |
Eşzamansız olarak onaylanan bir rezervasyon isteğinin işlenmesi başarısız olursa ve rezervasyonun durumu BAŞARISIZ olarak güncellenirse bu alan, işletme mantığı hatasını (ör. kullanıcının bu zamana çok yakın bir zamanda mevcut bir rezervasyonu var) yansıtmalıdır. Bu alan yalnızca rezervasyon durumu BAŞARISIZ olarak güncellenirken ayarlanmalı, aksi takdirde yoksayılmalıdır. |
UpdateMerchantRequest
Merchant güncelleme isteği.
| Alanlar | |
|---|---|
merchant |
Yeni satıcı verileri. |
update_mask |
Satıcı için güncellenecek alanlar. |
UpdateOrderRequest
google.maps.booking.v1alpha.Order güncelleme isteği
| Alanlar | |
|---|---|
update_mask |
Güncellenecek tüm sipariş alanlarının alan maskesi |
order |
Güncellenecek sipariş |
UpdateServiceRequest
Service güncelleme isteği.
| Alanlar | |
|---|---|
service |
Yeni hizmet verileri. |
update_mask |
Hizmet için güncellenecek alanlar. |
UriTemplate
Google'ın harici site URL'lerini nasıl oluşturacağını belirten bir şablon.
| Alanlar | |
|---|---|
uri_template |
İsteğe bağlı. URI şablonu RFC6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 2. düzey şablonları destekler. Bu parametreler, ilgili öğelerinde belirtilen değerlere dönüştürülür. Yemek rezervasyonu için yönlendirme bağlantısında kullanılabilen parametreler: 1) (zorunlu) {availability_slot_start_seconds} :: Stok durumu feed'indeki start_sec alanından doldurulur 2) (zorunlu) {resources_party_size} :: Stok durumu feed'indeki party_size alanından doldurulur 3) (isteğe bağlı) {availability_slot_duration_seconds} :: Stok durumu feed'indeki duration_sec alanından doldurulur 4) (isteğe bağlı) {availability_slot_availability_tag} :: Stok durumu feed'indeki availability_tag alanından doldurulur Kullanım örneği: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} Şu değerlerle: * start_sec = 123456 * party_size = 2 https://example.com/book/restaurant?start=123456&num_guests=2 |
UserPurchaseRestriction
Ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar.
| Alanlar | |
|---|---|
new_to_merchant |
Yalnızca daha önce aynı satıcıdan satın alma işlemi yapmamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneği. |
new_to_payment_option |
Daha önce aynı ödeme seçeneğini satın almamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneği. |
VirtualSession
Sanal/online oturum hakkında bilgiler. Ör. online yoga dersi, sanal yemek pişirme dersi vb.
| Alanlar | |
|---|---|
session_instructions |
Bu sanal sınıfın nasıl ayarlandığına ilişkin talimatlar. İş ortağı, rezervasyona video URL'sini dahil etmezse bu metinde video URL'sinin kullanıcıyla ne zaman paylaşılacağı belirtilmelidir. Ör. "Zoom URL'si, dersten 30 dakika önce e-postayla gönderilecektir." (Önerilir) |
session_requirements |
Belirli bir sanal oturumun şartları. Ör. yoga matı, mutfak gereçleri vb. (Önerilir) |
virtual_platform_info |
Bu oturumda kullanılan sanal platform hakkında bilgiler. (Sanal hizmetleri etkinleştirmek için gereklidir) |
is_session_prerecorded |
Zorunlu. Sanal oturum canlı değilse ve önceden kaydedilmişse bu değeri doğru olarak ayarlayın. |
VirtualPlatformInfo
Bu sanal oturumda kullanılacak platform hakkında bilgiler.
| Alanlar | |
|---|---|
platform |
Sanal oturum için kullanılan platform. |
other_platform_name |
Platform OTHER olarak ayarlanmışsa platformun adı. (Platform OTHER olarak ayarlandıysa zorunludur) |
Platform
Hangi sanal platformun satıcı tarafından kullanılacağını belirten enum.
| Sıralamalar | |
|---|---|
PLATFORM_UNSPECIFIED |
Kullanılmamış. |
FLEXIBLE |
Satıcı, hangi video platformunu kullanacağı konusunda esnektir. |
GOOGLE_HANGOUTS |
Google Hangouts ürünü. |
GOOGLE_MEET |
Google Meet ürünü. |
ZOOM |
Zoom Video Communications. |
SKYPE |
Skype. |
YOUTUBE |
YouTube'da canlı yayın yapma |
OTHER |
Kullanılan video platformu burada belirtilenlerden farklıysa ayarlanmalıdır. |
WaitlistRules
Bekleme listesine katılmayla ilgili kurallar.
| Alanlar | |
|---|---|
min_party_size |
Zorunlu. Bekleme listesi işlevi sunan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevi sunmuyorsa bu alan doldurulmamalıdır. |
max_party_size |
Zorunlu. Bekleme listesi işlevi sunan hizmetler için pozitif bir tam sayı olmalıdır. Hizmet veya satıcı bekleme listesi işlevi sunmuyorsa bu alan doldurulmamalıdır. |
supports_additional_request |
Doğruysa kullanıcı, bu hizmetin bekleme listesine katılırken serbest biçimli ek bir metin isteği gönderebilir. |
above_max_party_size_options[] |
Ayarlanan max_party_size değerinden daha büyük partiler için seçenekleri belirleyin. Daha büyük gruplara bekleme listesine katılmak için alternatif seçenekler sunulmaması gerekiyorsa boş bırakın. |