עדכונים לממשקי ה-API של Google Photos

פורסם בספטמבר 2024.

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

הערה: כל השינויים ייכנסו לתוקף במרץ 2025.

Library API: ההשפעה על תרחישים נפוצים לדוגמה

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

העלאת פריטים של מדיה ויצירת אלבומים

מה משתנה: אין שינוי. תוכלו להמשיך להעלות פריטי מדיה וליצור אלבומים באמצעות ההיקף photoslibrary.appendonly.

מה אפשר לעשות:

אם האפליקציה שלכם מעלה פריטים של מדיה או יוצרת אלבומים, חשוב לוודא שאתם משתמשים בהיקף photoslibrary.appendonly ולא בהיקף photoslibrary. ההיקף photoslibrary הוסר.

הצגת רשימה של אלבומים ופריטי מדיה, חיפוש שלהם ואחזור שלהם

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

מה אפשר לעשות:

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

שיתוף ואלבומים משותפים

מה ישתנה: אלבומים משותפים ופונקציות ה-API המשויכות (שיתוף, ביטול שיתוף, אחזור, הצטרפות, יציאה ורשימת אלבומים) יחזירו את הערך 403 PERMISSION_DENIED אחרי 31 במרץ 2025.

מה אפשר לעשות:

להפנות את המשתמשים לאפליקציית Google Photos כדי שהם יוכלו לנהל את השיתוף בעצמם. תוכלו לספק הוראות ברורות או קישורי עומק באפליקציה כדי להנחות אותם.

ניהול אלבומים שנוצרו על ידי אפליקציות: תוכן האלבומים והשיפורים

מה משתנה: השדה photoslibrary.edit.appcreateddata מתווסף לשלושת השיטות הבאות כדי לשמור על עקביות מושגית:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

מה אפשר לעשות:

• אם האפליקציה שלכם כבר משתמשת בשיטות האלה, כדאי להשתמש בהיקף photoslibrary.edit.appcreateddata כדי לפשט את תהליך ההרשאה.

Library API: היקפים ושיטות שהושפעו

כחלק מהשינויים שערכנו בממשקי Google Photos API, ביצענו את העדכונים הבאים.

כפי שמוצג בדף העדכון של ההרשאה, ההיקפים הבאים יוסרו מ-Library API אחרי 31 במרץ 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

ההיקפים הבאים יישארו:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

בטבלה הזו מפורטים השיטות וההיקפים הספציפיים של Library API שהושפעו.

עדכונים	Methods	טווחים
מעכשיו אפשר להשתמש בשיטות האלה רק עם אלבומים ופריטי מדיה שנוצרו על ידי האפליקציה שלכם.	albums.create mediaItems.batchCreate	ההיקפים שנותרו: photoslibrary.appendonly היקפים שהוסרו: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	ההיקפים שנותרו: photoslibrary.readonly.appcreateddata היקפים שהוסרו: photoslibrary photoslibrary.readonly
השיטות האלה לא יהיו זמינות יותר.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	ההיקפים שנותרו: ללא היקפים שהוסרו: photoslibrary.sharing הערה: האפליקציה sharedAlbums.list תוסר כי לא יהיו יותר אלבומים משותפים שנוצרו על ידה שיהיו זמינים להצגה ברשימה.
ה-method האלה יכללו את photoslibrary.edit.appcreateddata. עכשיו אפשר להשתמש בשיטות האלה רק עם אלבומים ופריטי מדיה שנוצרו על ידי האפליקציה שלכם.	albums.addEnrichment albums.batchAddMediaItems	ההיקפים שנותרו: photoslibrary.appendonly photoslibrary.edit.appcreateddata היקפים שהוסרו: photoslibrary
	albums.batchRemoveMediaItems	ההיקפים שנותרו: photoslibrary.edit.appcreateddata היקפים שהוסרו: photoslibrary
השיטות האלה לא ישתנו.	albums.patch mediaItems.patch	ההיקפים שנותרו: photoslibrary.edit.appcreateddata היקפים שהוסרו: ללא

עדכונים במדיניות של Photos API

מדיניות השימוש המקובל הנוכחית תוחלף ב-31 במרץ 2025 במדיניות החדשה למפתחים בנושא נתוני משתמש ב-Photos API. המדיניות החדשה זמינה עכשיו בתצוגה מקדימה.

עדכונים במסמכי התיעוד של Photos API

ביצענו שינויים משמעותיים במסמכי העזרה של Photos API כדי לשקף עדכונים עתידיים ולתמוך בחוויית הפיתוח שלכם:

• אתר מאוחד של Photos APIs: איחדנו את כל המשאבים של Photos API למיקום אחד (האתר הזה), כדי לספק למפתחים חוויה יעילה יותר. כאן תוכלו למצוא את הפרטים הבאים:
  • מקורות מידע מרוכזים: הוראות הגדרה והנחיות כלליות לשימוש, וגם מידע על תמיכה ועל מדיניות לגבי Picker API ו-Library API.
  • אתרים ייעודיים של ממשקי API: אתרים נפרדים עם מדריכים מפורטים, מסמכי עזרה ודוגמאות קוד ל-Picker API ול-Library API
• תוכן מעודכן של Library API: המסמכים של Library API עודכנו כך שישקפו את היכולות של Library API אחרי תקופת ההוצאה משימוש.

שאלות נפוצות

מה משתנה בממשקי Google Photos API?

אנחנו משיקים את Google Photos Picker API החדש לבחירת תמונות מאובטחת, ומעדכנים את Library API הקיים כדי להתמקד בניהול התמונות והסרטונים שנוצרו על ידי האפליקציה שלכם.

מתי השינויים האלה ייכנסו לתוקף?

השינויים האלה ייכנסו לתוקף ב-31 במרץ 2025. אנחנו ממליצים לכל מי שיש לו שילובים קיימים שמשתמשים ב-Library API לבחירת תמונות לעבור ל-Picker API בהקדם האפשרי.

איך Library API יושפע?

ההיקפים photoslibrary.readonly,‏ photoslibrary.sharing ו-photoslibrary יוסרו. קריאות API שמסתמכות רק על ההיקפים האלה יחזירו את הערך 403 PERMISSION_DENIED אחרי 31 במרץ 2025. מספר קריאות אחרות יוגבלו לשימוש רק בתמונות ובסרטונים שנוצרו על ידי האפליקציה.

בטבלה של ההיקפים והשיטות שמושפעים מהשינויים שבדף הזה אפשר לקרוא על כל השינויים.

מה צריך לעשות אם האפליקציה שלי משתמשת כרגע בהיקפים או בשיטות שמושפעים מהשינוי?

אם האפליקציה שלכם משתמשת באחד מההיקפים או השיטות שמושפעים מהבעיה, מומלץ לבצע את הפעולות הבאות:

• לבחירת תמונות: צריך לעבור ל-Google Photos Picker API.
• לפונקציונליות אחרת: כדאי לעיין במסמכי התיעוד המעודכנים של Library API כדי להבין את השינויים ולזהות תכונות באפליקציה שעשויות להיות לא זמינות יותר. יכול להיות שתצטרכו לשנות את הפונקציונליות של האפליקציה או לבדוק פתרונות חלופיים בתרחישי שימוש מסוימים.

מהו Google Photos Picker API?

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

איפה אפשר למצוא מידע נוסף על השינויים האלה?

בדף הזה שמוצג כרגע מופיעה סקירה כללית וסיכום של כל השינויים.

שאר המסמכים באתר שלנו עודכנו כך שישקפו את ממשקי ה-API המעודכנים.

בפוסט הזה בבלוג פורסמו השינויים.

מה עושים אם יש עוד שאלות או אם דרושה עזרה בהעברת האפליקציה?

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