> ## 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.
# 統合ガイド
> このガイドでは、manage Direct Messages エンドポイントをアプリケーションに統合するために必要な主要概念を説明します。manage をカバーする X API v2 standard tier のリファレンスです。
export const Button = ({href, children}) => {
return ;
};
このガイドでは、manage Direct Messages エンドポイントをアプリケーションに統合するために必要な主要な概念を説明します。
***
## 認証
DM エンドポイントではユーザー認証が必要です。
| Method | Description |
| :----------------------------------------------------------------------------------------------------------------------------- | :---------- |
| [OAuth 2.0 Authorization Code with PKCE](/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) | 推奨 |
| [OAuth 1.0a User Context](/resources/fundamentals/authentication) | レガシーサポート |
App-Only 認証はサポートされていません。すべてのダイレクトメッセージは非公開です。
### 必要なスコープ（OAuth 2.0）
| Scope | Required for |
| :----------- | :-------------- |
| `dm.write` | メッセージの送信と削除 |
| `dm.read` | dm.write と併用が必要 |
| `tweet.read` | dm スコープと併用が必要 |
| `users.read` | dm スコープと併用が必要 |
***
## エンドポイントの概要
| Method | Endpoint | Description |
| :----- | :-------------------------------------------------- | :-------------- |
| POST | `/2/dm_conversations/with/:participant_id/messages` | 1 対 1 のメッセージを送信 |
| POST | `/2/dm_conversations` | グループ会話を作成 |
| POST | `/2/dm_conversations/:dm_conversation_id/messages` | 会話にメッセージを追加 |
| DELETE | `/2/dm_events/:event_id` | メッセージを削除 |
***
## メッセージの送信
### 1 対 1 のメッセージ
特定のユーザーにメッセージを送信します。会話が存在しない場合は新規に作成します。
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/dm_conversations/with/9876543210/messages" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Hello!"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# 1 対 1 の DM を送信
response = client.dm_conversations.create_message(
participant_id="9876543210",
text="Hello!"
)
print(response.data)
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// 1 対 1 の DM を送信
const response = await client.dmConversations.createMessage({
participantId: "9876543210",
text: "Hello!",
});
console.log(response.data);
```
### グループ会話
新しいグループを作成し、最初のメッセージを送信します。
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/dm_conversations" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"conversation_type": "Group",
"participant_ids": ["944480690", "906948460078698496"],
"message": {"text": "Welcome to our group!"}
}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# グループ会話を作成
response = client.dm_conversations.create(
conversation_type="Group",
participant_ids=["944480690", "906948460078698496"],
message={"text": "Welcome to our group!"}
)
print(response.data)
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// グループ会話を作成
const response = await client.dmConversations.create({
conversationType: "Group",
participantIds: ["944480690", "906948460078698496"],
message: { text: "Welcome to our group!" },
});
console.log(response.data);
```
`conversation_type` フィールドは `"Group"` に設定する必要があります（大文字小文字を区別）。
### 既存の会話に追加
自分が参加している任意の会話にメッセージを送信します。
```bash cURL theme={null}
curl -X POST "https://api.x.com/2/dm_conversations/1582103724607971328/messages" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Another message"}'
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# 既存の会話にメッセージを追加
response = client.dm_conversations.add_message(
dm_conversation_id="1582103724607971328",
text="Another message"
)
print(response.data)
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// 既存の会話にメッセージを追加
const response = await client.dmConversations.addMessage({
dmConversationId: "1582103724607971328",
text: "Another message",
});
console.log(response.data);
```
***
## メディア添付
1 メッセージにつき 1 つのメディア（写真、動画、GIF）を添付できます。
[Media Upload endpoint](/x-api/media/quickstart/media-upload-chunked) を使用してファイルをアップロードし、`media_id` を取得します。
```json theme={null}
{
"text": "Check out this image!",
"attachments": [{"media_id": "1583157113245011970"}]
}
```
* 認証済みユーザー自身がメディアをアップロードしている必要があります
* メディアはアップロードから 24 時間有効です
* 1 メッセージにつき添付できるのは 1 つだけです
***
## Post の共有
Post URL をテキストに追加すると、メッセージに Post を含められます。
```json theme={null}
{
"text": "Have you seen this? https://x.com/XDevelopers/status/1580559079470145536"
}
```
レスポンスには Post ID を含む `referenced_tweets` フィールドが含まれます。
***
## メッセージの要件
| Field | Required | Notes |
| :------------ | :------- | :----------- |
| `text` | Yes\* | 添付がない場合は必須 |
| `attachments` | Yes\* | テキストがない場合は必須 |
\*`text` または `attachments` のいずれかを必ず指定する必要があります。
***
## v1.1 との ID 互換性
会話 ID とイベント ID は v1.1 と v2 のエンドポイント間で共有されます。これにより、ハイブリッドなワークフローが可能になります。
* v2 でメッセージを作成
* v1.1 でメッセージを削除（v2 ではまだ利用不可）
* x.com URL の会話 ID を参照
***
## エラー処理
| Status | Error | Solution |
| :----- | :---------------- | :--------------- |
| 400 | Invalid request | リクエストボディの形式を確認 |
| 401 | Unauthorized | Access Token を確認 |
| 403 | Forbidden | スコープとユーザーの権限を確認 |
| 429 | Too Many Requests | 待機してから再試行 |
### よくある問題
受信者が未知のユーザーからのメッセージを許可しない DM 設定にしている、またはあなたをブロックしている可能性があります。
メディアが同じ認証済みユーザーによってアップロードされ、24 時間以内であることを確認してください。
すべての participant ID が有効で、ユーザーがグループ DM の招待を許可していることを確認してください。
***
## 次のステップ
最初のダイレクトメッセージを送信
DM の会話を取得
添付用のメディアをアップロード
エンドポイントの完全なドキュメント