Temel kurulum

Devam etmek için Ön koşullar bölümündeki adımları tamamladığınızdan ve projenizi İşletme Profili API'lerine erişimi için onayladığımızdan emin olun.

API'leri etkinleştirme

İşletme Profili ile ilişkilendirilmiş ve Google API Console'da etkinleştirilmesi gereken sekiz API vardır:

  • Google My Business API
  • Benim İşletmem Hesabı Yönetim API'si
  • Benim İşletmem Lodging API'si
  • Benim İşletmem Yer İşlemleri API'si
  • My Business Notifications API
  • Benim İşletmem Doğrulamaları API'si
  • Benim İşletmem Bilgileri API'si
  • Benim İşletmem Soru-Cevap API'si

Bir API'yi etkinleştirin

Tüm Ön Koşulları tamamlamanıza ve API'ye erişmenize izin verilmesine rağmen sağlanan kısayolu hâlâ kullanamıyorsanız aşağıdaki adımları uygulayarak API'yi manuel olarak etkinleştirebilirsiniz.

Projeniz için bir API'yi etkinleştirmek üzere şunları yapın:

  1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse bir proje seçin ya da yeni proje oluşturun. API Kitaplığı, mevcut tüm API'leri ürün ailesine ve popülerliğe göre gruplandırılmış olarak listeler.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa bulmak için arama işlevini kullanın.
  3. Etkinleştirmek istediğiniz API'yi seçin ve Etkinleştir düğmesini tıklayın.
  4. İstenirse faturalandırmayı etkinleştirin.
  5. İstenirse API'nin Hizmet Şartları'nı kabul edin.

Google Workspace kullanıcısıysanız Google Workspace kuruluşunuzda Google İşletme Profili'nin hesabınız için etkin olduğunu onaylayın. Google Workspace kuruluşunuzdaki hesabınız için Google İşletme Profili devre dışı bırakıldıysa GBP API'lerini kullanırken "hata 403 - İZİN REDDEDİLDİ" ifadesini alırsınız.

OAuth 2.0 istemci kimliği isteyin

Uygulamanız herkese açık olmayan korumalı verilere eriştiği için OAuth 2.0 istemci kimliğine ihtiyacınız vardır. Bu işlem, uygulamanızın kullanıcıları adına kuruluşunuzun konum verilerine erişmek için yetkilendirme istemesine olanak tanır.

Uygulamanız, gizli kullanıcı verilerine erişen tüm İşletme Profili API'leri istekleriyle birlikte bir OAuth 2.0 jetonu göndermelidir.

Henüz yapmadıysanız Google API Konsolu'nun "Kimlik bilgileri" bölümüne gidin ve Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayarak OAuth 2.0 kimlik bilgilerinizi oluşturun. Kimlik bilgilerini oluşturduktan sonra istemci kimliğinizi Kimlik bilgileri sayfasında görebilirsiniz. İstemci gizli anahtarı, yönlendirme URI'leri, JavaScript kaynak adresi ve e-posta adresi gibi ayrıntılar için istemci kimliğini tıklayın.

REST ile ilgili temel bilgileri öğrenin

API'leri çağırmanın iki yolu vardır:

İstemci kitaplıklarını kullanmamaya karar verirseniz REST ile ilgili temel bilgileri öğrenmeniz gerekir.

REST, verileri istemek ve değiştirmek için kullanışlı ve tutarlı bir yaklaşım sunan yazılım mimarisi tarzıdır.

REST terimi, "Representational State Transfer"in (Temsili Durum Aktarımı) kısaltmasıdır. Google API'leri bağlamında bu, Google tarafından depolanan verilerin temsillerini almak ve değiştirmek için HTTP fiillerinin kullanımını belirtir.

RESTful sistem, kaynakları bir veri deposunda depolar. İstemciler kaynak oluşturma, alma, güncelleme veya silme gibi belirli bir işlemi gerçekleştirmesi için sunucuya istek gönderir. Sunucu, işlemi gerçekleştirir ve yanıt gönderir. Bu yanıt genellikle belirtilen kaynağın bir temsili şeklindedir.

Google'ın RESTful API'lerinde istemci, HTTP fiili olan bir işlem (ör. GET, POST, PUT veya DELETE) belirtir. İstemci, bir kaynağı aşağıdaki biçimdeki global olarak benzersiz tekdüzen kaynak tanımlayıcısı (URI) ile belirtir:

https://apiName.googleapis.com/apiVersion/resourcePath?parameters

Tüm API kaynaklarının HTTP tarafından erişilebilen benzersiz URI'leri olduğundan REST, veri önbelleğe almayı etkinleştirir ve web'in dağıtılan altyapısıyla çalışacak şekilde optimize edilir.

HTTP 1.1 standartları belgelerindeki yöntem tanımlarını faydalı bulabilirsiniz. Bunlar GET, POST, PUT ve DELETE özelliklerini içerir.

İşletme Profili API'lerinde REST

İşletme Profili API'leri işlemleri doğrudan REST HTTP fiilleriyle eşlenir.

İşletme Profili API'lerine özel biçim aşağıdaki URI'da gösterilir:

https://apiName.googleapis.com/apiVersion/resourcePath?parameters

API'lerde desteklenen her işlem için kullanılan URI'ların tamamı, İşletme Profili API'leri Referans belgelerinde yer alır.

Kaynak yolları uç noktaya göre değişiklik gösterir.

Örneğin, bir hesabın kaynak yolu aşağıdaki örnekte olduğu gibi görünür:

accounts/accountId

Bir konumun kaynak yolu aşağıdaki biçimde görünür:

locations/locationId

JSON ile ilgili temel bilgileri öğrenin

Business Profile API'leri, verileri JSON biçiminde döndürür.

JavaScript Object Notation (JSON), rastgele veri yapılarının basit metin temsilini sağlayan, yaygın ve dilden bağımsız bir veri biçimidir. Daha fazla bilgi için json.org adresine bakın.

Basit bir HTTP isteği oluşturmak için Oauth Playground'u kullanma

İşletme Profili API'leriyle denemeler yapmak için OAuth 2.0 Playground'u kullanabilirsiniz. Business Profile API'leri herkese açık API olmadığından, bunları Playground'da kullanmak için gerçekleştirmeniz gereken birkaç ek adım vardır. Devam etmek için web uygulamasının istemci kimliğine ihtiyacınız vardır.

  1. Google API Konsolu'na gidip projenizi açın. Web uygulamaları için OAuth istemci kimliğiniz yoksa hemen bir tane oluşturun:
    1. Kimlik bilgileri oluştur açılır listesinden OAuth istemci kimliği'ni seçin.
    2. Uygulama türü için Web Uygulaması'nı tıklayın.

    3. Aşağıdakini geçerli bir yönlendirme URI'si olarak ekleyin:

       https://developers.google.com/oauthplayground
    4. Oluştur'u tıklayın.
  2. İstemci kimliğini panoya kopyalayın.
  3. OAuth 2.0 Playground'a gidin.
  4. Yapılandırma seçeneklerini açmak için dişli simgesini tıklayın ve aşağıdaki değişiklikleri yapın:
    1. OAuth akışı ayarını İstemci tarafı olarak belirleyin.
    2. Kendi OAuth kimlik bilgilerinizi kullanın seçeneğini belirleyin.
    3. OAuth istemci kimliğinizi yapıştırın.
  5. Yapılandırma seçeneklerini kapatın.

  6. "1. Adım - API'leri seçme ve yetkilendirme" bölümünde İşletme Profili API'leri için aşağıdaki kapsamı Kendi kapsamlarınızı girin alanına yapıştırın:

    https://www.googleapis.com/auth/business.manage
  7. API'leri Yetkilendir'i tıklayın.
  8. İstendiğinde Kabul et'i tıklayın.

  9. "2. Adım - API isteğini yapılandırın" bölümünde, aşağıdaki URI'yı İstek URI'si alanına yapıştırın: 

    https://mybusinessaccountmanagement.googleapis.com/v1/accounts
  10. İsteği gönder'i tıklayın. Yanıtta 200 OK durumu gösterilir.

Çeşitli türlerde istek gönderme hakkında daha fazla bilgi edinmek için Business Profile API Referansı'nı inceleyin.

İstemci kitaplıkları

Business Profile API'leri istemci kitaplıkları, Business Profile API'lerinin işlevlerini destekler. HTTP taşıma, hata işleme, kimlik doğrulama ve JSON ayrıştırma gibi, tüm Google API'lerinde ortak olan işlevleri sunarlar.

İstemci kitaplıklarını indirmek için Kitaplıklar başlıklı makaleyi inceleyin.