Comments: update

Изменяет комментарий.

Влияние на квоту. Вызов этого метода имеет стоимость квоты в 50 единиц.

Примеры использования

Запрос

HTTP-запрос

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

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей доступа. Подробнее…

Область действия
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part определяет свойства, которые будут включены в ответ API. В значении параметра обязательно должна быть часть snippet, поскольку она содержит все свойства, которые можно обновить с помощью запроса к API.

В списке ниже приведены названия part, которые можно включить в значение параметра:
  • id
  • snippet

Тело запроса

В теле запроса укажите ресурс comment. Для этого ресурса:

  • Вы можете задать значения для следующих свойств:

    • snippet.textOriginal

Ответ

Если запрос выполнен успешно, этот метод возвращает ресурс комментария в теле ответа.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробную информацию можно найти в документации по сообщениям об ошибках.

Тип ошибки Сведения об ошибке Описание
badRequest (400) commentTextTooLong В свойстве snippet.textOriginal ресурса comment, который вы обновляете, слишком много символов.
badRequest (400) invalidCommentMetadata Недействительные метаданные запроса.
badRequest (400) operationNotSupported Изменить можно только комментарии, оставленные в Google+.
badRequest (400) processingFailure Серверу API не удалось обработать запрос. Это может быть временная ошибка, но обычно она указывает на то, что входные данные запроса недействительны. Проверьте структуру ресурса comment в теле запроса.
forbidden (403) forbidden Не удалось изменить комментарий из-за недостатка разрешений. Возможно, запрос не был авторизован должным образом.
forbidden (403) ineligibleAccount Чтобы изменить комментарий или цепочку комментариев, аккаунт YouTube, используемый для авторизации запроса к API, должен быть объединен с аккаунтом Google пользователя.
notFound (404) commentNotFound Указанный комментарий не найден. Проверьте значение свойства id в теле запроса.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.