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' מגדיר את המימדים של פריט מדיה מסוג תמונה כך שהרוחב יהיה 2048 פיקסלים והגובה יהיה 1,024 פיקסלים.
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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

מספר צמצם f בעדשת המצלמה שבה צולמה התמונה.
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.

טיפוסים בני מנייה (enum)
UNSPECIFIED סטטוס העיבוד של הסרטון לא ידוע.
PROCESSING הסרטון בתהליך עיבוד. המשתמש יראה סמל של הסרטון הזה באפליקציית Google Photos. עם זאת, עדיין לא ניתן להפעיל אותו.
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 של משתמש.