DriveItem の内容をアップロードまたは置換するUpload or replace the contents of a DriveItem

簡単なアップロード API を使用すると、新しいファイルの内容を提供したり、単一の API 呼び出しで既存のファイルの内容を更新したりすることができます。このメソッドは、サイズが 4MB までのファイルのみをサポートしています。The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call. This method only supports files up to 4MB in size.

大きなファイルをアップロードする場合は、「アップロード セッションを使ってサイズの大きなファイルをアップロードする」を参照してください。To upload large files see Upload large files with an upload session.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Files.ReadWrite、Files.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All
アプリケーションApplication Files.ReadWrite.All、Sites.ReadWrite.AllFiles.ReadWrite.All, Sites.ReadWrite.All

HTTP 要求 (既存アイテムを置換する場合)HTTP request (to replace an existing item)

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

HTTP 要求 (新しいファイルをアップロードする場合)HTTP request (to upload a new file)

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drive/items/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

要求本文Request body

要求の本文の内容は、アップロードするファイルのバイナリ ストリームである必要があります。The contents of the request body should be the binary stream of the file to be uploaded.

応答Response

成功した場合、このメソッドは、新しく作成されたファイルまたは更新されたファイルの応答本文で driveItem オブジェクトを返します。If successful, this method returns a driveItem object in the response body for the newly created or updated file.

例 (新しいファイルのアップロード)Example (upload a new file)

この例では、"The contents of the file goes here."(ファイルの内容がここに入ります。) という文字列を、This example uploads the string "The contents of the file goes here." サインインしたユーザーのドライブの FolderA の下の FileB.txt という名前のファイルにアップロードします。to a file in the signed-in user's drive under FolderA named FileB.txt.

PUT /me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

応答Response

成功した場合、このメソッドは、新しく作成されたファイルの応答本文で driveItem リソースを返します。If successful, this method returns an driveItem resource in the response body for the newly created file.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

例 (既存ファイルの更新)Example (updating an existing file)

この例では、既知の ID を持つファイルの内容を置き換えます。This example replaces the contents of a file with a known ID.

PUT /me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

応答Response

成功した場合、このメソッドは、新しく作成されたファイルの応答本文で driveItem リソースを返します。If successful, this method returns an driveItem resource in the response body for the newly created file.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

エラー応答Error responses

エラーがどのように返されるかの詳細については、「エラー応答」を参照してください。See Error Responses for details about how errors are returned.