REST Resource: files

المورد: ملف

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

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

تمثيل JSON 
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
الحقول
parents[]

string

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

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

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

object (User)

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

object (Permission)

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

string

النتائج فقط. قائمة المساحات التي يحتوي الملف عليها. القيم المتوافقة حاليًا هي drive وappDataFolder وphotos.
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" }
permissionIds[]

string

الناتج فقط. files.list of permission IDs for users with access to this file.
contentRestrictions[]

object (ContentRestriction)

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

string

النتائج فقط. تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#file".
driveId

string

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

string

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

boolean

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

string

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

object

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

string

النص المطلوب فهرسته للملف من أجل تحسين طلبات البحث fullText. يقتصر ذلك على 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، يتم استيراد المحتوى الذي تم تحميله، إذا كان ذلك ممكنًا. يتم نشر تنسيقات الاستيراد المتوافقة في صفحة "حول المورد".
shared

boolean

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

object (User)

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

string

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

object (User)

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

string

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

string (int64 format)

النتائج فقط. الحجم بالبايت لملفات "الملفات الثنائية الكبيرة" وملفات أدوات التحرير التابعة للطرف الأول لن يتم ملء هذا الحقل للملفات التي ليس لها حجم، مثل الاختصارات والمجلدات.
viewersCanCopyContent
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة copyRequiresWriterPermission بدلاً منها.
hasThumbnail

boolean

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

string

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

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

string

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

string

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

string

تمثّل هذه السمة وصفًا موجزًا للملف.
starred

boolean

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

boolean

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

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا تم نقل الملف إلى المهملات بشكل صريح، بدلاً من نقله بشكل متكرّر من مجلد رئيسي.
createdTime

string

الوقت الذي تم فيه إنشاء الملف (تاريخ ووقت بتنسيق RFC 3339).
modifiedTime

string

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

يُرجى العِلم أنّ ضبط modifiedTime يؤدي أيضًا إلى تعديل modifiedByMeTime للمستخدم.
modifiedByMeTime

string

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

string

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

string

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

string (int64 format)

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

string (int64 format)

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

string

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

boolean

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

string

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

يتم تعديل هذا الحقل تلقائيًا عند تغيير حقل name، ولكن لا تتم إزالة القيمة إذا كان الاسم الجديد لا يتضمّن امتدادًا صالحًا.
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

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

boolean

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

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي تنزيل هذا الملف.
capabilities.canListChildren

boolean

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

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي إزالة الأطفال من هذا المجلد. تكون هذه السمة دائمًا false عندما لا يكون العنصر مجلدًا. بالنسبة إلى مجلد في مساحة تخزين سحابي مشتركة، استخدِم 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

تحديد ما إذا كان بإمكان المستخدم إعادة تفعيل الأذونات المكتسَبة
capabilities.canChangeItemDownloadRestriction

boolean

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

boolean

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

object (User)

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

string (int64 format)

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

string

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

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا المستخدم قد عدّل الملف.
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

النتائج فقط. فتحة العدسة المستخدَمة لإنشاء الصورة (الرقم البؤري)
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 للملف المستهدَف.
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، ولا تتم تعبئته لملفات "محرّرات المستندات" أو ملفات الاختصارات.
inheritedPermissionsDisabled

boolean

توضّح ما إذا كانت الأذونات المكتسبة لهذا الملف غير مفعّلة. يتم تفعيل الأذونات المكتسَبة تلقائيًا.
downloadRestrictions

object (DownloadRestrictionsMetadata)

تم تطبيق قيود التنزيل على الملف.

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

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

DownloadRestrictionsMetadata

تم تطبيق قيود على تنزيل الملف.

تمثيل JSON 
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
الحقول
itemDownloadRestriction

object (DownloadRestriction)

تم فرض قيود على تنزيل الملف مباشرةً من قِبل المالك أو المنظِّم. لا يأخذ هذا الإجراء في الاعتبار إعدادات مساحة التخزين السحابي المشتركة أو قواعد "منع فقدان البيانات".
effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

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

DownloadRestriction

تمثّل هذه السمة قيودًا على نسخ الملف وتنزيله.

تمثيل JSON 
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
الحقول
restrictedForReaders

boolean

تحديد ما إذا كان التنزيل والنسخ محظورَين على القرّاء
restrictedForWriters

boolean

ما إذا كان التنزيل والنسخ محظورَين على الكُتّاب في حال ضبطها على "صحيح"، سيتم أيضًا حظر التنزيل على القرّاء.

الطُرق

copy

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

create

تنشئ هذه الطريقة ملفًا جديدًا.

delete

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

download

 تنزيل محتوى ملف

emptyTrash

 حذف جميع ملفات المستخدم في المهملات نهائيًا

export

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

generateIds

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

get

تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاص بملف معيّن من خلال رقم التعريف.

list

تعرض هذه السمة ملفات المستخدم.

listLabels

 تعرض هذه السمة التصنيفات في ملف.

modifyLabels

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

update

تعدّل هذه الطريقة البيانات الوصفية للملف و/أو محتواه.

watch

 للاشتراك في تلقّي إشعارات بشأن التغييرات التي يتم إجراؤها على ملف