Subscriptions

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

메서드

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

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

리소스 표현

다음 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.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 - 이 리소스의 기본 썸네일 이미지입니다. 동영상 또는 동영상을 참조하는 리소스(예: 재생목록 항목 또는 검색 결과)의 기본 썸네일은 너비 120px, 높이 90px입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 320px이고 높이가 180px입니다. 채널의 경우 이 이미지는 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 - 이 리소스의 기본 썸네일 이미지입니다. 동영상 또는 동영상을 참조하는 리소스(예: 재생목록 항목 또는 검색 결과)의 기본 썸네일은 너비 120px, 높이 90px입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 320px이고 높이가 180px입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 480px이고 높이가 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
subscriberSnippet.thumbnails.(key).url string
이미지의 URL입니다.
subscriberSnippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
subscriberSnippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.