Temel kurulum

Devam etmek için şurada adımları tamamladığınızdan emin olun: Ön koşullar ve projenizi İşletme Profili için onaylamış olmamız API erişimi.

API'leri etkinleştirme

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

  • 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

Bu kursta anlatılanların hepsini Ön koşullar ve API'ye erişim izni verilmesine rağmen verilen kısayolu kullanmak için 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, yeni bir proje oluşturabilirsiniz. API kitaplığında mevcut tüm Ürün ailesine ve popülerliğe göre gruplandırılmış API'ler.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa aramayı kullanarak onu bulacağım.
  3. Etkinleştirmek istediğiniz API'yi seçin ve ardından Etkinleştir'i tıklayın. 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ği. Bu işlem, uygulamanızın Uygulamanızın kullanıcıları adına kuruluşunuzun konum verilerine erişme yetkisi.

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

Henüz yapmadıysanız "Kimlik bilgileri"ne gidin. Google API Konsolu'nu tıklayın ve Kimlik bilgileri oluştur > OAuth 2.0 kimlik bilgilerinizi oluşturmak için OAuth istemci kimliğinizi kullanın. Planınızı istemci kimliğinizi Kimlik Bilgileri sayfasında görebilirsiniz. Önce İstemci gizli anahtarı, yönlendirme URI'leri, JavaScript kaynak adresi ve e-posta gibi ayrıntılar için Client-ID girin.

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, bir yazılıma yönelik tutarlı ve pratik yaklaşıma sahip bir yazılım verileri talep etme ve değiştirme.

REST terimi, "Temsili Durum Aktarımı." Google API'leri bağlamında üzere HTTP fiillerinin kullanımına yönelik bir hizmet sunar.

RESTful sistem, kaynakları bir veri deposunda depolar. Bir istemci bir kaynağı oluşturma, alma, güncelleme veya silme gibi belirli bir işlemi gerçekleştirmek için kullanılan sunucu, Ardından sunucu işlemi gerçekleştirir ve bir yanıt gönderir. Bu yanıt genelde belirtilen kaynağın bir temsilidir.

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

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

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

Daha fazla HTTP 1.1 standartları belgelerindeki yöntem tanımları faydalı olur. Bunlar GET, POST, PUT ve DELETE.

İş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'lerinde görünür. Referans belgeler.

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), kullanıcıların fikir edinmek için kullandığı, dilden bağımsız bir veri biçimidir rastgele veri yapılarının basit metin temsilini sağlar. Daha fazla bilgi için bkz. json.org

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

URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için OAuth 2.0 Oyun Alanı İşletme Profili API'leriyle denemeler yapın. İşletme Profili API'leri bu API herkese açık API'ler değilse, bunları Playground'da kullanmak için gerçekleştirmeniz gereken birkaç ek adım vardır. Siz devam etmek için bir web uygulamasının istemci kimliği gerekir.

  1. Google API Konsolu'na gidin. ve projenizi açın. Web uygulamaları için OAuth istemci kimliğiniz yoksa istemci kimliği oluşturun şimdi:
    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 - Seçin ve API'leri yetkilendir" aşağıdaki kapsamı, Kendi kapsamlarınızı girin alanına İşletme Profili API'lerini girin:

    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" aşağıdaki URI'yı şuraya yapıştırın: İstek URI'si alanı: 

    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ürlerdeki isteklerin nasıl yapılacağıyla ilgili daha fazla bilgi için bkz. Business Profile API Referansı.

İstemci kitaplıkları

Business Profile API'leri istemci kitaplıkları, Business Profile API'lerinin işlevlerini destekler. Bu özellikler tüm Google API'lerinde ortak kullanılan HTTP taşıma, hata işleme, kimlik doğrulama ve daha fazla bilgi edineceksiniz.

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