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

REST Resource: files

المرجع: ملف
- تمثيل JSON
  - تمثيل JSON
  - تمثيل JSON
- قيود المحتوى
  - تمثيل 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 }, "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 }

{
  "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
  },
  "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
}

الحقول
`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 آمنة (عنوان RFC 4648)، وفقًا للقسم 5. سلسلة Base64 مرمّزة.
`contentHints.thumbnail.mimeType`	`string` نوع MIME للصورة المصغّرة.
`writersCanShare`	`boolean` يوضّح هذا الإعداد ما إذا كان يمكن للمستخدمين الذين لديهم الإذن `writer` فقط تعديل أذونات الملف. لا تتم تعبئتها للعناصر في مساحات التخزين السحابي المشتركة
`viewedByMe`	`boolean` الإخراج فقط. يشير ذلك إلى ما إذا كان هذا المستخدم قد اطّلع على الملف.
`mimeType`	`string` نوع MIME للملف. يحاول Google Drive اكتشاف قيمة مناسبة تلقائيًا من المحتوى الذي تم تحميله، في حال عدم تقديم قيمة. لا يمكن تغيير القيمة ما لم يتم تحميل نسخة جديدة. في حال إنشاء ملف باستخدام نوع "مستند Google" MIME، يتم استيراد المحتوى الذي تم تحميله، إن أمكن. يتم نشر تنسيقات الاستيراد المتوافقة في المورد "لمحة".
`exportLinks`	`map (key: string, value: string)` الإخراج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات محدّدة عنصر يحتوي على قائمة بأزواج من `"key": value`. مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` أرقام تعريف المجلدات الرئيسية التي تحتوي على الملف إذا لم يتم تحديد الملف كجزء من طلب إنشاء، سيتم وضع الملف مباشرةً في مجلد "ملفاتي" للمستخدم. إذا لم يتم تحديد الملف كجزء من طلب نسخ، سيكتسب الملف أي عناصر رئيسية قابلة للاكتشاف للملف المصدر. يجب أن تستخدم ملفات update.المَعلمتَين `addParents` و`removeParents` لتعديل قائمة الوالدَين.
`thumbnailLink`	`string` الإخراج فقط. رابط قصير الأجل إلى الصورة المصغَّرة للملف، إذا كان متاحًا. ويدوم ذلك عادةً بترتيب الساعات. وتتم تعبئته فقط عندما يتمكن التطبيق الذي يقدّم الطلب من الوصول إلى محتوى الملف. في حال عدم مشاركة الملف بشكل علني، يجب جلب عنوان 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)` الإخراج فقط. الحجم بالبايت (blobs) وملفات محرر الطرف الأول لن تتم تعبئة البيانات للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
`viewersCanCopyContent (deprecated)`	`boolean` تم إيقاف هذا العنصر نهائيًا. تم الإيقاف: استخدِم `copyRequiresWriterPermission` بدلاً من ذلك.
`permissions[]`	`object (Permission)` الإخراج فقط. القائمة الكاملة للأذونات للملف. يتوفّر هذا الخيار فقط إذا كان بإمكان المستخدم الذي قدّم الطلب مشاركة الملف. لا تتم تعبئتها للعناصر في مساحات التخزين السحابي المشتركة
`hasThumbnail`	`boolean` الإخراج فقط. ما إذا كان هذا الملف يتضمّن صورة مصغّرة ولا تشير هذه القيمة إلى ما إذا كان بإمكان التطبيق الذي يقدّم الطلب الوصول إلى الصورة المصغّرة. للتحقّق من إمكانية الوصول، ابحث عن توفّر حقل imageLink.
`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` الإخراج فقط. ما إذا كان هناك قيود على المحتوى يمكن أن يزيله المستخدم الحالي
`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` الإخراج فقط. أصغر عدد من العدسة للبعد البؤري الذي يتم استخدامه لإنشاء الصورة (قيمة 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` فيها.
`shortcutDetails.targetId`	`string` رقم تعريف الملف الذي يشير إليه هذا الاختصار.
`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" أو ملفات الاختصارات.

قيود المحتوى

حصر إمكانية الوصول إلى محتوى الملف.

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

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

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

REST Resource: files

المورد: ملف

قيود المحتوى

الطُرق

`copy`

`create`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`