既存のコメントに返信を作成します。注: トップレベル コメントを作成するには、commentThreads.insert
メソッドを使用します。
割り当ての影響: このメソッドを呼び出すと、割り当てコストは 50 単位になります。
一般的なユースケース
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/youtube/v3/comments
承認
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
範囲 |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
パラメータ | ||
---|---|---|
必須パラメータ | ||
part |
string part パラメータは、API レスポンスに含めるプロパティを識別します。パラメータ値を snippet に設定します。snippet 部分の割り当て費用は 2 単位です。次のリストに、パラメータ値に含めることができる part 名を示します。
|
リクエスト本文
リクエストの本文にコメント リソースを指定します。対象リソース:
-
以下のプロパティの値を指定する必要があります。
snippet.textOriginal
snippet.parentId
-
以下のプロパティの値を設定することができます。
snippet.textOriginal
レスポンス
成功すると、このメソッドはレスポンスの本文でコメント リソースを返します。
エラー
次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。
エラーのタイプ | エラーの詳細 | 説明 |
---|---|---|
badRequest (400) |
commentTextRequired |
挿入する comment リソースは、snippet.textOriginal プロパティの値を指定する必要があります。コメントは空白にはできません。 |
badRequest (400) |
commentTextTooLong |
挿入される comment リソースの snippet.textOriginal プロパティに含まれる文字が多すぎます。 |
badRequest (400) |
invalidCustomEmoji |
挿入される comment リソースに無効なカスタム絵文字が含まれています。 |
badRequest (400) |
invalidCommentMetadata |
リクエスト メタデータが無効です。 |
badRequest (400) |
operationNotSupported |
API ユーザーは、snippet.parentId プロパティで指定されたトップレベルのコメントに返信する際、コメントを挿入できません。commentThread リソースの snippet.canReply プロパティは、現在の閲覧者がスレッドに返信できるかどうかを示します。 |
badRequest (400) |
parentCommentIsPrivate |
指定した親のコメントは非公開です。非公開コメントに対する返信はサポートされていません。 |
badRequest (400) |
parentIdMissing |
挿入するコメントは、親コメントにリンクする必要があります。しかし、API リクエストの本文の comment リソースで snippet.parentId プロパティの値が指定されませんでした。 |
badRequest (400) |
processingFailure |
API サーバーでリクエストを処理できませんでした。これは一時的なエラーの可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエスト本文の comment リソースの構造を調べて、リソースが有効であることを確認します。 |
forbidden (403) |
forbidden |
権限が不十分なため、コメントを作成できません。リクエストが適切に認証されない可能性があります。 |
forbidden (403) |
ineligibleAccount |
コメントまたはコメント スレッドを挿入するには、API リクエストの認証に使用する YouTube アカウントをユーザーの Google アカウントと統合する必要があります。 |
notFound (404) |
parentCommentNotFound |
指定された親コメントが見つかりませんでした。リクエスト本文の snippet.parentId プロパティの値が正しいことを確認します。 |
実習
APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。