API çağrılarının kimliğini doğrulama

Bu örnekte, alt hesaplar oluşturmak ve yönetmek için AdSense Platformlar API'sini çağırmak üzere hizmet hesaplarının nasıl kullanılabileceği gösterilmektedir.

1. adım: Yeni bir Google Cloud projesi oluşturun (veya mevcut bir projeyi kullanın)

Mevcut bir Google Cloud projeniz varsa bu projeyi kullanabilirsiniz. Aksi takdirde, yeni proje oluşturmayla ilgili aşağıdaki kılavuzu uygulayın:

https://cloud.google.com/resource-manager/docs/creating-managing-projects

2. adım: Hizmet hesabı oluşturun

Alt hesaplar oluşturmanın en iyi yolu hizmet hesaplarını kullanmaktır. Hizmet hesabınızı oluşturmak için aşağıdaki adımları uygulayın:

  • Google Cloud'daki hizmet hesapları sayfasını ziyaret edin.
  • Mevcut bir hizmet hesabını kullanabilir veya yeni bir hesap oluşturabilirsiniz:
    • "+ Hizmet hesabı oluştur"u tıklayın.
    • "Hizmet hesabı ayrıntıları" formunu doldurun
    • Sayfadaki 2. ve 3. adımlar (projelere ve kullanıcılara erişim verme) isteğe bağlıdır.

Hizmet hesapları oluşturma ve yönetme hakkında daha fazla bilgi edinin.

Hizmet hesabı oluşturulduktan sonra AdSense hesabınıza eklenmesi için Google'a göndermeniz gerekir. Hizmet hesabının AdSense hesabınıza erişmesine izin verilmesi gerektiğinden bu işlem önemlidir. Lütfen bunu hesap yöneticiniz aracılığıyla bildirin.

3. Adım: Google Cloud projeniz için AdSense Platform API'sini etkinleştirin

AdSense Platform API'si bulunabilir değildir. Yani, projeniz için etkinleştirmek üzere aşağıdaki bağlantıyı ziyaret etmeniz gerekir:

https://console.developers.google.com/apis/api/adsenseplatform.googleapis.com/overview

4. Adım: Hizmet anahtarı oluşturun

API çağrılarında kullanılacak erişim jetonları oluşturmak için bir hizmet anahtarı oluşturmanız gerekir. Şu adımları uygulayın:

  • Google Cloud'daki hizmet hesapları sayfasını ziyaret edin.
  • Alt hesap oluşturmak için kullanmak istediğiniz hizmet hesabı için işlemler sütununda simgesini, ardından "Anahtarları yönet"i tıklayın.
  • "Anahtar ekle"yi tıklayın, ardından "Yeni anahtar oluştur"u seçin.
  • Anahtar türü olarak JSON'u seçin ve "Oluştur"u tıklayın.
  • Bir JSON dosyası oluşturulur ve bilgisayarınıza indirilir. API çağrılarının kimliğini doğrulamak için bu anahtara ihtiyacınız olacağından anahtarı güvende tutun.

Hizmet hesabı anahtarları oluşturma ve yönetme hakkında daha fazla bilgi edinin.

5. adım: Erişim jetonu oluşturmak için Google'ın OAuth kitaplıklarını kullanın

Google, API çağrıları yapmak için kullanılabilecek erişim jetonları oluşturmaya yardımcı olan kitaplıklar sağlar. Hizmet hesapları için kimlik bilgilerini nasıl oluşturacağınız hakkında bilgi edinin:

https://developers.google.com/identity/protocols/oauth2/service-account#authorizingrequests

AdSense Platformlar API'sinin kapsamı aşağıdaki gibidir: https://www.googleapis.com/auth/adsense

Python örneği

from google.auth.transport import requests
from google.oauth2 import service_account

CREDENTIAL_SCOPES = ["https://www.googleapis.com/auth/adsense"]
CREDENTIALS_KEY_PATH = 'service.json'

def get_service_account_token():
  credentials = service_account.Credentials.from_service_account_file(
          CREDENTIALS_KEY_PATH, scopes=CREDENTIAL_SCOPES)
  credentials.refresh(requests.Request())
  return credentials.token

Bu aşamada, API'leri çağırmaya hazırsınız. AdSense Platform API için istemci kitaplıkları henüz desteklenmediğinden bunun yerine doğrudan HTTP istekleri gönderilmelidir. Erişim jetonu, HTTP isteğine üstbilgi olarak eklenmelidir. Başlık şu şekilde görünmelidir:

Authorization: OAuth <credentials>

Örnekler API sayfalarına eklenmiştir.