REST Resource: mediaItems

משאב: PickedMediaItem

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

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

string

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

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

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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

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