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". يجب ألا يزيد عدد الأحرف عن 1000 حرف. يجب تضمين النصوص التي كتبها المستخدمون فقط. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تضمِّن أي سلاسل تم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات والبيانات الوصفية الأخرى.
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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

batchGet

get

list

patch

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