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

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

batchGet

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

get

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

list

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

patch

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