REST Resource: mediaItems

المرجع: PickedMediaItem

تمثيل صورة أو فيديو اختارهما المستخدم

تمثيل JSON
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
الحقول
id

string

معرّف لعنصر الوسائط

هذا معرّف ثابت يمكن استخدامه بين الجلسات لتحديد عنصر الوسائط هذا.

createTime

string (Timestamp format)

الوقت الذي تم فيه إنشاء ملف الوسائط (وليس وقت تحميله إلى "صور Google")

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

type

enum (Type)

نوع عنصر الوسائط هذا.

mediaFile

object (MediaFile)

تمثّل هذه السمة ملف الوسائط الذي يشكّل عنصر الوسائط هذا.

النوع

نوع عنصر الوسائط

عمليات التعداد
TYPE_UNSPECIFIED لم يتم تحديد النوع.
PHOTO يمثّل ملف الوسائط صورة.
VIDEO يمثّل عنصر الوسائط فيديو.

MediaFile

تمثيل ملف وسائط

تمثيل JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
الحقول
baseUrl

string

عنوان URL لجلب وحدات البايت الخاصة بملف الوسائط

لتنزيل ملف وسائط، على عميل واجهة برمجة التطبيقات إضافة المَعلمات المحدّدة في مستندات المطوّرين إلى عنوان 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

رقم فتحة عدسة الكاميرا التي تم التقاط الصورة بها.

isoEquivalent

integer

سرعة ISO للكاميرا التي تم التقاط الصورة بها

exposureTime

string (Duration format)

مدة تعرّض فتحة الكاميرا للضوء عند التقاط الصورة

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

VideoMetadata

البيانات الوصفية الخاصة بالفيديو على سبيل المثال، عدد اللقطات في الثانية.

تمثيل JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
الحقول
fps

number

عدد اللقطات في الثانية للفيديو

processingStatus

enum (VideoProcessingStatus)

حالة معالجة الفيديو

VideoProcessingStatus

حالة معالجة فيديو محفوظ في "صور Google"

عمليات التعداد
UNSPECIFIED لم يتم تحديد حالة معالجة الفيديو.
PROCESSING

جارٍ معالجة الفيديو.

يظهر للمستخدم رمز هذا الفيديو في تطبيق "صور Google"، ولكن لا يمكن تشغيله بعد.

READY

اكتملت معالجة الفيديو وأصبح جاهزًا للعرض.

قد لا تنجح محاولة تنزيل فيديو غير في الحالة READY.

FAILED حدث خطأ وتعذّرت معالجة الفيديو.

الطُرق

list

لعرض قائمة بعناصر الوسائط التي اختارها المستخدم خلال الجلسة المحدّدة.