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

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

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

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

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

קודם מפעילים את ה-API ואז מבקשים מזהה לקוח ב-OAuth 2.0.

הפעלת ה-API

כדי להשתמש בממשקי ה-API של Photos, צריך להפעיל אותם בפרויקט.

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

הערה: כשמחפשים ממשקי API של Google, יכול להיות שיופיע גם 'Google Picker API', שהוא שונה מ-Google Photos Picker API.

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

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

1. נכנסים אל Google API Console ובוחרים את הפרויקט.
2. בתפריט, בוחרים באפשרות APIs & Services (ממשקי API ושירותים) > Credentials (פרטי כניסה).

3. בדף Credentials, לוחצים על Create Credentials > OAuth client ID.

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

4. בוחרים את סוג האפליקציה. בדוגמה הזו, סוג האפליקציה הוא Web application.

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

   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 המופעלים.

לפני שמפעילים אפליקציה ציבורית עם גישה לממשקי ה-API של Photos, האפליקציה צריכה להיבדק על ידי Google. כשאתם בודקים את האפליקציה, תופיע במסך ההודעה "Un מאומתים app" (אפליקציה לא מאומתת) עד שהיא מאומתת.

אחרי שתגדירו את האפליקציה, תוכלו להתחיל:

• תחילת העבודה עם Picker API
• תחילת העבודה עם Library API

שינוי מזהה הלקוח

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

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