CommentThreads: insert

Crea un comentario de nivel superior nuevo. Para agregar una respuesta a un comentario existente, usa el método comments.insert.

Impacto de la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.

Casos de uso habituales

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/youtube/v3/commentThreads

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

Alcance
https://www.googleapis.com/auth/youtube.force-ssl

Parámetros

En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part identifica las propiedades que incluirá la respuesta de la API. Establece el valor del parámetro en snippet. La parte snippet tiene un costo de cuota de 2 unidades.

La siguiente lista contiene los nombres de part que puedes incluir en el valor del parámetro:
  • id
  • replies
  • snippet

Cuerpo de la solicitud

Proporciona un recurso comentarioThread en el cuerpo de la solicitud.

En el caso de ese recurso, debes especificar un valor para las siguientes propiedades:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Respuesta

Si se aplica correctamente, este método muestra un recursocommentThread en el cuerpo de la respuesta.

Errores

En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Para obtener más detalles, consulta la documentación sobre mensajes de error.

Tipo de error Detalle del error Descripción
badRequest (400) channelOrVideoIdMissing Cada conversación de comentarios debe estar vinculada a un video. Asegúrate de que el recurso especifique valores para las propiedades snippet.channelId y snippet.videoId. Un comentario sobre un video aparece en la página de reproducción del video.
badRequest (400) commentTextRequired El recurso comment que se inserta debe especificar un valor para la propiedad snippet.topLevelComment.snippet.textOriginal. Los comentarios no pueden estar vacíos.
badRequest (400) commentTextTooLong El recurso comment que se está insertando contiene demasiados caracteres en la propiedad snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válido.
forbidden (403) forbidden No se pudo crear la conversación de comentarios porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube utilizada para autorizar la solicitud a la API debe combinarse con la cuenta de Google del usuario para insertar un comentario o una conversación de comentarios.
notFound (404) channelNotFound No se pudo encontrar el canal especificado. Verifica el valor de la propiedad snippet.channelId para asegurarte de que sea correcto.
notFound (404) videoNotFound No se pudo encontrar el video especificado. Verifica el valor de la propiedad snippet.videoId para asegurarte de que sea correcto.

Pruébalo

Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.