REST Resource: mediaItems

المورد: عنصر الوسائط

تمثيل لعنصر وسائط (مثل صورة أو فيديو) في "صور 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").

طابع زمني بتنسيق 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

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

 ينشئ عنصر وسائط واحدًا أو أكثر في مكتبة "صور Google" للمستخدم.

batchGet

 لعرض قائمة عناصر الوسائط لمعرّفات عناصر الوسائط المحددة.

get

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

list

 إدراج جميع عناصر الوسائط من مكتبة "صور Google" الخاصة بالمستخدم

patch

 عدِّل عنصر الوسائط باستخدام السمة id المحدّدة.
للبحث عن عناصر الوسائط في مكتبة المستخدم في "صور Google".