REST Resource: mediaItems

משאב: PickedMediaItem

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

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

string

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

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
שדות
baseUrl

string

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

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

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

string

סוג ה-MIME של קובץ המדיה. לדוגמה, image/jpeg.
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, רוחק מוקד וזמן חשיפה. חלק מהשדות האלה יכולים להיות null או לא כלולים.

ייצוג JSON 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
שדות
focalLength

number

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

number

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

integer

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

string (Duration format)

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

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

object (PrintMetadata)

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

PrintMetadata

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

ייצוג JSON 
{
  "qualityScore": enum (Score)
}
שדות
qualityScore

enum (Score)

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

אין להשתמש בציון כדי לייעץ למשתמשים לגבי הדפסה. הציון מוגדר ל-HIGH אם התמונה באיכות גבוהה והמשתמש ירצה להדפיס אותה. הציון NORMAL מציין שייתכן שהתמונה אינה באיכות גבוהה. SCORE_UNSPECIFIED מציין שאין ניקוד זמין.

ניקוד

ניקוד שמתאר את ההתאמה להדפסה של תמונה.

טיפוסים בני מנייה (enum)
SCORE_UNSPECIFIED הציון לא מצוין כברירת מחדל.
HIGH התמונה קיבלה תוצאה גבוהה.
NORMAL לתמונה יש ציון רגיל.

VideoMetadata

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

ייצוג JSON 
{
  "fps": number
}
שדות
fps

number

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

שיטות

list

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