נתוני גרסה

להירשם לנתוני הגרסה האלה.

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

במסמכי העזרה ובמדריכים מצוין איזו גרסה יש להשתמש בה.

1 באפריל 2025

הערות

במהדורה הזו מוטמעים השינויים שפורסמו בעבר בממשקי ה-API של Photos.

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

פרטים מלאים זמינים במאמר עדכונים בממשקי Google Photos API.

16 בספטמבר 2024

תכונות

• השקנו את Picker API החדש לבחירת תמונות בצורה מאובטחת ונוחה למשתמש.

הערות

במהדורה הזו הודענו על שינויים מרכזיים ב-Library API (החל מ-31 במרץ 2025).

• Library API ינהל רק תמונות וסרטונים שנוצרו על ידי האפליקציה שלכם.
• הסרה של היקפי ההרשאות photoslibrary.readonly,‏ photoslibrary.sharing ו-photoslibrary.
• הגבלת כמה שיטות לתוכן שנוצר באפליקציה בלבד.

הפרטים המלאים מופיעים בדף עדכונים בממשקי Google Photos API.

27 באוקטובר 2022

הערות

• סדנת הקוד 'פיתוח אפליקציה לשיתוף תמונות באמצעות Google Photos ו-Flutter' כבר לא זמינה. כדאי לעיין בדוגמאות האחרות שלנו ולהיעזר בקוד לדוגמה במדריכים שלנו.

1 ביוני 2022

הערות

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

‫27 באוקטובר 2021

תכונות

• תוכנית השותפים של Google Photos: השקת הרמה הבכירה. ברמה הזו מקבלים חבילה של תכונות API משופרות שמנצלות את הבינה המלאכותית החזקה של Google Photos.

29 בספטמבר 2021

תכונות

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

21 ביולי 2021

תכונות

• פרמטר חדש -no לכתובות URL בסיסיות של סרטונים כדי לטעון תמונות ממוזערות ללא שכבת-על של לחצן הפעלה. כברירת מחדל, התמונות הממוזערות של הסרטונים נטענות עם שכבת-על של כפתור הפעלה. הפרמטר החדש הזה מאפשר לכם להסתיר את לחצן ההפעלה בתמונות הממוזערות של הסרטונים.

בעיות שנפתרו

• בעיה 181282432: תמונות ממוזערות של סרטונים תמיד מוצגות עם שכבת-על של לחצן הפעלה.

25 במאי 2021

בעיות שנפתרו

• הנכס exposureTime לא מאוכלס במטא-נתונים של photo בפריטי מדיה.

19 במאי 2021

הערות

• תיעוד כתובת ה-URL הבסיסית לתמונות עם תנועה עודכן כדי להבהיר את ההתנהגות של הפרמטר =dv בתמונות עם תנועה ב-Android ובתמונות חיות ב-iOS.

11 בפברואר 2021

הערות

• מדיניות השימוש המקובל עודכנה, והוספו לה תכנים בנושא פרסום וצמצום השימוש בנתונים.

7 ביולי 2020

תכונות

• ממשק ה-API עודכן כדי לתמוך באמצעי הבקרה החדשים לשיתוף ב-Google Photos. עכשיו מוחזר שדה חדש, isJoinable, כחלק מהמאפיין shareInfo של אלבומים משותפים. ה-API יכול להצטרף משתמשים לאלבום משותף כשהערך של isJoinable הוא true. אם הבעלים השבית את שיתוף הקישור של אלבום ב-Google Photos, הערך של isJoinable יהיה false וה-API לא יוכל לצרף משתמשים לאלבום הזה.
• בעיות 111405623,‏ 116379853,‏ 117685011: עכשיו אפשר לשנות את שמות האלבומים ואת התמונות שלהם וגם לשנות את התיאורים של פריטי המדיה שנוצרו באפליקציה. מבקשים את היקף ההרשאה החדש photoslibrary.edit.appcreateddata כדי לקבל גישה לעדכון.

17 בפברואר 2020

תכונות

• גודל הקובץ המקסימלי שאפשר להעלות של תמונה הועלה מ-75MB ל-200MB.
• כשאתם מעלים קבצים, עכשיו צריך לציין את סוג ה-MIME בשלב העלאת הבייטים.
• עכשיו צריך לציין שמות של קובצי מדיה בזמן יצירת פריט מדיה, במקום בזמן העלאת ביטים של מדיה. הנכס החדש fileName ב-simpleMediaItem תומך במחרוזות UTF-8. עדיין אפשר לציין את שם הקובץ של פריט המדיה כשאתם מעלים ביטים של מדיה, אבל מומלץ מאוד לעדכן את ההטמעה.

הערות

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

16 באוגוסט 2019

תכונות

• בעיה 131874809: נוסף מאפיין חדש isOwned ב-shareInfo כדי לזהות אם המשתמש הוא הבעלים של האלבום המשותף. פרטים נוספים זמינים במדריך למפתחים בנושא שיתוף מדיה.

בעיות שנפתרו

• בעיה 131711405: המאפיין shareableUrl חסר בתגובה albums.list.
• בעיה 113870729: לפעמים mediaItems.list החזיר פריטים כפולים של מדיה בגבולות הדפים.
• בעיה 93428763: השדה status למטא-נתונים של הסרטון מחזיר עכשיו בצורה נכונה את הערך VideoProcessingStatus של הסרטון באיכות הגבוהה ביותר שזמין.

12 ביוני 2019

תכונות

• בעיה 110188560: מסנן חיפוש חדש לבחירת פריטי מדיה שסומנו כפריטי מועדפים: FeatureFilter.
• קטגוריות תוכן חדשות לContentFilter כדי לסנן פריטי מדיה שתואמים לקטגוריות ספציפיות: ARTS, ‏ CRAFTS,‏ FASHION, ‏ HOUSES, ‏ GARDENS, ‏ FLOWERS, ‏ HOLIDAYS.

הערות

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

7 במאי 2019

Codelabs

• Codelab חדש: פיתוח אפליקציה לשיתוף תמונות באמצעות Google Photos ו-Flutter. איך יוצרים אפליקציה לשיתוף תמונות באמצעות Google Photos Library API ב-Flutter? לפרטים נוספים, ראו מדריך לדוגמאות.

29 באפריל 2019

תכונות

• בעיה 109505022: הוספה והסרה של פריטים קיימים לאלבום:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

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

• קריאת ה-REST ליצירת פריטי מדיה mediaItems.batchCreate מחזירה עכשיו את סטטוס ה-HTTP 207 MULTI-STATUS אם לא ניתן היה ליצור חלק מפריטי המדיה. פרטים נוספים זמינים במדריך למפתחים בנושא העלאת מדיה.

הערות

• הגרסאות האחרונות של ספריות הלקוח כוללות שינוי שגורם לשבירה. הכיתות שקשורות ל-MediaItem, ל-Album ול-DateRange הועברו לחבילה חדשה ייעודית. הפונקציונליות שלהם לא השתנתה, רק המיקום שלהם בספריית הלקוח. אפשר לעיין בהערות למהדורה של ספריית הלקוח של Java (1.2.0) ושל ספריית הלקוח של PHP (1.2.0).

14 בפברואר 2019

הערות

• חלה מכסה חדשה על גישה לבייטים של מדיה מכתובות URL בסיסיות. אפשר לעקוב אחרי המכסה הזו ב-Google API Console.

בעיות שנפתרו

• בעיה 124355983: שגיאות 500 בקריאה ל-mediaItems.get לגבי פריטים מסוימים של מדיה משותפת.

21 בינואר 2019

בעיות שנפתרו

• בעיה 121998358: המאפיין isWriteable חסר בתגובה albums.create.

7 בינואר 2019

בעיות שנפתרו

• בעיה 118464845: mediaItems.list החזיר יותר מדי דפים ריקים.
• בעיה 111714379: mediaItems.search החזיר מחצית מ-pageSize.

30 בנובמבר 2018

תכונות

• קריאה חדשה mediaItems.batchGet לאחזור מספר פריטי מדיה לפי המזהים שלהם.
• בעיה 111279349: אפשרות חדשה sharedAlbums.leave לעזוב אלבום משותף.
• בעיה 111279347: הוספה של קריאה חדשה albums.unshare לסימון אלבום משותף כפרטי.

בעיות שנפתרו

• בעיה 113978705: תיאורים שהוגדרו ב-mediaItems.batchCreate הומרו לישות HTML.
• בעיה 114462217: לא ניתן היה להגדיר שם קובץ עבור קובצי וידאו ב-mediaItems.batchCreate.
• בעיה 118475587: המערכת החזירה כתובות URL לא תקינות של מוצרים עבור פריטי מדיה.
• בעיה 111862704: שגיאות 403 בזמן הגישה לכתובות URL בסיסיות.
• בעיה 115932469: העלאות נכשלות עם שגיאת מכסה.

6 בספטמבר 2018

תכונות

• ספריות הלקוח של Java ו-PHP זמינות עכשיו.

הערות

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

5 בספטמבר 2018

תכונות

• שיחה חדשה sharedAlbums.get כדי לקבל אלבום באמצעות shareToken.
• נכס חדש isJoined ב-shareInfo כדי לזהות אם המשתמש הצטרף לאלבום המשותף.

בעיות שנפתרו

• בעיה 79321120: המאפיין mimeType חסר בתגובה mediaItems.batchCreate עבור פריטי מדיה מסוג וידאו.
• בעיה 79319272: מאפיינים כמו mediaMetadata ו-contributorInfo חסרים בתגובה mediaItems.batchCreate.
• בעיה 110237685: תוקנה בעיה בהעלאת קבצים שקשורה ל-CORS.
• בעיה 79318118: לא נשמר סדר עקבי כשהעליתם כמה פריטים לאלבום בקריאה mediaItems.batchCreate.

הערות

• אם שמרתם מזהים (כמו מזהים של אלבומים, פריטים של מדיה או פריטים של העשרה) לפני 5 בספטמבר 2018, הם לא יפעלו יותר כי הפורמט השתנה. תצטרכו לקבל מזהים חדשים לשימוש באפליקציה.
• השם של המאפיין totalMediaItems של המשאב album השתנה ל-mediaItemsCount.
• הערך המקסימלי של הפרמטר pageSize בקריאות mediaItems.list ו-mediaItems.search השתנה ל-100. מספר ברירת המחדל של פריטי המדיה שמוחזרים כשלא מציינים את הפרמטר pageSize השתנה ל-25.
• המדריכים בנושא רשימת התוכן בספרייה, שיתוף מדיה וגישה לפריטי מדיה עודכנו עם תכונת המסנן excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) שפורסמה ב-31 ביולי 2018.

31 ביולי 2018

תכונות

• קריאה חדשה mediaItems.list להצגת רשימה של פריטי מדיה.
• מסנן חדש excludeNonAppCreatedData לחיפוש פריטים או לרישום אלבומים שנוצרו על ידי האפליקציה.
• פרמטרים חדשים לגישה לתמונות:
  • בעיה 79871479: פרמטר החיתוך c, כדי לחתוך את התמונה לממדים מדויקים.
  • בעיה 110343547,‏ בעיה 111228390: הפרמטר d להורדה, כדי להוריד את התמונה המקורית.
• הקריאה sharedAlbums.join מחזירה עכשיו אלבום.
• בעיה 109655786: album מכיל עכשיו את מזהה פריט המדיה של תמונת השער, coverPhotoMediaItemId.
• בעיה 79656863: עכשיו השדה mediaItem מכיל את שם הקובץ של פריט המדיה, filename.

בעיות שנפתרו

• בעיה 79757390: שם הקובץ לא הוגדר במהלך בקשות ההעלאה. מידע נוסף על השדות X-Goog-Upload-File-Namefile ו-X-Goog-Upload-Protocol זמין במדריך העלאת מדיה.
• בעיה 80182372: העלאות שניתן להמשיך החזירו שגיאה. במדריך החדש בנושא העלאות שניתן להמשיך מוסבר על הפרוטוקול המעודכן.
• בעיה 79497397: המאפיין isWriteable חסר בתגובה albums.list.
• בעיה 111143493: המסנן של קטגוריית התוכן PEOPLE החזיר תוצאות לא מדויקות.
• בעיה 111056278: המסנן של קטגוריית התוכן BIRTHDAYS החזיר שגיאה.

גרסת בטא – 8 במאי 2018

הגרסה הראשונית של Library API.

בעיות מוכרות

• הפונקציה GET mediaItem תשליך שגיאה אם פריט המדיה id שהיא מקבלת הוא פריט מדיה מאלבום משותף שאינו בבעלות המשתמש.
• התגובה מהקריאה ל-batchCreate לא תחזיר את הערכים mediaMetadata או contributorInfo.
• אם פריט המדיה הוא סרטון, הקריאה ל-batchCreate לא תחזיר mimeType.
• המערכת של batchCreate לא שומרת על סדר עקבי כשמעלים כמה פריטים.
• batchCreate לא תומך בסדר (הוספה של position) כשיוצרים פריטים של מדיה באלבום משותף בתור הבעלים של האלבום המשותף. כברירת מחדל, הוא מגיע לסוף האלבום.