特定のユーザーのチャット投稿を禁止し、チャットに再参加できるようにしました。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 のリクエストとレスポンスを確認します。