תחילת העבודה עם 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. ה-API של הספרייה לא תומך בחשבונות שירות. כדי להשתמש ב-API הזה, המשתמשים צריכים להיות מחוברים לחשבון Google תקין.

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

הפעלת ה-API

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

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

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

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

1. נכנסים אל Google API Console ובוחרים את הפרויקט.
2. בתפריט, בוחרים באפשרות APIs & Services > Credentials.
3. בדף Credentials לוחצים על Create Credentials > OAuth client ID.
4. בוחרים את סוג האפליקציה. בדוגמה הזו, סוג האפליקציה הוא Web application.

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

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

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

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

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

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

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

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

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

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

   • Client ID
   • סוד לקוח

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

כדי להפעיל אפליקציה ציבורית שמשתמשת ב-Library API, האפליקציה צריכה להיבדק על ידי Google. כשבודקים את האפליקציה, ההודעה 'אפליקציה לא מאומתת' מופיעה במסך עד לאימות.

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

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