# API トークンを作成する

rclone などのスクリプトやツールで使う個人用の API トークンを作成し、アクセスできる範囲を選んで、不要になったら無効にする方法を説明します。

更新日：2026-10-19  
出典：https://drime.cloud/ja/support/integrations-and-api/api-tokens

API トークンを使うと、rclone などのスクリプトやツールが、パスワードなしで Drime アカウントにアクセスできます。トークンごとにできることを選べ、いつでも無効にできます。

個人用のトークンは、自分のアカウントで動かすスクリプト、バックアップ、ツールのためのものです。ほかの Drime ユーザーが自分のアカウントに接続するアプリは OAuth を使い、ユーザーにパスワードを求めてはいけません。[Drime API のドキュメント](https://docs.drime.cloud/authentication)をご覧ください。

## トークンを作成する

1. 右上のアバターをクリックし、**設定**をクリックします。

2. **開発者**をクリックします。

3. **API アクセストークン**で**トークンを作成**をクリックします。

   ![設定の「開発者」。「API アクセストークン」セクションと「トークンを作成」ボタンがある](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

4. **トークン名**に、見分けやすい名前を入力します。

   トークンを使うツールやパソコンがわかる名前にします（例：「NAS の rclone」）。名前は3文字以上100文字以下にしてください。

5. **権限**で、トークンにできることを選びます。

   - **すべて**：すべてのリソースにフルアクセスできます。
   - **読み取り専用**：すべてのリソースを読み取り専用で利用できます。
   - **制限付き**：選んだリソースにだけアクセスでき、リソースごとに**アクセス権なし**、**既読**、**書き込み**のいずれかを設定します。

   [適切な権限を選ぶ](#permissions)をご覧ください。

   ![トークン名が入力され、「権限」のタブが並ぶ「新しいトークンを作成」ダイアログ](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

6. **作成**をクリックします。

7. **コピー**をクリックしてトークンをコピーし、**完了**をクリックします。

   トークンがクリップボードにコピーされると、ボタンに**コピーしました！** と表示されます。

   ![一度だけ表示される新しいトークン。「コピー」ボタンと、安全な場所に保管するよう求める警告がある](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **重要**
>
> トークンは一度しか表示されません。**トークンは安全な場所に保管してください。このダイアログを閉じると、トークンは再表示できなくなります。** すぐにパスワードマネージャーやツールの設定に保存してください。なくした場合は、そのトークンを削除して新しく作成してください。

作成したトークンは **API アクセストークン**に表示され、すぐに使えます。有効期限はなく、削除するまで使えます。

## 適切な権限を選ぶ

トークンには、必要な権限だけを与えてください。

| 権限 | トークンにできること |
| --- | --- |
| **すべて** | API を通じて、アカウントでできることをすべて行えます。 |
| **読み取り専用** | 下記のすべてのリソースを読み取れますが、何も変更できません。 |
| **制限付き** | **既読**または**書き込み**に設定したリソースにだけアクセスできます。**アクセス権なし**のままのリソースへのアクセスは拒否されます。 |

**制限付き**のトークンには、**ファイル**（バージョンとゴミ箱を含む）、**フォルダ**、**共有**、**ワークスペース**、**Vault**、**署名**、**ホワイトボード**、**ファイルリクエスト**、**Send & Track**、**連絡先**、**タグ**、**アナリティクス**のリソースが並びます。**アナリティクス**（ストレージの使用量）は読み取りしかできないため、選択肢は**アクセス権なし**と**アクセス**です。リソースの横にあるヘルプアイコンにカーソルを合わせると、そのリソースの対象範囲が表示されます。

アカウント、セキュリティ、請求の設定にアクセスできるのは、**すべて**のトークンだけです。**読み取り専用**と**制限付き**のトークンは、これらの設定には一切アクセスできません。

トークンの権限は、作成後に変更できません。変更するには、適切な権限で新しいトークンを作成し、ツールの設定を更新してから、古いトークンを削除します。

## トークンを使う

すべてのリクエストで、トークンを `Authorization` ヘッダーに入れて送信します。

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

**API アクセストークン**の横にある**ドキュメント**のリンクをクリックすると、[Drime API のドキュメント](https://docs.drime.cloud/authentication)が開きます。rclone でトークンを使う方法は、[Rclone、Drime CLI、WebDAV](https://drime.cloud/ja/support/integrations-and-api/rclone-cli-and-webdav)をご覧ください。

## トークンを確認・削除する

**API アクセストークン**には、自分で作成したトークンと、Drime のアプリ（Drime Desktop、Drime Mobile、ブラウザ拡張機能）が自動で作成したトークンが一覧表示されます。各行には次の情報が表示されます。

- トークンの名前、またはアプリとそのプラットフォーム（例：**デスクトップアプリ · Windows**）
- 権限（例：**すべてのアクセス権**）
- 最後に使われた日時、または**未使用**

トークンが1つもない場合は、**個人アクセストークンはまだありません**と表示されます。

トークンを無効にするには、次の手順で操作します。

1. トークンの行の右端にある**トークンを削除**（ゴミ箱のアイコン）をクリックします。

   ![「トークンを削除しますか？」の確認ダイアログ](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

2. **削除**をクリックして確定します。

   ダイアログには、**このトークンは直ちに完全に削除されます。削除すると、API リクエストには使用できなくなります。** という警告が表示されます。削除すると**トークンを削除しました**と表示され、そのトークンを使っているツールはすぐに動かなくなります。

Drime のアプリは、[セッションとデバイスを確認してログアウトする](https://drime.cloud/ja/support/account-and-settings/sessions-and-devices)の手順でログアウトさせることもできます。

## うまくいかない場合

| 表示される内容 | 対処方法 |
| --- | --- |
| **開発者**に **API アクセストークン**がない | お使いのアカウントで API アクセスが有効になっていません。[Drime のサポートに問い合わせて](https://drime.cloud/ja/support/getting-started/contact-drime-support)ください。 |
| トークンをなくした | トークンは再表示できません。削除してから、新しいトークンを作成してください。 |
| **作成**をクリックすると、**トークン名**の下にエラーが表示される | 名前は3文字以上100文字以下にしてください。 |
| `401` と `Unauthenticated.` が返される | トークンがない、間違っている、または削除されています。`Authorization: Bearer` ヘッダーを確認するか、新しいトークンを作成してください。 |
| `403` と `This API key is missing the required scope: files.write`（または別のリソース）が返される | トークンが**読み取り専用**または**制限付き**で、そのリソースへの権限がありません。そのリソース（メッセージに表示されます）を**既読**または**書き込み**に設定したトークンか、**すべて**のトークンを作成してください。 |
| `403` と `This endpoint cannot be accessed with a restricted API key.` が返される | アカウントや請求の設定など、API のこの部分には**すべて**のトークンが必要です。 |
| `403` と `This action is unauthorized.` が返される | トークンの権限にかかわらず、お使いのアカウント自体にこの操作が許可されていません。 |

## 次のステップ

- [Rclone、Drime CLI、WebDAV](https://drime.cloud/ja/support/integrations-and-api/rclone-cli-and-webdav)
- [セッションとデバイスを確認してログアウトする](https://drime.cloud/ja/support/account-and-settings/sessions-and-devices)