Method: files.export
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تصدِّر هذه الطريقة مستند Google Workspace إلى نوع MIME المطلوب وتعرض محتوى البايت المصدَّر. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.
يُرجى العِلم أنّ الحدّ الأقصى المسموح به لحجم المحتوى الذي يمكن تصديره هو 10 ميغابايت.
طلب HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/export
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
fileId |
string
رقم تعريف الملف
|
مَعلمات طلب البحث
المعلمات |
mimeType |
string
مطلوب. نوع MIME للتنسيق المطلوب لهذا التصدير. للاطّلاع على قائمة بأنواع MIME المتوافقة، يُرجى الانتقال إلى أنواع MIME لتصدير مستندات Google Workspace.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
في حال نجاح العملية، تعرض هذه الطريقة محتوى الملف على شكل وحدات بايت.
نطاقات التفويض
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.readonly
بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتتمكّن من استخدامها في تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: files.export\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nExports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/export`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Query parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------|\n| `mimeType` | `string` Required. The MIME type of the format requested for this export. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, this method returns the file content as bytes. For a list of Google Workspace documents and MIME type conversion formats, see [Google Workspace documents and corresponding export MIME types](/drive/api/guides/ref-export-formats).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]