משאב: MediaItem
ייצוג של פריט מדיה (כמו תמונה או סרטון) ב-Google Photos.
ייצוג JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
שדות | |
---|---|
id |
מזהה של פריט המדיה. זהו מזהה קבוע שיכול לשמש לזיהוי פריט המדיה הזה בין סשנים. |
description |
תיאור של פריט המדיה. התיאור מוצג למשתמש בקטע המידע של הפריט באפליקציית Google Photos. האורך המקסימלי הוא 1,000 תווים. יש לכלול רק טקסט שנכתבו על ידי משתמשים. התיאורים צריכים להוסיף הקשר ולעזור למשתמשים להבין את המדיה. אל תכללו מחרוזות שנוצרו באופן אוטומטי, כמו שמות קבצים, תגים ומטא-נתונים אחרים. |
productUrl |
כתובת ה-URL של פריט המדיה ב-Google Photos. הקישור זמין למשתמשים רק אם הם מחוברים לחשבון. כשמאחזרים אותו מחיפוש באלבום, כתובת ה-URL מפנה לפריט שבאלבום. |
baseUrl |
כתובת URL לבייטים של פריט המדיה. אין להשתמש בשם הזה. צריך להוסיף פרמטרים לכתובת ה-URL הזו לפני השימוש. כדי לקבל רשימה מלאה של הפרמטרים הנתמכים, אפשר לעיין בתיעוד למפתחים. לדוגמה, |
mimeType |
סוג MIME של פריט המדיה. לדוגמה, |
mediaMetadata |
מטא-נתונים שקשורים לפריט המדיה, כמו גובה, רוחב או זמן יצירה. |
contributorInfo |
מידע על המשתמש שהוסיף את פריט המדיה הזה. לתשומת ליבך, האפשרות הזו כלולה רק כשמשתמשים ב- |
filename |
שם הקובץ של פריט המדיה. השם יוצג למשתמש בקטע המידע של הפריט באפליקציית Google Photos. |
MediaMetadata
מטא-נתונים של פריט מדיה.
ייצוג JSON |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
שדות | |
---|---|
creationTime |
השעה שבה פריט המדיה נוצר לראשונה (לא מתי הוא הועלה ל-Google Photos). חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
width |
הרוחב המקורי (בפיקסלים) של פריט המדיה. |
height |
הגובה המקורי (בפיקסלים) של פריט המדיה. |
שדה איחוד metadata . מטא-נתונים עבור פריט המדיה הספציפי לסוג המדיה הבסיסי שהוא מייצג. metadata יכול להיות רק אחד מהבאים: |
|
photo |
מטא-נתונים לסוג מדיה של תמונה. |
video |
מטא-נתונים לסוג מדיה של וידאו. |
תמונה
מטא-נתונים ספציפיים לתמונה, כמו ISO, רוחק מוקד וזמן חשיפה. יכול להיות שחלק מהשדות האלה יהיו ריקים או לא ייכללו.
ייצוג JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
שדות | |
---|---|
cameraMake |
המותג של המצלמה שבאמצעותה צולמה התמונה. |
cameraModel |
דגם המצלמה שבאמצעותה צולמה התמונה. |
focalLength |
אורך המוקד של עדשת המצלמה שבה צולמה התמונה. |
apertureFNumber |
מספר הצמצם של עדשת המצלמה שבאמצעותה צולמה התמונה. |
isoEquivalent |
ISO של המצלמה שבה צולמה התמונה. |
exposureTime |
זמן החשיפה של צמצם המצלמה כאשר התמונה צולמה. משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-' |
וידאו
מטא-נתונים שהם ספציפיים לסרטון, לדוגמה FPS וסטטוס עיבוד. יכול להיות שחלק מהשדות האלה יהיו ריקים או לא ייכללו.
ייצוג JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
שדות | |
---|---|
cameraMake |
מותג המצלמה שבאמצעותה הסרטון צולם. |
cameraModel |
דגם המצלמה שבאמצעותה צולם הסרטון. |
fps |
קצב הפריימים של הסרטון. |
status |
סטטוס העיבוד של הסרטון. |
VideoProcessingStatus
סטטוס העיבוד של סרטון שהועלה ל-Google Photos.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
סטטוס עיבוד הסרטון לא ידוע. |
PROCESSING |
הסרטון בעיבוד. המשתמש רואה סמל של הסרטון הזה באפליקציית Google Photos, אבל עדיין לא ניתן להפעיל אותו. |
READY |
עיבוד הסרטון הושלם והוא מוכן לצפייה. חשוב: ניסיון להוריד סרטון שאינו במצב READY עלול להיכשל. |
FAILED |
משהו השתבש ועיבוד הסרטון נכשל. |
ContributorInfo
מידע על המשתמש שהוסיף את פריט המדיה. חשוב לזכור שהמידע הזה נכלל רק אם פריט המדיה נמצא באלבום משותף שנוצר על ידי האפליקציה ובתנאי שבחרת לשתף.
ייצוג JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
שדות | |
---|---|
profilePictureBaseUrl |
כתובת ה-URL של תמונת הפרופיל של השותף ביצירת התוכן. |
displayName |
השם המוצג של השותף ביצירת התוכן. |
שיטות |
|
---|---|
|
יצירת פריט מדיה אחד או יותר בספריית Google Photos של המשתמש. |
|
מחזירה את הרשימה של פריטי המדיה עבור המזהים שצוינו של פריטי המדיה. |
|
מחזירה את פריט המדיה עבור מזהה פריט המדיה שצוין. |
|
הצגת רשימה של כל פריטי המדיה מספריית Google Photos של המשתמש. |
|
מעדכנים את פריט המדיה עם הערך id שצוין. |
|
חיפוש פריטי מדיה בספריית Google Photos של המשתמש. |