Mengautentikasi panggilan API

Dalam contoh ini, kami menunjukkan bagaimana akun layanan dapat digunakan untuk memanggil AdSense Platforms API guna membuat dan mengelola sub-akun.

Langkah 1: Buat project Google Cloud baru (atau gunakan yang sudah ada)

Jika Anda sudah memiliki project Google Cloud, jangan ragu untuk menggunakannya. Jika tidak, ikuti panduan di bawah ini tentang cara menyiapkan project baru:

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

Langkah 2: Buat akun layanan

Cara terbaik untuk membuat sub-akun adalah menggunakan akun layanan. Ikuti langkah-langkah berikut untuk membuat akun layanan:

  • Kunjungi halaman akun layanan di Google Cloud
  • Anda dapat menggunakan akun layanan yang ada atau membuat yang baru:
    • Klik "+ Create service account"
    • Isi "Detail akun layanan" formulir
    • Langkah 2 dan 3 di halaman (memberikan akses ke project dan pengguna) bersifat opsional

Pelajari lebih lanjut cara membuat dan mengelola akun layanan.

Setelah akun layanan dibuat, Anda harus mengirimkannya ke Google untuk menambahkannya ke akun AdSense Anda. Hal ini penting, karena akun layanan harus diizinkan untuk mengakses akun AdSense Anda. Harap komunikasikan melalui Account Manager Anda.

Langkah 3: Aktifkan AdSense Platform API untuk project Google Cloud Anda

AdSense Platform API tidak dapat ditemukan, artinya Anda harus mengunjungi link berikut untuk mengaktifkannya di project Anda:

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

Langkah 4: Buat kunci layanan

Agar dapat membuat token akses untuk digunakan dalam panggilan API, Anda perlu membuat kunci layanan. Ikuti langkah-langkah berikut:

  • Kunjungi halaman akun layanan di Google Cloud
  • Di kolom tindakan, untuk akun layanan yang ingin Anda gunakan untuk membuat sub-akun, klik , lalu klik "Kelola kunci"
  • Klik "Add key", lalu pilih "Create new key"
  • Biarkan JSON dipilih sebagai jenis kunci, dan klik "Create"
  • File json akan dibuat dan didownload ke komputer Anda. Amankan karena akan diperlukan untuk mengautentikasi panggilan API

Pelajari lebih lanjut cara membuat dan mengelola kunci akun layanan.

Langkah 5: Gunakan library OAuth Google untuk membuat token akses

Google menyediakan library untuk membantu membuat token akses, yang dapat digunakan untuk melakukan panggilan API. Pelajari cara membuat kredensial untuk akun layanan di sini:

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

Cakupan untuk AdSense Platforms API adalah sebagai berikut: https://www.googleapis.com/auth/adsense

Contoh Python

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

Pada tahap ini, Anda siap untuk mulai memanggil API. Karena library klien belum didukung untuk AdSense Platform API, permintaan HTTP langsung harus dibuat. Token akses harus disertakan sebagai header dalam permintaan HTTP. Header akan terlihat seperti ini:

Authorization: OAuth <credentials>

Contoh disertakan dalam halaman API.