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 메서드에서 가져온 reportTypeidid에 상응합니다.
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 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성합니다. 콘텐츠 소유자는 이러한 보고서를 생성하는 작업을 수정하거나 삭제할 수 없습니다.