REST Resource: mediaItems

משאב: PickedMediaItem

ייצוג של תמונה או סרטון שנבחרו על ידי המשתמש.

ייצוג ב-JSON 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
שדות
id

string

המזהה של פריט המדיה.

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

string (Timestamp format)

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

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

enum (Type)

הסוג של פריט המדיה הזה.
mediaFile

object (MediaFile)

קובץ המדיה שמרכיב את פריט המדיה הזה.

סוג

הסוג של פריט המדיה.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED הסוג לא צוין.
PHOTO פריט המדיה מייצג תמונה.
VIDEO פריט המדיה מייצג סרטון.

MediaFile

ייצוג של קובץ מדיה.

ייצוג ב-JSON 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
שדות
baseUrl

string

כתובת URL לאחזור הבייטים של קובץ המדיה.

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

לדוגמה, '=w2048-h1024' מגדיר את המימדים של פריט מדיה מסוג תמונה כך שהרוחב יהיה 2,048 פיקסלים והגובה יהיה 1,024 פיקסלים.
mimeType

string

סוג ה-MIME של קובץ המדיה. לדוגמה, image/jpeg.
filename

string

שם הקובץ של קובץ המדיה.
mediaFileMetadata

object (MediaFileMetadata)

מטא-נתונים שקשורים לקובץ המדיה, כמו גובה ורוחב.

MediaFileMetadata

מטא-נתונים על קובץ מדיה.

ייצוג ב-JSON 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
שדות
width

integer

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

integer

הגובה המקורי (בפיקסלים) של קובץ המדיה.
cameraMake

string

המותג של המצלמה שבה צולמה המדיה.
cameraModel

string

הדגם של המצלמה שבה צולמה התמונה או הסרטון.
שדה האיחוד metadata. מטא-נתונים של קובץ המדיה שספציפיים לסוג המדיה שלו. הערך של metadata יכול להיות רק אחת מהאפשרויות הבאות:
photoMetadata

object (PhotoMetadata)

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

object (VideoMetadata)

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

PhotoMetadata

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

יכול להיות שחלק מהשדות האלה לא יוגדרו.

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

number

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

number

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

integer

ערך ה-ISO של המצלמה שבה צולמה התמונה.
exposureTime

string (Duration format)

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

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

VideoMetadata

מטא-נתונים ספציפיים לסרטון. לדוגמה, fps.

ייצוג ב-JSON 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
שדות
fps

number

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

enum (VideoProcessingStatus)

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

VideoProcessingStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין סטטוס עיבוד הסרטון.
PROCESSING

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

המשתמש רואה סמל של הסרטון הזה באפליקציית Google Photos, אבל עדיין לא ניתן להפעיל אותו.
READY

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

יכול להיות שניסיון להוריד סרטון שלא נמצא בסטטוס READY יכשל.
FAILED משהו השתבש והסרטון לא עבר עיבוד.

Methods

list

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