Method: files.copy
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת עותק של קובץ והחלת עדכונים מבוקשים באמצעות סמנטיקה של תיקון. מידע נוסף זמין במאמר יצירה וניהול של קבצים.
בקשת HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
fileId |
string
המזהה של הקובץ.
|
פרמטרים של שאילתה
| פרמטרים |
enforceSingleParent
(deprecated) |
boolean
הוצאה משימוש: כבר אי אפשר להעתיק קבצים לכמה תיקיות. במקום זאת, אפשר להשתמש בקיצורי דרך.
|
ignoreDefaultVisibility |
boolean
האם להתעלם מהגדרות ברירת המחדל של הדומיין לגבי החשיפה של הקובץ שנוצר. אדמינים בדומיין יכולים לבחור להגדיר שכל הקבצים שמועלים יהיו גלויים לדומיין כברירת מחדל. הפרמטר הזה עוקף את ההתנהגות הזו עבור הבקשה. ההרשאות עדיין עוברות בירושה מתיקיות האב.
|
keepRevisionForever |
boolean
האם להגדיר את השדה keepForever בגרסה החדשה של head. ההגדרה הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. אפשר לשמור לתמיד רק 200 גרסאות של הקובץ. אם מגיעים למגבלה, אפשר לנסות למחוק גרסאות מוצמדות.
|
ocrLanguage |
string
רמז לשפה לעיבוד OCR במהלך ייבוא תמונה (קוד ISO 639-1).
|
supportsAllDrives |
boolean
האם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
|
supportsTeamDrives
(deprecated) |
boolean
יצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
|
includePermissionsForView |
string
מציין אילו הרשאות של תצוגות נוספות לכלול בתשובה. יש תמיכה רק ב-published.
|
includeLabels |
string
רשימה מופרדת בפסיקים של מזהי התוויות שרוצים לכלול בחלק labelInfo של התשובה.
|
גוף הבקשה
גוף הבקשה מכיל מופע של File.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של File.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.photos.readonly
יש היקפי הרשאות מוגבלים שנדרשת הערכת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[],[],null,["# Method: files.copy\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\nCreates a copy of a file and applies any requested updates with patch semantics.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/files/{fileId}/copy`\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| `enforceSingleParent` | `boolean` Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead. |\n| `ignoreDefaultVisibility` | `boolean` Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders. |\n| `keepRevisionForever` | `boolean` Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. |\n| `ocrLanguage` | `string` A language hint for OCR processing during image import (ISO 639-1 code). |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only 'published' is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body contains an instance of [File](/workspace/drive/api/reference/rest/v3/files#File).\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v3/files#File).\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.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.photos.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)."]]
