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 به کاربر نشان داده می شود. باید کمتر از 1000 کاراکتر باشد. فقط شامل متن نوشته شده توسط کاربران باشد. توضیحات باید زمینه اضافه کنند و به کاربران در درک رسانه کمک کنند. رشته های تولید شده به صورت خودکار مانند نام فایل ها، برچسب ها و سایر ابرداده ها را وارد نکنید.

productUrl

string

نشانی وب 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 آپلود شد).

مهر زمانی در قالب 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" .

ویدئو

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

نمایندگی JSON
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
زمینه های
cameraMake

string

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

cameraModel

string

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

fps

number

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

status

enum ( VideoProcessingStatus )

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

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

در حال پردازش وضعیت ویدیویی در حال آپلود در Google Photos.

Enums
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 کاربر جستجو می کند.