المورد: عنصر الوسائط
تمثيل لعنصر وسائط (مثل صورة أو فيديو) في "صور Google"
تمثيل JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
الحقول | |
---|---|
id |
مُعرّف لعنصر الوسائط. هذا معرّف ثابت يمكن استخدامه بين الجلسات لتحديد عنصر الوسائط هذا. |
description |
وصف عنصر الوسائط. يظهر هذا الاسم للمستخدم في قسم معلومات العنصر في تطبيق "صور Google". ويجب ألا يزيد طوله عن 1,000 حرف. لا تضمِّن سوى النص الذي كتبه المستخدمون. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تضمِّن أي سلاسل تم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات وغيرها من البيانات الوصفية. |
productUrl |
عنوان URL لعنصر الوسائط على "صور Google" يتوفّر هذا الرابط للمستخدم فقط إذا كان مسجّلاً الدخول. وعند استردادها من بحث ألبوم، يشير عنوان URL إلى العنصر داخل الألبوم. |
baseUrl |
عنوان URL لوحدات البايت الخاصة بعنصر الوسائط. يجب عدم استخدام هذه المَعلمة كما هي، إذ يجب إلحاق المَعلمات بعنوان URL هذا قبل استخدامها. اطّلِع على مستندات المطوّرين للحصول على قائمة كاملة بالمعلَمات المتوافقة. على سبيل المثال، سيضبط |
mimeType |
نوع MIME لعنصر الوسائط. مثلاً: |
mediaMetadata |
البيانات الوصفية ذات الصلة بعنصر الوسائط، مثل الارتفاع أو العرض أو وقت الإنشاء |
contributorInfo |
معلومات حول المستخدم الذي أضاف ملف الوسائط هذا. تجدر الإشارة إلى أنّه لا يتم تضمين ذلك إلا عند استخدام |
filename |
اسم ملف عنصر الوسائط يظهر هذا الاسم للمستخدم في قسم معلومات العنصر في تطبيق "صور Google". |
MediaMetadata
البيانات الوصفية لعنصر وسائط
تمثيل JSON |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
الحقول | |
---|---|
creationTime |
الوقت الذي تم فيه إنشاء عنصر الوسائط لأول مرة (وليس وقت تحميله إلى "صور Google"). طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
width |
العرض الأصلي (بالبكسل) لعنصر الوسائط |
height |
الارتفاع الأصلي (بالبكسل) لعنصر الوسائط |
حقل الاتحاد metadata البيانات الوصفية لعنصر الوسائط الخاص بنوع الوسائط الأساسي الذي يمثله. يمكن أن يكون الحقل "metadata " واحدًا فقط مما يلي: |
|
photo |
البيانات الوصفية لنوع وسائط الصور |
video |
البيانات الوصفية لنوع وسائط الفيديو |
صورة
البيانات الوصفية الخاصة بالصورة، مثل ISO والبعد البؤري ووقت التعريض للضوء. وقد تكون بعض هذه الحقول فارغة أو غير مضمّنة.
تمثيل JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
الحقول | |
---|---|
cameraMake |
العلامة التجارية للكاميرا التي تم التقاط الصورة بها. |
cameraModel |
طراز الكاميرا التي تم التقاط الصورة بها |
focalLength |
البعد البؤري لعدسة الكاميرا التي تم التقاط الصورة بها. |
apertureFNumber |
رقم فتحة العدسة لعدسة الكاميرا التي تم التقاط الصورة بها. |
isoEquivalent |
ISO للكاميرا التي تم التقاط الصورة بها. |
exposureTime |
وقت التعرّض لفتحة عدسة الكاميرا عندما تم التقاط الصورة. مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
حملة فيديو
البيانات الوصفية الخاصة بفيديو معيّن، مثل عدد اللقطات في الثانية وحالة المعالجة وقد تكون بعض هذه الحقول فارغة أو غير مضمّنة.
تمثيل JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
الحقول | |
---|---|
cameraMake |
العلامة التجارية للكاميرا التي تم التقاط الفيديو بها. |
cameraModel |
طراز الكاميرا التي تم التقاط الفيديو بها |
fps |
عدد اللقطات في الثانية للفيديو |
status |
حالة معالجة الفيديو |
VideoProcessingStatus
حالة معالجة فيديو يتم تحميله إلى "صور Google"
عمليات التعداد | |
---|---|
UNSPECIFIED |
حالة معالجة الفيديو غير معروفة. |
PROCESSING |
تجري معالجة الفيديو. يرى المستخدم رمزًا لهذا الفيديو في تطبيق "صور Google"، ولكنّه غير قابل للتشغيل بعد. |
READY |
اكتملت معالجة الفيديو وأصبح جاهزًا الآن للمشاهدة. ملاحظة مهمة: قد تتعذّر محاولة تنزيل فيديو ليس في حالة "الاستعداد". |
FAILED |
حدث خطأ وتعذَّرت معالجة الفيديو. |
ContributorInfo
معلومات حول المستخدم الذي أضاف عنصر الوسائط تجدر الإشارة إلى أنّه لا يتم تضمين هذه المعلومات إلا إذا كان عنصر الوسائط في ألبوم مشترَك أنشأه تطبيقك وكان لديك نطاق المشاركة.
تمثيل JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
الحقول | |
---|---|
profilePictureBaseUrl |
تشير هذه السمة إلى عنوان URL يؤدي إلى صورة الملف الشخصي للمساهم. |
displayName |
الاسم المعروض للمساهم |
الطُرق |
|
---|---|
|
ينشئ عنصر وسائط واحدًا أو أكثر في مكتبة "صور Google" للمستخدم. |
|
لعرض قائمة عناصر الوسائط لمعرّفات عناصر الوسائط المحددة. |
|
لعرض عنصر الوسائط لمعرّف عنصر الوسائط المحدّد. |
|
إدراج جميع عناصر الوسائط من مكتبة "صور Google" الخاصة بالمستخدم |
|
عدِّل عنصر الوسائط باستخدام السمة id المحدّدة. |
|
للبحث عن عناصر الوسائط في مكتبة المستخدم في "صور Google". |