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

REST Resource: files

المرجع: ملف
- تمثيل JSON
  - تمثيل JSON
- قيود المحتوى
  - تمثيل 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، ولا تتم تعبئته لمحرّري "مستندات 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 للملف. وهذا قابل للتغيير فقط عند تحميل محتوى جديد. يمكن ترك هذا الحقل فارغًا، وسيتم تحديد نوع mime من نوع MIME للمحتوى الذي تم تحميله.
`exportLinks`	`map (key: string, value: string)` الإخراج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات محدّدة عنصر يحتوي على قائمة بأزواج من `"key": value`. مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`driveId`	`string` الإخراج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف. تتم تعبئة هذا الإعداد فقط للعناصر في مساحات التخزين السحابي المشتركة.
`parents[]`	`object (ParentReference)` مجموعة من المجلدات الرئيسية التي تحتوي على هذا الملف. إذا لم يتم تحديد الملف كجزء من طلب الإدراج، سيتم وضع الملف مباشرةً في مجلد "ملفاتي" للمستخدم. إذا لم يتم تحديد الملف كجزء من طلب نسخ، سيكتسب الملف أي عناصر رئيسية قابلة للاكتشاف للملف المصدر. يمكن أيضًا أن تستخدم طلبات تعديل المَعلمتَين `addParents` و`removeParents` لتعديل قائمة الوالدَين.
`thumbnailLink`	`string` الإخراج فقط. رابط قصير الأجل إلى الصورة المصغَّرة للملف، إذا كان متاحًا. ويدوم ذلك عادةً بترتيب الساعات. وتتم تعبئته فقط عندما يتمكن التطبيق الذي يقدّم الطلب من الوصول إلى محتوى الملف. في حال عدم مشاركة الملف بشكل علني، يجب جلب عنوان 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)` الإخراج فقط. الحجم بالبايت (blobs) وملفات محرر الطرف الأول لن تتم تعبئة البيانات للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
`copyRequiresWriterPermission`	`boolean` لتحديد ما إذا كانت خيارات نسخ هذا الملف أو طباعته أو تنزيله غير مفعَّلة للقرّاء والمعلِّقين.
`permissions[]`	`object (Permission)` الإخراج فقط. قائمة الأذونات للمستخدمين الذين لديهم الإذن بالوصول إلى هذا الملف. لا تتم تعبئتها للعناصر في مساحات التخزين السحابي المشتركة
`hasThumbnail`	`boolean` الإخراج فقط. ما إذا كان هذا الملف يتضمّن صورة مصغّرة ولا تشير هذه القيمة إلى ما إذا كان بإمكان التطبيق الذي يقدّم الطلب الوصول إلى الصورة المصغّرة. للتحقّق من إمكانية الوصول، ابحث عن توفّر حقل imageLink.
`spaces[]`	`string` الإخراج فقط. قائمة المساحات التي تحتوي على الملف. والقيمتان المسموح بإدراجهما هما `drive` و`appDataFolder` و`photos`.
`folderColorRgb`	`string` لون المجلد كسلسلة سداسية عشرية على شكل RGB إذا كان الملف مجلدًا أو اختصارًا لمجلد تتوفر قائمة الألوان المتوافقة في حقل folderColorPalette في المورد "لمحة". إذا تم تحديد لون غير متوافق، سيتم تغييره إلى أقرب لون في لوحة الألوان.
`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 سيؤدي أيضًا إلى تعديل تاريخ dateByMe للمستخدم الذي يحدد التاريخ.
`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` الإخراج فقط. ما إذا كان هناك قيود على المحتوى يمكن أن يزيله المستخدم الحالي
`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` الإخراج فقط. أصغر عدد من العدسة للبعد البؤري الذي يتم استخدامه لإنشاء الصورة (قيمة APEX).
`imageMediaMetadata.subjectDistance`	`integer` الإخراج فقط. المسافة التي تفصل عن العنصر الأساسي في الصورة بالمتر
`imageMediaMetadata.lens`	`string` الإخراج فقط. العدسة المستخدَمة لإنشاء الصورة.
`videoMediaMetadata`	`object` الإخراج فقط. البيانات الوصفية حول وسائط الفيديو ستتوفّر هذه الميزة لأنواع الفيديوهات فقط.
`videoMediaMetadata.width`	`integer` الإخراج فقط. عرض الفيديو بالبكسل
`videoMediaMetadata.height`	`integer` الإخراج فقط. تمثّل هذه السمة ارتفاع الفيديو بالبكسل.
`videoMediaMetadata.durationMillis`	`string (int64 format)` الإخراج فقط. تشير هذه العلامة إلى مدة الفيديو بالملي ثانية.
`shortcutDetails`	`object` تفاصيل ملف الاختصار تتم تعبئة هذا الحقل فقط لملفات الاختصارات التي يتم ضبط حقل mimeType على `application/vnd.google-apps.shortcut` فيها.
`shortcutDetails.targetId`	`string` رقم تعريف الملف الذي يشير إليه هذا الاختصار.
`shortcutDetails.targetMimeType`	`string` الإخراج فقط. نوع MIME للملف الذي يشير إليه هذا الاختصار. قيمة هذا الحقل هي نبذة عن نوع MIME المستهدف، ويتم التقاطه عند إنشاء الاختصار.
`shortcutDetails.targetResourceKey`	`string` الإخراج فقط. مفتاح ResourceKey للملف المستهدف.
`contentRestrictions[]`	`object (ContentRestriction)` القيود المفروضة على الوصول إلى محتوى الملف. لا تتم تعبئته إلا في حال توفّر هذا القيد.
`resourceKey`	`string` الإخراج فقط. مفتاح مطلوب للوصول إلى العنصر من خلال رابط مشترك.
`linkShareMetadata`	`object` الإخراج فقط. التفاصيل ذات الصلة بـ LinkShare يحتوي على تفاصيل حول عناوين URL للروابط التي يستخدمها العملاء للإشارة إلى هذا العنصر.
`linkShareMetadata.securityUpdateEligible`	`boolean` الإخراج فقط. ما إذا كان الملف مؤهَّلاً لتحديث الأمان.
`linkShareMetadata.securityUpdateEnabled`	`boolean` الإخراج فقط. ما إذا تم تفعيل تحديث الأمان لهذا الملف.
`labelInfo`	`object` الإخراج فقط. نظرة عامة على التصنيفات في الملف.
`labelInfo.labels[]`	`object (Label)` الإخراج فقط. مجموعة التصنيفات في الملف وفقًا لطلب أرقام تعريف التصنيفات في المعلمة `includeLabels`. ولا يتم عرض أي تصنيفات تلقائيًا.
`sha1Checksum`	`string` الإخراج فقط. المجموع الاختباري لشهادة SHA1 المرتبطة بهذا الملف، في حال توفّره. وتتم تعبئة هذا الحقل فقط للملفات التي تتضمن محتوى مُخزَّنًا في Google Drive، ولا تتم تعبئته لمحرّري "مستندات Google" أو ملفات الاختصارات.
`sha256Checksum`	`string` الإخراج فقط. المجموع الاختباري SHA256 المرتبط بهذا الملف، في حال توفّره. وتتم تعبئة هذا الحقل فقط للملفات التي تتضمن محتوى مُخزَّنًا في Google Drive، ولا تتم تعبئته لمحرّري "مستندات Google" أو ملفات الاختصارات.

قيود المحتوى

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

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

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

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

REST Resource: files

المورد: ملف

قيود المحتوى

الطُرق

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`