Gerçek zamanlı güncellemeler yapmak için Maps Booking API'ye istek göndermeniz gerekir. Haritalar Randevu API'si, API'ye erişimi olan ve gerekli sorgu sayısı/saniye (QPS) ayrılmış bir GCP hizmet hesabı kullanarak isteklerinizin kimliğini OAuth 2.0 üzerinden doğrulamanızı gerektirir. Bu rehberde aşağıdaki adımlar açıklanmaktadır:
- Google Cloud projenizi oluşturma
- Hizmet hesabı oluşturma
- GCP projenizde Maps Booking API'yi etkinleştirin
- Sık karşılaşılan sorunları ayıklama
API'ye nasıl istekte bulunacağınız hakkında bilgi edinmek için Fırsatlar kılavuzunun gerçek zamanlı API güncellemeleri bölümüne bakın.
Google Cloud projenizi İşlemler Merkezi ile ayarlama
- Google Cloud Platform hesabınızda oturum açın.
- Bu amaçla yeni bir proje oluşturabilir veya mevcut bir projeyi kullanabilirsiniz.
- Sonraki adımlarda ihtiyacınız olacağından lütfen bulut projesi numarasını not edin. Bulut projesi numaranızı Google Cloud Platform ana sayfasında da bulabilirsiniz. Bulut projesi numarası her zaman yalnızca sayısal değerlerden oluşur.
- Sonraki adımlarda ihtiyacınız olacağından lütfen bulut projesi numarasını not edin. Bulut projesi numaranızı Google Cloud Platform ana sayfasında da bulabilirsiniz. Bulut projesi numarası her zaman yalnızca sayısal değerlerden oluşur.
- İş Ortağı Portalı'na giriş yapın.
- İş Ortağı Portalı'nın İlk Katılım Görevleri sayfasında 1. adımı tamamlamak için bulut proje numarasını ve bulut proje e-posta adresini (bulut projesini yönetmek için kullanılan e-posta adresi) gönderin.
Hizmet hesabı ve OAuth kimlik bilgileri oluşturma
- Google Cloud Platform hesabınızda tekrar oturum açın.
- IAM ve yönetici > Hizmet hesapları'na gidin.
- Mevcut veya yeni oluşturduğunuz bulut projesi kimliğinizi arayın.
- Hizmet hesabı oluşturun.
- Hizmet hesabı ayrıntılarını doldurun.
- Yeni hizmet hesabına, uygulama ihtiyaçlarınıza en uygun rolü atayın. Hizmet hesabı için rol seçimi, Google Haritalar Booking API'ye hangi çağrıların yapılabileceğini etkilemez. Bunun yerine, bu çağrıların kullanılabilmesi için yeterli kotanın ayrılması, projenizin numarasının İşlemler Merkezi yapılandırmasında ilişkilendirilmesiyle belirlenir. Hangi rolü seçeceğinizden emin değilseniz Proje > Görüntüleyici'yi seçin.
- (6) numaralı adımda "Devam"ı tıkladıktan sonra JSON anahtarları oluşturma seçeneği sunulur.
- JSON kimlik bilgilerini kaydedin. Bu bilgileri daha sonra alamayacağınız için güvenli bir yerde sakladığınızdan emin olun.
- İş Ortağı Portalı'na tekrar giriş yapın ve İş Ortağı Portalı'nın İlk Katılım Görevleri sayfasındaki kalan görevleri tamamlayın.
MapsBooking API'yi etkinleştirme
- Google Cloud Platform hesabınızda oturum açın.
- API'ler ve Hizmetler > Kontrol Paneli'ne gidin.
- API'leri ve Hizmetleri Etkinleştir'i tıklayın ve
Google Maps Booking API.
araması yapın. - Aşağıdaki API'leri etkinleştirin:
- Google Maps Booking API
- Google Maps Booking API (Dev)
Yaygın Hatalar
Anlık güncelleme istekleri gönderirken yetkilendirme sorunları yaşamanızın çeşitli nedenleri olabilir. Gerçek zamanlı güncelleme istekleri yapma konusunda genel rehberliğe ihtiyacınız varsa Fırsatlar kılavuzumuzun Gerçek zamanlı API güncellemeleri bölümüne bakın. Ayrıca Kod Örnekleri bölümünde birden fazla dilde örnek istemciler bulabilirsiniz.
403 hatasıyla karşılaşıyorsanız aşağıdaki tüm koşulları karşıladığınızı kontrol edin:
- Google istemci kitaplığı kullanın.
- Hizmet Hesabı Kimlik Doğrulaması ile OAuth Kimlik Bilgileri oluşturun.
- Uygun kapsamda yetkilendirme yapın.
- Uygun uç noktayı (aşağıda listelenmiştir) arayın.
Doğru uç noktaya çağrı yaptığınızdan emin olun:
- Korumalı alan:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - Üretim:
https://mapsbooking.googleapis.com/v1alpha/...
OAuth kimlik bilgisi isteklerinizi doğru şekilde yetkilendirdiğinizden emin olun:
- "https://www.googleapis.com/auth/mapsbooking" kapsamına göre yetkilendirme yapıyorsunuz.
- Hizmet hesabı ve OAuth kimlik bilgileri oluşturma bölümünde oluşturulan hizmet hesabı anahtarını kullanıyorsunuz.
Hâlâ hata mı görüyorsunuz?
Bu adımları uyguladıktan sonra hâlâ hata görüyorsanız aşağıdaki bilgilerle birlikte İşlemler Merkezi'ndeki kişinize ulaşın:
- Cloud proje numarası ve proje kimliği ile ekran görüntüsü
- Hizmet hesabı kimliği
- Hizmet hesabını oluşturmak için kullanılan e-posta adresi
- İstek göndermeye çalışılan uç nokta ayrıntıları
- İstek denemelerinin zamanı
- İstek gönderirken alınan tam istek ve hata mesajları.