REST Resource: files

المرجع: ملف

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

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

تمثيل JSON
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": 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)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    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,
    "time": 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"

driveId

string

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

fileExtension

string

النتائج فقط. المكون الأخير لـ fullFileExtension. لا تتوفر هذه الميزة إلا للملفات التي تتضمن محتوى ثنائي في Google Drive.

copyRequiresWriterPermission

boolean

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

md5Checksum

string

النتائج فقط. المجموع الاختباري MD5 لمحتوى الملف. ينطبق هذا فقط على الملفات التي تحتوي على محتوى ثنائي في Google Drive.

contentHints

object

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

contentHints.indexableText

string

النص الذي ستتم فهرسته للملف لتحسين طلبات البحث في النص الكامل. لا يزيد طول هذا الملف عن 128 كيلوبايت وقد يحتوي على عناصر HTML.

contentHints.thumbnail

object

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

contentHints.thumbnail.image

string (bytes format)

بيانات الصورة المصغّرة التي تم ترميزها باستخدام Base64 متوافق مع عنوان URL (الفقرة 5 من معيار RFC 4648).

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

contentHints.thumbnail.mimeType

string

نوع MIME للصورة المصغّرة.

writersCanShare

boolean

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

viewedByMe

boolean

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

mimeType

string

نوع MIME للملف

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

إذا تم إنشاء الملف باستخدام نوع MIME في مستند Google، يتم استيراد المحتوى الذي تم تحميله، إن أمكن. يتم نشر تنسيقات الاستيراد المتوافقة في المورد "لمحة".

parents[]

string

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

يمكن أن يحتوي الملف على مجلد رئيسي واحد فقط؛ لا يمكن تحديد عدة مجموعات رئيسية.

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

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

النتائج فقط. رقم تعريف مراجعة رأس الملف. لا تتوفّر هذه الميزة حاليًا إلا للملفات ذات المحتوى الثنائي في Google Drive.

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

permissions[]

object (Permission)

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

hasThumbnail

boolean

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

spaces[]

string

النتائج فقط. قائمة المساحات التي تحتوي على الملف القيمتان المسموح بهما حاليًا هما "drive" و"appDataمجلد" و"الصور".

folderColorRgb

string

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

في حال تحديد لون غير متوافق، سيتم استخدام أقرب لون في لوحة الألوان بدلاً من ذلك.

id

string

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

name

string

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

description

string

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

starred

boolean

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

trashed

boolean

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

explicitlyTrashed

boolean

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

createdTime

string

وقت إنشاء الملف (التاريخ والوقت لمعيار RFC 3339).

modifiedTime

string

آخر مرة تم فيها تعديل الملف بواسطة أي شخص (RFC 3339 date-time).

تجدر الإشارة إلى أنّ الإعداد modifiedTime يؤدي أيضًا إلى تعديل modifiedByMeTime للمستخدم.

modifiedByMeTime

string

النتائج فقط. آخر مرة عدّل فيها المستخدم الملف (التاريخ والوقت لمعيار RFC 3339).

viewedByMeTime

string

آخر مرة شاهد فيها المستخدم الملف (التاريخ والوقت لمعيار RFC 3339).

sharedWithMeTime

string

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

quotaBytesUsed

string (int64 format)

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

version

string (int64 format)

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

originalFilename

string

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

ownedByMe

boolean

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

fullFileExtension

string

النتائج فقط. امتداد الملف الكامل المستخرج من الحقل name. قد يحتوي على عدة إضافات مجمعة، مثل "tar.gz". لا تتوفر هذه الميزة إلا للملفات التي تتضمن محتوى ثنائي في Google Drive.

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

properties

map (key: string, value: value (Value format))

مجموعة من أزواج المفتاح/القيمة العشوائية التي تكون مرئية لجميع التطبيقات.

يتم محو الإدخالات ذات القيم الفارغة في طلبات التعديل والنسخ.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

appProperties

map (key: string, value: value (Value format))

مجموعة من أزواج المفتاح/القيمة العشوائية الخاصة بالتطبيق الذي قدّم الطلب.

يتم محو الإدخالات ذات القيم الفارغة في طلبات التعديل والنسخ.

لا يمكن استرداد هذه السمات إلّا باستخدام طلب تمت مصادقته. يستخدم الطلب الذي تمت مصادقته رمز دخول تم الحصول عليه من خلال معرِّف عميل OAuth 2. لا يمكنك استخدام مفتاح واجهة برمجة التطبيقات لاسترداد المواقع الخاصة.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(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)

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

thumbnailVersion

string (int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

permissionIds[]

string

النتائج فقط. file.list، بمعرّفات الأذونات، للمستخدمين الذين لديهم الإذن بالوصول إلى هذا الملف.

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.time

string

النتائج فقط. تاريخ ووقت التقاط الصورة (EXIF DateTime).

imageMediaMetadata.cameraMake

string

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

imageMediaMetadata.cameraModel

string

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

imageMediaMetadata.exposureTime

number

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

imageMediaMetadata.aperture

number

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

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

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

imageMediaMetadata.subjectDistance

integer

النتائج فقط. المسافة إلى هدف الصورة، بالأمتار.

imageMediaMetadata.lens

string

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

videoMediaMetadata

object

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

videoMediaMetadata.width

integer

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

videoMediaMetadata.height

integer

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

videoMediaMetadata.durationMillis

string (int64 format)

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

shortcutDetails

object

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

shortcutDetails.targetId

string

رقم تعريف الملف الذي يشير إليه هذا الاختصار. لا يمكن ضبط الإعدادات إلا على طلبات "files.create".

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)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
الحقول
readOnly

boolean

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

reason

string

سبب حظر محتوى الملف يمكن تغيير هذا الخيار فقط في الطلبات التي تم ضبط readOnly=true عليها أيضًا.

type

string

النتائج فقط. نوع قيود المحتوى. القيمة الوحيدة الممكنة في الوقت الحالي هي globalContentRestriction.

restrictingUser

object (User)

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

restrictionTime

string

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

ownerRestricted

boolean

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

systemRestricted

boolean

النتائج فقط. ما إذا كان النظام قد طبّق قيود المحتوى، بسبب توقيع إلكتروني على سبيل المثال. لا يمكن للمستخدمين تعديل قيود المحتوى المفروض عليها قيود النظام أو إزالتها.

الطُرق

copy

ينشئ نسخة من ملف ويطبّق أي تعديلات مطلوبة باستخدام دلالات رمز التصحيح.

create

ينشئ ملفًا جديدًا.

delete

يحذف نهائيًا ملفًا يملكه المستخدم بدون نقله إلى المهملات.

emptyTrash

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

export

تصدِّر مستند Google Workspace إلى نوع MIME المطلوب وتعرض محتوى البايت الذي تم تصديره.

generateIds

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

get

يحصل على البيانات الوصفية للملف أو محتواه حسب رقم التعريف.

list

يسرد ملفات المستخدم.

listLabels

تعرض التصنيفات على ملف.

modifyLabels

لتعديل مجموعة التصنيفات المطبَّقة على ملف.

update

لتعديل البيانات الوصفية للملف و/أو محتواه.

watch

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