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' תגדיר את המידות של פריט מדיה מסוג 'תמונה' לרוחב 2,048 פיקסלים ולגובה של 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).

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

ייצוג 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 וסטטוס עיבוד. חלק מהשדות האלה יכולים להיות null או לא כלולים.

ייצוג 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

batchGet

get

list

patch

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