אימות קריאות ל-API

בדוגמה הזו אנחנו מראים איך אפשר להשתמש בחשבונות שירות כדי לשלוח קריאה ל-AdSense Platforms API כדי ליצור ולנהל חשבונות משנה.

שלב 1: יצירת פרויקט חדש ב-Google Cloud (או שימוש בפרויקט קיים)

אם יש לכם פרויקט קיים ב-Google Cloud, אתם מוזמנים להשתמש בו. אם לא, תוכלו להיעזר במדריך הבא להגדרת פרויקט חדש:

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

שלב 2: יוצרים חשבון שירות

הדרך הטובה ביותר ליצור חשבונות משנה היא להשתמש בחשבונות שירות. כדי ליצור חשבון שירות:

• כניסה לדף חשבונות שירות ב-Google Cloud
• אפשר להשתמש בחשבון שירות קיים או ליצור חשבון חדש:
  • לוחצים על '+ יצירת חשבון שירות'.
  • ממלאים את הפרטים של 'פרטי חשבון השירות' הטופס הזה
  • שלבים 2 ו-3 בדף (הענקת גישה לפרויקטים ולמשתמשים) הם אופציונליים

מידע נוסף על יצירה וניהול של חשבונות שירות

לאחר יצירת חשבון השירות, צריך לשלוח אותו ל-Google כדי להוסיף אותו לחשבון AdSense. הפעולה הזו חיונית, כי לחשבון השירות צריך להיות הרשאה לגשת לחשבון AdSense שלכם. יש לפנות אליו דרך מנהל החשבון.

שלב 3: מפעילים את AdSense Platform API לפרויקט ב-Google Cloud

ממשק ה-API של פלטפורמת AdSense אינו גלוי, ופירוש הדבר שעליך להיכנס לקישור הבא כדי להפעיל אותו בפרויקט שלך:

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

שלב 4: יצירת מפתח שירות

כדי ליצור אסימוני גישה לשימוש בקריאות ל-API, צריך ליצור מפתח שירות. כך עושים זאת:

• כניסה לדף חשבונות שירות ב-Google Cloud
• בעמודה 'פעולות', עבור חשבון השירות שבו רוצים להשתמש כדי ליצור חשבונות משנה, לוחצים על ולאחר מכן על 'ניהול מפתחות'.
• לוחצים על 'הוספת מפתח' ואז בוחרים באפשרות 'יצירת מפתח חדש'
• משאירים את שדה ה-JSON נבחר כסוג המפתח ולוחצים על 'יצירה'
• קובץ json ייווצר ויוריד למחשב שלך. יש לשמור את המידע הזה בבטחה, כי הוא יידרש לאימות הקריאות ל-API

מידע נוסף על יצירה וניהול של מפתחות לחשבונות שירות.

שלב 5: שימוש בספריות OAuth של Google כדי ליצור אסימון גישה

Google מספקת ספריות כדי לסייע ביצירת אסימוני גישה, שניתן להשתמש בהם לביצוע הקריאות ל-API. כאן מוסבר איך ליצור פרטי כניסה לחשבונות שירות:

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

ההיקף של AdSense Platforms API הוא: https://www.googleapis.com/auth/adsense

דוגמה ב-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

בשלב הזה אתם יכולים להתחיל לקרוא לממשקי ה-API. מאחר שספריות לקוח עדיין לא נתמכות ב-AdSense Platform API, יש לשלוח במקום זאת בקשות HTTP ישירות. צריך לכלול את אסימון הגישה ככותרת בבקשת ה-HTTP. הכותרת אמורה להיראות כך:

Authorization: OAuth <credentials>

בדפי ה-API יש דוגמאות.