YouTube Content ID API

YouTube Content ID API를 사용하면 연결된 콘텐츠, 참조, 소유권, 권리, 정책과 함께 YouTube 저작물을 관리할 수 있습니다.

서비스: youtubepartner.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

검색 문서

탐색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참고할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 탐색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://youtubepartner.googleapis.com

REST 리소스: assetLabels

메서드
insert POST /youtube/partner/v1/assetLabels
소유자의 저작물 라벨을 삽입합니다.
list GET /youtube/partner/v1/assetLabels
소유자의 모든 저작물 라벨 목록을 가져옵니다.

REST 리소스: assetMatchPolicy

메서드
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
인증된 사용자와 연결된 콘텐츠 소유자가 지정된 애셋에 할당한 동영상 일치 관련 정책을 가져옵니다.
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
저작물의 동영상 일치 관련 정책을 패치합니다.
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
저작물의 동영상 일치 관련 정책을 업데이트합니다.

REST 리소스: assetRelationships

메서드
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
두 애셋 간의 관계를 삭제합니다.
insert POST /youtube/partner/v1/assetRelationships
두 애셋을 연결하는 관계를 만듭니다.
list GET /youtube/partner/v1/assetRelationships
지정된 애셋의 관계 목록을 가져옵니다.

REST 리소스: assetSearch

메서드
list GET /youtube/partner/v1/assetSearch
애셋 메타데이터를 기반으로 애셋을 검색합니다.

REST 리소스: assetShares

메서드
list GET /youtube/partner/v1/assetShares
이 메서드는 파트너가 소유하고 지정된 애셋 뷰 ID에 매핑되는 애셋 공유 목록을 가져오거나 또는 파트너가 소유한 지정된 애셋 공유 ID와 연결된 애셋 뷰 목록을 가져옵니다.

REST 리소스: assets

메서드
get GET /youtube/partner/v1/assets/{assetId}
지정된 애셋의 메타데이터를 검색합니다.
insert POST /youtube/partner/v1/assets
지정된 메타데이터가 있는 애셋을 삽입합니다.
list GET /youtube/partner/v1/assets
저작물 메타데이터를 기반으로 애셋 목록을 가져옵니다.
patch PATCH /youtube/partner/v1/assets/{assetId}
지정된 애셋의 메타데이터에 패치를 적용합니다.
update PUT /youtube/partner/v1/assets/{assetId}
지정된 애셋의 메타데이터를 업데이트합니다.

REST 리소스: campaigns

메서드
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
소유자의 지정된 캠페인을 삭제합니다.
get GET /youtube/partner/v1/campaigns/{campaignId}
소유자의 특정 캠페인을 가져옵니다.
insert POST /youtube/partner/v1/campaigns
지정된 캠페인 데이터를 사용하여 소유자의 새 캠페인을 삽입합니다.
list GET /youtube/partner/v1/campaigns
소유자의 캠페인 목록을 가져옵니다.
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
특정 캠페인의 데이터를 패치합니다.
update PUT /youtube/partner/v1/campaigns/{campaignId}
특정 캠페인의 데이터를 업데이트합니다.

REST 리소스: claimHistory

메서드
get GET /youtube/partner/v1/claimHistory/{claimId}
지정된 클레임의 클레임 기록을 가져옵니다.

REST 리소스: claimSearch

메서드
list GET /youtube/partner/v1/claimSearch
검색 기준과 일치하는 클레임 목록을 가져옵니다.

REST 리소스: claims

메서드
get GET /youtube/partner/v1/claims/{claimId}
ID별로 특정 클레임을 가져옵니다.
insert POST /youtube/partner/v1/claims
소유권 주장을 만듭니다.
list GET /youtube/partner/v1/claims
현재 인증된 사용자와 연결된 콘텐츠 소유자가 관리하는 소유권 주장의 목록을 가져옵니다.
patch PATCH /youtube/partner/v1/claims/{claimId}
정책 또는 상태를 변경하여 기존 소유권 주장에 패치를 적용합니다.
update PUT /youtube/partner/v1/claims/{claimId}
정책 또는 상태를 변경하여 기존 소유권 주장을 업데이트합니다.

REST 리소스: contentOwners

메서드
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
지정된 콘텐츠 소유자에 대한 정보를 가져옵니다.
list GET /youtube/partner/v1/contentOwners
요청 기준과 일치하는 콘텐츠 소유자 목록을 가져옵니다.

REST 리소스: liveCuepoints

메서드
insert POST /youtube/partner/v1/liveCuepoints
라이브 방송에 큐 포인트를 삽입합니다.

REST 리소스: metadataHistory

메서드
list GET /youtube/partner/v1/metadataHistory
데이터를 제공한 콘텐츠 소유자와 관계없이 애셋에 제공된 모든 메타데이터 목록을 가져옵니다.

REST 리소스: musicChangeRequests

메서드
create POST /youtube/partner/v1/music/changeRequests
신곡 또는 트랙에 신고된 음악 변경 요청을 만듭니다.
list GET /youtube/partner/v1/music/changeRequests
발표곡 또는 트랙에 신고된 음악 변경 요청 목록을 가져옵니다.

REST 리소스: musicReleases

메서드
list GET /youtube/partner/v1/music/releases
음악 발매 목록을 가져옵니다.

REST 리소스: musicTracks

메서드
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
음악 트랙 목록을 가져옵니다.

REST 리소스: ownership

메서드
get GET /youtube/partner/v1/assets/{assetId}/ownership
인증된 사용자와 연결된 콘텐츠 소유자가 지정된 애셋에 제공한 소유권 데이터를 가져옵니다.
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
지정된 애셋의 새로운 소유권 정보를 제공합니다.
update PUT /youtube/partner/v1/assets/{assetId}/ownership
지정된 애셋의 새로운 소유권 정보를 제공합니다.

REST 리소스: ownershipHistory

메서드
list GET /youtube/partner/v1/ownershipHistory
데이터를 제공한 콘텐츠 소유자와 관계없이 애셋의 소유권 데이터 목록을 가져옵니다.

REST 리소스: package

메서드
get GET /youtube/partner/v1/package/{packageId}
지정된 패키지의 정보를 가져옵니다.
insert POST /youtube/partner/v1/package
메타데이터 전용 패키지를 삽입합니다.

REST 리소스: policies

메서드
get GET /youtube/partner/v1/policies/{policyId}
지정된 저장된 정책을 검색합니다.
insert POST /youtube/partner/v1/policies
저장된 정책을 만듭니다.
list GET /youtube/partner/v1/policies
콘텐츠 소유자의 저장된 정책 목록을 가져옵니다.
patch PATCH /youtube/partner/v1/policies/{policyId}
지정된 저장된 정책을 패치합니다.
update PUT /youtube/partner/v1/policies/{policyId}
지정된 저장된 정책을 업데이트합니다.

REST 리소스: referenceConflicts

메서드
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
지정된 참조 충돌에 대한 정보를 가져옵니다.
list GET /youtube/partner/v1/referenceConflicts
해결되지 않은 참조 충돌 목록을 가져옵니다.

REST 리소스: references

메서드
get GET /youtube/partner/v1/references/{referenceId}
지정된 참조에 대한 정보를 가져옵니다.
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references

다음 방법 중 하나로 참조를 만듭니다.

  • 참조 파일 업로드를 요청하는 경우 YouTube는 제공된 콘텐츠를 기반으로 참조를 만듭니다.
list GET /youtube/partner/v1/references
ID별 참조 목록 또는 지정된 애셋의 참조 목록을 가져옵니다.
patch PATCH /youtube/partner/v1/references/{referenceId}
참조에 패치를 적용합니다.
update PUT /youtube/partner/v1/references/{referenceId}
참조를 업데이트합니다.

REST 리소스: spreadsheetTemplate

메서드
list GET /youtube/partner/v1/spreadsheetTemplate
콘텐츠 소유자의 스프레드시트 템플릿 목록을 가져옵니다.

REST 리소스: uploader

메서드
list GET /youtube/partner/v1/uploader
콘텐츠 소유자의 업로더 목록을 가져옵니다.

REST 리소스: validator

메서드
validate POST /youtube/partner/v1/validator
메타데이터 파일의 유효성을 검사합니다.
validateAsync POST /youtube/partner/v1/validatorAsync
메타데이터 파일을 비동기적으로 검사합니다.
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
비동기 유효성 검사 상태를 가져옵니다.

REST 리소스: videoAdvertisingOptions

메서드
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
지정된 동영상의 광고 설정을 가져옵니다.
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
지정된 파트너 또는 사용자 업로드 동영상에 허용된 광고 유형에 관한 세부정보를 가져옵니다.
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
지정된 동영상의 광고 설정을 패치합니다.
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
지정된 동영상의 광고 설정을 업데이트합니다.

REST 리소스: whitelists

메서드
delete DELETE /youtube/partner/v1/whitelists/{id}
콘텐츠 소유자의 허용 목록에 있는 채널을 삭제합니다.
get GET /youtube/partner/v1/whitelists/{id}
ID로 특정 허용 목록 채널을 가져옵니다.
insert POST /youtube/partner/v1/whitelists
콘텐츠 소유자의 YouTube 채널을 허용 목록에 추가합니다.
list GET /youtube/partner/v1/whitelists
콘텐츠 소유자의 허용 목록에 추가된 채널 목록을 가져옵니다.