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

Bu örnekte, alt hesaplar oluşturmak ve yönetmek için AdSense Platforms API'yi çağırmak amacıyla hizmet hesaplarının nasıl kullanılabileceğini görebilirsiniz.

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

Mevcut bir Google Cloud projeniz varsa onu kullanabilirsiniz. Aksi takdirde, yeni proje oluştururken aşağıdaki kılavuzu takip edin:

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

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

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

  • Google Cloud'da 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 doldurma
    • Sayfadaki 2. ve 3. adımlar (projelere ve kullanıcılara erişim izni verme) isteğe bağlıdır

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

Hizmet hesabı oluşturulduktan sonra, AdSense hesabınıza eklenmesi için bu hesabı 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 bu bilgileri hesap yöneticiniz aracılığıyla bildirin.

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

AdSense Platform API'si bulunabilir değil. Projenizde bu API'yi etkinleştirmek için aşağıdaki bağlantıyı ziyaret etmeniz gerekiyor:

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

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

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

  • Google Cloud'da hizmet hesapları sayfasını ziyaret edin
  • İşlemler sütununda, alt hesap oluşturmak için kullanmak istediğiniz hizmet hesabıyla ilgili olarak 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 seçili olarak kalsın 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 gerekeceğinden bu adresi 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ı olacak kitaplıklar sağlar. Hizmet hesapları için kimlik bilgilerinin nasıl oluşturulacağını buradan öğrenebilirsiniz:

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

AdSense Platforms API'nin 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 başlayabilirsiniz. İstemci kitaplıkları henüz AdSense Platform API için desteklenmediğinden, bunun yerine doğrudan HTTP istekleri yapılmalıdır. Erişim jetonu, HTTP isteğine başlık olarak eklenmelidir. Başlık şu şekilde görünmelidir:

Authorization: OAuth <credentials>

API sayfalarında örnekler verilmiştir.