CommentThreads: insert

新しいトップレベル コメントを作成します。既存のコメントに返信を追加するには、代わりに comments.insert メソッドを使用します。

割り当ての影響: このメソッドを呼び出すと、割り当てコストは 50 単位になります。

一般的なユースケース

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/commentThreads

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。

範囲
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part string
part パラメータは、API レスポンスに含めるプロパティを識別します。パラメータ値を snippet に設定します。snippet 部分の割り当て費用は 2 単位です。

次のリストに、パラメータ値に含めることができる part 名を示します。
  • id
  • replies
  • snippet

リクエスト本文

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

  • 以下のプロパティの値を指定する必要があります。

    • snippet.channelId
    • snippet.topLevelComment.snippet.textOriginal

  • 以下のプロパティの値を設定することができます。

    • snippet.channelId
    • snippet.videoId
    • snippet.topLevelComment.snippet.textOriginal

レスポンス

成功すると、このメソッドはレスポンスの本文で commentThread リソースを返します。

エラー

次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) channelOrVideoIdMissing 各コメント スレッドは、チャンネルまたは動画にリンクする必要があります。
  • コメントがチャンネルに適用される場合は、リクエスト本文に指定されたリソースが snippet.channelId プロパティの値を指定するようにします。チャンネルに適用されるコメントは、チャンネルの [ディスカッション] タブに表示されます。
  • コメントが動画に適用される場合は、リソースで snippet.channelId プロパティと snippet.videoId プロパティの両方に値が指定されていることを確認してください。動画に適用されるコメントは動画再生ページに表示されます。
badRequest (400) commentTextRequired 挿入する comment リソースは、snippet.topLevelComment.snippet.textOriginal プロパティの値を指定する必要があります。コメントは空白にはできません。
badRequest (400) commentTextTooLong 挿入される comment リソースの snippet.topLevelComment.snippet.textOriginal プロパティに含まれる文字が多すぎます。
badRequest (400) invalidCommentThreadMetadata リクエスト メタデータが無効です。
badRequest (400) processingFailure API サーバーでリクエストを処理できませんでした。これは一時的なエラーの可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエスト本文の commentThread リソースの構造を調べて、リソースが有効であることを確認します。
forbidden (403) forbidden 権限が不十分なため、コメント スレッドを作成できませんでした。リクエストが適切に認証されない可能性があります。
forbidden (403) ineligibleAccount コメントまたはコメント スレッドを挿入するには、API リクエストの認証に使用する YouTube アカウントをユーザーの Google アカウントと統合する必要があります。
notFound (404) channelNotFound 指定されたチャンネルは見つかりませんでした。snippet.channelId プロパティの値が正しいことを確認してください。
notFound (404) videoNotFound 指定された動画が見つかりませんでした。snippet.videoId プロパティの値が正しいことを確認してください。

実習

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。