Haritalar Rezervasyon API'si ile kimlik doğrulama

Gerçek zamanlı güncellemeler yapabilmek için Haritalar Rezervasyon API'sine istek göndermeniz gerekir. Maps Reservation API, API'ye erişimi olan ve gerekli QPS'ye ayrılmış bir GCP hizmet hesabını kullanarak isteklerinizin kimliğini OAuth 2.0 üzerinden doğrulamanızı gerektirir. Bu kılavuzda şu adımlarla karşılaşacaksınız:

1. Google Cloud projenizi oluşturun
2. Hizmet hesabı oluşturma
3. GCP projenizde Maps Reservation API'yi etkinleştirme
4. Sık karşılaşılan sorunlarda hata ayıklama

API'ye nasıl istekte bulunacağınız hakkında bilgi edinmek için Randevular Uçtan Uca kılavuzunun gerçek zamanlı API güncellemeleri bölümüne bakın.

Actions Center ile Google Cloud projenizi oluşturma

Not: İş Ortağı Portalı hesabınızı zaten oluşturduysanız kurulum kapsamında girilen Google Cloud projesini kullanmanız gerekir. Söz konusu Google Cloud Platform projesine artık erişiminiz yoksa veya projeyi tanımlama konusunda yardıma ihtiyacınız varsa Actions Center temsilcinizle iletişime geçin.

1. Google Cloud Platform hesabınıza giriş yapın.
2. Bu amaçla yeni bir proje oluşturabilir veya mevcut bir projeyi kullanabilirsiniz.
   • Sonraki adımlarda ihtiyaç duyacağınız bulut proje numarasını lütfen not edin. Cloud proje numaranız Google Cloud Platform Ana Sayfası'nda da bulunabilir. Bulut proje numarası her zaman yalnızca sayılardan oluşur.
3. İş Ortağı Portalı'na giriş yapın.
4. Bulut proje numarasını ve bulut projesi e-posta adresini (bulut projesini yönetmek için kullanılan e-posta adresi) göndererek İş Ortağı Portalı'nın İlk Katılım Görevleri sayfasındaki 1. adımı tamamlayın.

Hizmet Hesabı ve OAuth kimlik bilgileri oluşturma

Not: Bu adımlar, ilk katılım görevleri adımlarında girilen geliştirici e-posta adresinin bulunduğu hesap tarafından uygulanmalıdır.

1. Google Cloud Platform hesabınıza tekrar giriş yapın.
2. IAM ve yönetici > Hizmet hesapları'na gidin.
3. Mevcut veya yeni oluşturulan bulut projesi kimliğinizi arayın.
4. Bir hizmet hesabı oluşturun.
5. Hizmet hesabı ayrıntılarını doldurun.
6. Yeni hizmet hesabına, uygulama ihtiyaçlarınıza en uygun rolü atayın. Hizmet hesabı rolünün seçilmesi, Google Haritalar Rezervasyon API'sine yapılan çağrıları etkilemez. Çünkü bunların kullanılması için yeterli kotanın ayrılması, bunun yerine Actions Center yapılandırmasında proje numaranızın ilişkilendirilmesiyle belirlenir. Hangi rolü seçeceğinizden emin değilseniz Proje > Görüntüleyen seçeneklerini belirlemeniz yeterlidir.
7. 6. adımda "Devam"ı tıkladıktan sonra JSON anahtarları oluşturma seçeneği sunulur.
8. JSON kimlik bilgilerini kaydedin. Bunları daha sonra geri alamayacağınız için güvenli bir yerde sakladığınızdan emin olun.
9. İş Ortağı Portalı'na tekrar giriş yapın ve İş Ortağı Portalı'nın İlk Katılım Görevleri sayfasında kalan görevleri tamamlayın.

MapsRezervasyon API'sini etkinleştirme

1. Google Cloud Platform hesabınıza giriş yapın.
2. API'ler ve Hizmetler > Kontrol Paneli'ne gidin.
3. API'leri ve Hizmetleri Etkinleştir'i tıklayıp Google Maps Booking API araması yapın.
4. Aşağıdaki API'leri etkinleştirin:
   • Google Maps Booking API
   • Google Maps Reservation API (Dev)

Not: İlk katılım adımlarını tamamladıysanız ve mevcut bulut projenizi yeni bir projeye güncellemek istiyorsanız lütfen Actions Center temsilcinizle iletişime geçin.

Yaygın Hatalar

Gerçek Zamanlı Güncelleme isteklerinde bulunurken yetkilendirme sorunlarıyla karşılaşmanızın çeşitli nedenleri olabilir. Gerçek Zamanlı Güncelleme isteklerinin nasıl yapılacağıyla ilgili genel yardıma ihtiyacınız varsa Randevular Uçtan Uca kılavuzunun gerçek zamanlı API güncellemeleri bölümünü inceleyin. Ayrıca Kod Örnekleri bölümünde birden çok dilde örnek istemcileri de bulabilirsiniz.

403 hatalarıyla karşılaşıyorsanız aşağıdaki gereksinimlerin tümüne uyduğunuzdan emin olun:

1. Google İstemci Kitaplığı kullanın.
2. Hizmet Hesabı Yetkilendirmeyi kullanarak OAuth Kimlik Bilgileri oluşturun.
3. Uygun kapsam ile yetki verin.
4. Uygun uç noktaya (aşağıda listelenmiştir) çağrı yapın.

Doğru uç noktaya çağrı yaptığınızdan emin olun:

1. Korumalı alan: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
2. Üretim: https://mapsbooking.googleapis.com/v1alpha/...

OAuth kimlik bilgisi isteklerinizi doğru şekilde yetkilendirdiğinizden emin olun:

1. "https://www.googleapis.com/auth/mapsbooking" kapsamı için yetkilendirme yapıyorsunuz.
2. Hizmet Hesabı ve OAuth kimlik bilgileri oluşturma bölümünde oluşturulan hizmet hesabı anahtarını kullanıyorsunuz.

Hâlâ hata görüyor musunuz?

Bu adımları uyguladıktan sonra hata görmeye devam ederseniz aşağıdaki bilgilerle Actions Center sorumlunuza ulaşın:

• Ekran görüntüsüyle birlikte Cloud proje numarası ve proje kimliği
• Hizmet hesabı kimliği
• Hizmet hesabını oluşturmak için kullanılan e-posta adresi
• Uç nokta ayrıntıları,
• İstek deneme zamanı
• İstek gönderilirken alınan tüm istek ve hata mesajları.