REST Resource: mediaItems

المورد: MediaItem

تمثيل عنصر وسائط (مثل صورة أو فيديو) في "صور Google"

تمثيل JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
الحقول
id

string

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

string

وصف عنصر الوسائط يتم عرض هذا العنوان للمستخدم في قسم معلومات العنصر في تطبيق "صور Google"، ويجب ألا يزيد عدد أحرفه عن 1,000 حرف. يجب تضمين النصوص التي كتبها المستخدمون فقط. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تدرِج أي سلاسل يتم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات والبيانات الوصفية الأخرى.
productUrl

string

عنوان URL الخاص بملف الوسائط في "صور Google" لا يتوفّر هذا الرابط للمستخدم إلا إذا سجّل الدخول. عند استرجاع المحتوى من خلال البحث في الألبوم، يشير عنوان 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".

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")

يستخدم معيار 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"
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

رقم فتحة عدسة الكاميرا التي تم التقاط الصورة بها.
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)

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

VideoProcessingStatus

حالة معالجة فيديو يتم تحميله إلى "صور Google"

عمليات التعداد
UNSPECIFIED حالة معالجة الفيديو غير معروفة.
PROCESSING جارٍ معالجة الفيديو. يظهر للمستخدم رمز هذا الفيديو في تطبيق "صور Google"، ولكن لا يمكن تشغيله بعد.
READY اكتملت معالجة الفيديو وأصبح جاهزًا للمشاهدة. ملاحظة مهمة: قد يتعذّر تنزيل فيديو غير في حالة "جاهز".
FAILED حدث خطأ وتعذّرت معالجة الفيديو.

ContributorInfo

معلومات عن المستخدم الذي أضاف ملف الوسائط يُرجى العِلم أنّه لا يتم تضمين هذه المعلومات إلا إذا كان عنصر الوسائط ضمن ألبوم مشترَك أنشأه تطبيقك وكان لديك نطاق المشاركة.

تمثيل JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
الحقول
profilePictureBaseUrl

string

عنوان URL لصورة الملف الشخصي للمساهم
displayName

string

الاسم المعروض للمساهم.

الطُرق

batchCreate

batchGet

get

list

patch

 عدِّل عنصر الوسائط باستخدام id المحدّد.