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

次のリストは、パラメータ値に指定できる 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 のリクエストとレスポンスを確認します。