שימוש ב-OAuth

Air Quality API תומך בשימוש ב-OAuth 2.0 לצורך אימות. Google תומכת בתרחישים נפוצים של OAuth 2.0, כמו תרחישים של שרת אינטרנט.

במסמך הזה מוסבר איך להעביר אסימון OAuth לקריאה ל-Air Quality API ב סביבת פיתוח. לקבלת הוראות לשימוש ב-OAuth בסביבת production, אימות ב-Google.

לפני שמתחילים

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

מידע על OAuth

יש הרבה דרכים ליצור אסימוני גישה באמצעות OAuth ולנהל אותם בהתאם לפריסה הסביבה.

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

לחלופין, אפשר להשתמש ב-Air Quality API כחלק מאפליקציה לנייד ל-Android או ל-iOS. למידע כללי על השימוש ב-OAuth עם Air Quality API, כולל מידע על ניהול לאסימוני גישה לסביבות פריסה שונות: שימוש ב-OAuth 2.0 כדי לגשת ל-Google APIs.

מידע על היקפי הרשאות של OAuth

כדי להשתמש ב-OAuth עם Air Quality API, צריך להקצות לאסימון OAuth את ההיקף:

• https://www.googleapis.com/auth/cloud-platform

דוגמה: התנסות בקריאות API ל-REST בסביבת הפיתוח המקומית

אם אתם רוצים לנסות את Air Quality API באמצעות אסימון OAuth, אבל אין לכם סביבה כזו כדי ליצור אסימונים, תוכלו לבצע את התהליך שבקטע הזה כדי לבצע את הקריאה.

דוגמה זו מתארת כיצד להשתמש באסימון OAuth שסופק על ידי Application Default Credentials (ADC) כדי להתקשר. רוצים לדעת איך משתמשים ב-ADC כדי לקרוא ל-Google APIs באמצעות ספריות לקוח? אימות באמצעות ספריות לקוח.

דרישות מוקדמות

כדי לשלוח בקשת REST באמצעות ADC, צריך להשתמש ב-Google Cloud CLI כדי לספק פרטי כניסה ל-ADC:

1. אם עדיין לא עשית זאת, עליך ליצור פרויקט ולהפעיל את החיוב על ידי ביצוע השלבים הבאים: ההגדרה מתבצעת במסוף Google Cloud.
2. מתקינים ומפעילים את ה-CLI של gcloud.

3. מריצים את פקודת gcloud הבאה במחשב המקומי כדי ליצור את קובץ פרטי הכניסה:

   gcloud auth application-default login

4. מסך התחברות יוצג לפניכם. אחרי ההתחברות, פרטי הכניסה נשמרים קובץ פרטי הכניסה המקומי שמשמש את ADC.

מידע נוסף זמין במאמר הבא: סביבת פיתוח מקומית בקטע של הוספת פרטי כניסה ל-Application Default Credentials התיעוד.

שליחת בקשת REST

בדוגמה הזו אתם מעבירים שתי כותרות של בקשות:

• מעבירים את אסימון ה-OAuth בכותרת Authorization באמצעות הפקודה הבאה כדי ליצור את האסימון:

  gcloud auth application-default print-access-token

  לאסימון המוחזר יש היקף של https://www.googleapis.com/auth/cloud-platform.

• מעבירים את המזהה או את השם של הפרויקט ב-Google Cloud שהחיוב הופעל בו. הכותרת X-Goog-User-Project. מידע נוסף זמין במאמר הבא: ההגדרה מתבצעת במסוף Cloud.

בדוגמה הבאה נשלחת קריאה ל-Air Quality API באמצעות אסימון OAuth:

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" -d '{
  "location": {
    "latitude": 32.62782385865436,
    "longitude": 35.02197334774893
    }
  }' \
"https://airquality.googleapis.com/v1/currentConditions:lookup"

פתרון בעיות

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