REST Resource: mediaItems

المورد: PickedMediaItem

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

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

string

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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
الحقول
baseUrl

string

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

لتنزيل ملف وسائط، على برنامج واجهة برمجة التطبيقات إضافة المَعلمات المحدّدة في وثائق المطوّرين إلى عنوان URL هذا.

على سبيل المثال، سيضبط '=w2048-h1024' أبعاد عنصر وسائط من نوع الصورة على أن يكون عرضها 2048 بكسل وارتفاعها 1024 بكسل.
mimeType

string

نوع MIME لملف الوسائط. مثلاً: image/jpeg
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,
  "printMetadata": {
    object (PrintMetadata)
  }
}
الحقول
focalLength

number

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

number

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

integer

ISO للكاميرا التي تم التقاط الصورة بها.
exposureTime

string (Duration format)

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

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

object (PrintMetadata)

البيانات الوصفية ذات الصلة بطباعة الصورة

PrintMetadata

البيانات الوصفية التي تصف السمات المتعلقة بالطباعة لإحدى الصور، مثل نقاط جودة الطباعة

تمثيل JSON 
{
  "qualityScore": enum (Score)
}
الحقول
qualityScore

enum (Score)

نقاط جودة الطباعة التي تحدِّد ما إذا كانت الصورة صالحة للطباعة أم لا.

ويجب عدم استخدام النتيجة لتقديم المشورة للمستخدمين بشأن الطباعة. ويتم ضبط النتيجة على HIGH إذا كانت الصورة ذات جودة عالية ورغب المستخدم في طباعتها. تشير درجة NORMAL إلى أنّ الصورة قد لا تكون ذات جودة عالية. تشير السمة SCORE_UNSPECIFIED إلى عدم توفّر نتيجة.

النتيجة

درجة تصف مدى ملاءمة الطباعة لصورة.

عمليات التعداد
SCORE_UNSPECIFIED لا يتم تحديد النتيجة تلقائيًا.
HIGH حصلت الصورة على درجة عالية.
NORMAL النتيجة الطبيعية للصورة.

VideoMetadata

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

تمثيل JSON 
{
  "fps": number
}
الحقول
fps

number

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

الطُرق

list

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