このページは 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`	指定した親コメントは非公開です。この API では、限定公開のコメントへの返信はサポートされていません。
`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 のリクエストとレスポンスを確認します。