Jobs

Un recurso job representa un trabajo de informe programado. Un trabajo de informe identifica un informe específico que YouTube genera todos los días para un canal o propietario de contenido 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 a diario. El informe estará disponible dentro de las 24 horas posteriores a la creación del trabajo.
delete Borra un trabajo de informe.
get Recupera información sobre un trabajo de informe específico que se programó para un canal o propietario del contenido.
list Muestra una lista de los trabajos de informes que se programaron para un canal o propietario del contenido. Cada recurso en la respuesta contiene una propiedad id, que especifica el ID que YouTube usa para identificar el trabajo de manera única. Necesitas ese ID para recuperar la lista de informes que se generaron para el trabajo o borrarlo.

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
El ID que YouTube usa para identificar de manera inequívoca el trabajo de informe. El valor tiene una longitud máxima de 40 caracteres.
reportTypeId string
Es el tipo de informe que crea el trabajo. El valor de la propiedad corresponde al id de un id de un reportType según lo recuperado del método reportTypes.list.
name string
Es el nombre que YouTube genera para describir el trabajo. El valor tiene una longitud máxima de 100 caracteres.
createTime timestamp
La fecha y la hora en que se creó el trabajo. El valor de la propiedad es una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de microsegundos. Ejemplo: "2015-10-02T15:01:23.045678Z".
expireTime timestamp
La fecha y la hora en que el trabajo venció o vencerá. El valor de la propiedad es una marca de tiempo en formato 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 en la que YouTube ya no genera informes nuevos para el trabajo.

Si tienes un trabajo que identifica una fecha de vencimiento, debes actualizar tus sistemas para que dejen de solicitarse el informe antes de esa fecha. En algunos casos, es posible que haya un informe disponible.
systemManaged boolean
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 trabajos que crean esos informes.