Jobs

job 리소스는 예약된 보고 작업을 나타냅니다. 보고 작업은 YouTube에서 특정 채널 또는 콘텐츠 소유자를 위해 매일 생성하는 특정 보고서를 식별합니다.

메서드

다음 표에서는 API가 job 리소스에 지원하는 메서드를 보여줍니다.

메서드
create 보고 작업을 만듭니다. 보고 작업을 만들면 YouTube에서 매일 보고서를 생성하게 됩니다. 작업 생성 후 24시간 이내에 보고서를 사용할 수 있습니다.
delete 보고 작업을 삭제합니다.
get 채널 또는 콘텐츠 소유자에 대해 예약된 특정 보고 작업에 대한 정보를 검색합니다.
list 채널 또는 콘텐츠 소유자에 대해 예약된 보고 작업을 나열합니다. 응답의 각 리소스에는 YouTube가 작업을 고유하게 식별하는 데 사용하는 ID를 지정하는 id 속성이 포함됩니다. 작업에 대해 생성된 보고서 목록을 검색하거나 작업을 삭제하려면 이 ID가 필요합니다.

JSON 리소스 표현

아래의 JSON 구조는 job 리소스의 형식을 보여줍니다.

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

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
id string
YouTube가 보고 작업을 고유하게 식별하는 데 사용하는 ID입니다. 값의 최대 길이는 40자(영문 기준)입니다.
reportTypeId string
작업에서 만드는 보고서 유형입니다. 속성 값은 reportTypes.list 메서드에서 가져온 reportType id의 id에 해당합니다.
name string
YouTube에서 작업을 설명하기 위해 생성하는 이름입니다. 값의 최대 길이는 100자(영문 기준)입니다.
createTime timestamp
작업이 생성된 날짜 및 시간입니다. 속성 값은 RFC3339 UTC 'Zulu'의 타임스탬프입니다. 마이크로초 단위까지 정확해야 합니다. 예를 들면 "2015-10-02T15:01:23.045678Z"입니다.
expireTime timestamp
작업이 만료되었거나 만료될 날짜 및 시간입니다. 속성 값은 RFC3339 UTC 'Zulu'의 타임스탬프입니다. 마이크로초 단위까지 정확해야 합니다. 예: "2015-10-02T15:01:23.045678Z".

작업과 연결된 보고서 유형이 지원 중단되었거나 작업에 대해 생성된 보고서가 장시간 다운로드되지 않은 경우 이 속성에 값이 포함됩니다. 이 값은 YouTube에서 해당 작업에 대한 새 보고서를 더 이상 생성하지 않는 날짜를 표시합니다.

만료일을 식별하는 작업이 있는 경우 해당 날짜까지 보고서 요청을 중지하도록 시스템을 업데이트해야 합니다. 경우에 따라 대체 보고서가 제공될 수 있습니다.
systemManaged boolean
작업이 시스템 관리 보고서를 생성하는 경우 이 값은 true입니다. YouTube는 YouTube 크리에이터 스튜디오에서 동일한 보고서에 액세스할 수 있는 YouTube 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성합니다. 콘텐츠 소유자는 이러한 보고서를 생성하는 작업을 수정하거나 삭제할 수 없습니다.