REST Resource: mediaItems

משאב: MediaItem

ייצוג של פריט מדיה (כמו תמונה או סרטון) ב-Google Photos.

ייצוג JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
שדות
id

string

מזהה של פריט המדיה. זהו מזהה קבוע שיכול לשמש לזיהוי פריט המדיה הזה בין סשנים.
description

string

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

string

כתובת ה-URL של פריט המדיה ב-Google Photos. הקישור זמין למשתמשים רק אם הם מחוברים לחשבון. כשמאחזרים אותו מחיפוש באלבום, כתובת ה-URL מפנה לפריט שבאלבום.
baseUrl

string

כתובת URL לבייטים של פריט המדיה. אין להשתמש בשם הזה. צריך להוסיף פרמטרים לכתובת ה-URL הזו לפני השימוש. כדי לקבל רשימה מלאה של הפרמטרים הנתמכים, אפשר לעיין בתיעוד למפתחים. לדוגמה, '=w2048-h1024' יגדיר את המידות של פריט מדיה מסוג תמונה כך ברוחב של 2,048 פיקסלים ובגובה של 1024 פיקסלים.
mimeType

string

סוג MIME של פריט המדיה. לדוגמה, image/jpeg.
mediaMetadata

object (MediaMetadata)

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

object (ContributorInfo)

מידע על המשתמש שהוסיף את פריט המדיה הזה. לתשומת ליבך, האפשרות הזו כלולה רק כשמשתמשים ב-mediaItems.search עם המזהה של אלבום משותף. האלבום נוצר על ידי האפליקציה שלך וצריך להיות לו היקף השיתוף.
filename

string

שם הקובץ של פריט המדיה. השם יוצג למשתמש בקטע המידע של הפריט באפליקציית Google Photos.

MediaMetadata

מטא-נתונים של פריט מדיה.

ייצוג JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
שדות
creationTime

string (Timestamp format)

השעה שבה פריט המדיה נוצר לראשונה (לא מתי הוא הועלה ל-Google Photos).

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
width

string (int64 format)

הרוחב המקורי (בפיקסלים) של פריט המדיה.
height

string (int64 format)

הגובה המקורי (בפיקסלים) של פריט המדיה.
שדה איחוד metadata. מטא-נתונים עבור פריט המדיה הספציפי לסוג המדיה הבסיסי שהוא מייצג. metadata יכול להיות רק אחד מהבאים:
photo

object (Photo)

מטא-נתונים לסוג מדיה של תמונה.
video

object (Video)

מטא-נתונים לסוג מדיה של וידאו.

תמונה

מטא-נתונים ספציפיים לתמונה, כמו ISO, רוחק מוקד וזמן חשיפה. יכול להיות שחלק מהשדות האלה יהיו ריקים או לא ייכללו.

ייצוג JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
שדות
cameraMake

string

המותג של המצלמה שבאמצעותה צולמה התמונה.
cameraModel

string

דגם המצלמה שבאמצעותה צולמה התמונה.
focalLength

number

אורך המוקד של עדשת המצלמה שבה צולמה התמונה.
apertureFNumber

number

מספר הצמצם של עדשת המצלמה שבאמצעותה צולמה התמונה.
isoEquivalent

integer

ISO של המצלמה שבה צולמה התמונה.
exposureTime

string (Duration format)

זמן החשיפה של צמצם המצלמה כאשר התמונה צולמה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".

וידאו

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

ייצוג JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
שדות
cameraMake

string

מותג המצלמה שבאמצעותה הסרטון צולם.
cameraModel

string

דגם המצלמה שבאמצעותה צולם הסרטון.
fps

number

קצב הפריימים של הסרטון.
status

enum (VideoProcessingStatus)

סטטוס העיבוד של הסרטון.

VideoProcessingStatus

סטטוס העיבוד של סרטון שהועלה ל-Google Photos.

טיפוסים בני מנייה (enums)
UNSPECIFIED סטטוס עיבוד הסרטון לא ידוע.
PROCESSING הסרטון בעיבוד. המשתמש רואה סמל של הסרטון הזה באפליקציית Google Photos, אבל עדיין לא ניתן להפעיל אותו.
READY עיבוד הסרטון הושלם והוא מוכן לצפייה. חשוב: ניסיון להוריד סרטון שאינו במצב READY עלול להיכשל.
FAILED משהו השתבש ועיבוד הסרטון נכשל.

ContributorInfo

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

ייצוג JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
שדות
profilePictureBaseUrl

string

כתובת ה-URL של תמונת הפרופיל של השותף ביצירת התוכן.
displayName

string

השם המוצג של השותף ביצירת התוכן.

שיטות

batchCreate

 יצירת פריט מדיה אחד או יותר בספריית Google Photos של המשתמש.

batchGet

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

get

 מחזירה את פריט המדיה עבור מזהה פריט המדיה שצוין.

list

 הצגת רשימה של כל פריטי המדיה מספריית Google Photos של המשתמש.

patch

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