REST Resource: files

المورد: ملف
الطُرق

المورد: ملف

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

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

تمثيل JSON

تمثيل JSON
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object (`ParentReference`) } ], "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "properties": [ { object (`Property`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "driveId": string, "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "defaultOpenWithLink": string, "headRevisionId": string, "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "hasThumbnail": boolean, "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, "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 }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean, "clientEncryptionDetails": { object (`ClientEncryptionDetails`) } }

{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "clientEncryptionDetails": {
    object (ClientEncryptionDetails)
  }
}

الحقول
`ownerNames[]`	`string` النتائج فقط. أسماء مالكي هذا الملف لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`exportLinks`	`map (key: string, value: string)` النتائج فقط. روابط لتصدير ملفات "أدوات تحرير مستندات Google" إلى تنسيقات معيّنة عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`object (ParentReference)` رقم تعريف المجلد الرئيسي الذي يحتوي على الملف يمكن أن يكون للملف مجلد رئيسي واحد فقط، ولا يُسمح بتحديد مجلدات رئيسية متعددة. إذا لم يتم تحديد المجلد كجزء من طلب الإدراج، يتم وضع الملف مباشرةً في مجلد "ملفاتي" الخاص بالمستخدم. إذا لم يتم تحديدها كجزء من طلب النسخ، يرث الملف أي عنصر رئيسي يمكن اكتشافه للملف المصدر. يجب أن تستخدم طلبات files.update المَعلمتَين `addParents` و`removeParents` لتعديل قائمة العناصر الرئيسية.
`owners[]`	`object (User)` النتائج فقط. مالك هذا الملف قد يكون لبعض الملفات القديمة أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`openWithLinks`	`map (key: string, value: string)` النتائج فقط. خريطة لمعرّف كل تطبيق من تطبيقات المستخدم إلى رابط لفتح هذا الملف باستخدام هذا التطبيق، ولا تتم تعبئتها إلا عند استخدام نطاق drive.apps.readonly. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`properties[]`	`object (Property)` قائمة المواقع
`permissions[]`	`object (Permission)` النتائج فقط. قائمة الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى هذا الملف لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`spaces[]`	`string` النتائج فقط. قائمة المساحات التي يحتوي الملف عليها. القيمتان المسموح بإدراجهما هما `drive` و`appDataFolder` و`photos`.
`permissionIds[]`	`string` إخراج فقط. files.list of permission IDs for users with access to this file.
`contentRestrictions[]`	`object (ContentRestriction)` القيود المفروضة على الوصول إلى محتوى الملف تتم تعبئة هذا الحقل فقط في حال توفّر مثل هذا القيد.
`kind`	`string` النتائج فقط. تمثّل هذه السمة نوع الملف. يكون هذا الخيار `drive#file` دائمًا.
`userPermission`	`object (Permission)` النتائج فقط. أذونات المستخدم الذي تمت مصادقته على هذا الملف
`fileExtension`	`string` النتائج فقط. المكوّن الأخير من `fullFileExtension` مع النص اللاحق الذي لا يبدو أنّه جزء من الامتداد الذي تمت إزالته. لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
`md5Checksum`	`string` النتائج فقط. المجموع الاختباري MD5 لمحتوى هذا الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
`selfLink`	`string` النتائج فقط. رابط يؤدي إلى هذا الملف
`lastModifyingUserName`	`string` النتائج فقط. اسم آخر مستخدم عدّل هذا الملف.
`editable (deprecated)`	`boolean` تم إيقاف هذا العنصر نهائيًا. النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة `capabilities/canEdit` بدلاً منها.
`writersCanShare`	`boolean` تحديد ما إذا كان بإمكان الكتّاب مشاركة المستند مع مستخدمين آخرين لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`downloadUrl`	`string` النتائج فقط. عنوان URL قصير الأمد لتنزيل الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لمستندات Google أو ملفات الاختصارات.
`mimeType`	`string` نوع MIME للملف يمكن تعديل هذا الحقل فقط عند تحميل محتوى جديد. يمكن ترك هذا الحقل فارغًا، وسيتم تحديد نوع MIME من نوع MIME للمحتوى الذي تم تحميله.
`driveId`	`string` النتائج فقط. معرّف مساحة التخزين السحابي المشتركة التي يقيم فيها الملف لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة.
`thumbnailLink`	`string` النتائج فقط. تمثّل هذه السمة رابطًا قصير الأمد إلى الصورة المصغّرة للملف، إذا كانت متاحة. وعادةً ما يستمر هذا الإجراء لعدة ساعات. لا يُنصح باستخدامه مباشرةً في تطبيقات الويب بسبب مشاركة المراجع مع نطاقات خارجية (CORS)، لذا يُنصح باستخدام خادم وكيل. لا تتم تعبئة هذا الحقل إلا عندما يمكن للتطبيق الذي يطلب الوصول إلى الملف الوصول إلى محتواه. إذا لم تتم مشاركة الملف بشكل علني، يجب استرداد عنوان URL الذي تم عرضه في `Files.thumbnailLink` باستخدام طلب يتضمّن بيانات اعتماد.
`appDataContents`	`boolean` النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الملف في مجلد "بيانات التطبيق".
`webViewLink`	`string` النتائج فقط. رابط متاح فقط في المجلدات العامة لعرض مواد عرض الويب الثابتة (HTML وCSS وJS وما إلى ذلك) من خلال ميزة "استضافة المواقع الإلكترونية" في Google Drive
`iconLink`	`string` النتائج فقط. رابط يؤدي إلى رمز الملف
`shared`	`boolean` النتائج فقط. تُستخدَم لتحديد ما إذا تمت مشاركة الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.
`lastModifyingUser`	`object (User)` النتائج فقط. المستخدم الذي عدّل هذا الملف آخر مرة لا تتم تعبئة هذا الحقل إلا عندما يجري مستخدم مسجّل الدخول آخر تعديل.
`defaultOpenWithLink`	`string` النتائج فقط. رابط لفتح هذا الملف باستخدام التطبيق التلقائي للمستخدم لهذا الملف لا تتم تعبئته إلا عند استخدام نطاق drive.apps.readonly.
`headRevisionId`	`string` النتائج فقط. رقم تعريف أحدث نسخة من الملف لا تتم تعبئة هذا الحقل إلا للملفات التي يتم تخزين محتواها في Google Drive، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
`copyable (deprecated)`	`boolean` تم إيقاف هذا العنصر نهائيًا. النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة `capabilities/canCopy` بدلاً منها.
`etag`	`string` النتائج فقط. تمثّل هذه السمة علامة ETag للملف.
`sharingUser`	`object (User)` النتائج فقط. المستخدم الذي شارك العنصر مع المستخدم الحالي، إذا كان متاحًا
`alternateLink`	`string` النتائج فقط. رابط لفتح الملف في أداة تعديل أو عارض من Google ذات الصلة
`embedLink`	`string` النتائج فقط. رابط لتضمين الملف
`webContentLink`	`string` النتائج فقط. رابط لتنزيل محتوى الملف في متصفّح باستخدام مصادقة تستند إلى ملف تعريف الارتباط في الحالات التي تتم فيها مشاركة المحتوى بشكل علني، يمكن تنزيله بدون أي بيانات اعتماد.
`fileSize`	`string (int64 format)` النتائج فقط. الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" وملفات أدوات التحرير التابعة للطرف الأول لن يتم ملء هذا الحقل للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
`copyRequiresWriterPermission`	`boolean` تحديد ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقراء والمعلّقين
`hasThumbnail`	`boolean` النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الملف يتضمّن صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي يطلب الوصول لديه إذن بالوصول إلى الصورة المصغّرة. للتحقّق من إمكانية الوصول، ابحث عن الحقل thumbnailLink.
`folderColorRgb`	`string` لون المجلد كسلسلة سداسية عشرية من النموذج اللوني أحمر أخضر أزرق إذا كان الملف مجلدًا أو اختصارًا لمجلد تتوفّر قائمة الألوان المتوافقة في الحقل 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، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
`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). لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة.
`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` النتائج فقط. تشير هذه السمة إلى فتحة العدسة المستخدَمة لإنشاء الصورة (الرقم البؤري).
`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 للملف المستهدَف.
`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، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
`inheritedPermissionsDisabled`	`boolean` تُستخدَم لتحديد ما إذا كانت أذونات الوصول المكتسَبة غير مفعَّلة لهذا الملف. تكون الأذونات المكتسَبة مفعّلة تلقائيًا.
`clientEncryptionDetails`	`object (ClientEncryptionDetails)` تفاصيل ذات صلة بميزة "التشفير من جهة العميل" يحتوي على تفاصيل حول حالة تشفير الملف وتفاصيل بشأن آلية التشفير التي يجب أن تستخدمها البرامج عند فك تشفير محتوى هذا العنصر. سيظهر هذا الرمز على الملفات فقط وليس على المجلدات أو الاختصارات.

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` النتائج فقط. تُستخدَم لتحديد ما إذا كان النظام قد فرض قيودًا على المحتوى، مثلاً بسبب توفّر توقيع إلكتروني. لا يمكن للمستخدمين تعديل قيود المحتوى المحظور من النظام أو إزالتها.

ClientEncryptionDetails

تفاصيل حول التشفير من جهة العميل المطبَّق على الملف

تمثيل JSON
{ "encryptionState": string, "decryptionMetadata": { object (`DecryptionMetadata`) } }

الحقول

الحقول
`encryptionState`	`string` حالة تشفير الملف القيم المتوقّعة هنا هي: `encrypted` `unencrypted`
`decryptionMetadata`	`object (DecryptionMetadata)` البيانات الوصفية المستخدَمة في العمليات من جهة العميل

encryptionState

string

حالة تشفير الملف القيم المتوقّعة هنا هي:

encrypted
unencrypted

decryptionMetadata

object (DecryptionMetadata)

البيانات الوصفية المستخدَمة في العمليات من جهة العميل

DecryptionMetadata

تمثيل لـ DecryptionMetadata في ميزة "التشفير من جهة العميل"

تمثيل JSON
{ "wrappedKey": string, "kaclsId": string, "kaclsName": string, "aes256GcmChunkSize": string, "jwt": string, "keyFormat": string, "encryptionResourceKeyHash": string }

الحقول
`wrappedKey`	`string` المفتاح المغلّف المرمّز باستخدام Base64 الآمن لعناوين URL والمستخدَم لتشفير محتوى الملف
`kaclsId`	`string (int64 format)` معرّف خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير (KACLS) المستخدَمة لتشفير الملف.
`kaclsName`	`string` اسم خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير (KACLS) المستخدَمة لتشفير الملف.
`aes256GcmChunkSize`	`string` حجم الأجزاء المستخدَم إذا تم تشفير المحتوى باستخدام معيار التشفير المتقدّم AES 256 GCM. القيم المحتملة هي: `default` `small`
`jwt`	`string` رمز JSON المميّز للويب (JWT) الموقّع الذي يمكن استخدامه لتفويض المستخدم الذي يقدّم الطلب من خلال خدمة Key ACL Service (KACLS). تؤكّد رمز JWT المميز أنّ المستخدم الذي يطلب الوصول لديه إذن بالاطّلاع على الملف على الأقل.
`keyFormat`	`string` تنسيق المفتاح غير المشفَّر يجب أن تكون `tinkAesGcmKey`.
`encryptionResourceKeyHash`	`string` تجزئة HMAC-SHA256 لبيانات وصف المورد المرمّزة بـ Base64 والمتوافقة مع عناوين URL مع مفتاح تشفير البيانات (DEK)، يُرجى الاطّلاع على https://developers.google.com/workspace/cse/reference

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

REST Resource: files

المورد: ملف

ContentRestriction

ClientEncryptionDetails

DecryptionMetadata

الطُرق

`copy`

`delete`

`emptyTrash`

`export`

`generateCseToken`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`

REST Resource: files تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

المورد: ملف

ContentRestriction

ClientEncryptionDetails

DecryptionMetadata

الطُرق

REST Resource: files