REST Resource: mediaItems

المورد: PickedMediaItem

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

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

string

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

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

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
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

مستوى حساسية الضوء في الكاميرا التي تم التقاط الصورة بها
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

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