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

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

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

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

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

בקטעים הבאים מפורטת ההשפעה של השינויים הצפויים על השימוש הנפוץ במקרים שונים.

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

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

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

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

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

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

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

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

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

מה עומד להשתנות: אלבומים משותפים והפונקציות המשויכות ל-API (שיתוף, unshare, get, join, take,! , ו-list) מחזירה 403 PERMISSION_DENIED אחרי 31 במרץ 2025.

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

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

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

מה משתנה: מתבצעת הוספה של photoslibrary.edit.appcreatedata אל את שלוש השיטות הבאות לעקביות רעיונית:

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

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

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

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

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

כפי שמופיע בהרשאה המעודכנת page, את ההיקפים הבאים יוסר מ-Library API אחרי 31 במרץ 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

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

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

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

עדכונים	שיטות	טווחים
ניתן להשתמש בשיטות האלה רק באלבומים ובפריטי מדיה שנוצרו באמצעות האפליקציה. נכללים בכך פריטי מדיה שנבחרו באמצעות Picker API ונוספו לספריית המשתמש באמצעות Library API.	albums.create mediaItems.batchCreate	היקפי ההרשאות שנותרו: photoslibrary.appendonly היקפי הרשאות שהוסרו: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	היקפי ההרשאות שנותרו: photoslibrary.readonly.appcreatedata היקפי הרשאות שהוסרו: photoslibrary photoslibrary.readonly
השיטות האלה לא יהיו זמינות יותר.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	היקפי ההרשאות שנותרו: ללא היקפי הרשאות שהוסרו: photoslibrary.sharing הערה: מתבצעת הסרה של sharedAlbums.list מפני שהאלבומים המשותפים שנוצרו על ידי האפליקציה שלך לא יהיו זמינים לרשימה.
לשיטות האלה יתווסף photoslibrary.edit.appcreatedata. עכשיו אפשר להשתמש בשיטות האלה רק עם אלבומים ופריטי מדיה שהאפליקציה שלך יצרה. נכללים בכך פריטי מדיה שנבחרו באמצעות Picker API ונוספו לספריית המשתמש באמצעות Library API.	albums.addEnrichment albums.batchAddMediaItems	היקפי ההרשאות שנותרו: photoslibrary.appendonly photoslibrary.edit.appcreatedata היקפי הרשאות שהוסרו: photoslibrary
	albums.batchRemoveMediaItems	היקפי ההרשאות שנותרו: photoslibrary.edit.appcreatedata היקפים שהוסרו: photoslibrary
השיטות האלה לא ישתנו.	albums.patch mediaItems.patch	היקפי ההרשאות שנותרו: photoslibrary.edit.appcreatedata היקפי הרשאות שהוסרו: ללא

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

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

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

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

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

שאלות נפוצות

מה השתנה בממשקי ה-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 חלק מהשיחות האחרות יוגבלו לעבודה בלבד עם תמונות וסרטונים שהאפליקציה יצרה.

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

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

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

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

מהו Google Photos Picker API?

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

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

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

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

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

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

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