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

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

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

Mevcut bir Google Cloud projeniz varsa bunu kullanabilirsiniz. Aksi takdirde, yeni bir proje oluştururken aşağıdaki rehberi izleyin:

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

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

Hizmet hesaplarını kullanmak, alt hesap oluşturmanın en iyi yoludur. Hizmet hesabınızı oluşturmak için şu 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ı"nı doldurun formu
    • Sayfadaki 2. ve 3. adım (projelere ve kullanıcılara erişim izni 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 bu hesabı Google'a göndermeniz gerekir. Hizmet hesabının AdSense hesabınıza erişmesine izin verilmesi gerektiğinden bu işlem çok önemlidir. Lütfen bunu hesap yöneticiniz aracılığıyla iletin.

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

AdSense Platform API bulunabilir değildir. Bu nedenle, projenizde API'yi etkinleştirmek için 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 kullanmak üzere erişim jetonları oluşturmak için hizmet anahtarı oluşturmanız gerekir. Şu adımları uygulayın:

  • Google Cloud'daki hizmet hesapları sayfasını ziyaret edin
  • İşlemler sütununda, alt hesap oluşturmak üzere kullanmak istediğiniz hizmet hesabı için simgesini ve 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 tutun 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 bunu güvenli bir şekilde saklayın

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 bilgileri oluşturma hakkında daha fazla bilgiyi burada bulabilirsiniz:

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. AdSense Platform API için istemci kitaplıkları henüz desteklenmediğinden, bunun yerine doğrudan HTTP isteklerinin yapılması gerekir. Erişim jetonu, HTTP isteğine bir başlık olarak eklenmelidir. Başlık aşağıdaki gibi görünmelidir:

Authorization: OAuth <credentials>

API sayfalarında örnekler verilmiştir.