תחילת העבודה עם REST

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

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

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

הגדרת האפליקציה

הפעלת ה-API

לפני שתוכלו להשתמש ב-Library API, עליכם להפעיל אותו בפרויקט שלכם.

1. עוברים אל Google API Console.
2. בסרגל התפריטים, בוחרים פרויקט או יוצרים פרויקט חדש.
3. כדי לפתוח את ספריית Google API, בתפריט הניווט בוחרים ממשקי API שירותים > ספרייה.
4. מחפשים את Google Photos Library API. בוחרים את התוצאה המתאימה ולוחצים על הפעלה.

בקשת מזהה לקוח ב-OAuth 2.0

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

1. עוברים אל Google API Console ובוחרים את הפרויקט.
2. בתפריט, בוחרים באפשרות APIs & שירותים > פרטי כניסה.
3. בדף Credentials, לוחצים על Create Credentials > מזהה הלקוח ב-OAuth.
4. בוחרים את Application type (סוג האפליקציה). בדוגמה הזו, סוג האפליקציה הוא אפליקציית אינטרנט.

5. רישום המקורות שמהם האפליקציה מורשית לגשת ל-Google APIs ככה:

   1. כדי לזהות את מזהה הלקוח, מזינים שם.

   2. בשדה Authorized JavaScript Sources (מקורות JavaScript מורשים), מזינים את המקור של אפליקציה. בשדה הזה אי אפשר להשתמש בתווים כלליים לחיפוש.

      אפשר להזין כמה מקורות כדי לאפשר לאפליקציה לפעול במכשירים שונים פרוטוקולים, דומיינים או תת-דומיינים. כתובות ה-URL שהזנת יכולות להתחיל בקשת OAuth.

      הדוגמה הבאה מציגה כתובת URL לפיתוח מקומי (הדוגמאות שלנו כוללות localhost:8080) וכתובת URL לסביבת הייצור.

      http://localhost:8080
      https://myproductionurl.example.com
      

   3. השדה Authorized Redirect URI הוא נקודת הקצה שמקבלת תגובות משרת OAuth 2.0. בדרך כלל, העדכון הזה כולל ואת סביבת הפיתוח ומצביעה על נתיב באפליקציה.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      

   4. לוחצים על יצירה.

6. מתיבת הדו-שיח של לקוח OAuth שמתקבלת, מעתיקים את הפרטים הבאים:

   • Client-ID
   • סוד לקוח

   האפליקציה שלך יכולה לגשת לממשקי Google API המופעלים באמצעות הערכים האלה.

לפני שמפעילים אפליקציה ציבורית שניגשת ל-Library API, האפליקציה חייבת להיבדק על ידי Google. 'אפליקציה לא מאומתת' ההודעה תופיע בזמן בדיקת האפליקציה, עד מאומת.

רוצה לנסות את הדוגמה?

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