Sisteminizdeki envanter, satıcılarınızın yaptığı yeni rezervasyonlar, iptaller ve program değişiklikleri nedeniyle değişir. Anlık Güncelleme (RTU) API'si, Google'ı bu değişiklikler ve mevcut rezervasyonlarda yapılan değişiklikler hakkında bilgilendirme mekanizmasıdır.
RTU'lar aşağıdaki durumlarda gereklidir:
- Bir kullanıcı sisteminizde rezervasyonu iptal ettiğinde ve yer kullanıma sunulduğunda
- Bir kullanıcı Actions Center üzerinden rezervasyon yaptığında ve yer artık müsait olmadığında.
- İşlemler Merkezi üzerinden yapılan bir rezervasyon sizin tarafınızdan iptal edildiğinde Doğrudan satıcı tarafından yapılan iptaller örnek durumlardandır. Orijinal zaman aralığı artık kullanılabilir olduğundan rezervasyonu ve stok durumunu güncellemeniz gerekir.
Sandbox incelemesine geçmeden önce aşağıdaki RTU ara hedef görevini tamamlayın:
Her görev tamamlandı olarak işaretlenir ve son 20 istek 14 gün boyunca hatasız olduğunda yeşile döner. Dönüm noktasının yeşil kalmasını sağlamak için başarılı istekler göndermeye devam edin.
API RTU ve Feed'ler
API RTU'ları, envanter kullanılabilirliği ve rezervasyonlardaki artımlı değişiklikler hakkında Google'ı gerçek zamanlı olarak bilgilendirir. RTU'lara ek olarak, kullanılabilirlik feed'lerini her gün eksiksiz olarak gönderin. Bu sayede Google, sisteminizdeki en doğru ve en güncel stok durumu bilgilerine sahip olur. Tam feed'ler, sisteminizdeki envanter stok durumunun anlık görüntüsü olarak işlev görür.
Daha fazla bilgi için aşağıdaki kaynaklara bakın:
API'ye erişme
Google Cloud projeniz, RTU'ları göndermek için kullandığınız İşlemler Merkezi'nin Haritalar Randevu API'sine erişmek için kullandığınız yerdir. Google Developers Console'da bir Google Hesabı kullanmanız ve oryantasyon planınızın Kurulum aşamasında Cloud Proje Numaranızı sağlamanız gerekir. Cloud API'leri etkinleştirme hakkında daha fazla bilgi için Cloud API'leri etkinleştirme başlıklı makaleyi inceleyin.
RESTful çağrıları kullanma veya istemci kitaplığını indirme
JSON yükleriyle doğrudan Haritalar Rezervasyon API'sine RESTful çağrılar yapmanızı öneririz. Daha fazla bilgi için REST API belgelerine bakın.
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 istemci talimatları başlıklı makaleyi inceleyin. |
Google API'lerine yapılan çağrıların yetkilendirme ve diğer yönlerini ele alan ek destek kitaplıkları indirilebilir. Daha fazla bilgi için Kod Örnekleri bölümüne bakın.
Keşif dokümanını getirme
Ruby gibi bazı istemci kitaplıklarında, yöntemlerini ve parametrelerini açıklayan API'nin Discovery belgesinin getirilmesi gerekir.
Discovery belgesini getirmek için aşağıdaki komutu kullanın:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
API'ye Ruby'den erişme hakkında daha fazla bilgi için Ruby API İstemcisi ve Ruby Auth Kitaplığı başlıklı makalelere bakın.
API'ye yetkili çağrılar yapma
API'ye çağrı yaparken hizmet hesabınızı özel anahtarınızla ve aşağıdaki OAuth kapsamıyla yetkilendirmek için Temsilci API çağrısı yapmaya hazırlanma başlıklı makaleyi inceleyin:
https://www.googleapis.com/auth/mapsbooking
Korumalı alan ve üretim uç noktaları
API aracılığıyla hem korumalı alan hem de üretim ortamlarına çağrı yapabilirsiniz. Google Cloud projenizde her iki API'yi de etkinleştirdiğinizden emin olun. İki API de aynı kapsamı kullanır ancak farklı uç noktaları vardı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ğine dair Java dilinde bir örnek 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()