特定のユーザーがチャットに投稿できないようにする禁止を解除し、ユーザーがチャットに再び参加できるようにします。API リクエストは、チャンネル所有者または禁止に関連付けられたチャットのモデレーターによって承認される必要があります。
一般的なユースケース
リクエスト
HTTP リクエスト
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
承認
このリクエストには、次のいずれかのスコープによる承認が必要です。認証と認可の詳細については、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 リクエストとレスポンスを確認します。