Subscriptions

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

메소드

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

list
API 요청 기준과 일치하는 구독정보 리소스를 반환합니다. 지금 사용해 보세요.
insert
인증된 사용자 채널에 대한 구독정보를 추가합니다. 지금 사용해 보세요.
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(YYYY-MM-DDThh:mm:ss.sZ) 형식으로 지정됩니다.
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 – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 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 – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
subscriberSnippet.thumbnails.(key).url string
이미지의 URL입니다.
subscriberSnippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
subscriberSnippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.