הערות מוצר

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

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

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

27 באוקטובר 2022

הערות

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

1 ביוני 2022

הערות

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

27 באוקטובר 2021

פיצ'רים

• תוכנית השותפים של Google Photos: השקה של רמה מתקדמת. המסלול המתקדם הוא חבילה של תכונות API מתקדמות שמתבססות על הבינה המלאכותית (AI) העוצמתית של תמונות Google.

29 בספטמבר 2021

פיצ'רים

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

21 ביולי 2021

פיצ'רים

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

בעיות שנפתרו

• בעיה 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.

בעיות שנפתרו

• בעיה 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 זמינות עכשיו.

הערות

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