تمت ترجمة هذه الصفحة بواسطة 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 للملف يمكن تغيير هذا الخيار عند إجراء تحديث فقط عند تحميل محتوى جديد. ويمكن ترك هذا الحقل فارغًا، وسيتم تحديد نوع MIME من نوع MIME للمحتوى الذي تم تحميله.
`exportLinks`	`map (key: string, value: string)` النتائج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات محدَّدة عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`driveId`	`string` النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.
`parents[]`	`object (ParentReference)` رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يحتوي الملف على مجلد رئيسي واحد فقط؛ لا يمكن تحديد عدة مجموعات رئيسية. إذا لم يتم تحديده كجزء من طلب الإدراج، يتم وضع الملف مباشرةً في مجلد "ملفاتي" للمستخدم. إذا لم يتم تحديد الملف كجزء من طلب النسخ، سيكتسب الملف أي عنصر رئيسي قابل للاكتشاف للملف المصدر. يجب أن تستخدم طلبات التحديث file.المعلمتَين `addParents` و`removeParents` لتعديل قائمة العناصر الرئيسية.
`thumbnailLink`	`string` النتائج فقط. رابط قصير الأجل إلى الصورة المصغّرة للملف، إن توفّر. تستمر هذه المهمة عادةً بترتيب الساعات. هذه الميزة غير مخصصة للاستخدام المباشر على تطبيقات الويب بسبب مشاركة الموارد المتعدّدة المصادر (CORS)، يمكنك استخدام خادم وكيل. لا تتم تعبئة هذا الحقل إلا عندما يتمكّن التطبيق صاحب الطلب من الوصول إلى محتوى الملف. إذا لم تتم مشاركة الملف بشكل علني، يجب استرجاع عنوان URL الذي تم عرضه في `Files.thumbnailLink` باستخدام طلب معتمد.
`appDataContents`	`boolean` النتائج فقط. ما إذا كان هذا الملف في مجلد "بيانات التطبيق".
`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` النتائج فقط. ما إذا كان هذا الملف يحتوي على صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي قدّم التطبيق لديه إذن الوصول إلى الصورة المصغّرة. للتحقق من إمكانية الوصول، ابحث عن الحقل صورة مصغّرةLink.
`spaces[]`	`string` النتائج فقط. قائمة المساحات التي تحتوي على الملف والقيم المسموح بإدراجها هي `drive` و`appDataFolder` و`photos`.
`folderColorRgb`	`string` لون المجلد كسلسلة سداسية عشرية باللون الأحمر والأخضر والأزرق إذا كان الملف مجلدًا أو اختصارًا لمجلد تتوفر قائمة الألوان المتوافقة في الحقل مجلدColorPalette في المورد "لمحة". إذا تم تحديد لون غير متوافق، سيتم تغييره إلى أقرب لون في لوحة الألوان.
`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 سيؤدي أيضًا إلى تعديل تاريخ updatedByMe للمستخدم الذي حدَّد التاريخ.
`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` النتائج فقط. file.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).
`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`. لا يمكن ضبط الإعدادات إلا على طلبات "`files.insert`".
`shortcutDetails.targetId`	`string` رقم تعريف الملف الذي يشير إليه هذا الاختصار. لا يمكن ضبط الإعدادات إلا على طلبات "`files.insert`".
`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. ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.
`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`