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