> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# クイックスタート
> このガイドでは、List の作成、更新、削除の手順を説明します。X API v2 スタンダード階層の manage lists に関するリファレンスドキュメントです。
export const Button = ({href, children}) => {
return ;
};
このガイドでは、List の作成、更新、削除の手順を説明します。
**前提条件**
始める前に、以下が必要です:
* 承認済みの App がある [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* ユーザー Access Token (OAuth 1.0a または OAuth 2.0 PKCE)
***
## List を作成
List の name (必須)、およびオプションで description と非公開設定を定義します:
```json theme={null}
{
"name": "Tech News",
"description": "Top tech journalists and publications",
"private": false
}
```
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/lists" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Tech News",
"description": "Top tech journalists and publications",
"private": false
}'
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# 新しい List を作成
response = client.lists.create(
name="Tech News",
description="Top tech journalists and publications",
private=False
)
print(f"List created: {response.data.id} - {response.data.name}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// 新しい List を作成
const response = await client.lists.create({
name: "Tech News",
description: "Top tech journalists and publications",
private: false,
});
console.log(`List created: ${response.data?.id} - ${response.data?.name}`);
```
```json theme={null}
{
"data": {
"id": "1441162269824405510",
"name": "Tech News"
}
}
```
後で List を更新または削除するために `id` を保存しておきます。
***
## List を更新
List の名前、説明、または非公開設定を変更します:
```bash cURL theme={null}
curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Tech News & Insights",
"description": "Updated description"
}'
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# List を更新
response = client.lists.update(
"1441162269824405510",
name="Tech News & Insights",
description="Updated description"
)
print(f"Updated: {response.data.updated}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// List を更新
const response = await client.lists.update("1441162269824405510", {
name: "Tech News & Insights",
description: "Updated description",
});
console.log(`Updated: ${response.data?.updated}`);
```
**レスポンス:**
```json theme={null}
{
"data": {
"updated": true
}
}
```
***
## List を削除
削除したい List の ID が必要です。
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
from xdk.oauth1_auth import OAuth1
oauth1 = OAuth1(
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
access_token="YOUR_ACCESS_TOKEN",
access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)
client = Client(auth=oauth1)
# List を削除
response = client.lists.delete("1441162269824405510")
print(f"Deleted: {response.data.deleted}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client, OAuth1 } from "@xdevplatform/xdk";
const oauth1 = new OAuth1({
apiKey: "YOUR_API_KEY",
apiSecret: "YOUR_API_SECRET",
accessToken: "YOUR_ACCESS_TOKEN",
accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});
const client = new Client({ oauth1 });
// List を削除
const response = await client.lists.delete("1441162269824405510");
console.log(`Deleted: ${response.data?.deleted}`);
```
```json theme={null}
{
"data": {
"deleted": true
}
}
```
削除できるのは自分が所有する List のみです。
***
## 次のステップ
List のメンバーの追加・削除
List の詳細を取得
主要な概念とベストプラクティス
エンドポイントの詳細ドキュメント