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.

Ön koşullar

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

1. Bir Google Cloud projesi. Mevcut bir projeyi kullanabilir veya Data Manager API'si için özel olarak yeni bir proje oluşturabilirsiniz.

2. Google Cloud projenizde serviceusage.services.enable iznine sahip bir Google Hesabı veya bu izni içeren bir role sahip bir Google Hesabı. Örneğin, hem roles/owner hem de roles/serviceusage.serviceUsageAdmin, serviceusage.services.enable iznini içerir. İzinlerinizi kontrol etmek için Mevcut erişimi görüntüleme başlıklı makaleyi inceleyin.

3. Google Cloud CLI 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.

Yaygın olarak kullanılan iki 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ı'nı seçin:

Kullanıcı hesabı

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.

   Önemli: Data Manager API kapsamı için kullanıcı kimlik bilgilerini almak üzere kullanılan tüm Google Cloud uygulamaları, kullanıcıları için doğrulanmamış bir kullanıcı arayüzü ekranı göstermemek amacıyla Google OAuth doğrulamasına tabi tutulmalıdır. Hizmet hesapları için Google OAuth doğrulaması gerekmez.

   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. Projeye 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. Data Manager API 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ı'na giriş yapmanı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"
   

   Data Manager API 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
   

Hizmet hesabı

Kimlik doğrulamak için hizmet hesabı kimliğine bürünme özelliğini kullanma adımları aşağıda verilmiştir. Bu adımlarda, hizmet hesabı anahtarları dikkatli bir şekilde yönetilmezse güvenlik riski oluşturabileceğinden hizmet hesabı anahtarları yerine kimliğe bürünme kullanılır.

1. Aşağıdaki Hizmet hesabı oluştur düğmesini tıklayın veya hizmet hesabı seçmek ya da oluşturmak için talimatları uygulayın.

   Hizmet hesabı oluşturma

2. Hizmet hesabına, Hizmet Kullanımı Tüketicisi IAM rolünü (roles/serviceusage.serviceUsageConsumer) verin. Bu rol, hizmet hesabının proje için API istekleri göndermesine olanak tanıyan serviceusage.services.use iznini içerir.

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

3. Hizmet hesabında Google Hesabınıza Service Account Token Creator IAM rolünü (roles/iam.serviceAccountTokenCreator) verin.

   Not: Google Hesabınız projenin sahibi olsa bile bu adım gereklidir.

   gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
     --member="user:USER_EMAIL" \
     --role="roles/iam.serviceAccountTokenCreator"
   

4. Aşağıdaki komutu çalıştırarak ADC'nizi yapılandırın:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
   

   Data Manager API 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 \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
   

   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 \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"
   

   Oturum açmanız istendiğinde, Hizmet Hesabı Jetonu Oluşturucu rolüne sahip Google Hesabınızla giriş yapın.

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

   gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
   

Not: https://www.googleapis.com/auth/datamanager kapsamı, Data Manager API'sindeki tüm hizmetler için gereklidir.

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 Bilgileri'nin işleyiş şekli başlıklı makaleleri inceleyin.

Hesap erişimini ayarlama

Kullanıcı hesabı

Kullanıcıyla ilişkili e-posta adresine Destination erişimi verin.

• Google Ads hesabı kullanıyorsanız kullanıcının e-posta adresini Google Ads hesabına veya bir ü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.
• Destination özelliğine reklamveren hesabından gelen bir iş ortağı bağlantısı içeren bir veri iş ortağı hesabı üzerinden erişiyorsanız kullanıcının e-posta adresini veri iş ortağı hesabına eklemek için talimatları uygulayın.

Hizmet hesabı

Hizmet hesabınızla ilişkili e-posta adresine Destination erişimi verin.

• Google Ads hesabı kullanıyorsanız hizmet hesabını Google Ads hesabına veya üst Google Ads yönetici hesabına eklemek için Hesap erişimi kurulumu'nu tamamlayın.
• Display & Video 360 hesabı kullanıyorsanız hizmet hesabıyla ilişkilendirilmiş bir Display & Video 360 kullanıcısı oluşturmak 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.
• Destination'ya reklamveren hesabından gelen bir iş ortağı bağlantısı içeren bir veri iş ortağı hesabı kullanarak erişiyorsanız hizmet hesabını eklemek ve erişim düzeyini ayarlamak için veri iş ortağı hesabında Hesap erişimi kurulumu'nu tamamlayın.

Sonraki adımlar

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