עדכונים לממשקי ה-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: היקפים ושיטות שהושפעו

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

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

שאלות נפוצות

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

אנחנו משיקים את 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 המעודכנים.

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

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

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