CommentThreads: insert

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

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 de 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 estas propiedades:

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

  • Puedes establecer los valores de 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. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
badRequest (400) channelOrVideoIdMissing Cada cadena de comentarios debe estar vinculada a un canal o video.
  • Si el comentario se aplica a un canal, asegúrate de que el recurso especificado en el cuerpo de la solicitud proporcione un valor para la propiedad snippet.channelId. Un comentario que se aplica a un canal aparece en la pestaña Debate del canal.
  • Si el comentario se aplica a un video, asegúrate de que el recurso especifique valores para las propiedades snippet.channelId y snippet.videoId. Un comentario que se aplica a 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, por lo general, 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álida.
forbidden (403) forbidden No se pudo crear la conversación 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 de 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. Comprueba el valor de la propiedad snippet.channelId para asegurarte de que sea correcto.
notFound (404) videoNotFound No se pudo encontrar el video especificado. Comprueba el valor de la propiedad snippet.videoId para asegurarte de que sea correcto.

Pruébela.

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