API erişimini ayarlama

SDK veya REST ile Veri Yöneticisi API'sine erişimi nasıl ayarlayacağınız aşağıda açıklanmıştır.

İzlemek istediğiniz kurulum sürecini seçin:

Ön koşullar

Data API'yi kullanabilmek için aşağıdakilere sahip olduğunuzdan emin olun:

  1. Bir Google Cloud projesi.
  2. Google Cloud projenizde serviceusage.services.enable iznine sahip bir Google Hesabı veya bu izni içeren bir role sahip olmanız gerekir. Örneğin, roles/owner ve roles/serviceusage.serviceUsageAdmin izinlerinin her ikisinde de serviceusage.services.enable izni bulunur. İzinlerinizi kontrol etmek için Mevcut erişimi görüntüleme başlıklı makaleyi inceleyin.
  3. Google Cloud komut satırı arayüzü yüklü olmalıdır.

API'yi etkinleştirme

Henüz yapmadıysanız Enable the Data Manager API'yi (Data Manager API'yi etkinleştir) tıklayarak Data Manager API'yi etkinleştirin veya bu adımı manuel olarak gerçekleştirmek için talimatları uygulayın.

Data Manager API'yi etkinleştirme

Veri Yöneticisi API'sini bulamıyorsanız veya Veri Yöneticisi API'sini etkinleştirme işlemi başarısız olursa Google Hesabınızın ön koşulları karşıladığını doğrulayın.

Kimlik doğrulama ayarlama

API anahtarlarının yanı sıra Google'daki kimlik doğrulama yöntemlerinden herhangi birini kullanabilirsiniz. Kullanım alanınıza uygun yaklaşımı belirlemek için Kullanım alanınıza uygun kimlik doğrulama yöntemini seçme başlıklı makaleyi incelemenizi öneririz.

İki yaygın kimlik doğrulama yöntemi kullanıcı hesapları ve hizmet hesaplarıdır:

  • Kullanıcı hesapları: Doğrudan Google API'leri ve hizmetleriyle etkileşim kuran kişileri temsil eder.
  • Hizmet hesapları: Kullanıcı olarak kişileri değil uygulamaları temsil eder. Bu kitaplıklar, uygulamalarınızın kimlik doğrulama ve yetkilendirme işlemlerini yönetmesine olanak tanır. Örneğin, bir uygulamanın Google Cloud kaynaklarına erişmesi gerekiyorsa.

Entegrasyonunuz, ortamdaki kimlik bilgilerini otomatik olarak bulmak için Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanabilir. Böylece, kimlik doğrulaması yapmak için istemci kodunu değiştirmeniz gerekmez.

ADC'yi ayarlamak için Kullanıcı hesabı veya Hizmet hesabı kimliğine bürünme'yi seçin:

Kullanıcı hesabı kimlik bilgileri ile kimlik doğrulama adımları aşağıda verilmiştir:

  1. Projeniz için Google Auth Platform ayarlarını yapılandırın.

    1. Google Cloud Console'da Markalama sayfası'nı açın.

    2. Projenizi seçin.

    3. Formu doldurun ve Oluştur'u tıklayın.

  2. Data Manager API kapsamı hassas bir kapsam olduğundan aşağıdaki adımlar gereklidir:

    1. Projenizin Veri Erişimi ayarlarına gidin.

    2. Kapsam ekle veya kaldır'ı tıklayın.

    3. Kapsamlar listesinde Data Manager API'nin yanındaki kutuyu işaretleyin ve Güncelle'yi tıklayın.

    4. Kaydet'i tıklayın.

    5. Google Cloud Console'da Kitle'ye gidin ve Yayınlama durumu ile Kullanıcı türü'nü güncelleyin. Bu ayarlar hakkında daha fazla bilgiyi Uygulama Kitlesini Yönetme başlıklı makalede bulabilirsiniz.

  3. Projede bir OAuth2 istemcisi oluşturmak için OAuth2 istemcisi oluştur'u tıklayın veya Masaüstü OAuth2 istemcisi oluşturmak için talimatları uygulayın. Veri Yöneticisi API'si için kullanmak istediğiniz bir Masaüstü OAuth2 istemciniz varsa bu adımı atlayabilirsiniz.

    OAuth2 istemcisi oluştur'u tıklarsanız istemciyi kalan adımlarda kullanabilmek için OAuth istemcinizi yapılandırma istemi aldığınızda Masaüstü uygulaması'nı seçin.

    OAuth2 istemcisi oluşturma

    Son adımda İSTEMCİ YAPILANDIRMASINI İNDİR'i tıklayın ve seçtiğiniz indirme konumunu not edin.

  4. Aşağıdaki komutu çalıştırarak yerel bir ADC dosyası oluşturun. Bu komut, API ile kullandığınız Google Hesabı'nda oturum açmanızın istendiği bir web akışı başlatır.

    PATH_TO_CLIENT_JSON yerine indirdiğiniz JSON dosyasının adını yazın.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Veri Yöneticisi API'si ve Google Ads API için aynı kimlik bilgilerini kullanmak istiyorsanız --scopes listesine Google Ads API kapsamını ekleyin:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Veri Yöneticisi API'si ve Display & Video 360 API için aynı kimlik bilgilerini kullanmak istiyorsanız --scopes listesine Display & Video 360 API kapsamını ekleyin:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Aşağıdaki komutu kullanarak kimlik bilgilerinin doğru şekilde ayarlandığını onaylayın. İşlem başarılı olursa komut, konsola bir erişim jetonu yazdırır.

    gcloud auth application-default print-access-token

Uygulamanızın kimlik doğrulaması ve kimlik bilgileri hakkında daha fazla bilgi edinmek için Google'daki kimlik doğrulama yöntemleri ve Uygulama varsayılan kimlik bilgilerinin işleyiş şekli başlıklı makaleleri inceleyin.

Hesap erişimini ayarlama

Kullanıcı hesabınızla ilişkili e-postaya Destination erişimi verin.

  • Google Ads hesabı kullanıyorsanız kullanıcının e-posta adresini Google Ads hesabına veya üst Google Ads yönetici hesabına eklemek için talimatları uygulayın.
  • Display & Video 360 hesabı kullanıyorsanız kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.
  • Google Analytics mülkü kullanıyorsanız kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.

Sonraki adımlar

İstemci kitaplığı yükleyin ve ilk Veri Yöneticisi API isteğinizi denemek için kod örneklerini çalıştırın.

Sonraki
İstemci kitaplığı yükleme