تمت ترجمة هذه الصفحة بواسطة 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, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": 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, "inheritedPermissionsDisabled": boolean }

{
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}

الحقول
`kind`	`string` النتائج فقط. نوع الملف يكون هذا الخيار دائمًا `drive#file`.
`userPermission`	`object (Permission)` النتائج فقط. أذونات المستخدم الذي تمّت مصادقته على هذا الملف
`fileExtension`	`string` النتائج فقط. المكوّن الأخير من `fullFileExtension` مع إزالة النص الذي يبدو أنّه ليس جزءًا من الإضافة لا يتم ملء هذا الحقل إلا للملفات التي تحتوي على محتوى مخزّن في Google Drive، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`md5Checksum`	`string` النتائج فقط. مجموع اختباري بترميز MD5 لمحتوى هذا الملف لا يتم ملء هذا الحقل إلا للملفات التي تحتوي على محتوى مخزّن في Google Drive، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`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)` النتائج فقط. روابط لتصدير ملفات "أدوات تحرير مستندات Google" إلى تنسيقات محدّدة عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`driveId`	`string` النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة فقط.
`parents[]`	`object (ParentReference)` رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يتضمّن الملف مجلدًا رئيسيًا واحدًا فقط، ولا يمكن تحديد مجلدات رئيسية متعددة. إذا لم يتم تحديده كجزء من طلب إدراج، يتم وضع الملف مباشرةً في مجلد "ملفاتي" الخاص بالمستخدم. إذا لم يتم تحديده كجزء من طلب نسخ، يكتسب الملف أي ملف رئيسي قابل للاكتشاف للملف المصدر. يجب أن تستخدِم طلبات files.update المَعلمتَين `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، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`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` النتائج فقط. ما إذا كان هذا الملف يتضمّن صورة مصغّرة ولا يشير ذلك إلى ما إذا كان التطبيق الذي يطلب الوصول إلى الصورة المصغّرة يملك إذن الوصول إليها. للتحقّق من إمكانية الوصول، ابحث عن حقل thumbnailLink.
`spaces[]`	`string` النتائج فقط. قائمة المساحات التي تحتوي على الملف القيم المسموح بها هي `drive` و`appDataFolder` و`photos`.
`folderColorRgb`	`string` لون المجلد كسلسلة سداسية عشرية لنموذج RGB إذا كان الملف مجلدًا أو اختصارًا لمجلد تتوفّر قائمة الألوان المتوافقة في حقل folderColorPalette ضمن المرجع 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) يُرجى العلم أنّ ضبط modifiedDate سيؤدي أيضًا إلى تعديل تاريخ modifiedByMe للمستخدم الذي ضبط التاريخ.
`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، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`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` النتائج فقط. ما إذا كان هناك قيود على المحتوى في الملف يمكن للمستخدم الحالي إزالتها
`capabilities.canDisableInheritedPermissions`	`boolean` النتائج فقط. ما إذا كان بإمكان المستخدم إيقاف الأذونات المكتسَبة
`capabilities.canEnableInheritedPermissions`	`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)
`imageMediaMetadata.focalLength`	`number` النتائج فقط. البعد البؤري المستخدَم لإنشاء الصورة، بالمليمتر
`imageMediaMetadata.isoSpeed`	`integer` النتائج فقط. سرعة ISO المستخدَمة لإنشاء الصورة.
`imageMediaMetadata.exposureBias`	`number` النتائج فقط. انحراف التعرّض للضوء في الصورة (قيمة APEX).
`imageMediaMetadata.maxApertureValue`	`number` النتائج فقط. أصغر عدد f للعدسة عند البعد البؤري المستخدَم لإنشاء الصورة (قيمة APEX).
`imageMediaMetadata.subjectDistance`	`integer` النتائج فقط. المسافة إلى الهدف المُراد تصويره، بالمتر
`imageMediaMetadata.lens`	`string` النتائج فقط. العدسة المستخدَمة لإنشاء الصورة
`videoMediaMetadata`	`object` النتائج فقط. البيانات الوصفية حول ملف وسائط الفيديو ولن يظهر هذا الخيار إلا لأنواع الفيديوهات.
`videoMediaMetadata.width`	`integer` النتائج فقط. عرض الفيديو بالبكسل
`videoMediaMetadata.height`	`integer` النتائج فقط. ارتفاع الفيديو بالبكسل
`videoMediaMetadata.durationMillis`	`string (int64 format)` النتائج فقط. مدة الفيديو بالملي ثانية
`shortcutDetails`	`object` تفاصيل ملف الاختصار تتم تعبئة هذا الحقل لملفات الاختصارات فقط التي تم ضبط حقل mimeType فيها على `application/vnd.google-apps.shortcut`. لا يمكن ضبطها إلا على `files.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، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`sha256Checksum`	`string` النتائج فقط. المجموع الاختباري SHA256 المرتبط بهذا الملف، إذا كان متاحًا لا يتم ملء هذا الحقل إلا للملفات التي تحتوي على محتوى مخزّن في Google Drive، ولا يتم ملؤه لمحرّري "مستندات Google" أو ملفات الاختصارات.
`inheritedPermissionsDisabled`	`boolean` يشير ذلك إلى ما إذا كانت الأذونات المُكتسَبة لهذا الملف غير مفعّلة. تكون الأذونات المكتسَبة مفعَّلة تلقائيًا.

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`