Jobs

Un recurso job representa un trabajo de informe programado. Un trabajo de informes identifica un informe específico que YouTube genera cada día 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 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 denuncia específico que se programó para un canal o propietario del contenido.
list Enumera 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. Necesita ese ID para recuperar la lista de informes que se generaron para el trabajo o para 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
ID que YouTube utiliza para identificar de forma exclusiva el trabajo de generación de informes. El valor tiene una longitud máxima de 40 caracteres.
reportTypeId string
El tipo de informe que crea el trabajo. El valor de propiedad corresponde al id de un id de un reportType, tal como se recupera del método reportTypes.list.
name string
Nombre que YouTube genera para describir el empleo. El valor tiene una longitud máxima de 100 caracteres.
createTime timestamp
Es 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 "Zulu", con precisión de microsegundos. Ejemplo: "2015-10-02T15:01:23.045678Z".
expireTime timestamp
Es 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 "Zulu", 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 que se generaron para el trabajo no se descargaron por un período prolongado. El valor marca 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 solicitar el informe antes de esa fecha. En algunos casos, es posible que haya un informe de reemplazo 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 de contenido que tienen acceso a los mismos informes en Creator Studio. Los propietarios del contenido no pueden modificar ni borrar los trabajos que crean esos informes.