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 de 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 que identifica la propiedad snippet.parentId. En un recurso commentThread, la propiedad snippet.canReply indica si el visualizador actual puede responder a la conversación.
badRequest (400) parentCommentIsPrivate El comentario principal especificado es privado. La API no admite respuestas a comentarios privados.
badRequest (400) parentIdMissing El comentario que se inserte debe estar vinculado a un comentario principal. 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, por lo general, indica 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 porque no tienes los permisos necesarios. 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) parentCommentNotFound No se pudo encontrar el comentario principal especificado. Verifica el valor de la propiedad snippet.parentId en el cuerpo de la solicitud 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.