Sisteminizdeki envanter, satıcılarınızdan gelen yeni rezervasyonlar, iptaller ve plan değişiklikleri nedeniyle gün içinde dalgalanma gösterir. Gerçek zamanlı güncelleme API'si, envanter kullanılabilirliğindeki bu değişiklikler hakkında Google'ı bilgilendirmek için kullanılan bir mekanizmadır. Ayrıca, mevcut rezervasyonlarda yapılan değişiklikleri Google'a bildirmek için gerçek zamanlı API güncellemelerini kullanabilirsiniz.
Gerçek zamanlı API güncellemeleri ve özet akışları
API gerçek zamanlı güncellemeleri, envanter kullanılabilirliği ve rezervasyonlarda gerçekleşen artımlı değişiklikleri Google'a gerçek zamanlı olarak bildirmek için kullanılır. Gerçek zamanlı API güncellemelerinin yanı sıra Google'ın sisteminizde mevcut olan kullanılabilirlik hakkında en doğru ve güncel bilgilere sahip olması için eksiksiz Kullanılabilirlik feed'lerini her gün gönderin. Tam feed'ler, sisteminizdeki envanter kullanılabilirliğinin mevcut durumunun anlık görüntüsü olarak görev yapar.
API güncellemeleri, satıcılar ve hizmetler hakkındaki bilgiler gibi feed'ler tarafından sağlanan tüm bilgileri güncellemek için kullanılabilse de genellikle yalnızca stok durumu bilgilerini güncellemek için kullanılır.
Gerekli Gerçek zamanlı güncelleme API'leri
Gerçek zamanlı güncelleme (RTU) API'leri | ||
---|---|---|
BookingNotification | Zorunlu | Rezervasyonda bir değişiklik olduğunda (ör. değişiklikler veya iptaller) Reservation Notification RTU'lar gönderin. |
Kullanılabilirlik RTU'yu değiştir | Koşula bağlı olarak gerekli[1] | Envanter kullanılabilirliğiyle ilgili güncellemeler göndermek için toplu değiştirme veya tek değiştirme RTU'ları gönderin. Değişikliklerin uygulanması ve yansıtılması birkaç dakika sürebilir. |
Satıcı RTU'su | İsteğe bağlı | Satıcı bilgilerinde gerçek zamanlı olarak değişiklik yapmak istiyorsanız Satıcı RTU'larını gönderin. Değişikliklerin uygulanması ve yansıtılması birkaç saat sürebilir. |
Hizmet RTU'su | İsteğe bağlı | Hizmet bilgilerinde gerçek zamanlı olarak değişiklik yapmak istiyorsanız Hizmet RTU'ları gönderin. Yaygın bir kullanım alanı, hizmet fiyatlarında gün içinde önemli dalgalanmalar yaşanmasıdır. Fiyat uyuşmazlığından kaynaklanan sipariş hatalarını önlemek için Hizmet RTU'larının uygulanması önerilir. Değişikliklerin uygulanması ve yansıtılması birkaç saat sürebilir. |
Kullanılabilirlik Değiştirme API RTU
Aşağıdaki kullanım durumlarında müsaitlik durumu güncellemeleri sağlamak için AvailabilityReplace API'yi kullanın:
- Bir kullanıcı, sisteminizde rezervasyon yaptırdığı için müsaitlik durumu artık kullanılamaz.
- Bir satıcı, sisteminizdeki stok durumunu değiştirir.
- Bir kullanıcı, Google üzerinden rezervasyon yaptırdığı için müsaitlik durumu artık kullanılamaz.
- Google üzerinden yapılan bir rezervasyon sizin tarafınızdan (örneğin, doğrudan satıcı tarafından) iptal edilir. Orijinal alan artık tekrar kullanılabilir olduğundan rezervasyonu ve müsaitlik durumunu güncellemeniz gerekir.
- Rezervasyon sunucusu
BatchAvailabilityLookup
çağrısı, gerçek envanterle eşleşmeyen envanteri döndürür.
Daha fazla bilgi için aşağıdaki kaynaklara bakın:
- Eğitim: Gerçek zamanlı güncellemeleri yapılandırma
- RESTful çağrıları kullanarak gerçek zamanlı güncellemeler için Java istemci örneği
- Envanter güncelleme API'si referans sayfası
Rezervasyon Bildirimi API'si RTU
Reservation Notification API'ler mevcut rezervasyonlarda yapılan güncellemeler hakkında Google'ı bilgilendirir. İptal işlemiyle ilgili bir güncelleme gönderirken updateMask
sorgu parametresi ile istekteki yalnızca temel bilgileri gönderin. Örnek:
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"CANCELED"}
API'ye erişme
Hizmet hesabı oluşturma
Hizmet hesabı oluşturmak için Google API Konsolu'ndaki Kimlik Bilgileri sekmesini kullanın. Özel anahtarı JSON biçiminde güvenli bir yerde saklayın. Hesabı oluşturduğunuzda rolü "Sahip" olarak ayarlayabilirsiniz.
Haritalar Rezervasyon API'lerinin kimliğini doğrulama
Bir hizmet hesabı oluşturduktan sonra aşağıdaki API'lerin kimliğini doğrulayın:
- Google Maps Booking API
- Google Haritalar Rezervasyon API'si (Dev)
Bunu nasıl yapacağınızla ilgili adım adım açıklamalı kılavuz için Haritalar Rezervasyon API'si ile Kimlik Doğrulama eğiticisini inceleyin.
RESTful arama kullanma veya istemci kitaplığını indirme
JSON yükleriyle doğrudan Maps Reservation API'ye RESTful çağrılar yapmanızı öneririz. Daha fazla bilgi için REST API belgelerini inceleyin.
API'ye bağlanmak için istemci kitaplıklarını da kullanabilirsiniz.
Dil | İndirme bağlantısı |
---|---|
Java | Java istemci kitaplığı. Daha fazla bilgi için Java istemcisi talimatlarına bakın. |
Yetkilendirmeyi ve Google API'lerine yapılan çağrıların diğer özelliklerini işleyen ek destek kitaplıkları indirilebilir. Gerekirse bu örneklere göz atın.
Keşif dokümanını getir
Ruby gibi bazı istemci kitaplıkları için API'nin yöntemlerini ve parametrelerini açıklayan Keşif belgesinin getirilmesi gerekir.
Keşif dokümanını getirmek için aşağıdaki komutu kullanın:
curl -s -o 'mapsbooking_rest' 'https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha'
Ruby'den API'ye erişme hakkında daha fazla bilgi edinmek için şu bağlantıları takip edin: Ruby API İstemcisi ve Ruby Auth Library.
API'ye yetkili çağrılar yapma
API'ye çağrı yaptığınızda hizmet hesabınızı özel anahtarınız ve şu OAuth kapsamıyla yetkilendirmek için Yetkili bir API çağrısı yapmak için hazırlanma bölümüne bakın: https://www.googleapis.com/auth/mapsbooking
.
API kotaları
API güncellemelerinin kotası her 60 saniyede 1.500 veya saniyede ortalama 25 istektir. Bir kota aşıldığında (İş Ortağı Portalınıza doğru Google Cloud Proje numarasını eklemediğinizde meydana gelebilir) Google, aşağıdaki hata mesajıyla yanıt verir:
{ "error": { "code": 429, "message": "Insufficient tokens for quota ...", "status": "RESOURCE_EXHAUSTED", "details": [...] } }
Bunu başarmak için, işlem başarılı olana kadar katlanarak daha büyük aralıklarda çağrıyı tekrar deneyin. Kotayı düzenli olarak ReplaceServiceAvailability
ile tüketiyorsanız API çağrılarının sayısını azaltmak için BatchReplaceServiceAvailabily
sürümüne geçin. Bu yöntem, tek bir API çağrısında birden fazla hizmeti güncellemenize olanak tanır.
Korumalı Alan ve Üretim Uç Noktaları
API aracılığıyla hem korumalı alana hem de üretim ortamlarına çağrı yapabilirsiniz. Google Cloud projenizde her iki API'yi de etkinleştirdiğinizden emin olun. Bu API'lerin ikisi de aynı kapsamı kullanır ancak uç noktaları farklıdır.
Üretim uç noktası: https://mapsbooking.googleapis.com/
Korumalı alan uç noktası: https://partnerdev-mapsbooking.googleapis.com/
Aşağıda, uç noktaların nasıl değiştirileceğini gösteren bir Java örneği verilmiştir:
// This block of code is for OAuth and is the same for prod and sandbox. GoogleCredential .fromStream(new FileInputStream(...)) .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking")) // This block of code sets the endpoint. This is what you'd change to connect to the sandbox. new GoogleMapsBookingAPI.Builder(...) .setApplicationName(...) .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev. .build()