Authentication

Bu belgede, Ad Manager API'de kimlik doğrulamanın nasıl yapılacağı açıklanmaktadır. Kimlik doğrulama yönteminiz, kullandığınız arayüze ve kodunuzun çalıştığı ortama bağlıdır ancak tüm API istekleri, Ad Manager API kapsamına sahip bir erişim jetonu içermelidir.

Ad Manager istemci kitaplıkları, Ad Manager API kapsamlarıyla erişim jetonları oluşturmak için Uygulama Varsayılan Kimlik Bilgileri'ni kullanır. Bu kılavuzda, Uygulama Varsayılan Kimlik Bilgileri'nin nasıl yapılandırılacağı gösterilmektedir.

İstemci kitaplığı kullanmıyorsanız kimlik bilgileri oluşturmanız ve isteklerinizi yetkilendirmek için bu bilgileri kullanmanız gerekir.

Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi için OAuth 2.0'ı kullanma kılavuzuna bakın.

Kimlik doğrulama türünüzü belirleme

Kimlik doğrulama türü Açıklama
Hizmet Hesabı Belirli bir kişi yerine özel hesap olarak kimlik doğrulaması yapmak istiyorsanız bu seçeneği belirleyin.
Daha fazla bilgi edinin.
Web uygulaması Uygulamanıza Ad Manager verilerine erişme izni veren herhangi bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsanız bu seçeneği belirleyin.
Daha fazla bilgi
Yerel geliştirme Yerel geliştirme ortamınızdan kendi Google Hesabınız veya bir hizmet hesabı olarak kimlik doğrulaması yapmak istiyorsanız bu seçeneği belirleyin.

Ad Manager API'yi etkinleştirme

  1. Google API Konsolu Cloud projenizde Ad Manager API'yi etkinleştirin.

  2. İstenirse bir proje seçin veya yeni bir proje oluşturun.

Kimlik bilgileri oluştur

Kimlik doğrulama türünüzün sekmesini tıklayın ve kimlik bilgilerinizi oluşturmak için talimatları uygulayın:

Hizmet Hesabı

Google Cloud'da

Google Cloud'da çalışan bir iş yükünün kimliğini doğrulamak için kodunuzun çalıştığı işlem kaynağına bağlı hizmet hesabının kimlik bilgilerini kullanırsınız.

Örneğin, bir hizmet hesabını Compute Engine sanal makine (VM) örneğine, Cloud Run hizmetine veya Dataflow işine ekleyebilirsiniz. Bu yaklaşım, Google Cloud bilgi işlem kaynağında çalışan kod için tercih edilen kimlik doğrulama yöntemidir.

Hangi kaynaklara hizmet hesabı ekleyebileceğiniz hakkında bilgi edinmek ve hizmet hesabını kaynağa ekleme konusunda yardım almak için hizmet hesabı eklemeyle ilgili belgelere bakın.

Şirket içinde veya farklı bir bulut sağlayıcıda

Google Cloud dışından kimlik doğrulamayı ayarlamak için tercih edilen yöntem, Workload Identity Federasyonu'nu kullanmaktır. Bir kimlik bilgisi yapılandırma dosyası oluşturur ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini bu dosyayı işaret edecek şekilde ayarlarsınız. Bu yaklaşım, hizmet hesabı anahtarı oluşturmaktan daha güvenlidir.

Workload Identity federasyonunu yapılandıramıyorsanız bir hizmet hesabı ve bu hizmet hesabı için bir anahtar oluşturmanız gerekir:

  1. Google API Konsolu Kimlik Bilgileri sayfasını açın.

  2. Kimlik Bilgileri sayfasında Kimlik bilgileri oluştur'u ve ardından Hizmet Hesabı'nı seçin.

  3. Anahtar oluşturmak istediğiniz hizmet hesabının e-posta adresini tıklayın.

  4. Keys (Anahtarlar) sekmesini tıklayın.

  5. Add key (Anahtar ekle) açılır menüsünü tıklayın, ardından Create new key'i (Yeni anahtar oluştur) seçin.

  6. Anahtar türü olarak JSON'u seçin ve Oluştur'u tıklayın.

  7. GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini JSON dosyasının yoluna ayarlayın.

Linux veya macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Web uygulaması

  1. Google API Konsolu Kimlik Bilgileri sayfasını açın.

  2. İstenirse Ad Manager API'yi etkinleştirdiğiniz projeyi seçin.

  3. Kimlik Bilgileri sayfasında Kimlik bilgileri oluştur'u ve ardından OAuth istemci kimliği'ni seçin.

  4. Web uygulaması uygulama türünü seçin.

  5. Formu doldurun ve Create'i (Oluştur) tıklayın. PHP, Java, Python, Ruby ve .NET gibi dilleri ve çerçeveleri kullanan uygulamaların yetkili yönlendirme URI'larını belirtmesi gerekir. Yönlendirme URI'leri, OAuth 2.0 sunucusunun yanıt gönderebileceği uç noktalardır. Bu uç noktalar Google'ın doğrulama kurallarına uygun olmalıdır.

  6. Kimlik bilgilerinizi oluşturduktan sonra client_secret.json dosyasını indirin. Dosyayı yalnızca uygulamanızın erişebileceği bir konumda güvenli bir şekilde saklayın.

Buradan, OAuth 2.0 erişim jetonlarını alma adımlarını uygulayın.

Yerel geliştirme

Yerel ortamınızda Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) ayarlayın.

Google Cloud CLI'yı yükleyin ve ardından aşağıdaki komutu çalıştırarak başlatın:

gcloud init

Google Hesabınız için yerel kimlik doğrulama bilgileri oluşturun ve proje kimliğini, Ad Manager API'nin etkinleştirildiği bir projeye ayarlayın:

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
gcloud auth application-default set-quota-project PROJECT_ID

Alternatif olarak, GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini anahtar dosyanızın yoluna ayarlayarak hizmet hesabı olarak kimlik doğrulaması yapabilirsiniz.

Linux veya macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Ad Manager ağınızı yapılandırma

Hizmet Hesabı

  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişimi'nin etkinleştirildiğinden emin olun.
  4. Hizmet hesabı kullanıcısı ekle düğmesini tıklayın.
  5. Hizmet hesabı e-postasını kullanarak formu doldurun. Hizmet hesabı kullanıcısı, API entegrasyonunuz için uygun rollere ve ekiplere eklenmelidir.
  6. Kaydet düğmesini tıklayın. Hizmet hesabınızın eklendiğini onaylayan bir mesaj gösterilir.
  7. Kullanıcılar sekmesine gidip Hizmet Hesabı filtresini tıklayarak mevcut hizmet hesabı kullanıcılarını görüntüleyin.

Web uygulaması

  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişimi'nin etkinleştirildiğinden emin olun.

Yerel Geliştirme

  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişimi'nin etkinleştirildiğinden emin olun.

İstemci kitaplığı olmadan

İstemci kitaplığı kullanmıyorsanız kimlik doğrulama için OAuth2 kitaplığı kullanmanızı önemle tavsiye ederiz.

Erişim jetonlarını alma hakkında ayrıntılı talimatlar için Google API'leriyle OAuth2'yi kullanma başlıklı makaleyi inceleyin.

Erişim jetonları

Erişim jetonunuzu, API'ye gönderilen bir isteğe access_token sorgu parametresi veya Authorization HTTP üstbilgisi Bearer değeri ekleyerek dahil edin. Sorgu dizeleri sunucu günlüklerinde görünür olma eğiliminde olduğundan, mümkünse HTTP üstbilgisi tercih edilir.

Örneğin:

GET /v1/networks/1234
Host: admanager.googleapis.com
Authorization: Bearer ya29.a0Ad52N3_shYLX

GET https://admanager.googleapis.com/v1/networks/1234?access_token=1/fFAGRNJru1FTz70BzhT3Zg

Kapsam

Her erişim jetonu bir veya daha fazla kapsamla ilişkilendirilir. Kapsam, bir erişim jetonunun izin verdiği kaynak ve işlem grubunu kontrol eder. Ad Manager API'nin iki kapsamı vardır. Uygulamanızın veri yazması gerekmiyorsa daha dar kapsamlı admanager.readonly kapsamını kullanmanızı öneririz.

Kapsam İzinler
https://www.googleapis.com/auth/admanager Google Ad Manager'da kampanyalarınızı görüntüleyip yönetebilirsiniz.
https://www.googleapis.com/auth/admanager.readonly Google Ad Manager'daki kampanyalarınızı ve verilerinizi görme