Comments: update

コメントを変更します。

割り当てへの影響: このメソッドの呼び出しには 50 ユニットの割り当てコストがかかります。

一般的なユースケース

リクエスト

HTTP リクエスト

PUT https://www.googleapis.com/youtube/v3/comments

承認

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

スコープ
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

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

パラメータ
必須パラメータ
part string
part パラメータは、API レスポンスに含めるプロパティを指定します。このパラメータ値には、API リクエストで更新できるすべてのプロパティが含まれているため、少なくとも snippet 部分を含める必要があります。

パラメータ値に含めることができる part 名は次のとおりです。
  • id
  • snippet

リクエストの本文

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

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

    • snippet.textOriginal

レスポンス

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

エラー

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

エラーのタイプ エラーの詳細 説明
badRequest (400) commentTextTooLong 更新される comment リソースの snippet.textOriginal プロパティに、多すぎる文字が含まれています。
badRequest (400) invalidCommentMetadata リクエスト メタデータが無効です。
badRequest (400) operationNotSupported 更新できるのは Google+ ベースのコメントのみです。
badRequest (400) processingFailure API サーバーがリクエストを正常に処理できませんでした。これは一時的なエラーである可能性がありますが、通常はリクエストの入力が無効であることを示しています。リクエストの本文の comment リソースの構造を確認して、有効であることを確認してください。
forbidden (403) forbidden 権限が不足しているため、コメントを更新できませんでした。リクエストが適切に認証されない可能性があります。
forbidden (403) ineligibleAccount コメントまたはコメント スレッドを更新するには、API リクエストの承認に使用する YouTube アカウントをユーザーの Google アカウントと統合する必要があります。
notFound (404) commentNotFound 指定されたコメントが見つかりませんでした。リクエストの本文の id プロパティの値が正しいことを確認してください。

試してみよう:

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