このページは Cloud Translation API によって翻訳されました。

Comments: insert

既存のコメントに返信を作成します。注: トップレベルコメントを作成するには、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` 名を示します。 `id` `snippet`

リクエスト本文

リクエストの本文にコメントリソースを指定します。対象リソース:

以下のプロパティの値を指定する必要があります。
- 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 のリクエストとレスポンスを確認します。