تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

REST Resource: files

المورد: ملف
- تمثيل JSON
  - تمثيل JSON
  - تمثيل JSON
- ContentRestriction
  - تمثيل JSON
الطُرق

المرجع: ملف

البيانات الوصفية لملف معيّن

تتطلّب بعض طرق الموارد (مثل files.update) استخدام fileId. استخدِم الطريقة files.list لاسترداد رقم تعريف ملف.

تمثيل JSON

تمثيل JSON
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "name": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "createdTime": string, "modifiedTime": string, "modifiedByMeTime": string, "viewedByMeTime": string, "sharedWithMeTime": string, "quotaBytesUsed": string, "version": string, "originalFilename": string, "ownedByMe": boolean, "fullFileExtension": string, "properties": { string: value, ... }, "appProperties": { string: value, ... }, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeViewersCanCopyContent": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "permissionIds": [ string ], "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { object (`ContentRestriction`) } ], "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

الحقول
`kind`	`string` النتائج فقط. لتحديد نوع المورد. القيمة: السلسلة الثابتة `"drive#file"`.
`driveId`	`string` النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`fileExtension`	`string` النتائج فقط. المكوّن النهائي من `fullFileExtension` لا يتوفّر هذا الخيار إلا للملفات التي تحتوي على محتوى ثنائي في Google Drive.
`copyRequiresWriterPermission`	`boolean` ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقراء والمعلقين
`md5Checksum`	`string` النتائج فقط. المجموع الاختباري MD5 لمحتوى الملف لا ينطبق ذلك إلا على الملفات التي تحتوي على محتوى ثنائي في Google Drive.
`contentHints`	`object` معلومات إضافية عن محتوى الملف لا تتم تعبئة هذه الحقول مطلقًا في الردود.
`contentHints.indexableText`	`string` النص الذي سيتم فهرسته للملف لتحسين طلبات البحث عن النص الكامل يجب ألا يزيد طول هذا المحتوى عن 128 كيلوبايت، وقد يحتوي على عناصر HTML.
`contentHints.thumbnail`	`object` صورة مصغّرة للملف ولن يتم استخدامها إلا إذا تعذّر على Google Drive إنشاء صورة مصغّرة عادية.
`contentHints.thumbnail.image`	`string (bytes format)` بيانات الصورة المصغّرة المشفّرة باستخدام Base64 المتوافق مع عناوين URL (القسم 5 من RFC 4648) سلسلة مُشفَّرة باستخدام base64
`contentHints.thumbnail.mimeType`	`string` نوع MIME للصورة المصغّرة
`writersCanShare`	`boolean` ما إذا كان بإمكان المستخدمين الذين لديهم إذن `writer` فقط تعديل أذونات الملف لا يتمّ تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`viewedByMe`	`boolean` النتائج فقط. ما إذا كان هذا المستخدم قد عرض الملف
`mimeType`	`string` نوع MIME للملف يحاول Google Drive رصد قيمة مناسبة تلقائيًا من المحتوى المحمَّل، في حال عدم تقديم أي قيمة. لا يمكن تغيير القيمة ما لم يتم تحميل نسخة جديدة. إذا تم إنشاء ملف باستخدام نوع MIME في "مستندات Google"، يتم استيراد المحتوى المحمَّل، إن أمكن. يتم نشر تنسيقات الاستيراد المتوافقة في مرجع "لمحة".
`exportLinks`	`map (key: string, value: string)` النتائج فقط. روابط لتصدير ملفات "أدوات تحرير مستندات Google" إلى تنسيقات محدّدة عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`parents[]`	`string` رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يتضمّن الملف مجلدًا رئيسيًا واحدًا فقط، ولا يمكن تحديد مجلدات رئيسية متعددة. إذا لم يتم تحديده كجزء من طلب الإنشاء، يتم وضع الملف مباشرةً في مجلد "ملفاتي" الخاص بالمستخدم. إذا لم يتم تحديده كجزء من طلب نسخ، يكتسب الملف أي ملف رئيسي قابل للاكتشاف للملف المصدر. يجب أن تستخدِم طلبات files.update المَعلمتَين `addParents` و`removeParents` لتعديل قائمة الملفات الرئيسية.
`thumbnailLink`	`string` النتائج فقط. رابط مؤقت يؤدي إلى الصورة المصغّرة للملف، إذا كانت متاحة وعادةً ما تستمر هذه العملية لعدة ساعات. لا يُقصد استخدامه مباشرةً في تطبيقات الويب بسبب سياسات مشاركة الموارد المشتركة المنشأ (CORS)، لذا ننصحك باستخدام خادم وكيل. لا يتمّ تعبئة هذا الحقل إلّا عندما يتمكّن التطبيق الذي يطلب الوصول من الوصول إلى محتوى الملف. إذا لم تتم مشاركة الملف بشكل علني، يجب جلب عنوان URL الذي تم إرجاعه في `Files.thumbnailLink` باستخدام طلب مزوّد ببيانات اعتماد.
`iconLink`	`string` النتائج فقط. رابط ثابت غير موثَّق يؤدي إلى رمز الملف
`shared`	`boolean` النتائج فقط. ما إذا تمت مشاركة الملف لا يتمّ تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`lastModifyingUser`	`object (User)` النتائج فقط. آخر مستخدم عدّل الملف لا تتم تعبئة هذا الحقل إلا عندما يكون آخر تعديل قد أجراه مستخدم سجّل الدخول.
`owners[]`	`object (User)` النتائج فقط. مالك هذا الملف قد يكون لبعض الملفات القديمة فقط أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`headRevisionId`	`string` النتائج فقط. رقم تعريف المراجعة الرئيسية للملف لا يتوفّر هذا الخيار حاليًا إلا للملفات التي تحتوي على محتوى ثنائي في Google Drive.
`sharingUser`	`object (User)` النتائج فقط. المستخدم الذي شارك الملف مع المستخدم المُقدّم للطلب، إن وُجد.
`webViewLink`	`string` النتائج فقط. رابط لفتح الملف في محرِّر أو مشغّل محتوى Google ذي صلة في متصفّح
`webContentLink`	`string` النتائج فقط. رابط لتنزيل محتوى الملف في متصفّح لا يتوفّر هذا الخيار إلا للملفات التي تحتوي على محتوى ثنائي في Google Drive.
`size`	`string (int64 format)` النتائج فقط. الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" و"أدوات التعديل" التابعة للجهة الأولى لن يتمّ تعبئة هذا الحقل للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
`viewersCanCopyContent (deprecated)`	`boolean` تم إيقاف هذا العنصر نهائيًا. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام `copyRequiresWriterPermission` بدلاً منها.
`permissions[]`	`object (Permission)` النتائج فقط. القائمة الكاملة للأذونات الخاصة بالملف لا يتوفّر هذا الخيار إلا إذا كان بإمكان المستخدم الذي يطلب المشاركة مشاركة الملف. لا يتمّ تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`hasThumbnail`	`boolean` النتائج فقط. ما إذا كان هذا الملف يتضمّن صورة مصغّرة ولا يشير ذلك إلى ما إذا كان التطبيق الذي يطلب الوصول إلى الصورة المصغّرة يملك إذن الوصول إليها. للتحقّق من إمكانية الوصول، ابحث عن حقل thumbnailLink.
`spaces[]`	`string` النتائج فقط. قائمة المساحات التي تحتوي على الملف القيم المسموح بها حاليًا هي "drive" و"appDataFolder" و"photos".
`folderColorRgb`	`string` لون مجلد أو اختصار لمجلد بتنسيق سلسلة سداسية عشرية لنموذج RGB يتم نشر الألوان المتوافقة في حقل `folderColorPalette` لمرجع "لمحة". في حال تحديد لون غير متوافق، يتم استخدام أقرب لون في لوحة الألوان بدلاً من ذلك.
`id`	`string` رقم تعريف الملف
`name`	`string` اسم الملف ولا يُشترط أن يكون هذا المفتاح فريدًا داخل مجلد. يُرجى العلم أنّ الاسم ثابت للعناصر غير القابلة للتغيير، مثل المجلدات ذات المستوى الأعلى في مساحات التخزين السحابي المشتركة والمجلد الجذر في "ملفاتي" ومجلد "بيانات التطبيقات".
`description`	`string` وصف موجز للملف
`starred`	`boolean` ما إذا كان المستخدم قد تميّز الملف بنجمة
`trashed`	`boolean` ما إذا تم نقل الملف إلى المهملات، إما بشكل صريح أو من مجلد رئيسي في المهملات يمكن للمالك فقط وضع ملف في المهملات، ولا يمكن للمستخدمين الآخرين الاطّلاع على الملفات في المهملات الخاصة بالمالك.
`explicitlyTrashed`	`boolean` النتائج فقط. ما إذا تم وضع الملف في المهملات بشكل صريح، بدلاً من وضعه في المهملات بشكل متكرر من مجلد رئيسي
`createdTime`	`string` الوقت الذي تم فيه إنشاء الملف (التاريخ والوقت بتنسيق RFC 3339)
`modifiedTime`	`string` آخر مرة عدَّل فيها أي مستخدم الملف (التاريخ والوقت بتنسيق RFC 3339) يُرجى العِلم أنّ ضبط `modifiedTime` يؤدي أيضًا إلى تعديل `modifiedByMeTime` للمستخدم.
`modifiedByMeTime`	`string` النتائج فقط. آخر مرة عدّل فيها المستخدم الملف (التاريخ والوقت بتنسيق RFC 3339)
`viewedByMeTime`	`string` آخر مرة اطّلع فيها المستخدم على الملف (التاريخ والوقت بتنسيق RFC 3339)
`sharedWithMeTime`	`string` النتائج فقط. الوقت الذي تمت فيه مشاركة الملف مع المستخدم، إذا كان ذلك منطبقًا (التاريخ والوقت بتنسيق RFC 3339)
`quotaBytesUsed`	`string (int64 format)` النتائج فقط. عدد وحدات البايت لمساحة التخزين المتوفّرة التي يستخدمها الملف يشمل ذلك مراجعة الرأس وكذلك المراجعات السابقة التي تم تفعيل `keepForever` فيها.
`version`	`string (int64 format)` النتائج فقط. رقم إصدار يتزايد بشكل منتظم للملف ويعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم.
`originalFilename`	`string` اسم الملف الأصلي للمحتوى الذي تم تحميله إذا كان متاحًا، أو القيمة الأصلية للحقل `name` لا يتوفّر هذا الخيار إلا للملفات التي تحتوي على محتوى ثنائي في Google Drive.
`ownedByMe`	`boolean` النتائج فقط. ما إذا كان المستخدم يملك الملف لا يتمّ تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`fullFileExtension`	`string` النتائج فقط. امتداد الملف الكامل المستخرَج من حقل `name` قد تحتوي على عدة امتدادات متسلسلة، مثل "tar.gz". لا يتوفّر هذا الخيار إلا للملفات التي تحتوي على محتوى ثنائي في Google Drive. يتم تعديل هذا الإعداد تلقائيًا عند تغيير حقل `name`، ولكن لا يتم محوه إذا كان الاسم الجديد لا يحتوي على إضافة صالحة.
`properties`	`map (key: string, value: value (Value format))` مجموعة من أزواج مفتاح/قيمة عشوائية تكون مرئية لجميع التطبيقات يتم محو الإدخالات التي تحتوي على قيم خالية في طلبات التعديل والنسخ. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`appProperties`	`map (key: string, value: value (Value format))` مجموعة من أزواج المفتاح/القيمة العشوائية الخاصة بالتطبيق الذي يطلب الإذن يتم محو الإدخالات التي تحتوي على قيم خالية في طلبات التعديل والنسخ. لا يمكن استرداد هذه السمات إلا باستخدام طلب تمّت مصادقةه. يستخدم الطلب الذي تمّت مصادقته رمز دخول تم الحصول عليه باستخدام معرّف عميل OAuth 2. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`isAppAuthorized`	`boolean` النتائج فقط. ما إذا كان التطبيق الذي يطلب الوصول إلى الملف هو الذي أنشأه أو فتحه
`teamDriveId (deprecated)`	`string` تم إيقاف هذا العنصر نهائيًا. تم إيقافها نهائيًا: النتائج فقط. استخدِم `driveId` بدلاً من ذلك.
`capabilities`	`object` النتائج فقط. الإمكانات التي يمتلكها المستخدم الحالي في هذا الملف يتوافق كلّ إذن مع إجراء دقيق يمكن أن يتّخذه المستخدِم.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد خارج مساحة التخزين السحابي المشتركة يكون هذا الحقل غير صحيح عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`capabilities.canReadDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي قراءة مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملف. تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`capabilities.canEdit`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تعديل هذا الملف. قد تحدّ عوامل أخرى من نوع التغييرات التي يمكن للمستخدم إجراؤها على ملف. على سبيل المثال، يمكنك الاطّلاع على `canChangeCopyRequiresWriterPermission` أو `canModifyContent`.
`capabilities.canCopy`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نسخ هذا الملف بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، ما إذا كان بإمكان المستخدم الحالي نسخ العناصر الفرعية غير المجلدات لهذا العنصر، أو هذا العنصر نفسه إذا لم يكن مجلدًا
`capabilities.canComment`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي التعليق على هذا الملف.
`capabilities.canAddChildren`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة أطفال إلى هذا المجلد تكون هذه القيمة خطأ دائمًا عندما لا يكون العنصر مجلدًا.
`capabilities.canDelete`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي حذف هذا الملف
`capabilities.canDownload`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تنزيل هذا الملف
`capabilities.canListChildren`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إدراج العناصر الفرعية لهذا المجلد تكون هذه القيمة خطأ دائمًا عندما لا يكون العنصر مجلدًا.
`capabilities.canRemoveChildren`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إزالة الأطفال من هذا المجلد تكون هذه القيمة خطأ دائمًا عندما لا يكون العنصر مجلدًا. بالنسبة إلى مجلد في مساحة تخزين سحابي مشتركة، استخدِم `canDeleteChildren` أو `canTrashChildren` بدلاً من ذلك.
`capabilities.canRename`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إعادة تسمية هذا الملف
`capabilities.canTrash`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل هذا الملف إلى المهملات
`capabilities.canReadRevisions`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي قراءة مرجع المراجعات لهذا الملف بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، يمكن قراءة النُسخ السابقة من العناصر الفرعية غير المجلدة لهذا العنصر، أو هذا العنصر نفسه إذا لم يكن مجلدًا.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canReadDrive` بدلاً من ذلك.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveItemWithinDrive` أو `canMoveItemOutOfDrive` بدلاً من ذلك.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير القيود المفروضة على هذا الملف بموجب `copyRequiresWriterPermission`
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveItemOutOfDrive` بدلاً من ذلك.
`capabilities.canUntrash`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي استعادة هذا الملف من المهملات
`capabilities.canModifyContent`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تعديل محتوى هذا الملف.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveItemWithinDrive` بدلاً من ذلك.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveItemOutOfDrive` بدلاً من ذلك.
`capabilities.canDeleteChildren`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي حذف العناصر الفرعية لهذا المجلد يكون هذا الحقل غير صحيح عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveChildrenOutOfDrive` بدلاً من ذلك.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم `canMoveChildrenWithinDrive` بدلاً من ذلك.
`capabilities.canTrashChildren`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي حذف العناصر الفرعية لهذا المجلد يكون هذا الحقل غير صحيح عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`capabilities.canMoveItemOutOfDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل هذا العنصر خارج هذا محرك الأقراص من خلال تغيير العنصر الرئيسي يُرجى العِلم أنّه قد لا يتم تنفيذ طلب تغيير العنصر الرئيسي للعنصر، وذلك استنادًا إلى العنصر الرئيسي الجديد الذي تتم إضافته.
`capabilities.canAddMyDriveParent`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة عنصر رئيسي للعنصر بدون إزالة عنصر رئيسي حالي في الطلب نفسه لا يتم تعبئة هذا الحقل لملفات مساحة التخزين السحابي المشتركة.
`capabilities.canRemoveMyDriveParent`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إزالة عنصر رئيسي من العنصر بدون إضافة عنصر رئيسي آخر في الطلب نفسه لا يتم تعبئة هذا الحقل لملفات مساحة التخزين السحابي المشتركة.
`capabilities.canMoveItemWithinDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل هذا العنصر ضمن مساحة التخزين هذه يُرجى العِلم أنّ طلب تغيير العنصر الرئيسي قد لا ينجح استنادًا إلى العنصر الرئيسي الجديد الذي تتم إضافته والعنصر الرئيسي الذي تتم إزالته.
`capabilities.canShare`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تعديل إعدادات المشاركة لهذا الملف
`capabilities.canMoveChildrenWithinDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية لهذا المجلد ضمن مساحة التخزين هذه يكون هذا الحقل غير صحيح عندما لا يكون العنصر مجلدًا. يُرجى العِلم أنّ طلب نقل العنصر الفرعي قد لا يزال يتعذّر إكماله استنادًا إلى إذن وصول المستخدم الحالي إلى العنصر الفرعي والمجلد الوجهة.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` تم إيقافها نهائيًا: النتائج فقط. استخدِم أحد الخيارات التالية: `canModifyEditorContentRestriction` أو `canModifyOwnerContentRestriction` أو `canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة مجلد من مساحة تخزين سحابي أخرى (مساحة تخزين سحابي مشتركة مختلفة أو "ملفاتي") إلى هذا المجلد. يكون هذا الحقل غير صحيح عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير الحقل securityUpdateEnabled في البيانات الوصفية لمشاركة الرابط
`capabilities.canAcceptOwnership`	`boolean` النتائج فقط. ما إذا كان المستخدم الحالي هو المالك المعلّق للملف. لا يتم تعبئة هذا الحقل لملفات مساحة التخزين السحابي المشتركة.
`capabilities.canReadLabels`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي قراءة التصنيفات على الملف
`capabilities.canModifyLabels`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تعديل التصنيفات على الملف
`capabilities.canModifyEditorContentRestriction`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة أو تعديل قيود المحتوى على الملف التي تم حظرها على المحرِّر
`capabilities.canModifyOwnerContentRestriction`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة أو تعديل قيود المحتوى التي فرضها المالك
`capabilities.canRemoveContentRestriction`	`boolean` النتائج فقط. ما إذا كان هناك قيود على المحتوى في الملف يمكن للمستخدم الحالي إزالتها
`capabilities.canDisableInheritedPermissions`	`boolean` ما إذا كان بإمكان المستخدم إيقاف الأذونات المكتسَبة
`capabilities.canEnableInheritedPermissions`	`boolean` ما إذا كان بإمكان المستخدم إعادة تفعيل الأذونات المكتسَبة
`hasAugmentedPermissions`	`boolean` النتائج فقط. ما إذا كانت هناك أذونات مباشرةً في هذا الملف لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة.
`trashingUser`	`object (User)` النتائج فقط. إذا تم وضع الملف في المهملات صراحةً، المستخدم الذي وضعه في المهملات تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`thumbnailVersion`	`string (int64 format)` النتائج فقط. إصدار الصورة المصغّرة لاستخدامه في إلغاء صلاحية ذاكرة التخزين المؤقت للصورة المصغّرة
`trashedTime`	`string` النتائج فقط. الوقت الذي تم فيه نقل العنصر إلى المهملات (تاريخ ووقت بتنسيق RFC 3339) تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`modifiedByMe`	`boolean` النتائج فقط. ما إذا كان هذا المستخدم قد عدّل الملف
`permissionIds[]`	`string` الإخراج فقط: files.list من أرقام تعريف الأذونات للمستخدمين الذين يمكنهم الوصول إلى هذا الملف
`imageMediaMetadata`	`object` النتائج فقط. بيانات وصفية إضافية عن وسائط الصور، إن توفّرت
`imageMediaMetadata.flashUsed`	`boolean` النتائج فقط. ما إذا تم استخدام فلاش لإنشاء الصورة
`imageMediaMetadata.meteringMode`	`string` النتائج فقط. وضع القياس المستخدَم لإنشاء الصورة
`imageMediaMetadata.sensor`	`string` النتائج فقط. نوع أداة الاستشعار المستخدَمة لإنشاء الصورة
`imageMediaMetadata.exposureMode`	`string` النتائج فقط. وضع التعريض للضوء المستخدَم لإنشاء الصورة
`imageMediaMetadata.colorSpace`	`string` النتائج فقط. مساحة اللون للصورة
`imageMediaMetadata.whiteBalance`	`string` النتائج فقط. وضع توازن اللون الأبيض المستخدَم لإنشاء الصورة
`imageMediaMetadata.width`	`integer` النتائج فقط. عرض الصورة بالبكسل
`imageMediaMetadata.height`	`integer` النتائج فقط. ارتفاع الصورة بالبكسل
`imageMediaMetadata.location`	`object` النتائج فقط. معلومات الموقع الجغرافي المخزّنة في الصورة
`imageMediaMetadata.location.latitude`	`number` النتائج فقط. خط العرض المخزَّن في الصورة
`imageMediaMetadata.location.longitude`	`number` النتائج فقط. خط الطول المخزّن في الصورة
`imageMediaMetadata.location.altitude`	`number` النتائج فقط. الارتفاع المخزَّن في الصورة
`imageMediaMetadata.rotation`	`integer` النتائج فقط. عدد مرات التدوير 90 درجة في اتجاه عقارب الساعة التي تم تطبيقها من اتجاه الصورة الأصلي
`imageMediaMetadata.time`	`string` النتائج فقط. تاريخ ووقت التقاط الصورة (EXIF DateTime)
`imageMediaMetadata.cameraMake`	`string` النتائج فقط. علامة تجارية الكاميرا المستخدَمة لإنشاء الصورة
`imageMediaMetadata.cameraModel`	`string` النتائج فقط. طراز الكاميرا المستخدَمة لإنشاء الصورة
`imageMediaMetadata.exposureTime`	`number` النتائج فقط. مدة التعرّض للضوء، بالثواني
`imageMediaMetadata.aperture`	`number` النتائج فقط. فتحة العدسة المستخدَمة لإنشاء الصورة (رقم f)
`imageMediaMetadata.focalLength`	`number` النتائج فقط. البعد البؤري المستخدَم لإنشاء الصورة، بالمليمتر
`imageMediaMetadata.isoSpeed`	`integer` النتائج فقط. سرعة ISO المستخدَمة لإنشاء الصورة.
`imageMediaMetadata.exposureBias`	`number` النتائج فقط. انحراف التعرّض للضوء في الصورة (قيمة APEX).
`imageMediaMetadata.maxApertureValue`	`number` النتائج فقط. أصغر عدد f للعدسة عند البعد البؤري المستخدَم لإنشاء الصورة (قيمة APEX).
`imageMediaMetadata.subjectDistance`	`integer` النتائج فقط. المسافة إلى الهدف المُراد تصويره، بالمتر
`imageMediaMetadata.lens`	`string` النتائج فقط. العدسة المستخدَمة لإنشاء الصورة
`videoMediaMetadata`	`object` النتائج فقط. بيانات وصفية إضافية عن ملف وسائط الفيديو قد لا يتوفّر هذا الخيار فور تحميل الفيديو.
`videoMediaMetadata.width`	`integer` النتائج فقط. عرض الفيديو بالبكسل
`videoMediaMetadata.height`	`integer` النتائج فقط. ارتفاع الفيديو بالبكسل
`videoMediaMetadata.durationMillis`	`string (int64 format)` النتائج فقط. مدة الفيديو بالملي ثانية
`shortcutDetails`	`object` تفاصيل ملف الاختصار تتم تعبئة هذا الحقل لملفات الاختصارات فقط التي تم ضبط حقل mimeType فيها على `application/vnd.google-apps.shortcut`. لا يمكن ضبطها إلا على `files.create` طلب.
`shortcutDetails.targetId`	`string` معرّف الملف الذي يشير إليه هذا الاختصار لا يمكن ضبطها إلا على `files.create` طلب.
`shortcutDetails.targetMimeType`	`string` النتائج فقط. نوع MIME للملف الذي يشير إليه هذا الاختصار قيمة هذا الحقل هي لقطة لنوع MIME للهدف، تم التقاطها عند إنشاء الاختصار.
`shortcutDetails.targetResourceKey`	`string` النتائج فقط. مفتاح ResourceKey للملف المستهدَف.
`contentRestrictions[]`	`object (ContentRestriction)` القيود المفروضة على الوصول إلى محتوى الملف لا تتم تعبئة هذا الحقل إلا في حال توفّر هذا القيد.
`resourceKey`	`string` النتائج فقط. مفتاح مطلوب للوصول إلى العنصر من خلال رابط مشترَك
`linkShareMetadata`	`object` النتائج فقط. التفاصيل المتعلّقة بخدمة LinkShare يحتوي على تفاصيل عن عناوين URL للرابط التي يستخدمها العملاء للإشارة إلى هذا العنصر.
`linkShareMetadata.securityUpdateEligible`	`boolean` النتائج فقط. ما إذا كان الملف مؤهلاً للحصول على تحديث أمان
`linkShareMetadata.securityUpdateEnabled`	`boolean` النتائج فقط. ما إذا كان تحديث الأمان مفعّلاً لهذا الملف
`labelInfo`	`object` النتائج فقط. نظرة عامة على التصنيفات في الملف
`labelInfo.labels[]`	`object (Label)` النتائج فقط. مجموعة التصنيفات في الملف كما هو مطلوب من خلال أرقام تعريف التصنيفات في المَعلمة `includeLabels`. لا يتم عرض أي تصنيفات تلقائيًا.
`sha1Checksum`	`string` النتائج فقط. المجموع الاختباري SHA1 المرتبط بهذا الملف، في حال توفّره لا يتم ملء هذا الحقل إلا للملفات التي تحتوي على محتوى مخزّن في Google Drive، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`sha256Checksum`	`string` النتائج فقط. المجموع الاختباري SHA256 المرتبط بهذا الملف، إذا كان متاحًا لا يتم ملء هذا الحقل إلا للملفات التي تحتوي على محتوى مخزّن في Google Drive، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`inheritedPermissionsDisabled`	`boolean` يشير ذلك إلى ما إذا كانت الأذونات المُكتسَبة لهذا الملف غير مفعّلة. تكون الأذونات المكتسَبة مفعَّلة تلقائيًا.

ContentRestriction

تقييد الوصول إلى محتوى الملف

تمثيل JSON
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionTime": string, "ownerRestricted": boolean, "systemRestricted": boolean }

الحقول
`readOnly`	`boolean` ما إذا كان محتوى الملف للقراءة فقط إذا كان الملف للقراءة فقط، قد لا تتم إضافة نسخة جديدة منه، وقد لا تتم إضافة تعليقات أو تعديلها، وقد لا تتم تعديل عنوان الملف.
`reason`	`string` سبب حظر محتوى الملف لا يمكن تغيير هذه القيمة إلا في الطلبات التي تم ضبط `readOnly=true` فيها أيضًا.
`type`	`string` النتائج فقط. نوع تقييد المحتوى القيمة الوحيدة الممكنة حاليًا هي `globalContentRestriction`.
`restrictingUser`	`object (User)` النتائج فقط. المستخدم الذي ضبط القيود المفروضة على المحتوى لا تتم تعبئة هذا الحقل إلا إذا كانت قيمة `readOnly` صحيحة.
`restrictionTime`	`string` النتائج فقط. الوقت الذي تم فيه فرض قيود على المحتوى (طابع زمني بتنسيق RFC 3339) لا تتم تعبئة هذا الحقل إلا إذا كانت قيمة `readOnly` صحيحة.
`ownerRestricted`	`boolean` ما إذا كان يمكن للمستخدم مالك الملف فقط تعديل قيود المحتوى أو إزالتها بالنسبة إلى الملفات في مساحات التخزين السحابي المشتركة، يمكن لأي مستخدم لديه إمكانات `organizer` تعديل قيد المحتوى هذا أو إزالته.
`systemRestricted`	`boolean` النتائج فقط. ما إذا كان النظام قد طبّق قيود المحتوى، على سبيل المثال بسبب توقيع إلكتروني لا يمكن للمستخدمين تعديل أو إزالة القيود المفروضة على المحتوى المحظور من النظام.

الطُرق
`copy`	تُنشئ هذه الوظيفة نسخة من ملف وتطبّق أي تعديلات مطلوبة باستخدام دلالات التصحيح.
`create`	لإنشاء ملف جديد.
`delete`	يؤدي هذا الإجراء إلى حذف ملف يملكه المستخدم نهائيًا بدون نقله إلى المهملات.
`download`	تنزيل محتوى ملف
`emptyTrash`	يؤدي هذا الإجراء إلى حذف جميع ملفات المستخدم في المهملات نهائيًا.
`export`	تصدير مستند Google Workspace إلى نوع MIME المطلوب وعرض محتوى البايتات المُصدَّر
`generateIds`	تُنشئ مجموعة من أرقام تعريف الملفات التي يمكن تقديمها في طلبات الإنشاء أو النسخ.
`get`	الحصول على البيانات الوصفية أو المحتوى الخاص بالملف باستخدام رقم التعريف
`list`	يعرض ملفات المستخدم.
`listLabels`	يعرض التصنيفات في ملف.
`modifyLabels`	لتعديل مجموعة التصنيفات المطبَّقة على ملف
`update`	تعديل البيانات الوصفية و/أو محتوى الملف
`watch`	الاشتراك في التغييرات التي تطرأ على ملف

REST Resource: files

المرجع: ملف

ContentRestriction

الطُرق

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`