כדי להתחיל להשתמש ב-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, צריך להפעיל אותם בפרויקט.
- עוברים אל Google API Console.
- בסרגל התפריטים, בוחרים פרויקט או יוצרים פרויקט חדש.
- כדי לפתוח את אחד ממשקי ה-API של Google Photos, בתפריט הניווט בוחרים באפשרות APIs & Services > Library.
- מחפשים את 'תמונות'. בוחרים אחד או יותר מממשקי ה-API של Photos ולוחצים על הפעלה.
בקשה למזהה לקוח ב-OAuth 2.0
כדי לבקש מזהה לקוח ב-OAuth ולהגדיר אותו לאפליקציה, פועלים לפי השלבים הבאים. בדוגמה הזו נעשה שימוש באפליקציה שבה כל תהליך OAuth מטופל בצד השרת, כמו זו שבדוגמאות שלנו. תהליך ההגדרה עשוי להשתנות בהתאם לתרחישי הטמעה אחרים.
- נכנסים אל Google API Console ובוחרים את הפרויקט.
- בתפריט, בוחרים באפשרות APIs & Services > Credentials.
בדף Credentials, לוחצים על Create Credentials > OAuth client ID.
בוחרים את Application type (סוג האפליקציה). בדוגמה הזו, סוג האפליקציה הוא אפליקציית אינטרנט.
צריך לרשום את המקורות שמהם האפליקציה מורשית לגשת לממשקי ה-API של Google, באופן הבא:
- כדי לזהות את מזהה הלקוח, מזינים שם.
בשדה Authorized JavaScript origins, מזינים את המקור של האפליקציה. בשדה הזה אסור להשתמש בתווים כלליים לחיפוש.
אפשר להזין כמה מקורות כדי לאפשר לאפליקציה לפעול בפרוטוקולים, בדומיינים או בתת-דומיינים שונים. לכתובות ה-URL שאתם מזינים יש אפשרות להתחיל בקשת OAuth.
בדוגמה הבאה מוצגת כתובת URL לפיתוח מקומי (בדוגמאות שלנו נעשה שימוש ב-
localhost:8080
) וכתובת URL לסביבת הייצור.http://localhost:8080 https://myproductionurl.example.com
השדה Authorized redirect URI הוא נקודת הקצה שמקבלת תשובות משרת OAuth 2.0. בדרך כלל, הפעולות האלה כוללות את סביבת הפיתוח ומפנות לנתיב באפליקציה.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
לוחצים על יצירה.
-
מעתיקת הפרטים הבאים מתיבת הדו-שיח של לקוח ה-OAuth שנוצרה:
- Client-ID
- סוד לקוח
האפליקציה שלך יכולה לגשת לממשקי Google API המופעלים באמצעות הערכים האלה.
לפני שמפעילים אפליקציה ציבורית עם גישה לממשקי ה-API של Photos, האפליקציה צריכה להיבדק על ידי Google. ההודעה 'אפליקציה לא מאומתת' תופיע במסך כשבודקים את האפליקציה, עד שהיא תאומת.
אחרי שתגדירו את האפליקציה, תוכלו להתחיל:
שינוי של מזהה הלקוח
אפשר לגשת למשאבים שנוצרו דרך כל אחד מממשקי ה-API של Google Photos או לשנות אותם רק באמצעות מזהה הלקוח המקורי ששימש ליצירת אותם. לדוגמה, אם יוצרים 'סשן' ב-Picker API עם מזהה לקוח ספציפי, ומחליפים את מזהה הלקוח הזה באפליקציה בשלב מאוחר יותר, האפליקציה תאבד את הגישה לכל משאבי ה-API שנוצרו עם מזהה הלקוח הקודם.
כדאי לתכנן בקפידה ולבחור את הסוג של מזהה הלקוח שמתאים ל-Photos API שבו אתם משתמשים. חשוב לשנות את מזהה הלקוח רק אם הדבר הכרחי כדי למנוע בעיות בגישה.