> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ブックマークの管理
> X API を使用してブックマークを追加および削除します
export const Button = ({href, children}) => {
return ;
};
このガイドでは、X API を使用してブックマークを追加および削除する方法を説明します。
**前提条件**
作業を始める前に、次のものが必要です。
* 承認された App を持つ [開発者アカウント](https://developer.x.com/en/portal/petition/essential/basic-info)
* `bookmark.write` スコープを持つユーザーアクセストークン (OAuth 2.0 PKCE)
***
## ブックマークを追加する
認証済みユーザーのIDが必要です。`/2/users/me` エンドポイント、または [ユーザー lookup エンドポイント](/ja/x-api/users/lookup/introduction)を使って取得できます。
ポストを表示しているときのURLからポストIDを確認します：
```
https://x.com/XDevelopers/status/1460323737035677698
└── これがポストIDです
```
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tweet_id": "1460323737035677698"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# ブックマークを追加する
response = client.bookmarks.create(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// ブックマークを追加する
const response = await client.bookmarks.create("2244994945", {
tweetId: "1460323737035677698",
});
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
```json theme={null}
{
"data": {
"bookmarked": true
}
}
```
***
## ブックマークを削除する
ブックマークからポストを削除するには、次のようにします:
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# ブックマークを削除する
response = client.bookmarks.delete(
user_id="2244994945",
tweet_id="1460323737035677698"
)
print(f"Bookmarked: {response.data.bookmarked}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// ブックマークを削除する
const response = await client.bookmarks.delete("2244994945", "1460323737035677698");
console.log(`Bookmarked: ${response.data?.bookmarked}`);
```
**レスポンス:**
```json theme={null}
{
"data": {
"bookmarked": false
}
}
```
***
## 必要なスコープ
OAuth 2.0 PKCE を使用する場合、アクセストークンには次のスコープが必要です。
| Scope | Description |
| :--------------- | :----------- |
| `bookmark.write` | ブックマークの追加と削除 |
| `tweet.read` | ポストのデータの読み取り |
| `users.read` | ユーザーデータの読み取り |
***
## 次のステップ
ブックマークした投稿を取得
エンドポイントの完全なドキュメント