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 )

فایل رسانه ای که این آیتم رسانه ای را تشکیل می دهد.

تایپ کنید

نوع یک آیتم رسانه ای

Enums
TYPE_UNSPECIFIED نوع آن مشخص نشده است.
PHOTO آیتم رسانه نشان دهنده یک عکس است.
VIDEO مورد رسانه یک ویدیو را نشان می دهد.

MediaFile

نمایش یک فایل رسانه ای

نمایندگی JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
فیلدها
baseUrl

string

URL برای واکشی بایت های فایل رسانه.

برای دانلود یک فایل رسانه ای، سرویس گیرنده API باید پارامترهای مشخص شده در مستندات توسعه دهنده را به این URL اضافه کند.

برای مثال، '=w2048-h1024' ابعاد یک آیتم رسانه ای از نوع عکس را به عرض 2048 پیکسل و ارتفاع 1024 پیکسل تنظیم می کند.

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

دیافراگم f عدد لنز دوربینی که عکس با آن گرفته شده است.

isoEquivalent

integer

ISO دوربینی که عکس با آن گرفته شده است.

exposureTime

string ( Duration format)

زمان نوردهی دیافراگم دوربین در هنگام گرفتن عکس.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

داده های ویدیویی

فراداده ای که مختص یک ویدیو است. مثلا fps.

نمایندگی JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
فیلدها
fps

number

نرخ فریم ویدیو.

processingStatus

enum ( VideoProcessingStatus )

وضعیت پردازش ویدیو

وضعیت پردازش ویدیو

در حال پردازش وضعیت یک ویدیوی ذخیره شده در Google Photos.

Enums
UNSPECIFIED وضعیت پردازش ویدیو مشخص نشده است.
PROCESSING

ویدئو در حال پردازش است.

کاربر نمادی برای این ویدیو در برنامه Google Photos می بیند. با این حال، هنوز قابل پخش نیست.

READY

پردازش ویدیو کامل شده است و این ویدیو اکنون برای مشاهده آماده است.

تلاش برای دانلود ویدیویی که در حالت READY نیست ممکن است با شکست مواجه شود.

FAILED مشکلی پیش آمده است و ویدیو پردازش نشد.

روش ها

list

فهرستی از موارد رسانه انتخاب شده توسط کاربر در طول جلسه مشخص شده را برمی گرداند.