API erişimini ayarlama

SDK veya REST ile Data Manager API'ye erişimi nasıl ayarlayacağınız aşağıda açıklanmaktadır.

Ön koşullar

1. Google Cloud projesi veya projenin sahibi olmasını istediğiniz bir Google Hesabı.

   • Projeniz yoksa sonraki bölümdeki kurulum süreci sizin için bir proje oluşturur.

   • Halihazırda bir projeniz varsa Google Hesabınızın projede API'leri etkinleştirebilecek bir role (ör. Sahip, Düzenleyici veya Hizmet Kullanımı Yöneticisi) sahip olduğundan emin olun. Rolünüzü kontrol etmek için Google Cloud Console'da IAM sayfasını açın, projenizi seçin ve listede Google Hesabınızı bulun.

     Daha fazla bilgi için Mevcut erişimi görüntüleme başlıklı makaleyi inceleyin.

2. Google Cloud CLI yüklü olmalıdır.

API'yi etkinleştirme

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

İpucu: Henüz bir Google Cloud projeniz yoksa Data Manager API'sini etkinleştir seçeneği sizin için bir proje oluşturur.

Data Manager API'yi etkinleştirme

Data Manager API'yi bulamıyorsanız veya Data Manager API'yi etkinleştirme işlemi başarısız olursa Google Hesabınızın ön koşulları karşıladığından emin olun.

Kimlik doğrulamayı 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şimde bulunan kişileri temsil eder.
• Hizmet hesapları: Kullanıcı olarak kişileri değil, uygulamaları temsil eder. Uygulamalarınızın kimlik doğrulama ve yetkilendirme işlemlerini yönetmesini sağlar. Ö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ı 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 bilgileriyle kimlik doğrulama adımları şunlardır:

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 amacıyla kullanılan tüm Google Cloud uygulamalarının, kullanıcılarına doğrulanmamış kullanıcı arayüzü ekranı gösterilmemesi için Google OAuth doğrulamasından geçmesi gerekir. İlk geliştirme ve test aşamasında, test kullanıcıları ekleyerek uygulamayı doğrulama olmadan kullanabilirsiniz. Doğrulama süreci ve üretim önerileriyle ilgili ayrıntılar için OAuth uygulaması doğrulama başlıklı makaleyi inceleyin. Hizmet hesapları veya dahili uygulamalar gibi belirli senaryolarda doğrulama gerekmez. Ayrıntılar için Doğrulama ne zaman gerekli değildir? başlıklı makaleyi inceleyin.

   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, hassas kapsamlar kullandığından aşağıdaki adımlar gereklidir:

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

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

   3. Kapsam listesinde Data Manager API'yi bulun ve uygulamanızın gerektirdiği her kapsamın kutusunu işaretleyin:

      • .../auth/datamanager: Müşteri verilerini, kitleleri ve etkinlikleri yönetme gibi standart API işlemleri için bu kapsamı seçin. Bu, kılavuzda kullanılan birincil kapsamdır.

      • .../auth/datamanager.partnerlink: Bu kapsamı yalnızca reklamveren hesaplarında iş ortağı bağlantıları oluşturan veya silen bir veri iş ortağıysanız seçin.

   4. Güncelle'yi tıklayın.

   5. Kaydet'i tıklayın.

   6. Google Cloud konsolunda Kitle'ye gidin ve ilk geliştirme için ayarları yapılandırın:

      • Yayınlanma durumu'nu Test olarak ayarlayın.
      • Kullanıcı türü'nü Dahili (projeniz bir Google Workspace kuruluşundaysa) veya Harici (projeniz bir Google Workspace kuruluşunda değilse) olarak ayarlayın.
      • Harici'yi kullanıyorsanız kimlik bilgileri oluşturmak için kullandığınız Google Hesaplarını Test kullanıcıları olarak ekleyin.

      Bu ayarlar hakkında daha fazla bilgiyi Uygulama kitlesini yönetme bölümünde 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. 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 OAuth istemcinizi yapılandırın istemi gösterildiğinde Masaüstü uygulaması'nı seçin. Böylece istemciyi kalan adımlarda kullanabilirsiniz.

   Not: Veri iş ortağıysanız ve iş ortağı bağlantıları oluşturmak için reklamverenlerden kimlik bilgileri almak amacıyla özel olarak bir OAuth istemcisi istiyorsanız OAuth istemcinizi yapılandırın istemi gösterildiğinde Web sunucusu veya Web tarayıcısı'nı seçin ve Reklamveren hesabı için kimlik bilgilerini alma talimatlarını uygulayın.
   OAuth2 istemcisi oluşturma

   Son adımda DOWNLOAD CLIENT CONFIGURATION'ı (İstemci yapılandırmasını indir) 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 ifadesini, indirdiğiniz JSON dosyasının adıyla değiştirin.

   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"
   

   Data Manager API ve Display & Video 360 API için aynı kimlik bilgilerini kullanmak istiyorsanız Display & Video 360 API kapsamını --scopes listesine 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ı

Yerel bir geliştirme ortamında kimlik doğrulaması yapmak için hizmet hesabı oluşturma ve hizmet hesabı kimliğine bürünme özelliğini kullanma adımları aşağıda verilmiştir. Bu adımlarda, hizmet hesabı anahtarları yerine kimliğe bürünme kullanılır. Bunun nedeni, dikkatli bir şekilde yönetilmediği takdirde hizmet hesabı anahtarlarının güvenlik riski oluşturabilmesidir.

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, projenin API istekleri göndermesine izin veren serviceusage.services.use iznini içeren Hizmet Kullanımı Tüketicisi IAM rolünü (roles/serviceusage.serviceUsageConsumer) verin.

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

   İpucu: Kodunuzu bir Google Cloud kaynağında (ör. Compute Engine sanal makinesi, Cloud Run veya GKE) çalıştırıyorsanız kimliğe bürünmeyle ilgili kalan adımları atlayabilirsiniz. Bunun yerine, hizmet hesabını doğrudan kaynağa ekleyin ve Hesap erişimini ayarlama bölümüne geçin.

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"
   

   Data Manager API ve Display & Video 360 API için aynı kimlik bilgilerini kullanmak istiyorsanız Display & Video 360 API kapsamını --scopes listesine 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, konsola bir erişim jetonu 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ı birincil kapsamdır ve Data Manager API'sindeki tüm hizmetlerde çalışır. Daha dar kapsamlı https://www.googleapis.com/auth/datamanager.partnerlink izin yalnızca iş ortağı bağlantılarını yönetmek için kullanılır.

Uygulamanızın kimlik doğrulaması ve kimlik bilgileri hakkında daha fazla bilgi edinmek için Google'da 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ım alanınıza karşılık gelen sekmeyi seçin.

• Yönetmek istediğiniz reklamveren hesaplarında kullanıcı olan bir Google Hesabı'nın kimlik bilgilerini kullanıyorsanız Reklamveren'i seçin.
• Bir veri iş ortağı hesabında kullanıcı olan bir Google Hesabı'nın kimlik bilgilerini kullanıyorsanız ve veri iş ortağı hesabına iş ortağı bağlantısı olan reklamveren hesaplarını yönetmek istiyorsanız Veri İş Ortağı'nı seçin. Veri iş ortağı hesapları yalnızca onay sürecinden geçtikten sonra verilir. Başlamak için talep formunu doldurun.

Reklamveren

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

Google Ads

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

Kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.

Google Analytics

Kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.

Veri iş ortağı

Kullanıcıyla ilişkili e-posta adresine veri iş ortağı hesabınıza erişim izni verin. Veri iş ortakları genellikle API erişimi için bir hizmet hesabı kullanır. Ancak test veya başka amaçlarla bir kullanıcı hesabı kullanıyorsanız kullanıcı hesabınıza veri iş ortağı hesabına erişim izni vermeniz gerekir.

Bu talimatları uygulayarak kullanıcının e-posta adresini Google Ads kullanıcı arayüzü üzerinden veri iş ortağı hesabına ekleyin.

Hizmet hesabı

Kullanım alanınıza karşılık gelen sekmeyi seçin.

• Yönetmek istediğiniz reklamveren hesaplarında kullanıcı olan bir Google Hesabı'nın kimlik bilgilerini kullanıyorsanız Reklamveren'i seçin.
• Bir veri iş ortağı hesabında kullanıcı olan bir Google Hesabı'nın kimlik bilgilerini kullanıyorsanız ve veri iş ortağı hesabıyla iş ortağı bağlantısı olan reklamveren hesaplarını yönetmek istiyorsanız Veri İş Ortağı'nı seçin. Veri iş ortağı hesapları yalnızca onay sürecinden geçtikten sonra verilir. Başlamak için talep formunu doldurun.

Reklamveren

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

Google Ads

Hizmet hesabını Google Ads hesabına veya bir üst Google Ads yönetici hesabına eklemek için Hesap erişimi kurulumunu tamamlayın.

Display & Video 360

Hizmet hesabıyla ilişkili bir Display & Video 360 kullanıcısı oluşturmak için talimatları uygulayın.

Google Analytics

Hizmet hesabının e-posta adresini hesaba eklemek için talimatları uygulayın.

Veri iş ortağı

Hizmet hesabınızla ilişkili e-posta adresine veri iş ortağı hesabınıza erişim izni verin.

Veri iş ortağı hesabı erişimi, Google Ads kullanıcı arayüzü üzerinden yönetilir. Hizmet hesabını eklemek ve erişim düzeyini ayarlamak için Hesap erişimi kurulumu bölümündeki adımları uygulayın.

Sonraki adımlar

• İlk Data Manager API isteğinizi denemek için bir istemci kitaplığı yükleyin ve kod örneklerini çalıştırın.
• Üretim ortamına dağıtım yaparken kimlik doğrulamayı nasıl yapılandıracağınızı öğrenin.