المورد: ملف
البيانات الوصفية لملف
تتطلّب بعض طرق الموارد (مثل files.update) توفير fileId. استخدِم طريقة files.list لاسترداد معرّف ملف.
| تمثيل JSON |
|---|
{ "exportLinks": { string: string, ... }, "parents": [ string ], "owners": [ { object ( |
| الحقول | |
|---|---|
exportLinks |
النتائج فقط. روابط لتصدير ملفات "أدوات تحرير مستندات Google" إلى تنسيقات معيّنة عنصر يحتوي على قائمة بأزواج |
parents[] |
رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يكون للملف مجلد رئيسي واحد فقط، ولا يُسمح بتحديد مجلدات رئيسية متعددة. إذا لم يتم تحديدها كجزء من طلب إنشاء، يتم وضع الملف مباشرةً في مجلد "ملفاتي" الخاص بالمستخدم. إذا لم يتم تحديدها كجزء من طلب النسخ، يكتسب الملف أي عنصر رئيسي يمكن العثور عليه للملف المصدر. يجب أن تستخدم طلبات التعديل المَعلمتَين |
owners[] |
النتائج فقط. مالك هذا الملف قد يكون لبعض الملفات القديمة أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
permissions[] |
النتائج فقط. القائمة الكاملة بأذونات الملف لا تتوفّر هذه الميزة إلا إذا كان بإمكان المستخدم الذي يطلب الوصول مشاركة الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
spaces[] |
النتائج فقط. قائمة المساحات التي يحتوي الملف عليها. القيم المتاحة حاليًا هي |
properties |
مجموعة من أزواج المفتاح/القيمة العشوائية التي تكون مرئية لجميع التطبيقات يتم محو الإدخالات التي تتضمّن قيمًا فارغة في طلبات التعديل والنسخ. عنصر يحتوي على قائمة بأزواج |
appProperties |
مجموعة من أزواج المفتاح/القيمة العشوائية التي تكون خاصة بالتطبيق الذي يرسل الطلب. يتم محو الإدخالات التي تتضمّن قيمًا فارغة في طلبات التعديل والنسخ. لا يمكن استرداد هذه المواقع إلا باستخدام طلب مصادَق عليه. يستخدم الطلب الذي تمت مصادقته رمز دخول تم الحصول عليه باستخدام معرّف عميل OAuth 2.0. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد خصائص خاصة. عنصر يحتوي على قائمة بأزواج |
permissionIds[] |
النتائج فقط. قائمة بأرقام تعريف الأذونات للمستخدمين الذين يمكنهم الوصول إلى هذا الملف |
contentRestrictions[] |
القيود المفروضة على الوصول إلى محتوى الملف تتم تعبئة هذا الحقل فقط في حال وجود مثل هذا القيد. |
kind |
النتائج فقط. تحدّد نوع المورد. القيمة: السلسلة الثابتة |
driveId |
النتائج فقط. معرّف مساحة التخزين السحابي المشتركة التي يقيم فيها الملف لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
fileExtension |
النتائج فقط. المكوّن الأخير من |
copyRequiresWriterPermission |
تحديد ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقراء والمعلّقين |
md5Checksum |
النتائج فقط. المجموع الاختباري MD5 لمحتوى الملف لا ينطبق ذلك إلا على الملفات ذات المحتوى الثنائي في Google Drive. |
contentHints |
معلومات إضافية حول محتوى الملف لا تتم تعبئة هذه الحقول أبدًا في الردود. |
contentHints.indexableText |
النص المطلوب فهرسته للملف من أجل تحسين طلبات البحث fullText. يقتصر ذلك على 128 كيلوبايت في الطول وقد يحتوي على عناصر HTML. |
contentHints.thumbnail |
تمثّل هذه السمة صورة مصغّرة للملف. سيتم استخدام هذه الصورة فقط إذا تعذّر على Google Drive إنشاء صورة مصغّرة عادية. |
contentHints.thumbnail.image |
بيانات الصورة المصغّرة المشفّرة باستخدام Base64 الآمن لعنوان URL (القسم 5 من RFC 4648) سلسلة مرمّزة باستخدام Base64 |
contentHints.thumbnail.mimeType |
نوع MIME الخاص بالصورة المصغّرة. |
writersCanShare |
تحديد ما إذا كان بإمكان المستخدمين الذين لديهم إذن |
viewedByMe |
النتائج فقط. تُستخدَم لتحديد ما إذا كان المستخدم قد اطّلع على الملف. |
mimeType |
نوع MIME للملف يحاول Google Drive تلقائيًا رصد قيمة مناسبة من المحتوى الذي تم تحميله، في حال عدم توفير أي قيمة. لا يمكن تغيير القيمة إلا بعد تحميل نسخة جديدة. إذا تم إنشاء ملف باستخدام نوع MIME لمستند Google، يتم استيراد المحتوى الذي تم تحميله، إذا كان ذلك ممكنًا. يتم نشر تنسيقات الاستيراد المتوافقة في مرجع |
thumbnailLink |
النتائج فقط. تمثّل هذه السمة رابطًا قصير الأمد إلى الصورة المصغّرة للملف، إذا كانت متاحة. وعادةً ما يستمر هذا الإجراء لعدة ساعات. لا يُنصح باستخدامها مباشرةً في تطبيقات الويب بسبب سياسات مشاركة المراجع مع نطاقات خارجية (CORS). ننصحك باستخدام خادم وكيل. لا تتم تعبئة هذا الحقل إلا عندما يمكن للتطبيق الذي يطلب الوصول إلى الملف الوصول إلى محتواه. إذا لم تتم مشاركة الملف بشكل علني، يجب استرداد عنوان URL الذي تم عرضه في |
iconLink |
النتائج فقط. رابط ثابت غير مصادق عليه يؤدي إلى رمز الملف |
shared |
النتائج فقط. تُستخدَم لتحديد ما إذا تمت مشاركة الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
lastModifyingUser |
النتائج فقط. المستخدم الأخير الذي عدّل الملف لا تتم تعبئة هذا الحقل إلا عندما يجري مستخدم مسجّل الدخول آخر تعديل. |
headRevisionId |
النتائج فقط. رقم تعريف أحدث نسخة من الملف لا يتوفّر هذا الخيار حاليًا إلا للملفات ذات المحتوى الثنائي في Google Drive. |
sharingUser |
النتائج فقط. المستخدم الذي شارك الملف مع المستخدم الذي أرسل الطلب، إذا كان ذلك منطبقًا |
webViewLink |
النتائج فقط. رابط لفتح الملف في أداة تعديل أو عارض من Google في المتصفّح |
webContentLink |
النتائج فقط. رابط لتنزيل محتوى الملف في المتصفّح لا يتوفّر هذا الخيار إلا للملفات ذات المحتوى الثنائي في Google Drive. |
size |
النتائج فقط. الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" وملفات محرّر Google Workspace لن يتم ملء هذا الحقل للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات. |
viewersCanCopyContent |
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة |
hasThumbnail |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الملف يتضمّن صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي يطلب الوصول لديه إذن بالوصول إلى الصورة المصغّرة. للتحقّق من إمكانية الوصول، ابحث عن الحقل thumbnailLink. |
folderColorRgb |
لون المجلد أو اختصار المجلد كسلسلة سداسية عشرية بنموذج أحمر أخضر أزرق. يتم نشر الألوان المتوافقة في الحقل في حال تحديد لون غير متوافق، سيتم استخدام اللون الأقرب في لوحة الألوان بدلاً منه. |
id |
رقم تعريف الملف |
name |
تمثّل هذه السمة اسم الملف. لا يكون هذا المعرّف فريدًا بالضرورة داخل مجلد. يُرجى العِلم أنّ الاسم ثابت للعناصر غير القابلة للتغيير، مثل المجلدات ذات المستوى الأعلى في مساحات التخزين السحابي المشتركة ومجلد الجذر في "ملفاتي" ومجلد "بيانات التطبيقات". |
description |
تمثّل هذه السمة وصفًا موجزًا للملف. |
starred |
تُستخدَم لتحديد ما إذا كان المستخدم قد ميّز الملف بنجمة. |
trashed |
ما إذا تم نقل الملف إلى المهملات، إما بشكل صريح أو من مجلد رئيسي تم نقله إلى المهملات يمكن للمالك فقط نقل ملف إلى المهملات، ولكن يظل بإمكان المستخدمين الآخرين الوصول إلى الملف في مهملات المالك إلى أن يتم حذفه نهائيًا. |
explicitlyTrashed |
النتائج فقط. ما إذا تم نقل الملف إلى المهملات بشكل صريح، بدلاً من نقله بشكل متكرّر من مجلد رئيسي |
createdTime |
الوقت الذي تم فيه إنشاء الملف (تاريخ ووقت بتنسيق RFC 3339) |
modifiedTime |
آخر مرة عدَّل فيها أي مستخدم الملف (تاريخ ووقت بتنسيق RFC 3339) يُرجى العِلم أنّ ضبط |
modifiedByMeTime |
النتائج فقط. آخر مرة عدّل فيها المستخدم الملف (تنسيق التاريخ والوقت RFC 3339) |
viewedByMeTime |
آخر مرة اطّلع فيها المستخدم على الملف (تنسيق التاريخ والوقت RFC 3339) |
sharedWithMeTime |
النتائج فقط. الوقت الذي تمت فيه مشاركة الملف مع المستخدم، إذا كان ذلك منطبقًا (تنسيق التاريخ والوقت RFC 3339) |
quotaBytesUsed |
النتائج فقط. عدد وحدات البايت لمساحة التخزين المتوفّرة التي يستخدمها الملف يتضمّن ذلك مراجعة الرأس بالإضافة إلى المراجعات السابقة التي تم تفعيل |
version |
النتائج فقط. رقم إصدار يتزايد بشكل منتظم للملف ويعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم. |
originalFilename |
اسم الملف الأصلي للمحتوى الذي تم تحميله إذا كان متاحًا، وإلا سيتم استخدام القيمة الأصلية للحقل |
ownedByMe |
النتائج فقط. تُستخدَم لتحديد ما إذا كان المستخدم يملك الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة. |
fullFileExtension |
النتائج فقط. امتداد الملف الكامل الذي تم استخراجه من الحقل يتم تعديل هذا الحقل تلقائيًا عند تغيير الحقل |
isAppAuthorized |
النتائج فقط. تُستخدَم لتحديد ما إذا كان التطبيق الذي يطلب الإذن قد أنشأ الملف أو فتحه. |
teamDriveId |
تم إيقافها نهائيًا: النتائج فقط. يمكنك استخدام |
capabilities |
النتائج فقط. الإمكانات التي يملكها المستخدم الحالي في هذا الملف تتوافق كل إمكانية مع إجراء دقيق يمكن للمستخدم اتخاذه. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على إمكانات الملفات. |
capabilities.canChangeViewersCanCopyContent |
تم إيقافها نهائيًا: النتائج فقط. |
capabilities.canMoveChildrenOutOfDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد خارج مساحة التخزين السحابي المشتركة. هذا هو |
capabilities.canReadDrive |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي قراءة مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملف. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
capabilities.canEdit |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم الحالي تعديل هذا الملف قد تحدّ عوامل أخرى من نوع التغييرات التي يمكن للمستخدم إجراؤها على ملف. على سبيل المثال، اطّلِع على |
capabilities.canCopy |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نسخ هذا الملف. بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، يحدّد هذا الحقل ما إذا كان بإمكان المستخدم الحالي نسخ العناصر الفرعية غير المجلدات لهذا العنصر، أو هذا العنصر إذا لم يكن مجلدًا. |
capabilities.canComment |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي التعليق على هذا الملف. |
capabilities.canAddChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة أطفال إلى هذا المجلد. تكون هذه القيمة دائمًا |
capabilities.canDelete |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف هذا الملف. |
capabilities.canDownload |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تنزيل هذا الملف. |
capabilities.canListChildren |
النتائج فقط. تحديد ما إذا كان بإمكان المستخدم الحالي إدراج العناصر الفرعية لهذا المجلد تكون هذه القيمة دائمًا |
capabilities.canRemoveChildren |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إزالة الأطفال من هذا المجلد. تكون هذه القيمة دائمًا |
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 |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تغيير الحقل |
capabilities.canAcceptOwnership |
النتائج فقط. تُستخدَم لتحديد ما إذا كان المستخدم الحالي هو المالك غير النهائي للملف. لا تتم تعبئته لملفات مساحة التخزين السحابي المشتركة. |
capabilities.canReadLabels |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي قراءة التصنيفات في الملف. |
capabilities.canModifyLabels |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تعديل التصنيفات في الملف. |
capabilities.canModifyEditorContentRestriction |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة قيود المحتوى في الملف أو تعديلها، وهي قيود لا يمكن للمحرِّرين تجاوزها. |
capabilities.canModifyOwnerContentRestriction |
النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إضافة قيود المحتوى أو تعديلها، وهي قيود لا يمكن إلا للمالك فرضها. |
capabilities.canRemoveContentRestriction |
النتائج فقط. ما إذا كان هناك قيود على محتوى الملف يمكن للمستخدم الحالي إزالتها |
capabilities.canDisableInheritedPermissions |
تحديد ما إذا كان بإمكان المستخدم إيقاف الأذونات المكتسَبة |
capabilities.canEnableInheritedPermissions |
تحديد ما إذا كان بإمكان المستخدم إعادة تفعيل الأذونات المكتسَبة |
capabilities.canChangeItemDownloadRestriction |
النتائج فقط. توضّح ما إذا كان بإمكان المستخدم الحالي تغيير القيود التي فرضها المالك أو المنظِّم على تنزيل الملف. |
hasAugmentedPermissions |
النتائج فقط. تُستخدَم لتحديد ما إذا كانت هناك أذونات مباشرة على هذا الملف. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
trashingUser |
النتائج فقط. إذا تم نقل الملف إلى المهملات بشكل صريح، سيظهر المستخدم الذي نفّذ هذا الإجراء. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
thumbnailVersion |
النتائج فقط. نسخة الصورة المصغّرة التي سيتم استخدامها في إبطال ذاكرة التخزين المؤقت للصور المصغّرة. |
trashedTime |
النتائج فقط. تشير هذه السمة إلى الوقت الذي تم فيه نقل العنصر إلى المهملات (تنسيق التاريخ والوقت RFC 3339). لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة. |
modifiedByMe |
النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا المستخدم قد عدّل الملف. |
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.time |
النتائج فقط. تاريخ ووقت التقاط الصورة (EXIF DateTime) |
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 |
النتائج فقط. مفتاح مطلوب للوصول إلى الملف من خلال رابط مشاركة |
linkShareMetadata |
النتائج فقط. تفاصيل ذات صلة بـ LinkShare يحتوي على تفاصيل حول عناوين URL للروابط التي يستخدمها العملاء للإشارة إلى هذا العنصر. |
linkShareMetadata.securityUpdateEligible |
النتائج فقط. تُستخدَم لتحديد ما إذا كان الملف مؤهَّلاً لتلقّي تحديث الأمان. |
linkShareMetadata.securityUpdateEnabled |
النتائج فقط. تُستخدَم لتحديد ما إذا كان تحديث الأمان مفعَّلاً لهذا الملف. |
labelInfo |
النتائج فقط. نظرة عامة على التصنيفات في الملف |
labelInfo.labels[] |
النتائج فقط. مجموعة التصنيفات في الملف على النحو المطلوب من خلال أرقام تعريف التصنيفات في المَعلمة |
sha1Checksum |
النتائج فقط. المجموع الاختباري SHA1 المرتبط بهذا الملف، إذا كان متاحًا لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "أدوات تحرير مستندات Google" أو ملفات الاختصارات. |
sha256Checksum |
النتائج فقط. المجموع الاختباري SHA256 المرتبط بهذا الملف، إذا كان متاحًا لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "أدوات تحرير مستندات Google" أو ملفات الاختصارات. |
inheritedPermissionsDisabled |
تُستخدَم لتحديد ما إذا كانت أذونات الوصول المكتسَبة غير مفعَّلة لهذا الملف. تكون الأذونات المكتسَبة مفعّلة تلقائيًا. |
downloadRestrictions |
تم تطبيق قيود التنزيل على الملف. |
ContentRestriction
تمثّل هذه السمة قيودًا على الوصول إلى محتوى الملف.
| تمثيل JSON |
|---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
| الحقول | |
|---|---|
readOnly |
تُستخدَم لتحديد ما إذا كان محتوى الملف للقراءة فقط. إذا كان الملف للقراءة فقط، قد لا تتم إضافة نسخة جديدة من الملف، وقد لا تتم إضافة التعليقات أو تعديلها، وقد لا يتم تعديل عنوان الملف. |
reason |
سبب حظر محتوى الملف يمكن تغيير هذه السمة فقط في الطلبات التي تضبط |
type |
النتائج فقط. تمثّل هذه السمة نوع القيود المفروضة على المحتوى. القيمة الوحيدة المتاحة حاليًا هي |
restrictingUser |
النتائج فقط. المستخدم الذي وضع قيود المحتوى تتم تعبئة هذا الحقل فقط إذا كان |
restrictionTime |
النتائج فقط. الوقت الذي تم فيه ضبط قيود المحتوى (بتنسيق RFC 3339 date-time) تتم تعبئة هذا الحقل فقط إذا كان |
ownerRestricted |
تحديد ما إذا كان يمكن للمستخدم الذي يملك الملف فقط تعديل قيود المحتوى أو إزالتها بالنسبة إلى الملفات في مساحات التخزين السحابي المشتركة، يمكن لأي مستخدم لديه إمكانات |
systemRestricted |
النتائج فقط. تُستخدَم لتحديد ما إذا كان النظام قد فرض قيودًا على المحتوى، مثلاً بسبب توفّر توقيع إلكتروني. لا يمكن للمستخدمين تعديل قيود المحتوى المحظور من النظام أو إزالتها. |
DownloadRestrictionsMetadata
تم تطبيق قيود على تنزيل الملف.
| تمثيل JSON |
|---|
{ "itemDownloadRestriction": { object ( |
| الحقول | |
|---|---|
itemDownloadRestriction |
تم تطبيق قيود تنزيل الملف مباشرةً من قِبل المالك أو المنظِّم. لا يأخذ هذا الإجراء في الاعتبار إعدادات مساحة تخزين سحابي مشتركة أو قواعد منع فقدان البيانات. |
effectiveDownloadRestrictionWithContext |
النتائج فقط. قيود التنزيل السارية على هذا الملف ويأخذ هذا الإجراء في الاعتبار جميع إعدادات القيود وقواعد "منع فقدان البيانات". |
DownloadRestriction
تمثّل هذه السمة قيودًا على نسخ الملف وتنزيله.
| تمثيل JSON |
|---|
{ "restrictedForReaders": boolean, "restrictedForWriters": boolean } |
| الحقول | |
|---|---|
restrictedForReaders |
تحديد ما إذا كان التنزيل والنسخ محظورَين على القرّاء |
restrictedForWriters |
ما إذا كان التنزيل والنسخ محظورَين على الكُتّاب إذا كان |
الطُرق |
|
|---|---|
|
ينشئ نسخة من ملف ويطبّق أي تحديثات مطلوبة باستخدام دلالات التصحيح. |
|
تنشئ هذه الطريقة ملفًا. |
|
يحذف هذا الإجراء نهائيًا ملفًا يملكه المستخدم بدون نقله إلى المهملات. |
|
تنزيل محتوى ملف |
|
حذف جميع ملفات المستخدم في المهملات نهائيًا |
|
تصدِّر هذه الطريقة مستند Google Workspace إلى نوع MIME المطلوب وتعرض محتوى البايت المصدَّر. |
|
تنشئ هذه الطريقة مجموعة من معرّفات الملفات التي يمكن تقديمها في طلبات الإنشاء أو النسخ. |
|
تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاص بملف معيّن من خلال رقم تعريفه. |
|
تعرض هذه السمة ملفات المستخدم. |
|
تعرض هذه السمة التصنيفات في ملف. |
|
تعديل مجموعة التصنيفات المطبَّقة على ملف |
|
تعدّل هذه الطريقة البيانات الوصفية لملف أو محتواه أو كليهما. |
|
للاشتراك في تلقّي إشعارات بشأن التغييرات التي يتم إجراؤها على ملف |