Subscriptions: insert

인증된 사용자 채널에 대한 구독정보를 추가합니다.

할당량 영향: 이 메서드에 대한 호출의 할당량 비용은 50단위입니다.

일반적인 사용 사례

요청

HTTP 요청

POST https://www.googleapis.com/youtube/v3/subscriptions

승인

이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)

범위
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

매개변수

다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.

매개변수
필수 매개변수
part string
part 매개변수는 이 작업에서 두 가지 용도로 사용됩니다. 쓰기 작업이 설정할 속성과 API 응답에 포함할 속성을 식별합니다.

다음 목록에는 매개변수 값에 포함할 수 있는 part 이름이 포함되어 있습니다.
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

요청 본문

요청 본문에 subscription 리소스를 제공합니다. 해당 리소스의 경우:

  • 다음 속성에 값을 지정해야 합니다.

    • snippet.resourceId

  • 다음 속성에 값을 설정할 수 있습니다.

    • snippet.resourceId

응답

성공하는 경우 이 메소드는 응답 본문에 subscription 리소스를 반환합니다.

오류

다음 표에서는 이 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 확인합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.

오류 유형 오류 세부정보 설명
badRequest (400) subscriptionDuplicate 만들려는 구독정보가 이미 존재합니다.
badRequest (400) subscriptionForbidden 최대 구독 수에 도달했습니다.
badRequest (400) subscriptionForbidden 내 채널을 구독하는 기능은 지원되지 않습니다.
badRequest (400) subscriptionForbidden 최근 구독이 너무 많습니다. 몇 시간 후 다시 시도해 보세요.
forbidden (403) subscriptionForbidden 요청이 제대로 인증되지 않았거나 이 채널에서 지원하지 않습니다.
notFound (404) publisherNotFound 요청의 snippet.resourceId 속성으로 지정된 리소스를 찾을 수 없습니다.
notFound (404) subscriberNotFound 요청에서 확인된 구독자를 찾을 수 없습니다.
required (400) publisherRequired 구독 중인 채널을 확인하려면 요청에 지정된 정기 결제 리소스가 snippet.resourceId 속성을 사용해야 합니다.

사용해 보기

APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인하세요.