Method: files.copy
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
파일의 사본을 만들고 패치 의미 체계를 사용하여 요청된 업데이트를 적용합니다. 자세한 내용은 파일 만들기 및 관리를 참고하세요.
HTTP 요청
POST https://www.googleapis.com/drive/v3/files/{fileId}/copy
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
fileId |
string
파일의 ID입니다.
|
쿼리 매개변수
매개변수 |
enforceSingleParent (deprecated) |
boolean
지원 중단됨: 파일을 여러 폴더에 복사하는 기능이 더 이상 지원되지 않습니다. 대신 단축키를 사용하세요.
|
ignoreDefaultVisibility |
boolean
생성된 파일에 대해 도메인의 기본 공개 상태 설정을 무시할지 여부입니다. 도메인 관리자는 업로드된 모든 파일을 기본적으로 도메인에 표시되도록 선택할 수 있습니다. 이 매개변수는 요청에 대해 해당 동작을 우회합니다. 권한은 여전히 상위 폴더에서 상속됩니다.
|
keepRevisionForever |
boolean
새 헤드 버전에서 keepForever 필드를 설정할지 여부입니다. 이는 Google Drive의 바이너리 콘텐츠가 있는 파일에만 적용됩니다. 파일의 버전은 200개까지만 영구 보관할 수 있습니다. 한도에 도달한 경우 고정된 버전을 삭제해 보세요.
|
ocrLanguage |
string
이미지 가져오기 중 OCR 처리를 위한 언어 힌트 (ISO 639-1 코드)입니다.
|
supportsAllDrives |
boolean
요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부입니다.
|
supportsTeamDrives (deprecated) |
boolean
지원 중단됨: 대신 supportsAllDrives 를 사용하세요.
|
includePermissionsForView |
string
응답에 포함할 추가 뷰의 권한을 지정합니다. published 만 지원됩니다.
|
includeLabels |
string
응답의 labelInfo 부분에 포함할 라벨 ID의 쉼표로 구분된 목록입니다.
|
요청 본문
요청 본문에 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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]