Method: files.copy
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת עותק של הקובץ שצוין.
בקשת HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/copy
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
fileId |
string
המזהה של הקובץ שרוצים להעתיק.
|
פרמטרים של שאילתה
| פרמטרים |
convert |
boolean
האם להמיר את הקובץ הזה לפורמט המתאים של עורכי Docs.
|
enforceSingleParent
(deprecated) |
boolean
הוצא משימוש: אין יותר תמיכה בהעתקת קבצים לכמה תיקיות. במקום זאת, אפשר להשתמש במקשי קיצור.
|
ocr |
boolean
האם לנסות לבצע OCR בהעלאות של קבצים בפורמטים .jpg, .png, .gif או .pdf.
|
ocrLanguage |
string
אם הערך של ocr הוא true, הוא נותן רמז לגבי השפה שבה צריך להשתמש. הערכים החוקיים הם קודים של BCP 47.
|
pinned |
boolean
האם להצמיד את הגרסה הראשית של העותק החדש. בכל קובץ אפשר להצמיד עד 200 גרסאות.
|
supportsAllDrives |
boolean
האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
|
supportsTeamDrives
(deprecated) |
boolean
האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
|
timedTextLanguage |
string
השפה של הטקסט המתוזמן.
|
timedTextTrackName |
string
השם של הטראק של הטקסט המתוזמן.
|
visibility |
enum (Visibility)
סטטוס החשיפה של הקובץ החדש. הפרמטר הזה רלוונטי רק כשהמקור הוא לא מסמך Google Docs מקורי ו-convert=false.
|
includePermissionsForView |
string
מציין אילו הרשאות של תצוגה נוספת צריך לכלול בתשובה. יש תמיכה רק ב-published.
|
includeLabels |
string
רשימה מופרדת בפסיקים של מזהי תוויות שרוצים לכלול בחלק labelInfo של התשובה.
|
גוף הבקשה
גוף הבקשה מכיל מופע של File.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של File.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
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-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון 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 the specified file.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/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 to copy. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `convert` | `boolean` Whether to convert this file to the corresponding Docs Editors format. |\n| `enforceSingleParent` **(deprecated)** | `boolean` Deprecated: Copying files into multiple folders is no longer supported. Use shortcuts instead. |\n| `ocr` | `boolean` Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads. |\n| `ocrLanguage` | `string` If `ocr` is true, hints at the language to use. Valid values are BCP 47 codes. |\n| `pinned` | `boolean` Whether to pin the head revision of the new copy. A file can have a maximum of 200 pinned revisions. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `timedTextLanguage` | `string` The language of the timed text. |\n| `timedTextTrackName` | `string` The timed text track name. |\n| `visibility` | `enum (`[Visibility](/workspace/drive/api/reference/rest/v2/Visibility)`)` The visibility of the new file. This parameter is only relevant when the source is not a native Google Doc and convert=false. |\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/v2/files#File).\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v2/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\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.apps.readonly`\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)."]]
