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

REST Resource: files

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

المرجع: ملف

البيانات الوصفية لملف.

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

تمثيل JSON

تمثيل JSON
{ "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "ownerNames": [ string ], "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "exportLinks": { string: string, ... }, "driveId": string, "parents": [ { object (`ParentReference`) } ], "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "defaultOpenWithLink": string, "headRevisionId": string, "properties": [ { object (`Property`) } ], "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "title": string, "description": string, "labels": { "viewed": boolean, "restricted": boolean, "starred": boolean, "hidden": boolean, "trashed": boolean, "modified": boolean }, "explicitlyTrashed": boolean, "createdDate": string, "modifiedDate": string, "modifiedByMeDate": string, "lastViewedByMeDate": string, "markedViewedByMeDate": string, "sharedWithMeDate": string, "quotaBytesUsed": string, "version": string, "indexableText": { "text": string }, "originalFilename": string, "ownedByMe": boolean, "canComment": boolean, "shareable": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeRestrictedDownload": 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`) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": string, "permissionIds": [ string ], "thumbnail": { "image": string, "mimeType": 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, "date": 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,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": 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)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": 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`.
`userPermission`	`object (Permission)` النتائج فقط. الأذونات الخاصة بالمستخدم الذي تمت مصادقته في هذا الملف.
`fileExtension`	`string` النتائج فقط. المكوّن النهائي من `fullFileExtension` مع نص لاحق لا يبدو أنه جزء من الإضافة التي تمت إزالتها. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`md5Checksum`	`string` النتائج فقط. مجموع اختباري MD5 لمحتوى هذا الملف. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`selfLink`	`string` النتائج فقط. رابط للرجوع إلى هذا الملف.
`ownerNames[]`	`string` النتائج فقط. أسماء مالكي هذا الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`lastModifyingUserName`	`string` النتائج فقط. اسم المستخدم الأخير الذي عدّل هذا الملف
`editable (deprecated)`	`boolean` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `capabilities/canEdit` بدلاً منها.
`writersCanShare`	`boolean` يمكنك اختيار ما إذا كان بإمكان الكتاب مشاركة المستند مع مستخدمين آخرين. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`downloadUrl`	`string` النتائج فقط. عنوان URL قصير الأجل لتنزيل الملف. ولا تتم تعبئة هذا الحقل إلا للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته لملفات "مستندات Google" أو ملفات الاختصارات.
`mimeType`	`string` تمثّل هذه السمة النوع MIME للملف. ولا يمكن تغيير هذا الإعداد إلا عند التحديث عند تحميل محتوى جديد. يمكن ترك هذا الحقل فارغًا، وسيتم تحديد mimetype من نوع MIME للمحتوى الذي تم تحميله.
`exportLinks`	`map (key: string, value: string)` النتائج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات محدَّدة عنصر يحتوي على قائمة من أزواج `"key": value`. مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`driveId`	`string` النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.
`parents[]`	`object (ParentReference)` مجموعة من المجلدات الرئيسية التي تحتوي على هذا الملف إذا لم يتم تحديد الملف كجزء من طلب الإدراج، سيتم وضع الملف مباشرةً في مجلد "ملفاتي" لدى المستخدم. في حال عدم تحديد هذه السياسة كجزء من طلب نسخ، سيكتسب الملف أي عناصر رئيسية قابلة للاكتشاف من ملف المصدر. ويمكن أن تستخدم طلبات files.update أيضًا المعلمتَين `addParents` و`removeParents` لتعديل قائمة العناصر الرئيسية.
`thumbnailLink`	`string` النتائج فقط. رابط قصير الأجل يؤدي إلى الصورة المصغّرة للملف، إذا كان متاحًا. تدوم عادةً حسب ترتيب الساعات. تتم تعبئة هذا الحقل فقط عندما يتمكّن التطبيق المطلوب من الوصول إلى محتوى الملف. إذا لم تتم مشاركة الملف بشكل علني، يجب جلب عنوان URL الذي يتم عرضه في `Files.thumbnailLink` باستخدام طلب بيانات اعتماد.
`appDataContents`	`boolean` النتائج فقط. ما إذا كان هذا الملف في مجلد Application Data (بيانات التطبيق).
`webViewLink`	`string` النتائج فقط. رابط متاح فقط في المجلدات العامة لعرض مواد العرض الثابتة على الويب (HTML وCSS وJS وما إلى ذلك) عبر استضافة المواقع الإلكترونية في Google Drive.
`iconLink`	`string` النتائج فقط. رابط إلى رمز الملف.
`shared`	`boolean` النتائج فقط. ما إذا تمت مشاركة الملف أم لا. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`lastModifyingUser`	`object (User)` النتائج فقط. آخر مستخدم يعدِّل هذا الملف.
`owners[]`	`object (User)` النتائج فقط. مالك هذا الملف. يمكن أن يكون لبعض الملفات القديمة فقط أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`openWithLinks`	`map (key: string, value: string)` النتائج فقط. خريطة لرقم تعريف كل تطبيق من تطبيقات المستخدم إلى رابط لفتح هذا الملف باستخدام هذا التطبيق. ولا تتم تعبئتها إلا عند استخدام النطاق drive.apps.readonly. عنصر يحتوي على قائمة من أزواج `"key": value`. مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`defaultOpenWithLink`	`string` النتائج فقط. رابط لفتح هذا الملف باستخدام التطبيق التلقائي للمستخدم لهذا الملف. لا تتم تعبئتها إلا عند استخدام النطاق drive.apps.readonly.
`headRevisionId`	`string` النتائج فقط. رقم تعريف النسخة السابقة لرأس الملف. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`properties[]`	`object (Property)` قائمة الخصائص.
`copyable (deprecated)`	`boolean` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `capabilities/canCopy` بدلاً منها.
`etag`	`string` النتائج فقط. علامة ETag للملف.
`sharingUser`	`object (User)` النتائج فقط. المستخدم الذي شارك العنصر مع المستخدم الحالي، إن توفّر.
`alternateLink`	`string` النتائج فقط. رابط لفتح الملف في محرر أو عارض ذي صلة من Google.
`embedLink`	`string` النتائج فقط. رابط لتضمين الملف.
`webContentLink`	`string` النتائج فقط. رابط لتنزيل محتوى الملف في متصفح باستخدام مصادقة تستند إلى ملفات تعريف الارتباط. في الحالات التي تتم فيها مشاركة المحتوى بشكل علني، يمكن تنزيله بدون أي بيانات اعتماد.
`fileSize`	`string (int64 format)` النتائج فقط. الحجم بالبايت من الكائنات الثنائية الكبيرة وملفات محرر الطرف الأول. لن تتم تعبئتها للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
`copyRequiresWriterPermission`	`boolean` ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقرّاء والمعلِّقين
`permissions[]`	`object (Permission)` النتائج فقط. قائمة الأذونات للمستخدمين الذين لديهم الإذن بالوصول إلى هذا الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`hasThumbnail`	`boolean` النتائج فقط. ما إذا كان لهذا الملف صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي قدّم الطلب بإمكانه الوصول إلى الصورة المصغّرة. للتحقق من إمكانية الوصول، ابحث عن وجود الحقل العبارة المصغرة "رابط".
`spaces[]`	`string` النتائج فقط. قائمة المسافات التي تحتوي على الملف والقيمتان المسموح بإدراجهما هما `drive` و`appDataFolder` و`photos`.
`folderColorRgb`	`string` لون المجلد كسلسلة سداسية عشرية لنموذج نموذج أحمر أخضر أزرق إذا كان الملف مجلدًا أو اختصارًا له. تتوفر قائمة الألوان المتوافقة في الحقل albumColorPalette في المورد "About" (حول). إذا تم تحديد لون غير متوافق، فسيتم تغييره إلى اللون الأقرب في لوحة الألوان.
`id`	`string` رقم تعريف الملف.
`title`	`string` عنوان هذا الملف. بالنسبة إلى العناصر غير القابلة للتغيير، مثل مجلدات المستوى الأعلى لمساحات التخزين السحابي المشتركة والمجلد الجذر في "ملفاتي" ومجلد "بيانات التطبيق"، يكون العنوان ثابتًا.
`description`	`string` اكتب وصفًا موجزًا للملف.
`labels`	`object` مجموعة من التصنيفات للملف.
`labels.viewed`	`boolean` ما إذا كان هذا المستخدم قد عرض هذا الملف.
`labels.restricted (deprecated)`	`boolean` النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `copyRequiresWriterPermission` بدلاً منها.
`labels.starred`	`boolean` ما إذا كان المستخدم قد ميّز هذا الملف بنجمة.
`labels.hidden (deprecated)`	`boolean` النتائج فقط. تمّ الإيقاف.
`labels.trashed`	`boolean` ما إذا كان قد تم نقل هذا الملف إلى المهملات. ينطبق هذا التصنيف على جميع المستخدمين الذين يصلون إلى الملف، ومع ذلك، يُسمح فقط للمالكين بالاطّلاع على الملفات واستعادتها.
`labels.modified`	`boolean` النتائج فقط. ما إذا كان هذا المستخدم قد عدّل الملف أم لا.
`explicitlyTrashed`	`boolean` النتائج فقط. ما إذا كان قد تم نقل هذا الملف بشكل صريح إلى المهملات، بدلاً من وضعه في المهملات على نحو متكرر.
`createdDate`	`string` النتائج فقط. أنشئ وقتًا لهذا الملف (الطابع الزمني بتنسيق RFC 3339).
`modifiedDate`	`string` آخر مرة تم فيها تعديل هذا الملف من قِبل أي شخص (الطابع الزمني بتنسيق RFC 3339). ولا يمكن تغيير هذا الإعداد إلا عند التعديل عند ضبط المَعلمة setModifiedDate.
`modifiedByMeDate`	`string` النتائج فقط. آخر مرة عدَّل فيها المستخدم هذا الملف (الطابع الزمني بتنسيق RFC 3339). تجدر الإشارة إلى أنّ الإعداد editDate سيؤدي أيضًا إلى تعديل تاريخ updateByMe للمستخدم الذي يضبط التاريخ.
`lastViewedByMeDate`	`string` آخر مرة شاهد فيها المستخدم هذا الملف (الطابع الزمني بتنسيق RFC 3339).
`markedViewedByMeDate (deprecated)`	`string` تم إيقاف هذا العنصر. النتائج فقط. تمّ الإيقاف.
`sharedWithMeDate`	`string` النتائج فقط. الوقت الذي تمت فيه مشاركة هذا الملف مع المستخدم (الطابع الزمني بتنسيق RFC 3339).
`quotaBytesUsed`	`string (int64 format)` النتائج فقط. عدد وحدات بايت الحصة التي يستخدمها هذا الملف.
`version`	`string (int64 format)` النتائج فقط. رقم إصدار يتزايد بانتظام للملف. يعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم الذي يطلب نقل البيانات.
`indexableText`	`object` سمات النص القابلة للفهرسة للملف (يمكن كتابتها فقط)
`indexableText.text`	`string` النص المطلوب فهرسته لهذا الملف.
`originalFilename`	`string` اسم الملف الأصلي للمحتوى الذي تم تحميله في حال توفّره، أو القيمة الأصلية للحقل `title` ولا تتوفر هذه الميزة إلا للملفات التي تتضمّن محتوى ثنائيًا في Google Drive.
`ownedByMe`	`boolean` النتائج فقط. ما إذا كان المستخدم الحالي الملف يملكه. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`canComment (deprecated)`	`boolean` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `capabilities/canComment` بدلاً منها.
`shareable (deprecated)`	`boolean` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `capabilities/canShare` بدلاً منها.
`fullFileExtension`	`string` النتائج فقط. امتداد الملف الكامل؛ مُستخرج من العنوان. قد يحتوي على العديد من الإضافات المتسلسلة، مثل "tar.gz". لا تؤدي إزالة إضافة من العنوان إلى محو هذا الحقل، ولكن تغيير الامتداد في العنوان يؤدي إلى تعديل هذا الحقل. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`isAppAuthorized`	`boolean` النتائج فقط. ما إذا تم إنشاء الملف أو فتحه من خلال التطبيق الطالب.
`teamDriveId (deprecated)`	`string` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `driveId` بدلاً منها.
`capabilities`	`object` النتائج فقط. الإمكانات التي يمتلكها المستخدم الحالي في هذا الملف. وتتوافق كل ميزة مع إجراء دقيق قد يتخذه المستخدم.
`capabilities.canChangeRestrictedDownload (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)` النتائج فقط. إذا تم نقل الملف إلى المهملات صراحةً، يعني ذلك المستخدم الذي نقل الملف إلى المهملات. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.
`canReadRevisions (deprecated)`	`boolean` تم إيقاف هذا العنصر. النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام `capabilities/canReadRevisions` بدلاً منها.
`thumbnailVersion`	`string (int64 format)` النتائج فقط. نسخة الصورة المصغّرة التي سيتم استخدامها في إبطال صلاحية ذاكرة التخزين المؤقت للصور المصغّرة
`trashedDate`	`string` النتائج فقط. وقت نقل العنصر إلى المهملات (الطابع الزمني بتنسيق RFC 3339) تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.
`permissionIds[]`	`string` إخراج فقط. files.list من معرّفات الأذونات للمستخدمين الذين لديهم إمكانية الوصول إلى هذا الملف.
`thumbnail`	`object` صورة مصغّرة للملف. ولن يتم استخدام هذه الصورة إلّا إذا تعذّر إنشاء صورة مصغّرة عادية.
`thumbnail.image`	`string (bytes format)` وحدات البايت المشفرّة باستخدام Base64 في عنوان URL الخاص بالصورة المصغّرة وينبغي أن يتوافق مع القسم 5 من RFC 4648. سلسلة بترميز base64.
`thumbnail.mimeType`	`string` تمثّل هذه السمة نوع MIME للصورة المصغّرة.
`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.date`	`string` النتائج فقط. تاريخ ووقت التقاط الصورة (الطابع الزمني لتنسيق EXIF).
`imageMediaMetadata.cameraMake`	`string` النتائج فقط. نوع الكاميرا المستخدمة لإنشاء الصورة.
`imageMediaMetadata.cameraModel`	`string` النتائج فقط. طراز الكاميرا المستخدَمة لإنشاء الصورة.
`imageMediaMetadata.exposureTime`	`number` النتائج فقط. مدة التعرض للضوء بالثواني
`imageMediaMetadata.aperture`	`number` النتائج فقط. فتحة العدسة المُستخدَمة لإنشاء الصورة (f-number).
`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` النتائج فقط. التفاصيل ذات الصلة بمشاركة الروابط يحتوي على تفاصيل حول عناوين URL للروابط التي يستخدمها العملاء للإشارة إلى هذا العنصر.
`linkShareMetadata.securityUpdateEligible`	`boolean` النتائج فقط. ما إذا كان الملف مؤهَّلاً لتحديث الأمان أم لا.
`linkShareMetadata.securityUpdateEnabled`	`boolean` النتائج فقط. ما إذا كان تحديث الأمان مفعَّلاً لهذا الملف أم لا.
`labelInfo`	`object` النتائج فقط. نظرة عامة على التصنيفات في الملف.
`labelInfo.labels[]`	`object (Label)` النتائج فقط. مجموعة التصنيفات في الملف وفقًا لما تطلبه أرقام تعريف التصنيفات في المَعلمة `includeLabels`. وبشكل تلقائي، لا يتم عرض أي تصنيفات.
`sha1Checksum`	`string` النتائج فقط. المجموع الاختباري لخوارزمية SHA1 المرتبط بهذا الملف، في حال توفّره. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`sha256Checksum`	`string` النتائج فقط. المجموع الاختباري لخوارزمية SHA256 المرتبط بهذا الملف، في حال توفّره. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

ContentRestriction

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

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

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

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

REST Resource: files

المرجع: ملف

ContentRestriction

الطُرق

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`