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