Jobs

Un recurso job representa un trabajo de informes programado. Los trabajos de generación de informes identifican un informe específico que YouTube genera cada día para un propietario de contenido o canal en particular.

Métodos

En la siguiente tabla, se muestran los métodos que la API admite para los recursos job.

Métodos
create Crea un trabajo de informes. Cuando creas un trabajo de informes, le indicas a YouTube que genere ese informe diariamente. El informe está disponible dentro de las 24 horas posteriores a la creación del trabajo.
delete Borra un trabajo de informes.
get Recupera información sobre un trabajo de informes específico que se programó para un canal o propietario de contenido.
list Muestra una lista de los trabajos de informes que se programaron para un canal o propietario del contenido. Cada recurso de la respuesta contiene una propiedad id, que especifica el ID que YouTube utiliza para identificar el trabajo de forma única. Necesitas ese ID para recuperar la lista de informes que se generaron para el trabajo o para borrar el trabajo.

Representación de recursos JSON

La estructura JSON a continuación muestra el formato de un recurso job:

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
id string de
ID que YouTube utiliza para identificar de forma exclusiva el trabajo de informe. El valor tiene una longitud máxima de 40 caracteres.
reportTypeId string de
El tipo de informe que crea el trabajo. El valor de propiedad corresponde al id de un id de una reportType según se recuperó a partir del método reportTypes.list.
name string de
Un nombre que YouTube genera para describir el empleo. El valor tiene una longitud máxima de 100 caracteres.
createTime timestamp de
La fecha y hora en que se creó el trabajo. El valor de la propiedad es una marca de tiempo en RFC3339 UTC "Zulú" con precisión de microsegundos. Ejemplo: "2015-10-02T15:01:23.045678Z".
expireTime timestamp de
Fecha y hora de vencimiento del trabajo. El valor de la propiedad es una marca de tiempo en RFC3339 UTC "Zulú" con precisión de microsegundos. Ejemplo: "2015-10-02T15:01:23.045678Z".

Esta propiedad tiene un valor si el tipo de informe asociado con el trabajo dejó de estar disponible o si los informes generados para el trabajo no se descargaron durante un período prolongado. El valor indica la fecha a partir de la cual YouTube deja de generar informes nuevos para el trabajo.

Si tienes un trabajo que identifica una fecha de vencimiento, debes actualizar tus sistemas para dejar de solicitar el informe antes de esa fecha. En algunos casos, es posible que haya un informe de reemplazo disponible.
systemManaged boolean de
Este valor es true si el trabajo genera informes administrados por el sistema. YouTube genera automáticamente informes administrados por el sistema para los propietarios del contenido de YouTube que tienen acceso a los mismos informes en YouTube Creator Studio. Los propietarios del contenido no pueden modificar ni borrar los trabajos que crean esos informes.