特定のユーザーがチャットに参加できないようにする禁止を解除します。これにより、ユーザーはチャットに再参加できるようになります。API リクエストは、チャンネル所有者、または参加禁止に関連付けられているチャットのモデレーターが承認する必要があります。
一般的なユースケース
リクエスト
HTTP リクエスト
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
認可
このリクエストには、次のスコープのうち少なくとも 1 つによる承認が必要です。認証と認可の詳細については、OAuth 2.0 認証の実装をご覧ください。
| 範囲 |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
| パラメータ | ||
|---|---|---|
| 必須パラメータ | ||
id |
stringid パラメータは、削除するチャット禁止を指定します。この値は参加禁止とチャットの両方を一意に識別します。 |
|
リクエスト本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
レスポンス
成功すると、このメソッドは HTTP 204 No Content ステータス コードを返します。
エラー
次の表に、このメソッドの呼び出しへのレスポンスとして API から返されるエラー メッセージを示します。詳しくは、エラー メッセージをご覧ください。
| エラーのタイプ | エラーの詳細 | 説明 |
|---|---|---|
forbidden (403) |
forbidden |
指定した禁止は削除できません。このエラーは、別のモデレーターの禁止を解除しようとしているモデレーターがリクエストを承認した場合に発生することがあります。 |
forbidden (403) |
insufficientPermissions |
指定した禁止を解除するために必要な権限がありません。 |
invalidValue (400) |
invalidLiveChatBanId |
id パラメータに無効な値が指定されています。 |
notFound (404) |
liveChatBanNotFound |
指定された禁止が見つかりません。 |
試してみよう:
APIs Explorer を使用して API を呼び出し、API のリクエストとレスポンスを確認します。