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 פיקסלים והגובה יהיה 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).

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

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

ContributorInfo

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

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

string

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

string

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

Methods

batchCreate

batchGet

get

list

patch

 מעדכנים את פריט המדיה עם id שצוין.