Comments: insert

Crea una respuesta a un comentario existente. Nota: Para crear un comentario de nivel superior, usa el método commentThreads.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/comments

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
  • snippet

Cuerpo de la solicitud

Proporciona un recurso de comentario en el cuerpo de la solicitud. Para ese recurso:

  • Debes especificar un valor para estas propiedades:

    • snippet.textOriginal
    • snippet.parentId

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.textOriginal

Respuesta

Si se aplica correctamente, este método muestra un recurso de comentario 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) commentTextRequired El recurso comment que se inserta debe especificar un valor para la propiedad 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.textOriginal.
badRequest (400) invalidCustomEmoji El recurso comment que se inserta contiene emojis personalizados no válidos.
badRequest (400) invalidCommentMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) operationNotSupported El usuario de la API no puede insertar un comentario en respuesta al comentario de nivel superior identificado por la propiedad snippet.parentId. En un recurso commentThread, la propiedad snippet.canReply indica si el usuario actual puede responder al hilo.
badRequest (400) parentCommentIsPrivate El comentario superior especificado es privado. La API no admite respuestas a comentarios privados.
badRequest (400) parentIdMissing El comentario que se inserta debe estar vinculado a un comentario superior. Sin embargo, el recurso comment en el cuerpo de la solicitud a la API no especificó un valor para la propiedad snippet.parentId.
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 comment en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se puede crear el comentario debido a que no tienes los permisos suficientes. 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 un hilo de comentarios.
notFound (404) parentCommentNotFound No se pudo encontrar el comentario superior especificado. Verifica el valor de la propiedad snippet.parentId en el cuerpo de la solicitud 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.