CommentThreads: insert

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

Impacto en 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 part que puedes incluir en el valor del parámetro:
  • id
  • replies
  • snippet

Cuerpo de la solicitud

Proporciona un recurso commentThread en el cuerpo de la solicitud.

Para 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 recurso commentThread 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 de los mensajes de error.

Tipo de error Detalle del error Descripción
badRequest (400) channelOrVideoIdMissing Cada cadena 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 inserta 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, suele indicar 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álida.
forbidden (403) forbidden No se pudo crear la cadena de comentarios debido a permisos insuficientes. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se usa para autorizar la solicitud a la API debe combinarse con la Cuenta de Google del usuario para insertar un comentario o una cadena 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 el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.