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.