구현: 정기 결제

다음 예는 YouTube Data API (v3)를 사용하여 구독과 관련된 기능을 수행하는 방법을 보여줍니다.

채널 구독 검색

subscriptions.list 메서드를 호출하여 특정 채널의 정기 결제를 검색합니다. 채널을 식별하는 방법에는 두 가지가 있습니다.

• 현재 인증된 사용자의 구독을 검색하려면 mine 매개변수의 값을 true로 설정합니다. mine 매개변수를 사용하는 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &mine=true

• 다른 채널의 구독을 검색하려면 channelId 매개변수의 값을 해당 채널의 고유한 YouTube 채널 ID로 설정하세요. 아래 예시는 YouTube의 TED 채널에서 구독한 채널 목록을 검색합니다.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &channelId=UCAuUUnT6oDeKwE6v1NGQxug

  참고: 지정된 채널이 구독을 공개적으로 노출하지 않고 채널 소유자가 요청을 승인하지 않은 경우 API는 403 (Forbidden) HTTP 응답 코드를 반환합니다.

코드 샘플은 subscriptions.list 메서드 문서를 참고하세요.

구독 추가하기

subscriptions.insert 메서드를 호출하여 채널 구독을 추가합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 요청 본문은 다음 값을 설정하는 subscription 리소스입니다.

• snippet.resourceId.kind에는 youtube#channel 값이 포함되어 있습니다.
• snippet.resourceId.channelId 속성은 구독 중인 채널을 식별합니다. 속성 값은 고유한 YouTube 채널 ID입니다. 채널 ID는 channels.list 메서드 호출 또는 채널 검색결과 검색 등 여러 가지 방법으로 얻을 수 있습니다.

아래의 API 요청은 YouTube의 TED 채널을 구독합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

요청 본문은 다음과 같습니다.

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

코드 샘플은 subscriptions.insert 메서드 문서를 참고하세요.

구독 삭제

이 예시에서는 정기 결제를 삭제합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. 이 예시에는 다음 두 단계가 있습니다.

• 1단계: 인증된 사용자 채널의 구독 가져오기

  subscriptions.list 메서드를 호출하여 정기 결제 목록을 검색합니다. 채널의 구독 검색을 위한 위의 예시는 이러한 요청을 하는 방법을 설명합니다.

  API를 호출하는 애플리케이션은 API 응답을 처리하여 각 구독의 ID를 키로 사용하여 구독 목록을 표시할 수 있습니다. 응답에서 각 항목의 id 속성은 해당 정기 결제를 고유하게 식별하는 정기 결제 ID를 식별합니다. 이 값을 사용하여 다음 단계의 목록에서 항목을 삭제합니다.

• 2단계: 정기 결제 삭제하기

  subscriptions.delete 메서드를 호출하여 정기 결제를 삭제합니다. 요청의 id 매개변수를 삭제하려는 정기 결제의 정기 결제 ID로 설정합니다. 이 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

  API 탐색기에서 요청을 완료하려면 id 속성의 값을 설정해야 합니다.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

코드 샘플은 subscriptions.delete 메서드 문서를 참고하세요.

승인된 사용자 채널의 구독자 목록을 가져옵니다.

현재 인증된 사용자의 채널을 구독하는 채널 목록을 가져오려면 subscriptions.list 메서드를 호출하고 mySubscribers 매개변수의 값을 true로 설정합니다. 요청은 OAuth 2.0을 사용하여 승인되어야 합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true