REST Resource: files

المرجع: ملف

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

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

تمثيل 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

النتائج فقط. نوع الملف. دائمًا ما تكون drive#file.

userPermission

object (Permission)

النتائج فقط. الأذونات الخاصة بالمستخدم الذي تمت مصادقته في هذا الملف.

fileExtension

string

النتائج فقط. المكوّن النهائي من fullFileExtension مع نص لاحق لا يبدو أنه جزء من الإضافة التي تمت إزالتها. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

md5Checksum

string

النتائج فقط. مجموع اختباري MD5 لمحتوى هذا الملف. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

ownerNames[]

string

النتائج فقط. أسماء مالكي هذا الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

lastModifyingUserName

string

النتائج فقط. اسم المستخدم الأخير الذي عدّل هذا الملف

editable
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام capabilities/canEdit بدلاً منها.

writersCanShare

boolean

يمكنك اختيار ما إذا كان بإمكان الكتاب مشاركة المستند مع مستخدمين آخرين. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

downloadUrl

string

النتائج فقط. عنوان URL قصير الأجل لتنزيل الملف. ولا تتم تعبئة هذا الحقل إلا للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته لملفات "مستندات Google" أو ملفات الاختصارات.

mimeType

string

تمثّل هذه السمة النوع MIME للملف. ولا يمكن تغيير هذا الإعداد إلا عند التحديث عند تحميل محتوى جديد. يمكن ترك هذا الحقل فارغًا، وسيتم تحديد mimetype من نوع MIME للمحتوى الذي تم تحميله.

driveId

string

النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة التي يتوفّر فيها الملف تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

parents[]

object (ParentReference)

مجموعة من المجلدات الرئيسية التي تحتوي على هذا الملف

إذا لم يتم تحديد الملف كجزء من طلب الإدراج، سيتم وضع الملف مباشرةً في مجلد "ملفاتي" لدى المستخدم. في حال عدم تحديد هذه السياسة كجزء من طلب نسخ، سيكتسب الملف أي عناصر رئيسية قابلة للاكتشاف من ملف المصدر. ويمكن أن تستخدم طلبات files.update أيضًا المعلمتَين addParents وremoveParents لتعديل قائمة العناصر الرئيسية.

appDataContents

boolean

النتائج فقط. ما إذا كان هذا الملف في مجلد Application Data (بيانات التطبيق).

shared

boolean

النتائج فقط. ما إذا تمت مشاركة الملف أم لا. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

lastModifyingUser

object (User)

النتائج فقط. آخر مستخدم يعدِّل هذا الملف.

owners[]

object (User)

النتائج فقط. مالك هذا الملف. يمكن أن يكون لبعض الملفات القديمة فقط أكثر من مالك واحد. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

headRevisionId

string

النتائج فقط. رقم تعريف النسخة السابقة لرأس الملف. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

properties[]

object (Property)

قائمة الخصائص.

copyable
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام capabilities/canCopy بدلاً منها.

etag

string

النتائج فقط. علامة ETag للملف.

sharingUser

object (User)

النتائج فقط. المستخدم الذي شارك العنصر مع المستخدم الحالي، إن توفّر.

fileSize

string (int64 format)

النتائج فقط. الحجم بالبايت من الكائنات الثنائية الكبيرة وملفات محرر الطرف الأول. لن تتم تعبئتها للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.

copyRequiresWriterPermission

boolean

ما إذا كان يجب إيقاف خيارات نسخ هذا الملف أو طباعته أو تنزيله للقرّاء والمعلِّقين

permissions[]

object (Permission)

النتائج فقط. قائمة الأذونات للمستخدمين الذين لديهم الإذن بالوصول إلى هذا الملف. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

hasThumbnail

boolean

النتائج فقط. ما إذا كان لهذا الملف صورة مصغّرة. ولا يشير ذلك إلى ما إذا كان التطبيق الذي قدّم الطلب بإمكانه الوصول إلى الصورة المصغّرة. للتحقق من إمكانية الوصول، ابحث عن وجود الحقل العبارة المصغرة "رابط".

spaces[]

string

النتائج فقط. قائمة المسافات التي تحتوي على الملف والقيمتان المسموح بإدراجهما هما drive وappDataFolder وphotos.

folderColorRgb

string

لون المجلد كسلسلة سداسية عشرية لنموذج نموذج أحمر أخضر أزرق إذا كان الملف مجلدًا أو اختصارًا له. تتوفر قائمة الألوان المتوافقة في الحقل albumColorPalette في المورد "About" (حول). إذا تم تحديد لون غير متوافق، فسيتم تغييره إلى اللون الأقرب في لوحة الألوان.

id

string

رقم تعريف الملف.

title

string

عنوان هذا الملف. بالنسبة إلى العناصر غير القابلة للتغيير، مثل مجلدات المستوى الأعلى لمساحات التخزين السحابي المشتركة والمجلد الجذر في "ملفاتي" ومجلد "بيانات التطبيق"، يكون العنوان ثابتًا.

description

string

اكتب وصفًا موجزًا للملف.

labels

object

مجموعة من التصنيفات للملف.

labels.viewed

boolean

ما إذا كان هذا المستخدم قد عرض هذا الملف.

labels.restricted
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام copyRequiresWriterPermission بدلاً منها.

labels.starred

boolean

ما إذا كان المستخدم قد ميّز هذا الملف بنجمة.

labels.hidden
(deprecated)

boolean

النتائج فقط. تمّ الإيقاف.

labels.trashed

boolean

ما إذا كان قد تم نقل هذا الملف إلى المهملات. ينطبق هذا التصنيف على جميع المستخدمين الذين يصلون إلى الملف، ومع ذلك، يُسمح فقط للمالكين بالاطّلاع على الملفات واستعادتها.

labels.modified

boolean

النتائج فقط. ما إذا كان هذا المستخدم قد عدّل الملف أم لا.

explicitlyTrashed

boolean

النتائج فقط. ما إذا كان قد تم نقل هذا الملف بشكل صريح إلى المهملات، بدلاً من وضعه في المهملات على نحو متكرر.

createdDate

string

النتائج فقط. أنشئ وقتًا لهذا الملف (الطابع الزمني بتنسيق RFC 3339).

modifiedDate

string

آخر مرة تم فيها تعديل هذا الملف من قِبل أي شخص (الطابع الزمني بتنسيق RFC 3339). ولا يمكن تغيير هذا الإعداد إلا عند التعديل عند ضبط المَعلمة setModifiedDate.

modifiedByMeDate

string

النتائج فقط. آخر مرة عدَّل فيها المستخدم هذا الملف (الطابع الزمني بتنسيق RFC 3339). تجدر الإشارة إلى أنّ الإعداد editDate سيؤدي أيضًا إلى تعديل تاريخ updateByMe للمستخدم الذي يضبط التاريخ.

lastViewedByMeDate

string

آخر مرة شاهد فيها المستخدم هذا الملف (الطابع الزمني بتنسيق RFC 3339).

markedViewedByMeDate
(deprecated)

string

النتائج فقط. تمّ الإيقاف.

sharedWithMeDate

string

النتائج فقط. الوقت الذي تمت فيه مشاركة هذا الملف مع المستخدم (الطابع الزمني بتنسيق RFC 3339).

quotaBytesUsed

string (int64 format)

النتائج فقط. عدد وحدات بايت الحصة التي يستخدمها هذا الملف.

version

string (int64 format)

النتائج فقط. رقم إصدار يتزايد بانتظام للملف. يعكس هذا كل تغيير يتم إجراؤه على الملف على الخادم، حتى تلك التغييرات غير المرئية للمستخدم الذي يطلب نقل البيانات.

indexableText

object

سمات النص القابلة للفهرسة للملف (يمكن كتابتها فقط)

indexableText.text

string

النص المطلوب فهرسته لهذا الملف.

originalFilename

string

اسم الملف الأصلي للمحتوى الذي تم تحميله في حال توفّره، أو القيمة الأصلية للحقل title ولا تتوفر هذه الميزة إلا للملفات التي تتضمّن محتوى ثنائيًا في Google Drive.

ownedByMe

boolean

النتائج فقط. ما إذا كان المستخدم الحالي الملف يملكه. لا تتم تعبئة هذا الحقل للعناصر في مساحات التخزين السحابي المشتركة.

canComment
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام capabilities/canComment بدلاً منها.

shareable
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام capabilities/canShare بدلاً منها.

fullFileExtension

string

النتائج فقط. امتداد الملف الكامل؛ مُستخرج من العنوان. قد يحتوي على العديد من الإضافات المتسلسلة، مثل "tar.gz". لا تؤدي إزالة إضافة من العنوان إلى محو هذا الحقل، ولكن تغيير الامتداد في العنوان يؤدي إلى تعديل هذا الحقل. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

isAppAuthorized

boolean

النتائج فقط. ما إذا تم إنشاء الملف أو فتحه من خلال التطبيق الطالب.

teamDriveId
(deprecated)

string

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام driveId بدلاً منها.

capabilities

object

النتائج فقط. الإمكانات التي يمتلكها المستخدم الحالي في هذا الملف. وتتوافق كل ميزة مع إجراء دقيق قد يتخذه المستخدم.

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

النتائج فقط. تمّ الإيقاف.

capabilities.canMoveChildrenOutOfDrive

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي نقل العناصر الثانوية لهذا المجلد خارج مساحة التخزين السحابي المشتركة. يكون هذا خطأ عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

capabilities.canReadDrive

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان المستخدم الحالي يمكنه قراءة مساحة التخزين السحابي المشتركة التي ينتمي إليها هذا الملف. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

capabilities.canEdit

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان يمكن للمستخدم الحالي تعديل هذا الملف. هناك عوامل أخرى قد تحد من نوع التغييرات التي يمكن للمستخدم إجراؤها على الملف. على سبيل المثال، يمكنك الاطّلاع على canChangeCopyRequiresWriterPermission أو canModifyContent.

capabilities.canCopy

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي نسخ هذا الملف بالنسبة إلى عنصر في مساحة تخزين سحابي مشتركة، سواء كان المستخدم الحالي يمكنه نسخ العناصر التابعة لهذا العنصر بدون مجلد، أو هذا العنصر نفسه إذا لم يكن مجلدًا

capabilities.canComment

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي التعليق على هذا الملف.

capabilities.canAddChildren

boolean

النتائج فقط. ما إذا كان المستخدم الحالي يمكنه إضافة عناصر فرعية إلى هذا المجلد. يكون هذا الخطأ دائمًا عندما لا يكون العنصر مجلدًا.

capabilities.canDelete

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي حذف هذا الملف

capabilities.canDownload

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان المستخدم الحالي يمكنه تنزيل هذا الملف.

capabilities.canListChildren

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي إدراج العناصر الثانوية لهذا المجلد أم لا. يكون هذا الخطأ دائمًا عندما لا يكون العنصر مجلدًا.

capabilities.canRemoveChildren

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان بإمكان المستخدم الحالي إزالة الأطفال من هذا المجلد. يكون هذا الخطأ دائمًا عندما لا يكون العنصر مجلدًا. بالنسبة إلى مجلد في مساحة تخزين سحابي مشتركة، استخدِم canDeleteChildren أو canTrashChildren بدلاً من ذلك.

capabilities.canRename

boolean

النتائج فقط. ما إذا كان المستخدم الحالي يمكنه إعادة تسمية هذا الملف.

capabilities.canTrash

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان بإمكان المستخدم الحالي نقل هذا الملف إلى المهملات.

capabilities.canReadRevisions

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي قراءة مورد النُسخ السابقة من هذا الملف. بالنسبة إلى عنصر مساحة التخزين السحابي المشتركة، يمكن قراءة نُسخ من العناصر التابعة لهذا العنصر والتي ليست من المجلدات أو لهذا العنصر نفسه إذا لم يكن مجلدًا.

capabilities.canReadTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canReadDrive بدلاً منها.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveItemWithinDrive أو canMoveItemOutOfDrive بدلاً منها.

capabilities.canChangeCopyRequiresWriterPermission

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان يمكن للمستخدم الحالي تغيير قيد copyRequiresWriterPermission لهذا الملف.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveItemOutOfDrive بدلاً منها.

capabilities.canUntrash

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان بإمكان المستخدم الحالي استعادة هذا الملف من المهملات.

capabilities.canModifyContent

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي تعديل محتوى هذا الملف أم لا.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveItemWithinDrive بدلاً منها.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveItemOutOfDrive بدلاً منها.

capabilities.canDeleteChildren

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي حذف عناصر هذا المجلد الثانوية. يكون هذا خطأ عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveChildrenOutOfDrive بدلاً منها.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام canMoveChildrenWithinDrive بدلاً منها.

capabilities.canTrashChildren

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان يمكن للمستخدم الحالي نقل عناصر هذا المجلد الثانوية إلى المهملات. يكون هذا خطأ عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

capabilities.canMoveItemOutOfDrive

boolean

النتائج فقط. ما إذا كان بإمكان المستخدم الحالي نقل هذا العنصر خارج مساحة التخزين السحابي هذه عن طريق تغيير المجلد الرئيسي. تجدُر الإشارة إلى أنّ طلب تغيير العنصر الرئيسي قد يظل يتعذّر، استنادًا إلى العنصر الرئيسي الجديد الذي تتم إضافته.

capabilities.canAddMyDriveParent

boolean

النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إضافة عنصر رئيسي للعنصر بدون إزالة عنصر رئيسي حالي في الطلب نفسه لا تتم تعبئتها لملفات مساحة التخزين السحابي المشتركة.

capabilities.canRemoveMyDriveParent

boolean

النتائج فقط. ما إذا كان بإمكان المستخدم الحالي إزالة عنصر رئيسي من العنصر بدون إضافة عنصر رئيسي آخر في الطلب نفسه لا تتم تعبئتها لملفات مساحة التخزين السحابي المشتركة.

capabilities.canMoveItemWithinDrive

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي نقل هذا العنصر في مساحة التخزين السحابي هذه يُرجى العلم أنّه قد يتعذّر رغم ذلك طلب تغيير العنصر الرئيسي للعنصر اعتمادًا على العنصر الرئيسي الجديد الذي تتم إضافته والعنصر الرئيسي الذي تتم إزالته.

capabilities.canShare

boolean

النتائج فقط. يوضّح ما إذا كان يمكن للمستخدم الحالي تعديل إعدادات المشاركة لهذا الملف.

capabilities.canMoveChildrenWithinDrive

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي نقل العناصر الثانوية لهذا المجلد في مساحة التخزين السحابي هذه. يكون هذا خطأ عندما لا يكون العنصر مجلدًا. تجدُر الإشارة إلى أنّ طلب نقل الحساب الفرعي قد يستمر بالفشل استنادًا إلى إمكانية وصول المستخدم الحالي إلى الطفل وإلى مجلد الوجهة.

capabilities.canModifyContentRestriction
(deprecated)

boolean

مهملة: النتائج فقط. استخدِم أي من canModifyEditorContentRestriction أو canModifyOwnerContentRestriction أو canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي إضافة مجلد من مساحة تخزين سحابي أخرى (مساحة تخزين سحابي مشتركة مختلفة أو "ملفاتي") إلى هذا المجلد. يكون هذا خطأ عندما لا يكون العنصر مجلدًا. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

capabilities.canChangeSecurityUpdateEnabled

boolean

النتائج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير حقل securityUpdateEnabled في البيانات الوصفية لمشاركة الرابط.

capabilities.canAcceptOwnership

boolean

النتائج فقط. ما إذا كان المستخدم الحالي هو المالك المعلَّق للملف. لا تتم تعبئتها لملفات مساحة التخزين السحابي المشتركة.

capabilities.canReadLabels

boolean

النتائج فقط. ما إذا كان المستخدم الحالي يمكنه قراءة التصنيفات في الملف.

capabilities.canModifyLabels

boolean

النتائج فقط. ما إذا كان يمكن للمستخدم الحالي تعديل التصنيفات في الملف.

capabilities.canModifyEditorContentRestriction

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان يمكن للمستخدم الحالي إضافة أو تعديل قيود المحتوى على الملف المشروط بالمحرِّر.

capabilities.canModifyOwnerContentRestriction

boolean

النتائج فقط. يشير ذلك إلى ما إذا كان بإمكان المستخدم الحالي إضافة أو تعديل قيود المحتوى التي تم فرض قيود عليها من قِبل المالك.

capabilities.canRemoveContentRestriction

boolean

النتائج فقط. ما إذا كان هناك قيود محتوى على الملف يمكن للمستخدم الحالي إزالتها.

hasAugmentedPermissions

boolean

النتائج فقط. ما إذا كانت هناك أذونات على هذا الملف مباشرةً تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

trashingUser

object (User)

النتائج فقط. إذا تم نقل الملف إلى المهملات صراحةً، يعني ذلك المستخدم الذي نقل الملف إلى المهملات. تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

canReadRevisions
(deprecated)

boolean

النتائج فقط. متوقّفة نهائيًا: يمكنك استخدام capabilities/canReadRevisions بدلاً منها.

thumbnailVersion

string (int64 format)

النتائج فقط. نسخة الصورة المصغّرة التي سيتم استخدامها في إبطال صلاحية ذاكرة التخزين المؤقت للصور المصغّرة

trashedDate

string

النتائج فقط. وقت نقل العنصر إلى المهملات (الطابع الزمني بتنسيق RFC 3339) تتم تعبئة هذا الحقل فقط للعناصر في مساحات التخزين السحابي المشتركة.

permissionIds[]

string

إخراج فقط. files.list من معرّفات الأذونات للمستخدمين الذين لديهم إمكانية الوصول إلى هذا الملف.

thumbnail

object

صورة مصغّرة للملف. ولن يتم استخدام هذه الصورة إلّا إذا تعذّر إنشاء صورة مصغّرة عادية.

thumbnail.image

string (bytes format)

وحدات البايت المشفرّة باستخدام Base64 في عنوان URL الخاص بالصورة المصغّرة وينبغي أن يتوافق مع القسم 5 من RFC 4648.

سلسلة بترميز base64.

thumbnail.mimeType

string

تمثّل هذه السمة نوع MIME للصورة المصغّرة.

imageMediaMetadata

object

النتائج فقط. البيانات الوصفية عن وسائط الصور سيتم عرض هذه السمة فقط لأنواع الصور، وسيعتمد محتواها على ما يمكن تحليله من محتوى الصور.

imageMediaMetadata.flashUsed

boolean

النتائج فقط. ما إذا تم استخدام الفلاش لإنشاء الصورة أم لا.

imageMediaMetadata.meteringMode

string

النتائج فقط. تمثّل هذه السمة وضع قياس حصة القراءة المجانية المستخدَم لإنشاء الصورة.

imageMediaMetadata.sensor

string

النتائج فقط. نوع أداة الاستشعار المستخدمة لإنشاء الصورة.

imageMediaMetadata.exposureMode

string

النتائج فقط. وضع التعرض للضوء المستخدَم لإنشاء الصورة.

imageMediaMetadata.colorSpace

string

النتائج فقط. مساحة لون الصورة

imageMediaMetadata.whiteBalance

string

النتائج فقط. وضع توازن اللون الأبيض المُستخدَم لإنشاء الصورة.

imageMediaMetadata.width

integer

النتائج فقط. عرض الصورة بالبكسل.

imageMediaMetadata.height

integer

النتائج فقط. ارتفاع الصورة بالبكسل.

imageMediaMetadata.location

object

النتائج فقط. معلومات الموقع الجغرافي المخزّنة في الصورة

imageMediaMetadata.location.latitude

number

النتائج فقط. خط العرض المخزن في الصورة.

imageMediaMetadata.location.longitude

number

النتائج فقط. خط الطول المحفوظ في الصورة.

imageMediaMetadata.location.altitude

number

النتائج فقط. الارتفاع المخزّنة في الصورة.

imageMediaMetadata.rotation

integer

النتائج فقط. عدد التدوير بمقدار 90 درجة في اتجاه عقارب الساعة والذي يتم تطبيقه من الاتجاه الأصلي للصورة.

imageMediaMetadata.date

string

النتائج فقط. تاريخ ووقت التقاط الصورة (الطابع الزمني لتنسيق EXIF).

imageMediaMetadata.cameraMake

string

النتائج فقط. نوع الكاميرا المستخدمة لإنشاء الصورة.

imageMediaMetadata.cameraModel

string

النتائج فقط. طراز الكاميرا المستخدَمة لإنشاء الصورة.

imageMediaMetadata.exposureTime

number

النتائج فقط. مدة التعرض للضوء بالثواني

imageMediaMetadata.aperture

number

النتائج فقط. فتحة العدسة المُستخدَمة لإنشاء الصورة (f-number).

imageMediaMetadata.focalLength

number

النتائج فقط. البعد البؤري المستخدم لإنشاء الصورة، بالملليمتر.

imageMediaMetadata.isoSpeed

integer

النتائج فقط. سرعة ISO المستخدمة لإنشاء الصورة.

imageMediaMetadata.exposureBias

number

النتائج فقط. انحياز الصورة (قيمة APEX)

imageMediaMetadata.maxApertureValue

number

النتائج فقط. أصغر عدد بؤري للعدسة في البعد البؤري يُستخدم لإنشاء الصورة (قيمة APEX).

imageMediaMetadata.subjectDistance

integer

النتائج فقط. المسافة إلى الشخص الظاهر في الصورة بالمتر

imageMediaMetadata.lens

string

النتائج فقط. العدسة المستخدَمة لإنشاء الصورة

videoMediaMetadata

object

النتائج فقط. البيانات الوصفية عن وسائط الفيديو ولن يتم ذلك إلا لأنواع الفيديوهات.

videoMediaMetadata.width

integer

النتائج فقط. تمثّل هذه السمة عرض الفيديو بالبكسل.

videoMediaMetadata.height

integer

النتائج فقط. تمثّل هذه السمة ارتفاع الفيديو بالبكسل.

videoMediaMetadata.durationMillis

string (int64 format)

النتائج فقط. تشير هذه العلامة إلى مدة الفيديو بالمللي ثانية.

shortcutDetails

object

تفاصيل ملف الاختصار تتم تعبئة هذا الحقل فقط لملفات الاختصارات التي تم ضبط حقل mimeType عليها على application/vnd.google-apps.shortcut.

shortcutDetails.targetId

string

رقم تعريف الملف الذي يشير إليه هذا الاختصار.

shortcutDetails.targetMimeType

string

النتائج فقط. تمثّل هذه السمة نوع MIME للملف الذي يشير إليه هذا الاختصار. قيمة هذا الحقل هي نبذة عن نوع MIME للهدف، ويتم تسجيله عند إنشاء الاختصار.

shortcutDetails.targetResourceKey

string

النتائج فقط. مفتاح ResourceKey للملف الهدف

contentRestrictions[]

object (ContentRestriction)

قيود الوصول إلى محتوى الملف. تتم تعبئة هذا الحقل فقط في حال وجود هذا القيد.

resourceKey

string

النتائج فقط. يجب توفّر مفتاح للوصول إلى العنصر من خلال رابط مشترك.

linkShareMetadata.securityUpdateEligible

boolean

النتائج فقط. ما إذا كان الملف مؤهَّلاً لتحديث الأمان أم لا.

linkShareMetadata.securityUpdateEnabled

boolean

النتائج فقط. ما إذا كان تحديث الأمان مفعَّلاً لهذا الملف أم لا.

labelInfo

object

النتائج فقط. نظرة عامة على التصنيفات في الملف.

labelInfo.labels[]

object (Label)

النتائج فقط. مجموعة التصنيفات في الملف وفقًا لما تطلبه أرقام تعريف التصنيفات في المَعلمة includeLabels. وبشكل تلقائي، لا يتم عرض أي تصنيفات.

sha1Checksum

string

النتائج فقط. المجموع الاختباري لخوارزمية SHA1 المرتبط بهذا الملف، في حال توفّره. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

sha256Checksum

string

النتائج فقط. المجموع الاختباري لخوارزمية SHA256 المرتبط بهذا الملف، في حال توفّره. تتم تعبئة هذا الحقل فقط للملفات التي تتضمّن محتوى مخزَّنًا في Google Drive، ولا تتم تعبئته في "أدوات تحرير المستندات" أو ملفات الاختصارات.

ContentRestriction

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

تمثيل JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean
}
الحقول
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

للاشتراك في التغييرات التي يتم إجراؤها على ملف