コメントを変更します。
割り当てへの影響: このメソッドの呼び出しには 50 ユニットの割り当てコストがかかります。
一般的なユースケース
リクエスト
HTTP リクエスト
PUT https://www.googleapis.com/youtube/v3/comments
承認
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
| スコープ |
|---|
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
| パラメータ | ||
|---|---|---|
| 必須パラメータ | ||
part |
stringpart パラメータは、API レスポンスに含めるプロパティを指定します。このパラメータ値には、API リクエストで更新できるすべてのプロパティが含まれているため、少なくとも snippet 部分を含める必要があります。パラメータ値に含めることができる part 名は次のとおりです。
|
|
リクエストの本文
リクエストの本文にコメント リソースを指定します。 このリソースの場合:
-
以下のプロパティの値を指定することができます。
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 リクエストとレスポンスを確認します。