Activities: insert

YouTube dio de baja la función de boletín de canales, y este método ya no es compatible.

Si quieres obtener más información, consulta el Centro de ayuda de YouTube.

Publica un boletín para un canal específico. (El usuario que envía la solicitud debe estar autorizado para actuar en nombre del canal).

Nota: Aunque un recurso activity puede contener información sobre acciones como la calificación de un video por parte de un usuario o marcar un video como favorito, debes usar otros métodos de API para generar esos recursos activity. Por ejemplo, podrías usar el método videos.rate() de la API para calificar un video y el método playlistItems.insert() para marcar un video como favorito.

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

Solicitud

Solicitud HTTP

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

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
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 tiene dos propósitos en esta operación. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que incluirá la respuesta de la API.

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

Cuerpo de la solicitud

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

  • Debes especificar un valor para estas propiedades:

    • snippet.description

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.description
    • contentDetails.bulletin.resourceId

Respuesta

Si se aplica correctamente, este método muestra un recurso de actividad 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) bulletinTextRequired La solicitud debe usar la propiedad description del objeto snippet para proporcionar el texto de la entrada de boletín.
badRequest (400) invalidMetadata La propiedad kind no coincide con el tipo de ID proporcionado.
forbidden (403) forbidden La solicitud no está debidamente autorizada.
notFound (404) playlistNotFound YouTube no puede encontrar el video que intentas asociar con la entrada de boletín. Verifica el valor de la propiedad contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound YouTube no puede encontrar el video que intentas asociar con la entrada de boletín. Verifica el valor de la propiedad contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded La solicitud no se puede completar porque superaste tu cuota.