Looker Studio API'sı

Looker Studio API'si, Looker Studio öğelerini aramanıza ve yönetmenize olanak tanır.

API'nin birincil kullanım alanı, Google Workspace veya Cloud Identity kuruluşlarının Looker Studio öğelerinin yönetimini ve taşımasını otomatikleştirmesine izin vermektir.

Şartlara genel bakış

Looker Studio API'sini kullanmak için aşağıdaki adımların uygulanması gerekir:

  1. API'yi kullanmak için bir uygulama yapılandırın.
  2. Uygulamayı yetkilendirmek için Google Yönetici Konsolu'nu kullanın.
  3. OAuth 2.0 erişim jetonları alın ve API'yi çağırın.

Yukarıdaki adımlar, aşağıdaki yaygın senaryolara göre aynı veya farklı kuruluşlar tarafından gerçekleştirilebilir:

  • Bir kuruluş için geliştirilmiş dahili uygulamalar. Kuruluş, kuruluşun tüm kullanıcıları için uygulamayı yapılandırır ve yetkilendirir.
  • Harici kullanıcılar/müşteriler için geliştirilen üçüncü taraf uygulamaları (geliştirici ve kullanıcılar farklı kuruluşlara aittir). Geliştirici, uygulamayı yapılandırır ancak kullanıcının kuruluşu üçüncü taraf uygulamasını yetkilendirir.

1. Uygulamayı API kullanacak şekilde yapılandırma

Uygulamanızı yapılandırmak için aşağıdaki adımları uygulayın:

API'yi etkinleştirme

Projenizde bir API'yi etkinleştirmek için:

  1. Google API Konsolu'nda Looker Studio API'sini açın.
  2. İstenirse bir proje seçin veya yeni proje oluşturun.
  3. Etkinleştir'i tıklayın.
  4. İstenirse API'nin Hizmet Şartları'nı okuyup kabul edin.

OAuth İstemcisi Oluşturma

Aşağıdaki, OAuth İstemci oluşturma adımları genel yönergelerdir ve uygulama şartlarını karşılayacak şekilde ayarlanmalıdır.

  1. OAuth izin ekranını yapılandırma'ya gidin.
    1. Dahili'yi seçin ve Oluştur'u tıklayın.
    2. Zorunlu alanları doldurun, Kaydet'i tıklayın.
  2. Credentials'a (Kimlik Bilgileri) gidin.
    1. BİLDİRİM OLUŞTUR'u tıklayın.
    2. OAuth istemci kimliği'ni seçin.
    3. Uygun Application Type öğesini seçin. (Web uygulaması en yaygın olanlarıdır).
    4. Zorunlu alanları doldurun, Oluştur'u tıklayın.
  3. Uygulamayı yetkilendirmek için kullanıldığından Client ID'yi not edin.

2. Uygulamayı bir kuruluş için yetkilendirme

Looker Studio API'sini kullanan uygulamalar, yalnızca kullanıcının kuruluşuna API erişimini kontrol etmek için alan genelinde yetki verme yetkisi verdiği Google Workspace alanlarında kimlik doğrulaması yapabilir ve bu kullanıcıları yetkilendirebilir.

Alan genelinde yetki'yi uygulamanın OAuth İstemci Kimliği ve uygulamanın gerektirdiği Kapsamlar ile yapılandırın.

  1. Google Yönetici Konsolunuzda oturum açın ve alan genelinde yetki bölümüne gidin.
  2. API clients bölümünde Yeni ekle'yi tıklayın.
  3. Yetkilendirilecek uygulamanın Client ID değerini (Looker Studio API'sini kullanan uygulama) girin.
  4. Uygulama için gereken tüm OAuth kapsamlarını girin. Öğeleri yönetmek için Looker Studio API'yi kullanıyorsanız genellikle aşağıdaki kapsamlar istenir:
    • https://www.googleapis.com/auth/datastudio
    • https://www.googleapis.com/auth/userinfo.profile
  5. Yetkilendir'i tıklayın.

Uygulamayı yetkilendirdikten sonra, kuruluşa ait tüm Workspace kullanıcıları uygulamayı Looker Studio API'si ile kullanma yetkisini otomatik olarak alır.

3. OAuth 2.0 erişim jetonları alma ve API'yi çağırma

Uygulamayı geliştirip yetkilendirdikten sonra Workspace kullanıcılarına API'yi çağırmak için gerekli erişim düzeyine sahip olursunuz. OAuth kullanarak Google API'leriyle çalışma hakkında ayrıntılı bilgi için Google API'lerine Erişmek için OAuth 2.0'ı Kullanma bölümüne bakın. Kullanılabilir işlemler için API referansına bakın.

Sorun giderme

OAuth iletişim kutusu yok

Bir kullanıcının kuruluşu uygulamayı yetkilendirdiyse söz konusu kuruluşun kullanıcıları uygulamaya yetki verirken OAuth iletişim kutusu gösterilmez. Tek istisna, uygulamanın Workspace Yöneticisi'nin yapılandırmadığı ek Google API kapsamları için yetkilendirme istemesidir. Bu durumda, kullanıcılara OAuth iletişim kutusu gösterilir.

Hata 400: invalid_scope

Bir kullanıcı uygulamayı yetkilendirmeye çalışırken Error 400: invalid_scope mesajı alırsa kullanıcının kuruluşu uygulamaya yetki vermemiş veya yanlış cevap vermiş olur. Sorunu çözmek için kullanıcının kuruluşundan uygulamayı yetkilendirmesini istemesi gerekir.

Geçersiz bir kapsam istendiğini belirten bir OAuth 400 hata mesajı