שימוש ב-OAuth

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

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

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

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

מידע על OAuth

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

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

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

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

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

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

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

אם ברצונך לנסות את ה-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.

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

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://addressvalidation.googleapis.com/v1:validateAddress"

פתרון בעיות

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