المورد: ملف
البيانات الوصفية لملف
تتطلّب بعض طرق الموارد (مثل files.update) توفير fileId. استخدِم طريقة files.list لاسترداد معرّف ملف.
| تمثيل JSON |
|---|
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object ( |
| الحقول | |
|---|---|
ownerNames[] |
النتائج فقط. أسماء مالكي هذا الملف لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
exportLinks |
النتائج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات معيّنة عنصر يحتوي على قائمة بأزواج |
parents[] |
رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يكون للملف مجلد رئيسي واحد فقط، ولا يُسمح بتحديد مجلدات رئيسية متعددة. إذا لم يتم تحديد المجلد كجزء من طلب الإدراج، يتم وضع الملف مباشرةً في مجلد "ملفاتي" الخاص بالمستخدم. إذا لم يتم تحديدها كجزء من طلب نسخ، سيرث الملف أي عنصر رئيسي قابل للاكتشاف للملف المصدر. يجب أن تستخدم طلبات files.update المَعلمتَين |
owners[] |
النتائج فقط. مالك هذا الملف قد يكون لبعض الملفات القديمة أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
openWithLinks |
النتائج فقط. خريطة لمعرّف كل تطبيق من تطبيقات المستخدم إلى رابط لفتح هذا الملف باستخدام هذا التطبيق، ولا تتم تعبئتها إلا عند استخدام نطاق drive.apps.readonly. عنصر يحتوي على قائمة بأزواج |
properties[] |
قائمة المواقع |
permissions[] |
النتائج فقط. قائمة الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى هذا الملف لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
spaces[] |
النتائج فقط. قائمة المساحات التي يحتوي الملف عليها. القيمتان المسموح بإدراجهما هما |
permissionIds[] |
إخراج فقط. files.list of permission IDs for users with access to this file. |
contentRestrictions[] |
القيود المفروضة على الوصول إلى محتوى الملف تتم تعبئة هذا الحقل فقط في حال وجود مثل هذا القيد. |
kind |
النتائج فقط. تمثّل هذه السمة نوع الملف. يكون هذا الخيار |
userPermission |
النتائج فقط. أذونات المستخدم الذي تمت مصادقته على هذا الملف |
fileExtension |
النتائج فقط. المكوّن الأخير من |
md5Checksum |
النتائج فقط. المجموع الاختباري MD5 لمحتوى هذا الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات. |
selfLink |
النتائج فقط. رابط يؤدي إلى هذا الملف |
lastModifyingUserName |
النتائج فقط. اسم آخر مستخدم عدّل هذا الملف. |
editable |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
writersCanShare |
تحديد ما إذا كان بإمكان الكتّاب مشاركة المستند مع مستخدمين آخرين لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
downloadUrl |
النتائج فقط. عنوان URL قصير الأمد لتنزيل الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لمستندات Google أو ملفات الاختصارات. |
mimeType |
نوع MIME للملف يمكن تعديل هذا الحقل فقط عند تحميل محتوى جديد. يمكن ترك هذا الحقل فارغًا، وسيتم تحديد نوع MIME من نوع MIME الخاص بالمحتوى الذي تم تحميله. |
driveId |
النتائج فقط. معرّف مساحة التخزين السحابي المشتركة التي يقيم فيها الملف لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
thumbnailLink |
النتائج فقط. تمثّل هذه السمة رابطًا قصير الأمد إلى الصورة المصغّرة للملف، إذا كانت متاحة. وعادةً ما يستمر هذا الإجراء لعدة ساعات. لا يُنصح باستخدامه مباشرةً في تطبيقات الويب بسبب مشاركة المراجع مع نطاقات خارجية (CORS)، لذا يُنصح باستخدام خادم وكيل. لا تتم تعبئة هذا الحقل إلا عندما يمكن للتطبيق الذي يطلب الوصول إلى الملف الوصول إلى محتواه. إذا لم تتم مشاركة الملف بشكل علني، يجب استرداد عنوان URL الذي تم عرضه في |
appDataContents |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الملف في مجلد "بيانات التطبيق". |
webViewLink |
النتائج فقط. رابط متاح فقط على المجلدات العامة لعرض مواد عرض الويب الثابتة (HTML وCSS وJS وما إلى ذلك) من خلال خدمة "استضافة المواقع الإلكترونية" في Google Drive |
iconLink |
النتائج فقط. رابط يؤدي إلى رمز الملف |
shared |
النتائج فقط. تُستخدَم لتحديد ما إذا تمت مشاركة الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
lastModifyingUser |
النتائج فقط. المستخدم الذي عدّل هذا الملف آخر مرة لا تتم تعبئة هذا الحقل إلا عندما يجري مستخدم مسجّل الدخول آخر تعديل. |
defaultOpenWithLink |
النتائج فقط. رابط لفتح هذا الملف باستخدام التطبيق التلقائي للمستخدم لهذا الملف لا تتم تعبئته إلا عند استخدام نطاق drive.apps.readonly. |
headRevisionId |
النتائج فقط. رقم تعريف أحدث نسخة من الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات. |
copyable |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
etag |
النتائج فقط. تمثّل هذه السمة علامة ETag للملف. |
sharingUser |
النتائج فقط. المستخدم الذي شارك العنصر مع المستخدم الحالي، إذا كان متاحًا |
alternateLink |
النتائج فقط. رابط لفتح الملف في أداة تعديل أو عارض من Google ذات الصلة |
embedLink |
النتائج فقط. رابط لتضمين الملف |
webContentLink |
النتائج فقط. رابط لتنزيل محتوى الملف في متصفّح باستخدام مصادقة تستند إلى ملف تعريف الارتباط في الحالات التي تتم فيها مشاركة المحتوى بشكل علني، يمكن تنزيله بدون أي بيانات اعتماد. |
fileSize |
النتائج فقط. الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" وملفات أدوات التحرير التابعة للطرف الأول لن يتم ملء هذا الحقل للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات. |
copyRequiresWriterPermission |
تحديد ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقراء والمعلّقين |
hasThumbnail |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الملف يتضمّن صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي يطلب الوصول لديه إذن بالوصول إلى الصورة المصغّرة. للتحقّق من إمكانية الوصول، ابحث عن الحقل thumbnailLink. |
folderColorRgb |
لون المجلد كسلسلة سداسية عشرية من قيم RGB إذا كان الملف مجلدًا أو اختصارًا لمجلد تتوفّر قائمة الألوان المتوافقة في الحقل folderColorPalette الخاص بمورد About. في حال تحديد لون غير متوافق، سيتم تغييره إلى أقرب لون في لوحة الألوان. |
id |
رقم تعريف الملف |
title |
تمثّل هذه السمة عنوان الملف. يُرجى العِلم أنّ العنوان ثابت للعناصر غير القابلة للتغيير، مثل المجلدات ذات المستوى الأعلى في مساحات التخزين السحابي المشتركة ومجلد الجذر في "ملفاتي" ومجلد "بيانات التطبيقات". |
description |
تمثّل هذه السمة وصفًا موجزًا للملف. |
labels |
مجموعة من التصنيفات للملف |
labels.viewed |
تُستخدَم لتحديد ما إذا كان هذا المستخدم قد اطّلع على هذا الملف. |
labels.restricted |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
labels.starred |
تُستخدَم لتحديد ما إذا كان المستخدم قد وضع نجمة على هذا الملف. |
labels.hidden |
النتائج فقط. تمّ الإيقاف. |
labels.trashed |
تُستخدَم لتحديد ما إذا تم نقل هذا الملف إلى المهملات. ينطبق هذا التصنيف على جميع المستخدمين الذين يمكنهم الوصول إلى الملف، ولكن يُسمح للمالكين فقط بالاطّلاع على الملفات واستردادها من المهملات. |
labels.modified |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا المستخدم قد عدّل الملف. |
explicitlyTrashed |
النتائج فقط. توضّح هذه السمة ما إذا تم نقل هذا الملف إلى المهملات بشكل صريح، بدلاً من نقله بشكل متكرر. |
createdDate |
النتائج فقط. وقت إنشاء هذا الملف (طابع زمني منسَّق بتنسيق RFC 3339). |
modifiedDate |
آخر مرة عدَّل فيها أي مستخدم هذا الملف (طابع زمني منسَّق بتنسيق RFC 3339). لا يمكن تغيير هذا الحقل عند التعديل إلا عندما يتم ضبط المَعلمة setModifiedDate. |
modifiedByMeDate |
النتائج فقط. آخر مرة عدّل فيها المستخدم هذا الملف (طابع زمني منسَّق بتنسيق RFC 3339). يُرجى العِلم أنّ ضبط modifiedDate سيؤدي أيضًا إلى تعديل تاريخ modifiedByMe للمستخدم الذي ضبط التاريخ. |
lastViewedByMeDate |
آخر مرة عرض فيها المستخدم هذا الملف (طابع زمني منسَّق بتنسيق RFC 3339). |
markedViewedByMeDate |
النتائج فقط. تمّ الإيقاف. |
sharedWithMeDate |
النتائج فقط. الوقت الذي تمت فيه مشاركة هذا الملف مع المستخدم (طابع زمني منسَّق بتنسيق RFC 3339). |
quotaBytesUsed |
النتائج فقط. عدد وحدات البايت لمساحة التخزين المتوفّرة التي يستخدمها هذا الملف |
version |
النتائج فقط. رقم إصدار يتزايد بشكل منتظم للملف ويعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم الذي يطلبها. |
indexableText |
سمات النص القابل للفهرسة للملف (يمكن كتابتها فقط) |
indexableText.text |
النص الذي سيتم فهرسته لهذا الملف |
originalFilename |
اسم الملف الأصلي للمحتوى الذي تم تحميله إذا كان متاحًا، وإلا سيتم استخدام القيمة الأصلية للحقل |
ownedByMe |
النتائج فقط. تُستخدَم لتحديد ما إذا كان المستخدم الحالي يملك الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
canComment |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
shareable |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
fullFileExtension |
النتائج فقط. تمثّل هذه السمة امتداد الملف الكامل، ويتم استخراجه من العنوان. قد يحتوي على عدة امتدادات متسلسلة، مثل "tar.gz". لا تؤدي إزالة إضافة من العنوان إلى محو هذا الحقل، ولكن يؤدي تغيير الإضافة في العنوان إلى تعديل هذا الحقل. لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات. |
isAppAuthorized |
النتائج فقط. تُستخدَم لتحديد ما إذا كان التطبيق الذي يطلب الإذن قد أنشأ الملف أو فتحه. |
teamDriveId |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities |
النتائج فقط. الإمكانات التي يملكها المستخدم الحالي في هذا الملف تتوافق كل إمكانية مع إجراء دقيق يمكن للمستخدم اتخاذه. |
capabilities.canChangeRestrictedDownload |
النتائج فقط. تمّ الإيقاف. |
capabilities.canMoveChildrenOutOfDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد خارج مساحة التخزين السحابي المشتركة. تكون هذه القيمة غير صحيحة عندما لا يكون العنصر مجلدًا. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canReadDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي قراءة مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملف. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canEdit |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم الحالي تعديل هذا الملف قد تحدّ عوامل أخرى من نوع التغييرات التي يمكن للمستخدم إجراؤها على ملف. على سبيل المثال، اطّلِع على |
capabilities.canCopy |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نسخ هذا الملف. بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، يحدّد هذا الحقل ما إذا كان بإمكان المستخدم الحالي نسخ العناصر الفرعية غير المجلدات لهذا العنصر، أو هذا العنصر نفسه إذا لم يكن مجلدًا. |
capabilities.canComment |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي التعليق على هذا الملف. |
capabilities.canAddChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة أطفال إلى هذا المجلد. تكون هذه السمة دائمًا false عندما لا يكون العنصر مجلدًا. |
capabilities.canDelete |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف هذا الملف. |
capabilities.canDownload |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تنزيل هذا الملف. |
capabilities.canListChildren |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم الحالي إدراج العناصر الفرعية لهذا المجلد تكون هذه القيمة دائمًا خطأ عندما لا يكون العنصر مجلدًا. |
capabilities.canRemoveChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إزالة الأطفال من هذا المجلد. تكون هذه السمة دائمًا false عندما لا يكون العنصر مجلدًا. بالنسبة إلى مجلد في مساحة تخزين سحابي مشتركة، استخدِم |
capabilities.canRename |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إعادة تسمية هذا الملف. |
capabilities.canTrash |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل هذا الملف إلى سلة المهملات. |
capabilities.canReadRevisions |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي قراءة مورد المراجعات لهذا الملف. بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، يحدّد هذا الحقل ما إذا كان يمكن قراءة مراجعات العناصر الفرعية غير المجلدات لهذا العنصر، أو هذا العنصر نفسه إذا لم يكن مجلدًا. |
capabilities.canReadTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canMoveTeamDriveItem |
النتائج فقط. تم إيقاف هذا الحدث نهائيًا: يُرجى استخدام |
capabilities.canChangeCopyRequiresWriterPermission |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير قيود |
capabilities.canMoveItemIntoTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canUntrash |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي استعادة هذا الملف من المهملات. |
capabilities.canModifyContent |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تعديل محتوى هذا الملف. |
capabilities.canMoveItemWithinTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canMoveItemOutOfTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canDeleteChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف عناصر فرعية من هذا المجلد. تكون هذه القيمة غير صحيحة عندما لا يكون العنصر مجلدًا. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canMoveChildrenOutOfTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canMoveChildrenWithinTeamDrive |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
capabilities.canTrashChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف العناصر الفرعية لهذا المجلد. تكون هذه القيمة غير صحيحة عندما لا يكون العنصر مجلدًا. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canMoveItemOutOfDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل هذا العنصر خارج هذه المساحة من خلال تغيير العنصر الأصل. يُرجى العِلم أنّه قد يتعذّر تغيير الحساب الرئيسي للعنصر، وذلك حسب الحساب الرئيسي الجديد الذي تتم إضافته. |
capabilities.canAddMyDriveParent |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة عنصر رئيسي للعنصر بدون إزالة عنصر رئيسي حالي في الطلب نفسه. لا تتم تعبئته لملفات مساحة التخزين السحابي المشتركة. |
capabilities.canRemoveMyDriveParent |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إزالة أحد الوالدَين من العنصر بدون إضافة والد آخر في الطلب نفسه. لا تتم تعبئته لملفات مساحة التخزين السحابي المشتركة. |
capabilities.canMoveItemWithinDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل هذا العنصر داخل مساحة التخزين هذه. يُرجى العِلم أنّه قد يتعذّر تغيير العنصر الرئيسي للعنصر، وذلك حسب العنصر الرئيسي الجديد الذي تتم إضافته والعنصر الرئيسي الذي تتم إزالته. |
capabilities.canShare |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تعديل إعدادات المشاركة لهذا الملف. |
capabilities.canMoveChildrenWithinDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد داخل مساحة التخزين هذه. تكون هذه القيمة غير صحيحة عندما لا يكون العنصر مجلدًا. يُرجى العِلم أنّه قد يتعذّر نقل الطفل حسب إذن الوصول الممنوح للمستخدم الحالي إلى الطفل وإلى المجلد الوجهة. |
capabilities.canModifyContentRestriction |
تم إيقافها نهائيًا: النتائج فقط. استخدِم أحد الخيارات التالية: |
capabilities.canAddFolderFromAnotherDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة مجلد من مساحة تخزين أخرى (مساحة تخزين سحابي مشتركة مختلفة أو "ملفاتي") إلى هذا المجلد. تكون هذه القيمة غير صحيحة عندما لا يكون العنصر مجلدًا. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canChangeSecurityUpdateEnabled |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم الحالي تغيير الحقل securityUpdateEnabled في بيانات وصف مشاركة الرابط |
capabilities.canAcceptOwnership |
النتائج فقط. تُستخدَم لتحديد ما إذا كان المستخدم الحالي هو المالك غير النهائي للملف. لا تتم تعبئته لملفات مساحة التخزين السحابي المشتركة. |
capabilities.canReadLabels |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي قراءة التصنيفات في الملف. |
capabilities.canModifyLabels |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تعديل التصنيفات في الملف. |
capabilities.canModifyEditorContentRestriction |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة قيود المحتوى في الملف أو تعديلها، وهي قيود لا يمكن للمحرّرين تجاوزها. |
capabilities.canModifyOwnerContentRestriction |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة قيود المحتوى أو تعديلها، وهي قيود لا يمكن إلا للمالك فرضها. |
capabilities.canRemoveContentRestriction |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هناك قيود على المحتوى في الملف يمكن للمستخدم الحالي إزالتها. |
capabilities.canDisableInheritedPermissions |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم إيقاف الأذونات المكتسَبة |
capabilities.canEnableInheritedPermissions |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم إعادة تفعيل الأذونات المكتسَبة |
hasAugmentedPermissions |
النتائج فقط. تُستخدَم لتحديد ما إذا كانت هناك أذونات مباشرة على هذا الملف. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
trashingUser |
النتائج فقط. إذا تم نقل الملف إلى المهملات بشكل صريح، سيظهر المستخدم الذي نفّذ هذا الإجراء. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
canReadRevisions |
النتائج فقط. تم إيقافها نهائيًا: يُرجى استخدام |
thumbnailVersion |
النتائج فقط. نسخة الصورة المصغّرة التي سيتم استخدامها في إبطال ذاكرة التخزين المؤقت للصور المصغّرة |
trashedDate |
النتائج فقط. الوقت الذي تم فيه نقل العنصر إلى المهملات (طابع زمني منسَّق RFC 3339). لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
thumbnail |
تمثّل هذه السمة صورة مصغّرة للملف. سيتم استخدام هذه الصورة فقط إذا تعذّر إنشاء صورة مصغّرة عادية. |
thumbnail.image |
وحدات البايت المُشفّرة بتنسيق Base64 المتوافق مع عناوين URL للصورة المصغّرة يجب أن يتوافق مع القسم 5 من RFC 4648. سلسلة مرمّزة باستخدام Base64 |
thumbnail.mimeType |
نوع MIME الخاص بالصورة المصغّرة. |
imageMediaMetadata |
النتائج فقط. بيانات وصفية حول وسائط الصور سيكون هذا الحقل متاحًا لأنواع الصور فقط، وسيعتمد محتواه على ما يمكن تحليله من محتوى الصورة. |
imageMediaMetadata.flashUsed |
النتائج فقط. تُستخدَم لتحديد ما إذا تم استخدام فلاش لإنشاء الصورة. |
imageMediaMetadata.meteringMode |
النتائج فقط. تشير هذه السمة إلى وضع قياس الإضاءة المستخدَم لإنشاء الصورة. |
imageMediaMetadata.sensor |
النتائج فقط. تمثّل هذه السمة نوع جهاز الاستشعار المستخدَم لإنشاء الصورة. |
imageMediaMetadata.exposureMode |
النتائج فقط. تشير هذه السمة إلى وضع التعرّض للضوء المستخدَم لإنشاء الصورة. |
imageMediaMetadata.colorSpace |
النتائج فقط. تمثّل مساحة الألوان في الصورة. |
imageMediaMetadata.whiteBalance |
النتائج فقط. تمثّل هذه السمة وضع توازن اللون الأبيض المستخدَم لإنشاء الصورة. |
imageMediaMetadata.width |
النتائج فقط. تمثّل هذه السمة عرض الصورة بالبكسل. |
imageMediaMetadata.height |
النتائج فقط. تمثّل هذه السمة ارتفاع الصورة بالبكسل. |
imageMediaMetadata.location |
النتائج فقط. معلومات الموقع الجغرافي المخزّنة في الصورة |
imageMediaMetadata.location.latitude |
النتائج فقط. تمثّل خط العرض المخزّن في الصورة. |
imageMediaMetadata.location.longitude |
النتائج فقط. خط الطول المخزَّن في الصورة |
imageMediaMetadata.location.altitude |
النتائج فقط. تمثّل هذه السمة الارتفاع المخزّن في الصورة. |
imageMediaMetadata.rotation |
النتائج فقط. عدد عمليات التدوير بزاوية 90 درجة في اتجاه عقارب الساعة التي تم تطبيقها من الاتجاه الأصلي للصورة |
imageMediaMetadata.date |
النتائج فقط. تمثّل هذه السمة تاريخ ووقت التقاط الصورة (طابع زمني بتنسيق EXIF). |
imageMediaMetadata.cameraMake |
النتائج فقط. تشير هذه السمة إلى الشركة المصنّعة للكاميرا المستخدَمة لالتقاط الصورة. |
imageMediaMetadata.cameraModel |
النتائج فقط. تمثّل هذه السمة طراز الكاميرا المستخدَمة لإنشاء الصورة. |
imageMediaMetadata.exposureTime |
النتائج فقط. تمثّل هذه السمة مدة التعرّض للضوء بالثواني. |
imageMediaMetadata.aperture |
النتائج فقط. تشير هذه السمة إلى فتحة العدسة المستخدَمة لالتقاط الصورة (الرقم البؤري). |
imageMediaMetadata.focalLength |
النتائج فقط. تمثّل هذه السمة البُعد البؤري المستخدَم لإنشاء الصورة، ويتم قياسه بالملليمتر. |
imageMediaMetadata.isoSpeed |
النتائج فقط. تمثّل هذه السمة سرعة ISO المستخدَمة لإنشاء الصورة. |
imageMediaMetadata.exposureBias |
النتائج فقط. قطر التعرض للضوء في الصورة (قيمة APEX) |
imageMediaMetadata.maxApertureValue |
النتائج فقط. تشير هذه السمة إلى أصغر رقم بؤري للعدسة عند البُعد البؤري المستخدَم لإنشاء الصورة (قيمة APEX). |
imageMediaMetadata.subjectDistance |
النتائج فقط. تمثّل هذه السمة المسافة إلى الهدف المُراد تصويره، بالمتر. |
imageMediaMetadata.lens |
النتائج فقط. تشير هذه السمة إلى العدسة المستخدَمة لالتقاط الصورة. |
videoMediaMetadata |
النتائج فقط. البيانات الوصفية لوسائط الفيديو سيظهر هذا الخيار لأنواع الفيديوهات فقط. |
videoMediaMetadata.width |
النتائج فقط. تمثّل هذه السمة عرض الفيديو بالبكسل. |
videoMediaMetadata.height |
النتائج فقط. تمثّل هذه السمة ارتفاع الفيديو بالبكسل. |
videoMediaMetadata.durationMillis |
النتائج فقط. تمثّل هذه السمة مدة الفيديو بالملي ثانية. |
shortcutDetails |
تفاصيل ملف الاختصار تتم تعبئة هذا الحقل لملفات الاختصارات فقط، والتي تم ضبط حقل mimeType فيها على |
shortcutDetails.targetId |
تمثّل هذه السمة معرّف الملف الذي يشير إليه هذا الاختصار. يمكن ضبطها فقط على طلبات |
shortcutDetails.targetMimeType |
النتائج فقط. تمثّل هذه السمة نوع MIME للملف الذي يشير إليه هذا الاختصار. قيمة هذا الحقل هي لقطة لنوع MIME الخاص بالهدف، ويتم التقاطها عند إنشاء الاختصار. |
shortcutDetails.targetResourceKey |
النتائج فقط. تمثّل هذه السمة ResourceKey للملف المستهدَف. |
resourceKey |
النتائج فقط. مفتاح مطلوب للوصول إلى الملف من خلال رابط مشاركة |
linkShareMetadata |
النتائج فقط. تفاصيل ذات صلة بـ LinkShare يحتوي على تفاصيل حول عناوين URL للروابط التي يستخدمها العملاء للإشارة إلى هذا العنصر. |
linkShareMetadata.securityUpdateEligible |
النتائج فقط. تُستخدَم لتحديد ما إذا كان الملف مؤهَّلاً لتلقّي تحديث الأمان. |
linkShareMetadata.securityUpdateEnabled |
النتائج فقط. تُستخدَم لتحديد ما إذا كان تحديث الأمان مفعَّلاً لهذا الملف. |
labelInfo |
النتائج فقط. نظرة عامة على التصنيفات في الملف |
labelInfo.labels[] |
النتائج فقط. مجموعة التصنيفات في الملف على النحو المطلوب من خلال أرقام تعريف التصنيفات في المَعلمة |
sha1Checksum |
النتائج فقط. المجموع الاختباري SHA1 المرتبط بهذا الملف، إذا كان متاحًا لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات. |
sha256Checksum |
النتائج فقط. المجموع الاختباري SHA256 المرتبط بهذا الملف، إذا كان متاحًا لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات. |
inheritedPermissionsDisabled |
تُستخدَم لتحديد ما إذا كانت أذونات الوصول المكتسَبة غير مفعَّلة لهذا الملف. تكون الأذونات المكتسَبة مفعّلة تلقائيًا. |
ContentRestriction
تمثّل هذه السمة قيودًا على الوصول إلى محتوى الملف.
| تمثيل JSON |
|---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
| الحقول | |
|---|---|
readOnly |
تُستخدَم لتحديد ما إذا كان محتوى الملف للقراءة فقط. إذا كان الملف للقراءة فقط، قد لا تتم إضافة نسخة جديدة من الملف، وقد لا تتم إضافة التعليقات أو تعديلها، وقد لا يتم تعديل عنوان الملف. |
reason |
سبب حظر محتوى الملف يمكن تغيير هذه السمة فقط في الطلبات التي تضبط |
type |
النتائج فقط. تمثّل هذه السمة نوع القيود المفروضة على المحتوى. القيمة الوحيدة المتاحة حاليًا هي |
restrictingUser |
النتائج فقط. المستخدم الذي وضع قيود المحتوى تتم تعبئة هذا الحقل فقط إذا كانت قيمة |
restrictionDate |
النتائج فقط. الوقت الذي تم فيه ضبط قيود المحتوى (طابع زمني منسَّق بتنسيق RFC 3339). تتم تعبئة هذا الحقل فقط إذا كانت قيمة |
ownerRestricted |
تحديد ما إذا كان يمكن للمستخدم الذي يملك الملف فقط تعديل قيود المحتوى أو إزالتها بالنسبة إلى الملفات في مساحات التخزين السحابي المشتركة، يمكن لأي مستخدم لديه إمكانات |
systemRestricted |
النتائج فقط. تُستخدَم لتحديد ما إذا كان النظام قد فرض قيودًا على المحتوى، مثلاً بسبب توفّر توقيع إلكتروني. لا يمكن للمستخدمين تعديل قيود المحتوى المحظور من النظام أو إزالتها. |
الطُرق |
|
|---|---|
|
تنشئ هذه الدالة نسخة من الملف المحدّد. |
|
يحذف هذا الإجراء نهائيًا ملفًا يملكه المستخدم بدون نقله إلى المهملات. |
|
حذف جميع ملفات المستخدم في المهملات نهائيًا |
|
تصدِّر هذه الطريقة مستند Google Workspace إلى نوع MIME المطلوب وتعرض محتوى البايت المصدَّر. |
|
تنشئ هذه الطريقة مجموعة من أرقام تعريف الملفات التي يمكن تقديمها في طلبات الإدراج أو النسخ. |
|
تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاص بملف معيّن من خلال رقم تعريفه. |
|
يُدرج ملفًا جديدًا. |
|
تعرض هذه السمة ملفات المستخدم. |
|
تعرض هذه السمة التصنيفات في ملف. |
|
تعديل مجموعة التصنيفات المطبَّقة على ملف |
|
تعدّل هذه الطريقة البيانات الوصفية للملف و/أو محتواه. |
|
اضبط وقت تعديل الملف على وقت الخادم الحالي. |
|
ينقل ملفًا إلى المهملات. |
|
تستعيد هذه الطريقة ملفًا من المهملات. |
|
تعدّل هذه الطريقة البيانات الوصفية لملف أو محتواه أو كليهما. |
|
للاشتراك في تلقّي إشعارات بشأن التغييرات التي يتم إجراؤها على ملف |