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 リクエストとレスポンスを確認します。