すべてのプロダクト
Search
ドキュメントセンター

:Batch

最終更新日:May 27, 2026

複数の API 呼び出しを 1 つのリクエストにまとめて、効率を向上させます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/batch HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

domain_id

string

必須

body

object

任意

リクエストボディのパラメーターを含みます。

resource

string

必須

サブリクエストのリソースタイプです。サポートされるリソースタイプは以下のとおりです。

  • file:ファイル

  • drive:ドライブ

  • user:ユーザー

  • group:グループ

  • membership:グループメンバーシップ

  • share_link:共有リンク

  • async_task:非同期タスク

列挙値:

  • share_link :

    共有リンク

  • file :

    ファイル

  • async_task :

    非同期タスク

  • membership :

    グループメンバーシップ

  • drive :

    ドライブ

  • user :

    ユーザー

  • group :

    グループ

file

requests

array<object>

必須

サブリクエストのコレクションです。

バッチリクエストには、1 ~ 100 個のサブリクエストを含めることができます。

array<object>

任意

サブリクエストオブジェクトです。

id

string

必須

サブリクエストの一意な ID です。この ID は、サブリクエストとその応答を関連付けるために使用されます。ID はバッチリクエスト内で一意である必要があります。

93433894994ad2e1

method

string

必須

サブリクエストの HTTP メソッドです。サポートされるメソッドは以下のとおりです。

  • POST

  • GET

  • PUT

  • DELETE

  • HEAD

列挙値:

  • HEAD :

    HEAD

  • DELETE :

    DELETE

  • POST :

    POST

  • GET :

    GET

  • PUT :

    PUT

POST

url

string

必須

サブリクエストの API パスです。サポートされるパスは以下のとおりです。

  • /file/get:ファイルの詳細を取得します。

  • /file/update:ファイル情報を更新します。

  • /file/search:ファイルを検索します。

  • /file/copy:ファイルまたはフォルダをコピーします。

  • /file/move:ファイルまたはフォルダを移動します。

  • /file/delete:ファイルまたはフォルダを削除します。

  • /file/get_download_url:ファイルのダウンロード URL を取得します。

  • /file/get_share_link_download_url:共有リンクからダウンロード URL を取得します。

  • /recyclebin/trash:ファイルまたはフォルダをゴミ箱に移動します。

  • /recyclebin/restore:ゴミ箱からファイルまたはフォルダを復元します。

  • /file/put_usertags:ユーザータグを設定します。

  • /file/delete_usertags:ユーザータグを削除します。

  • /drive/get:ドライブ情報を取得します。

  • /user/get:ユーザー情報を取得します。

  • /group/get:グループ情報を取得します。

  • /share_link/create:共有リンクを作成します。

  • /share_link/update:共有リンクを更新します。

  • /share_link/cancel:共有リンクをキャンセルします。

  • /share_link/list:共有リンクを一覧表示します。

  • /share_link/get:共有リンク情報を取得します。

  • /share_link/get_share_token:共有トークンを取得します。

  • /async_task/get:非同期タスク情報を取得します。

列挙値:

  • /file/copy :

    ファイルまたはフォルダをコピー

  • /file/get_share_link_download_url :

    共有リンクのダウンロード URL を取得

  • /file/move :

    ファイルまたはフォルダを移動

  • /share_link/create :

    共有リンクを作成

  • /share_link/update :

    共有リンクを更新

  • /async_task/get :

    非同期タスク情報を取得

  • /drive/get :

    ドライブ情報を取得

  • /group/get :

    グループ情報を取得

  • /share_link/list :

    共有リンクを一覧表示

  • /file/delete :

    ファイルまたはフォルダを削除

  • /share_link/get :

    共有リンク情報を取得

  • /file/get :

    ファイルの詳細を取得

  • /file/get_download_url :

    ファイルのダウンロード URL を取得

  • /recyclebin/restore :

    ファイルまたはフォルダを復元

  • /file/update :

    ファイル情報を更新

  • /recyclebin/trash :

    ゴミ箱に移動

  • /file/search :

    ファイルを検索

  • /user/get :

    ユーザー情報を取得

  • /share_link/get_share_token :

    共有トークンを取得

  • /share_link/cancel :

    共有リンクをキャンセル

/file/get

body

object

任意

サブリクエストのリクエストボディです。詳細については、特定の API オペレーションのドキュメントをご参照ください。

body パラメーターを指定する場合は、Content-Type リクエストヘッダーを application/json に設定する必要があります。

any

任意

サブリクエストのリクエストボディです。

{"domain_id":"1","drive_id":"1"}

headers

object

任意

サブリクエストのリクエストヘッダーです。

string

任意

サブリクエストのリクエストヘッダーです。

{"Content-Type":"application/json"}

レスポンスフィールド

フィールド

型

説明

例

object

応答パラメーターです。

responses

array<object>

サブリクエストへの応答のコレクションです。

array<object>

単一のサブリクエストに対する応答オブジェクトです。

id

string

この応答に対応するサブリクエストの ID です。

93433894994ad2e1

status

integer

サブリクエストの HTTP ステータスコードです。詳細については、特定の API オペレーションのドキュメントをご参照ください。

200

body

object

サブリクエストのレスポンスボディです。詳細については、特定の API オペレーションのドキュメントをご参照ください。

any

サブリクエストのレスポンスボディです。

{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"}

例

成功レスポンス

JSONJSON

{
  "responses": [
    {
      "id": "93433894994ad2e1",
      "status": 200,
      "body": {
        "key": "{\"domain_id\":\"1\",\"drive_id\":\"1\",\"file_id\":\"9520943DC264\"}"
      }
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。