Subscriptions

subscription 리소스에는 YouTube 사용자 구독에 대한 정보가 포함되어 있습니다. 구독정보는 채널에 새 동영상이 추가되거나 다른 사용자가 YouTube에서 동영상 업로드, 동영상 평가 또는 동영상 추천 등의 작업 중 하나를 수행할 때 이를 알려줍니다.

방법

API는 subscriptions 리소스에 다음 메서드를 지원합니다.

list
API 요청 기준과 일치하는 정기 결제 리소스를 반환합니다. 지금 사용해보기
삽입
인증된 사용자의 채널에 구독을 추가합니다. 지금 사용해보기
delete
정기 결제를 삭제합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조는 subscriptions 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

속성

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

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#subscription입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube가 구독을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 제목, 사용자가 구독한 채널 등 구독에 대한 기본 세부정보가 포함되어 있습니다.
snippet.publishedAt datetime
정기 결제가 생성된 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.
snippet.channelTitle string
구독이 속한 채널의 제목입니다.
snippet.title string
정기 결제의 제목입니다.
snippet.description string
정기 결제 세부정보입니다.
snippet.resourceId object
id 객체에는 사용자가 구독한 채널에 대한 정보가 포함되어 있습니다.
snippet.resourceId.kind string
API 리소스의 유형입니다.
snippet.resourceId.channelId string
YouTube가 사용자가 구독하는 채널을 고유하게 식별하는 데 사용하는 값입니다.
snippet.channelId string
YouTube가 구독자의 채널을 고유하게 식별하는 데 사용하는 ID입니다. resource_id 객체는 사용자가 구독한 채널을 식별합니다.
snippet.thumbnails object
정기 결제와 연결된 썸네일 이미지의 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
snippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default – 이 리소스의 기본 썸네일 이미지입니다. 동영상의 기본 썸네일(또는 재생목록 항목 또는 검색결과와 같이 동영상을 참조하는 리소스)은 너비 120픽셀, 높이 90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium: 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 320픽셀, 높이 180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high: 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 480px, 높이 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
snippet.thumbnails.(key).url string
이미지의 URL입니다.
snippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
snippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.
contentDetails object
contentDetails 객체에는 정기 결제에 관한 기본 통계가 포함되어 있습니다.
contentDetails.totalItemCount unsigned integer
정기 결제가 가리키는 대략적인 항목 수입니다.
contentDetails.newItemCount unsigned integer
콘텐츠를 마지막으로 읽은 이후 구독의 새 항목 수입니다.
contentDetails.activityType string
이 구독의 활동 유형입니다 (업로드만 해당, 모두).

이 속성에 유효한 값은 다음과 같습니다.
  • all
  • uploads
subscriberSnippet object
subscriberSnippet 객체에는 구독자에 관한 기본 세부정보가 포함되어 있습니다.
subscriberSnippet.title string
구독자 채널의 제목입니다.
subscriberSnippet.description string
구독자 채널에 대한 설명입니다.
subscriberSnippet.channelId string
YouTube가 구독자의 채널을 고유하게 식별하기 위해 할당하는 ID입니다.
subscriberSnippet.thumbnails object
구독자 채널의 썸네일 이미지입니다.
subscriberSnippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default – 이 리소스의 기본 썸네일 이미지입니다. 동영상의 기본 썸네일(또는 재생목록 항목 또는 검색결과와 같이 동영상을 참조하는 리소스)은 너비 120픽셀, 높이 90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium: 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 320픽셀, 높이 180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high: 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이미지는 너비 480px, 높이 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
subscriberSnippet.thumbnails.(key).url string
이미지의 URL입니다.
subscriberSnippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
subscriberSnippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.