YouTube Content ID API - 업데이트 기록

참고: YouTube Content ID API는 YouTube 콘텐츠 파트너가 사용하도록 설계되었으며 모든 개발자 또는 모든 YouTube 사용자가 액세스할 수 있는 것은 아닙니다. Google API 콘솔에 표시된 서비스 중 YouTube Content ID API가 표시되지 않으면 YouTube 고객센터에서 YouTube 파트너 프로그램에 관해 자세히 알아보세요.

이 페이지에는 YouTube Content ID API 변경사항 및 문서 업데이트가 표시됩니다.

2025년 3월 26일

2025년 3월 31일부터 Shorts 동영상의 조회수 집계 방식이 변경됩니다. 이전에는 Shorts 동영상이 일정 시간 재생된 후에 조회수가 집계되었습니다. 이제 최소 시청 시간 요건 없이 Shorts 동영상의 재생 또는 다시보기가 시작되는 횟수가 Shorts 조회수로 집계됩니다. 자세히 알아보기

2025년 6월 30일까지 Content ID API는 이번 변경사항에 따라 다음과 같이 업데이트됩니다.

• claimSearch.list.sort의 정렬 순서가 업데이트됩니다.
  • 이전 조회수 집계 방식에 따라 일일 조회수에 DAILY_ENGAGED_VIEWS가 추가됩니다.
  • 이전 조회수 집계 방법에 따라 LIFETIME_ENGAGED_VIEWS가 전체 조회수에 추가됩니다.
• assetSearch.list.sort의 정렬 순서가 업데이트됩니다.
  • 이전 조회수 집계 방식에 따라 일일 조회수에 DAILY_ENGAGED_VIEWS가 추가됩니다.

2025년 9월 30일까지 Content ID API는 이번 변경사항에 따라 다음과 같이 업데이트됩니다.

• assetSearch.list.sort 정렬 순서 VIEWS가 지원 중단됩니다.
• claimSearch.list.sort 정렬 순서 VIEW_COUNT가 지원 중단됩니다.
• claimSearch.claimSnippet.videoViews는 Shorts 동영상 조회수의 업데이트된 조회수 집계 방식을 반영하도록 업데이트됩니다.
• 이전 조회수 집계 방법에 따라 조회수에 claimSearch.claimSnippet.engagedViews가 추가됩니다.

2025년 1월 14일

이제 ad_breaks와 autoGeneratedBreaks를 동시에 제공할 수 있으므로 videoAdvertisingOption 리소스의 autoGeneratedBreaks[] 필드가 업데이트되었습니다. adBreaks가 정의된 동영상에서 autoGeneratedBreaks가 true로 설정되면 YouTube 시스템에서 수동으로 배치한 광고 슬롯 외에도 광고를 게재할 위치를 식별합니다. 자세한 내용은 지원 도움말을 참고하세요.

2023년 11월 10일

videoAdvertisingOption 리소스의 adFormats[] 필드가 업데이트되어 third_party가 이 필드의 유일한 유효한 값이 되었습니다. instream_trueview, instream_standard, display, preroll, postroll 광고 형식은 더 이상 지원되지 않습니다. 자세한 내용은 지원 도움말을 참고하세요.

2023년 6월 1일

참고: 지원 중단 공지사항입니다.

이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.

• 기존 리소스 및 메서드 업데이트

  • videoAdvertisingOption 리소스의 breakPosition[] 필드는 지원 중단된 것으로 표시되었으며 2024년에 삭제될 예정입니다.
    videoAdvertisingOptions.update 및 videoAdvertisingOptions.patch 메서드는 이미 필드를 무시합니다.
  • 지원 중단된 videoAdvertisingOption 리소스의 adBreaks[].slot[] 필드가 삭제되었습니다.
  • 지원 중단된 asset 리소스의 category 및 showCustomId 필드가 삭제되었습니다.
  • 새 claim 리소스의 timeStatusLastModified 필드는 소유권 주장이 마지막으로 수정된 시간을 보고합니다.
  • 새로운 claimSearch.list 메서드의 isVideoShortsEligible 매개변수를 사용하여 소유권 주장이 제기된 동영상을 YouTube Shorts 자격요건을 기준으로 필터링할 수 있습니다.

• 새로운 리소스 및 메서드

  • 이제 API에서 YouTube Music 리소스 목록을 지원합니다.
    • musicRelease 리소스는 musicReleases.list 메서드를 사용하여 나열할 수 있습니다.
    • musicTrack 리소스는 musicTracks.list 메서드를 사용하여 나열할 수 있습니다.
    • musicChangeRequest 리소스는 musicChangeRequests.list 메서드를 사용하여 나열할 수 있습니다.

2022년 12월 20일

assetSearch.list 메서드의 ownershipRestriction 쿼리 매개변수 정의가 업데이트되어 이 매개변수의 값이 none인 경우 metadataSearchFields 매개변수 값도 하나 이상의 ID 필터를 사용해야 함을 명확히 했습니다. 이 문서 변경사항은 API 동작의 변경사항을 반영하지 않습니다.

2022년 11월 9일

다음에 대해 여러 값이 지원되는 방식을 명확히 하기 위해 asset.get 및 asset.list 메서드의 문서가 업데이트되었습니다.

• fetchMatchPolicy(가져오기, 목록)
• fetchMetadata(가져오기, 목록)
• fetchOwnership(가져오기, 목록)

2022년 9월 28일

라이선스 구매 가능 여부 정보가 asset resource에 추가되었습니다.

2022년 7월 18일

YouTube 스튜디오와의 일관성을 개선하기 위해 claimSearch.list 메서드의 inactiveReasons 문서가 업데이트되었습니다.

• 이전에 스튜디오에서 Audio Swap 및 Song Erase 지원을 삭제했습니다. 상응하는 API 값인 audio_removed 및 song_erased는 자동으로 무시되었으며 이제 문서화되지 않았습니다.
• channel_whitelisted를 channel_allowlisted로 대체했습니다. 이전 값은 더 이상 문서화되지 않지만 계속 지원됩니다.
• 이제 closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced, video_modified 값이 지원됩니다.

2021년 6월 14일

assetSearch 리소스 문서가 두 가지 새로운 속성인 isrcs[] 및 iswcs[]을 반영하도록 업데이트되었습니다. 새 isrcs[] 및 iswcs[] 속성 값에는 각각 검색 결과에서 식별된 저작물에 매핑되는 ISRC 또는 ISWC를 지정하는 각 값이 포함된 문자열 값 배열이 포함됩니다.

새 속성은 더 정확한 데이터를 제공하므로 assetSearch 리소스에 이미 포함된 isrc 및 iswc 속성보다 권장됩니다. 새 속성은 문자열 값 배열을 나열할 수 있지만 isrc 및 iswc 속성은 검색 결과와 연결된 ISRC 또는 ISWC 코드 하나만 식별합니다.

2022년 5월 12일

클라이언트 라이브러리 링크가 표준 Google API 클라이언트 라이브러리를 가리키도록 업데이트되었습니다. PHP용으로 사전 생성된 바인딩이 업데이트되었습니다.

2022년 5월 3일

이제 claimSearch.list 메서드의 status 매개변수가 잠재적 소유권 주장 세부정보를 기반으로 더 많은 필터를 지원합니다.

2022년 5월 2일

assetSearch.list 메서드의 응답에 관한 문서가 AIP-158과의 일관성을 개선하기 위한 업데이트를 반영하도록 업데이트되었습니다.

• pageInfo.totalResults의 설명에 값이 실제 값이 아닌 추정치임을 명시적으로 언급합니다.
• pageInfo.resultsPerPage 및 pageInfo.startIndex 필드가 삭제되었습니다.

2022년 4월 25일

labelPrefix 및 q 요청 매개변수의 의미를 명확히 하고 요청 / 응답이 페이징을 지원한다고 문서화하기 위해 assetLabels.list 리소스의 문서가 업데이트되었습니다.

2021년 12월 8일

이 메서드에서 다루는 두 가지 사용 사례를 적절하게 반영하도록 claimSearch.list 리소스의 문서가 업데이트되었습니다.

• ID (저작물, 참조 또는 동영상) 또는 검색 문자열로 검색
• 소유권 주장 생성일, 수정일 또는 상태로 검색

각 사용 사례는 서로 다른 쿼리 매개변수 집합을 지원합니다. 각 사용 사례에 지원되는 매개변수를 설명하도록 claimSearch.list 메서드 문서가 업데이트되었습니다.

2021년 11월 17일

이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.

• 이제 claims.update 메서드에서 비활성 또는 잠재적 소유권 주장의 상태를 active로 업데이트하는 기능을 지원합니다. claim 리소스의 status 속성 정의에서 자세한 내용을 확인할 수 있습니다.
• 소유권 주장과 관련된 YouTube 스튜디오 페이지 링크가 포함된 새 studioInfo 객체가 추가됨에 따라 claim 및 claimSearch 리소스의 문서가 업데이트되었습니다.
• claimSearch.list 메서드의 origin 매개변수에 지원되는 값 목록이 변경되었습니다. 이제 이 매개변수는 batchTool, inProductShorts, melodyMatch, youTubeAdmin의 네 가지 값을 추가로 지원합니다. 또한 dropboxUpload 및 webUpload 값은 더 이상 지원되지 않습니다.

2021년 2월 26일

이제 claimSearch.list 메서드의 videoId 매개변수 문서가 업데이트되어 매개변수 값이 쉼표로 구분된 동영상 ID를 최대 10개까지 허용한다고 명시되었습니다. 값에 동영상 ID가 10개를 초과하면 API는 badRequest 오류(400 HTTP 응답 코드)를 반환합니다.

2018년 12월 6일

참고: 지원 중단 공지사항입니다.

contentOwnerAdvertisingOptions 리소스 및 메서드에 대한 참조를 삭제하도록 API 문서가 업데이트되었습니다. 이러한 메서드는 거의 사용되지 않았으며 이를 사용한 API 사용자에게는 이 발표 전에 별도로 연락을 취했습니다.

2018년 3월 21일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 이제 뮤직비디오 또는 음원 저작물을 삽입, 업데이트 또는 패치할 때마다 metadataMine.artist 속성을 설정해야 합니다. 이제 이러한 리소스 유형에 속성이 설정되지 않은 경우 API가 오류를 반환합니다. 또한 metadataMine.artist 속성은 뮤직비디오 및 음원 아티스트에게만 지원됩니다.

2017년 7월 24일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새 package 리소스는 웹, SFTP 또는 기타 전송 메커니즘을 통해 전송된 파일 그룹을 나타냅니다. 이 API는 이 리소스에 대해 두 가지 메서드를 지원합니다.

  • package.insert 메서드는 메타데이터 파일이 정확히 1개 포함된 메타데이터 전용 패키지를 검증하고 업로드합니다.
  • package.get 메서드는 이전에 업로드된 패키지에 관한 정보를 검색합니다.

• validator.validate 메서드의 경우 uploaderName 속성의 정의가 업데이트되어 값이 데이터를 업로드하는 콘텐츠 파트너가 아니라 콘텐츠 소유자가 사용하는 특정 업로더 계정을 식별하는 web-google 또는 yt-google과 같은 값을 나타낸다는 점을 명시했습니다.

• reference 리소스의 status 속성은 더 이상 값 duplicate_on_hold를 사용하여 참조가 다른 참조의 중복임을 나타내지 않습니다. 대신 참조가 중복된 경우 status 속성의 값이 inactive로 설정되고 statusReason 속성의 값은 REASON_DUPLICATE_FOR_OWNERS로 설정됩니다.

  하지만 이전과 마찬가지로 리소스의 duplicateLeader 속성은 참조가 중복인 경우에만 채워집니다. 이 속성이 설정된 경우 해당 속성의 값은 중복된 참조를 식별합니다.

2017년 4월 17일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 컴포지션 애셋과만 관련된 새 assetShare 리소스는 애셋 리소스의 두 표현 간의 관계를 식별합니다. 이러한 표현은 권리와 음원 저작물의 관련성을 보다 투명하게 파악하고 관리할 수 있도록 설계된 새로운 게시 데이터 모델을 반영합니다.

  새 모델에서는 각 음원이 음악작품 뷰라고 하는 고유한 저작물 하나에 매핑됩니다. 저작물의 메타데이터는 YouTube에서 특정 녹음 파일과 연결된 음악작품 권리에 관해 표시하는 표준 정보 집합을 나타내며 여러 데이터 제공업체의 정보를 종합할 수 있습니다.

  또한 각 음악작품 소유자는 자체 음악작품 공유 저작물을 갖습니다. 음악작품 공유는 특정 게시자가 음악작품 저작물에 대해 제공한 정보를 나타냅니다. 음악작품 공유는 여러 음원과 연결될 수 있습니다.

  assetShare 리소스는 컴포지션 뷰와 컴포지션 공유 간의 관계를 식별합니다. 새 assetShares.list 메서드를 사용하면 다음 중 하나를 실행할 수 있습니다.

  • 음악작품 뷰의 ID를 제공하고 요청을 승인한 파트너가 소유한 해당 음악작품 공유(있는 경우)를 검색합니다.
  • 콘텐츠 파트너가 소유한 음악작품 공유의 ID를 제공하고 해당 공유가 연결된 모든 음악작품 뷰 목록을 검색합니다.

• 새로운 음악작품 저작물 관리 가이드에서는 이러한 메서드에 제출된 저작물 ID가 음악작품 뷰인지 음악작품 공유인지에 따라 다양한 API 메서드가 요청을 처리하는 방법을 설명합니다.

• contentOwnerAdvertisingOptions 리소스의 새 claimedVideoOptions.autoGeneratedBreaks 속성은 YouTube에서 소유권 주장이 제기된 10분이 넘는 동영상에 광고 시점을 자동으로 생성해야 하는지 여부를 나타냅니다. 이 속성은 길이가 10분이 넘는 콘텐츠 소유자의 모든 동영상에 영향을 미치지만, 동영상에 여러 소유권 주장이 제기된 경우 동영상에 대한 소유권 주장을 제기한 첫 번째 파트너가 해당 동영상과 관련하여 이 속성의 기본 동작을 설정합니다.

2016년 8월 11일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• YouTube 엔지니어링 및 개발자 블로그에서 자세히 설명하는 새로 게시된 YouTube API 서비스 약관 ('업데이트된 약관')은 현재 서비스 약관에 대한 다양한 업데이트를 제공합니다. 2017년 2월 10일부터 적용되는 업데이트된 약관 외에도 이번 업데이트에는 개발자가 준수해야 하는 정책을 설명하는 데 도움이 되는 여러 증빙 서류가 포함되어 있습니다.

  새로운 문서의 전체 세트는 업데이트된 약관의 버전 기록에 설명되어 있습니다. 또한 향후 업데이트된 약관 또는 관련 증빙 서류가 변경되면 해당 버전 기록에 설명이 제공됩니다. 문서의 링크에서 해당 버전 기록의 변경사항을 나열하는 RSS 피드를 구독할 수 있습니다.

2016년 5월 31일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새로운 리소스 및 메서드

  • 새 validator.validate 메서드를 사용하면 메타데이터 파일에 YouTube에서 메타데이터를 성공적으로 처리하지 못하도록 하는 유효성 검사 오류가 포함되어 있는지 확인할 수 있습니다. 파일에 오류가 있는 경우 API 응답의 errors 속성에는 각 오류의 심각도, 원인, 위치를 식별하는 유효성 검사 오류 목록이 포함됩니다.

• 신규 및 업데이트된 오류

  • 이제 assets.patch 및 assets.update 메서드에서 다음 오류를 지원합니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 지원할 수 있습니다. 발생 가능한 오류의 전체 목록은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

    오류
    invalidValue (400)	parameters.assetId 업데이트 중인 저작물이 다른 저작물과 병합되어 요청이 실패했습니다. 오류 메시지에서 반환된 저작물 ID를 assetId 매개변수의 값으로 사용하여 요청을 다시 제출합니다.

2016년 3월 28일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 기존 리소스 및 메서드 업데이트

  • claim 리소스의 새 matchInfo.matchSegments[] 속성에는 각 항목이 참조 동영상의 일부와 일치하는 소유권 주장이 제기된 동영상의 세그먼트를 설명하는 목록이 포함됩니다. 소유권 주장에는 여러 개의 일치 세그먼트가 있을 수 있습니다. 예를 들어 업로드된 동영상의 오디오 및 동영상 콘텐츠가 참조 동영상의 콘텐츠와 일치하는 경우 일치 세그먼트가 2개가 됩니다. 한 세그먼트는 오디오 일치를 설명하고 다른 세그먼트는 동영상 일치를 설명합니다.

    일치하는 각 세그먼트의 경우 API는 일치하는 콘텐츠의 길이와 유형 (오디오 또는 동영상)을 반환합니다. 또한 API는 소유권 주장이 제기된 동영상과 참조 동영상에서 각 일치 세그먼트가 시작되고 종료되는 시간 오프셋을 식별합니다.

  • 이제 contentOwnerAdvertisingOptions.patch 또는 contentOwnerAdvertisingOptions.update 메서드를 호출할 때 contentOwnerAdvertisingOptions 리소스의 claimedVideoOptions.newVideoDefaults[] 속성 값을 업데이트할 수 있습니다.

  • contentOwnerAdvertisingOptions 리소스의 읽기 전용 allowedOptions.autoGeneratedBreaks 속성이 지원 중단되었습니다.

• 신규 및 업데이트된 오류

  • 이제 API의 claims.update 메서드에서 다음 오류를 지원합니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 지원할 수 있습니다. 발생 가능한 오류의 전체 목록은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

    오류
    badRequest (400)	alreadyClaimed 소유권 주장이 다른 기존 소유권 주장과 중복되며 업데이트할 수 없습니다.

  • assets.list 메서드는 때때로 제한 시간 초과되어 500 HTTP 응답 코드 (Internal Server Error)를 반환합니다. 특히 요청에서 여러 애셋의 데이터를 검색하고 fetchMatchPolicy 매개변수의 값이 effective인 경우 그렇습니다. assets.list 요청에서 여러 확장 소재 ID를 지정하고 500 오류를 반환하는 경우 단일 확장 소재 또는 더 적은 수의 확장 소재에 대한 요청을 다시 제출해 보세요.

  • 요청에서 손상된 참조 파일을 업로드하면 참조 자체가 처리될 때까지 이 문제가 식별되지 않는다는 내용을 포함하도록 references.insert 오류 문서가 업데이트되었습니다. 따라서 references.insert 요청이 성공적인 응답을 반환하더라도 참조가 성공적으로 처리되지 않을 수 있습니다. 참조를 삽입한 후 references.list 메서드를 사용하여 폴링하여 참조가 예상대로 활성화되었는지 확인하는 것이 좋습니다.

2016년 2월 3일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 기존 리소스 및 메서드 업데이트

  • 이제 API에서 제품 등록정보 광고를 지원합니다. 제품 등록정보 광고는 동영상 콘텐츠와 관련이 있거나 동영상에 등장하는 제품을 강조 표시합니다. 이러한 광고는 동영상 재생 중에 표시되는 스폰서 카드입니다. 카드는 광고 시스템에 의해 자동으로 추가됩니다. 시청자는 몇 초 동안 카드의 티저를 보게 되며 동영상 오른쪽 상단의 아이콘을 클릭하여 동영상의 카드를 탐색할 수도 있습니다.

    이 변경사항으로 인해 이제 product_listing를 다음 속성 값에 포함할 수 있습니다.

    리소스/API 메서드	속성
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • assetSearch.list 메서드의 새 createdBefore 및 createdAfter는 API에 특정 날짜 전후에 생성된 애셋만 반환하도록 지시합니다.

  • assetSearch.list 요청에 대한 API 응답에서 type 속성이 이제 art_track_video 값을 지원합니다. YouTube 고객센터에서 아트 트랙 동영상에 대해 자세히 알아보세요.

  • claimSearch.list 메서드는 다음과 같은 새 매개변수를 지원합니다.

    매개변수
    referenceId	이 필터 매개변수는 소유권 주장을 검색하는 참조의 YouTube 참조 ID를 지정합니다.
    inactiveReasons	이 선택적 매개변수를 사용하면 소유권 주장이 비활성화된 지정된 이유에 따라 비활성 소유권 주장만 포함하도록 API 응답을 제한할 수 있습니다. 매개변수 정의에는 검색할 수 있는 비활성 소유권 주장 유형이 나열됩니다.
    partnerUploaded	이 선택적 불리언 매개변수를 사용하면 API 응답에 파트너가 업로드한 소유권 주장 또는 파트너가 업로드하지 않은 소유권 주장만 포함되어야 한다고 지정할 수 있습니다.

  • reference 리소스의 새 references#origination 객체에는 참조 소스를 설명하는 정보가 포함되어 있습니다.

  • 이제 references.insert 메서드에서 YouTube의 gfp_gen 소프트웨어를 사용하여 생성된 참조를 업로드하는 기능을 지원합니다. 사전 생성된 지문을 제공하는 경우 업로드된 reference 리소스에서 fpDirect 속성 값을 true로 설정합니다.

    이 변경사항으로 인해 참조를 업로드할 때 fpDirect 속성을 설정하려고 하면 API에서 더 이상 오류가 반환되지 않습니다.

• 신규 및 업데이트된 오류

  이제 문서에 whitelist 리소스 메서드에서 반환하는 오류가 나열됩니다.

  또한 다음 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다. 자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  오류
  badRequest (400)	inappropriateCampaignTarget 캠페인에서 일부 사용자에게 부적절할 수 있는 동영상을 표시하려고 하면 campaigns.insert 및 campaigns.update 메서드에서 이 오류를 반환합니다. 이 오류를 해결하려면 다른 콘텐츠를 선택하세요.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets 음악작품 또는 음원 저작물로 파트너가 업로드한 소유권 주장을 만들려고 하면 claims.insert 메서드에서 이 오류를 반환합니다.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim 지정된 동영상에 녹음된 음악에 대한 소유권 주장이 이미 있는 경우 claims.insert 메서드에서 이 오류를 반환합니다. API를 통해 직접 작곡자 표시를 추가할 수는 없습니다.
  badRequest (400)	asset_id 요청에서 파일을 통해 참조를 만들려고 했지만 요청에 assetId가 지정되지 않은 경우 references.insert 메서드에서 이 오류를 반환합니다.
  badRequest (400)	canNotBeActivated 참조의 상태 또는 소유권 조건으로 인해 참조를 활성화할 수 없는 경우 references.update 메서드가 이 오류를 반환합니다.
  badRequest (400)	videoNotClaimed 광고 옵션을 검색하려는 동영상에 대한 소유권을 주장하지 않아 요청된 정보를 사용할 수 없는 경우 videoAdvertisingOptions.get 메서드가 이 오류를 반환합니다.

2015년 12월 18일

유럽연합 (EU) 법규에 따라 EU의 최종 사용자에게 특정 정보 공개 문구를 제공하고 동의를 얻어야 합니다. 따라서 유럽연합(EU)의 최종 사용자의 경우 EU 사용자 동의 정책을 준수해야 합니다. YouTube API 서비스 약관에 이 요구사항에 관한 알림이 추가되었습니다.

2015년 4월 21일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새 campaign 리소스는 특정 콘텐츠 소유자 캠페인을 나타내며, 이를 통해 콘텐츠 소유자는 주석을 사용하여 소유권 주장이 제기된 사용자 업로드 동영상에서 콘텐츠를 홍보할 수 있습니다. 예를 들어 콘텐츠 소유자는 소유한 영화의 장면이 포함된 사용자 업로드 동영상에 대해 소유권을 주장하는 동영상의 경우 영화 보기 페이지로 연결되는 링크를 추가하는 캠페인을 만들 수 있습니다.

  이 API는 get, list, insert, update, patch, delete campaign 리소스에 대한 메서드를 지원합니다.

• API는 새 campaigns.get, campaigns.insert, campaigns.update, campaigns.delete 메서드에 여러 가지 새로운 오류를 지원합니다.

2015년 3월 30일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 기존 리소스 및 메서드 업데이트

  • assetSearch.list 메서드의 새로운 isrcs 매개변수를 사용하면 최대 50개의 ISRC 목록을 지정할 수 있습니다. API 응답에는 이러한 ISRC와 연결된 저작물이 포함됩니다.

  • claimHistory 리소스의 event[].reason 속성은 다음과 같은 새 값을 지원합니다. 각 이유에는 소유권 주장과 관련된 특정 이벤트가 발생한 이유가 설명되어 있습니다.

    • closed_audio_claim_on_visual_reference
    • closed_partner_exclusion
    • closed_reference_conflict

  • claimSearch.list 메서드의 새 sort 매개변수는 API 응답에서 리소스를 정렬하는 데 사용되는 메서드를 지정합니다. 기본적으로 리소스는 생성된 날짜를 기준으로 시간순 (최신순)으로 정렬됩니다. 소유권 주장이 제기된 콘텐츠의 조회수가 가장 많은 리소스부터 가장 적은 리소스 순으로 정렬할 수도 있습니다.

    claimSearch.list 요청에서 status 매개변수 값을 appealed, disputed, pending, potential 또는 routedForReview로 설정하는 경우 결과는 소유권 주장 검토 기간이 만료되는 시간순으로 정렬됩니다.

  • 이제 ownership.update 및 ownership.patch 메서드를 호출할 때 업데이트할 수 있는 모든 속성이 올바르게 표시됩니다. 이 변경사항은 API 문서 수정사항을 나타내며 API 기능 변경사항을 나타내지 않습니다.

  • 이제 assets.get 및 assets.list 메서드의 fetchMatchPolicy 매개변수에 지원되는 값으로 effective이 표시됩니다. 이 값은 API 서버에 YouTube가 저작물에 적용하는 동영상 일치 관련 정책을 검색하도록 지시합니다.

  • 이제 assets.list, claims.list, contentOwners.list, policies.list, publishers.list, references.list 메서드의 id 매개변수에서 매개변수 값에 쉼표로 구분된 ID를 최대 50개까지 포함할 수 있다고 모두 명시합니다.

• 신규 및 업데이트된 오류

  아래 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다.

  자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  오류 유형	오류 세부정보	설명
  badRequest (400)	tooManyIsrcs	isrcs 매개변수가 50개가 넘는 ISRC를 지정하면 assetSearch.list 메서드가 이 오류를 반환합니다.
  badRequest (400)	videoIsPrivate	비공개 동영상의 소유권을 주장하려고 하면 claims.insert 메서드에서 이 오류를 반환합니다. 공개 상태가 public 또는 unlisted인 동영상에 대해서만 소유권 주장을 제기할 수 있습니다.
  notModified (304)	blockOutsideOwnershipUnchanged	소유권 주장의 blockOutsideOwnership 플래그가 수정되지 않은 경우 claims.update 메서드는 이 오류를 반환합니다. 이 오류가 발생하는 이유는 여러 가지가 있습니다. 일반적인 예로는 지정된 수정사항이 소유권 주장이 제기된 동영상에 영향을 미치지 않는 경우를 들 수 있습니다.

2014년 11월 7일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 기존 리소스 및 메서드 업데이트

  • 이제 claimSearch.list 메서드의 status 매개변수가 routedForReview 값을 지원합니다. 이 값은 저작물의 동영상 일치 관련 정책에 있는 규칙에 따라 직접 검토가 필요한 소유권 주장으로 결과를 제한합니다.

  • claimHistory 리소스의 event[].reason 속성은 다음과 같은 새 값을 지원합니다. 각 이유에는 소유권 주장과 관련된 특정 이벤트가 발생한 이유가 설명되어 있습니다.

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • 소유권 주장의 출처를 식별하는 claim 리소스의 origin.source 속성은 이제 melodyMatch 값을 지원합니다. 멜로디 일치 소유권 주장은 소유권 주장이 제기된 동영상이 참조와 음악작품을 공유함을 나타냅니다.

  • API가 이 메서드에 두 가지 엔드포인트를 사용한다는 점을 적절하게 반영하도록 references.insert 메서드 문서가 업데이트되었습니다. 이는 API 기능의 변경사항이 아니라 기존 문서가 수정된 것입니다.

    • 요청이 새 참조 파일을 업로드하는 경우 올바른 엔드포인트는 다음과 같습니다.

      POST https://www.googleapis.com/upload/youtube/partner/v1/references

    • 소유권 주장이 제기된 동영상을 참조 콘텐츠로 사용하여 참조를 만들려는 요청인 경우 올바른 엔드포인트는 다음과 같습니다.

      POST https://www.googleapis.com/youtube/partner/v1/references

• 신규 및 업데이트된 오류

  아래 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다.

  자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  오류 유형	오류 세부정보	설명
  badRequest (400)	invalidLabelName	애셋 라벨의 이름이 잘못된 경우 assets.insert, assets.update, assetLabels.insert 메서드는 이 오류를 반환합니다. 라벨 이름은 2~30자 사이여야 합니다. 꺾쇠 괄호, 쉼표, 콜론, 앰퍼샌드 또는 세로 선 문자 (|)는 포함할 수 없습니다.
  badRequest (400)	ownerHaveMaximumNumberOfLabels	콘텐츠 소유자가 현재 허용되는 최대 개수인 고유 저작물 라벨 2, 500개를 이미 정의한 경우 assets.insert, assets.update, assetLabels.insert 메서드가 이 오류를 반환합니다.
  badRequest (400)	tooManyLabelsOnOneAsset	저작물이 현재 허용되는 최대 개수인 30개의 저작물 라벨과 이미 연결된 경우 assets.insert 및 assets.update 메서드는 이 오류를 반환합니다.
  badRequest (400)	channelMonetizationSuspended	claims.insert 및 claims.update 메서드는 파트너의 소유권 주장으로 인해 동영상의 채널이 정지된 경우 이 오류를 반환합니다.
  badRequest (400)	channelNotActive	동영상의 채널이 활성 상태가 아니면 claims.update 메서드가 이 오류를 반환합니다.

• 요청 본문의 리소스에 metadataMine.contentType 속성이 포함되지 않은 경우 assets.insert 및 assets.update 메서드가 더 이상 일부 애셋에 badRequest 오류를 반환하지 않습니다.

2014년 9월 23일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 콘텐츠 소유자 ID 변경사항

  2014년 7월 9일의 수정 내역에서 발표된 콘텐츠 소유자 ID 변경사항이 적용되었습니다. 이번 변경으로 인해 API는 이제 생성된 고유 ID를 반환하여 인증된 사용자 또는 API를 통해 관리되는 리소스와 연결된 콘텐츠 소유자를 식별합니다. 이전에는 API가 'qrs_network'와 같이 사람이 읽을 수 있는 이름을 ID로 반환했습니다.

  이 변경사항은 다음 API 기능에 영향을 미치며 애플리케이션에 파트너 코드를 하드코딩한 파트너에게 영향을 미칠 수 있습니다.

  • 이제 API는 이전에 파트너 코드를 반환한 리소스 속성(예: contentOwner 리소스의 id 속성)의 값으로 새 ID를 반환합니다.
  • 모든 API 메서드는 API 요청을 대신하는 콘텐츠 소유자를 식별하는 onBehalfOfContentOwner 매개변수를 지원합니다. 변경 후에는 매개변수를 파트너 코드 대신 새 ID로 설정해야 합니다. 코드 중단을 방지하기 위해 이 매개변수는 전환 기간 동안 두 값 중 하나를 허용합니다.
  • 변경 후 contentOwners.list 메서드의 contentOwnerId 매개변수는 파트너 코드 대신 새 ID를 지정해야 합니다.

• 기존 리소스 및 메서드 업데이트

  • assetSearch.list 메서드의 새 metadataSearchFields 매개변수를 사용하면 검색할 확장 소재 메타데이터 필드와 해당 필드에서 검색할 값을 지정할 수 있습니다. 매개변수 값은 필드 및 값 쌍의 쉼표로 구분된 목록입니다. 쌍 내에서 필드와 값은 콜론으로 구분됩니다.

  • claim 리소스의 새 appliedPolicy 객체는 YouTube에서 소유권 주장에 실제로 적용하는 정책을 지정합니다. 객체의 값은 policy 리소스입니다. 이 리소스에는 요청을 제출한 콘텐츠 소유자가 소유권을 주장하는 저작물이 있는 국가의 정책 정보가 포함되어 있습니다.

    적용된 정책은 콘텐츠 소유자가 정의한 정책과 다음 두 가지 방법으로 다를 수 있습니다.

    1. API 요청을 제출한 콘텐츠 소유자와 동일한 일부 지역에서 소유권 주장이 제기된 저작물의 일부 소유권을 보유한 다른 소유자가 설정한 정책을 고려합니다.

    2. 콘텐츠 소유자가 소유권 주장이 제기된 저작물을 소유한 지역에 적용되는 YouTube 관리 정책을 고려합니다.

  • claimHistory 리소스의 새 uploaderChannelId 속성은 소유권 주장이 제기된 동영상이 업로드된 채널의 채널 ID를 식별합니다.

2014년 9월 8일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새로운 리소스 및 메서드

  • 새 assetLabel 리소스는 애셋에 할당할 수 있는 텍스트 라벨을 식별합니다. 저작물 라벨을 사용하면 저작물을 맞춤 카테고리로 분류하여 저작물 라이브러리를 더 쉽게 정리할 수 있습니다. 라벨을 기준으로 저작물을 검색할 수 있으므로 특정 저작물 그룹을 업데이트해야 하는 사용 사례를 간소화할 수 있습니다.

    • assetLabels.list 메서드를 사용하면 콘텐츠 소유자의 라벨 목록을 검색할 수 있습니다.
    • assetLabels.insert 메서드를 사용하면 새 저작물 라벨을 만들 수 있습니다. assets.update 메서드를 호출하고 저작물의 라벨을 업데이트하여 새 라벨을 만들 수도 있습니다. API 서버는 이전에 정의되지 않은 라벨에 대해 새 assetLabel 리소스를 자동으로 만듭니다.

• 기존 리소스 및 메서드 업데이트

  • assets.update 메서드를 호출하여 저작물의 라벨을 업데이트할 수 있음을 나타내도록 asset 리소스의 label[] 속성이 업데이트되었습니다. 그러나 assets.insert 메서드를 호출할 때는 저작물의 라벨을 설정할 수 없습니다.

    새로운 저작물 라벨 사용 가이드에서는 저작물 라벨을 만들고 검색하는 방법과 저작물의 라벨을 업데이트하거나 특정 라벨과 연결된 저작물을 검색하는 방법을 설명합니다.

• 신규 및 업데이트된 오류

  API는 새 assetLabels.list 및 assetLabels.insert 메서드에 관한 몇 가지 새로운 오류를 지원합니다.

2014년 7월 9일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 콘텐츠 소유자 ID 변경사항

  이전에는 API에서 'qrs_network'와 같은 사람이 읽을 수 있는 파트너 코드를 사용하여 인증된 사용자 또는 API를 통해 관리되는 리소스와 연결된 콘텐츠 소유자를 고유하게 식별했습니다. 2014년 3분기부터 API는 콘텐츠 소유자를 식별하기 위해 고유한 22자 ID를 대신 사용하도록 전환됩니다. 이 변경사항은 다음 API 기능에 영향을 미치며 애플리케이션에 파트너 코드를 하드코딩한 파트너에게 영향을 미칠 수 있습니다.

  • API는 이전에 파트너 코드를 반환한 리소스 속성(예: contentOwner 리소스의 id 속성)의 값으로 22자 ID를 반환합니다.
  • 모든 API 메서드는 API 요청을 대신하는 콘텐츠 소유자를 식별하는 onBehalfOfContentOwner 매개변수를 지원합니다. 변경 후에는 매개변수를 파트너 코드 대신 22자리 ID로 설정해야 합니다. 코드 중단을 방지하기 위해 이 매개변수는 전환 기간 동안 두 값 중 하나를 허용합니다.
  • 변경 후 contentOwners.list 메서드의 contentOwnerId 매개변수는 파트너 코드 대신 22자 ID를 지정해야 합니다.

• 기존 리소스 및 메서드 업데이트

  • 이제 asset 리소스에서 저작물과 연결된 저작물 라벨 목록을 지정하는 label 속성을 지원합니다. 여러 저작물에 라벨을 적용하여 저작물을 그룹화할 수 있습니다. 라벨을 검색 필터로 사용하여 일괄 업데이트를 하거나 보고서를 다운로드하거나 YouTube 분석을 필터링할 수도 있습니다.

  • 이제 assetSearch.list 메서드에서 다음과 같은 선택적 매개변수를 지원합니다.

    • labels: 지정된 라벨과 연결된 확장 소재만 포함되도록 결과를 제한합니다. 기본적으로 API는 지정된 모든 라벨과 일치하는 저작물을 반환합니다. 하지만 includeAnyProvidedLabel 매개변수를 사용하여 지정된 라벨과 일치하는 애셋을 반환하도록 API에 지시할 수 있습니다.
    • includeAnyProvidedLabel: labels 매개변수와 함께 사용되는 이 매개변수는 API에 labels 매개변수 값에 지정된 라벨과 연결된 저작물을 반환하도록 지시합니다.

  • 이제 claimHistory 리소스에 다음과 같은 새로운 속성이 포함됩니다.

    • event[].source.userEmail 속성은 이벤트를 시작한 사용자의 이메일 주소를 제공합니다.
    • event[].typeDetails.disputeNotes 속성에는 dispute_create 이벤트의 이의 제기 메모가 포함되어 있습니다.

  • 이제 claimSearch.list 메서드에서 다음과 같은 선택적 매개변수를 지원합니다.

    • createdAfter: 지정된 날짜 이후에 생성된 소유권 주장만 포함하도록 결과를 제한합니다.
    • createdBefore: 지정된 날짜 이전에 생성된 소유권 주장만 포함하도록 결과를 제한합니다.
    • includeThirdPartyClaims: videoId 매개변수와 함께 사용되는 이 매개변수는 API 결과에 서드 파티 소유권 주장을 포함할지 여부를 나타냅니다.

• 자세한 오류 정보

  이제 오류 문서에서 각 오류 유형의 HTTP 응답 코드를 지정합니다.

• 신규 및 업데이트된 오류

  아래 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다. 예를 들어 필수 메타데이터 필드가 누락된 asset 리소스를 삽입하려고 하면 required 오류가 반환됩니다. 실제로 필수 메타데이터 필드는 2개 이상일 수 있으며, 각 필드는 약간 다른 메시지와 함께 오류를 반환합니다.

  자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  메서드	오류
  assetSearch.list	invalidValue – API에서 프로그램 또는 시즌 저작물을 검색하는 기능을 지원하지 않습니다. type 매개변수의 값을 지원되는 값으로 변경합니다.
  assets.insert	conflict – 동일한 식별자 (예: 맞춤 ID, ISRC 등)를 가진 저작물이 이미 너무 많습니다. conflict – 지정된 저작물의 사본이 이미 너무 많습니다. invalidValue – API를 호출하는 사용자에게 지정된 유형의 애셋을 만들 권한이 없습니다.
  assets.patch assets.update	badRequest – API에서 시도한 저작물 유형 변환을 지원하지 않습니다.
  claimSearch.list	badRequest – includeThirdPartyClaims 매개변수는 videoId 필터와 함께만 사용할 수 있습니다.
  ownership.patch ownership.update	badRequest – 아트 트랙 저작물의 소유권은 업데이트할 수 없습니다.
  references.patch references.update	badRequest – 참조가 시도 중인 작업에 대해 잘못된 상태입니다.

2014년 2월 3일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 기존 리소스 및 메서드 업데이트

  • 이제 asset 리소스의 type 값이 art_track_video일 수 있습니다.

  • 이제 claimSearch 리소스에 다음과 같은 새로운 속성이 포함됩니다.

    • origin 객체에는 소유권 주장이 생성된 방식을 설명하는 정보가 포함됩니다.
    • thirdPartyClaim 속성에는 검색을 실행하는 사용자와 연결된 콘텐츠 소유자가 아닌 콘텐츠 소유자가 소유권 주장을 제기했는지 여부를 나타내는 불리언 값이 포함되어 있습니다.

  • 이제 claimSearch.list 메서드에서 다음과 같은 선택적 매개변수를 지원합니다.

    • contentType: 오디오 전용 소유권 주장, 동영상 전용 소유권 주장 또는 시청각 소유권 주장만 포함하도록 결과를 제한합니다.
    • origin: 소유권 주장을 찾을 소유권 주장 출처(예: descriptiveSearch 또는 videoMatch)를 하나 이상 지정합니다.
    • status: 지정된 상태의 클레임만 포함하도록 결과를 제한합니다.

  • 이제 claim 리소스의 status 속성이 appealed, disputed, potential, takedown, unknown 값을 추가로 지원합니다.

  • claim 리소스의 새 blockOutsideOwnership 속성은 소유권 주장이 제기된 동영상이 명시적으로 소유되지 않은 지역에서 차단되어야 하는지 여부를 나타냅니다. 기본적으로 소유권 주장과 연결된 저작물에 대한 소유권 데이터가 정의되지 않은 국가에서는 소유권 주장이 제기된 동영상이 계속 표시됩니다.

  • contentOwnerAdvertisingOption 리소스의 새 allowedOptions.autoGeneratedBreaks 속성은 파트너가 YouTube가 자동으로 결정하는 광고 시점에 미드롤 인스트림 광고를 게재하도록 선택할 수 있는지 여부를 나타냅니다.

  • 이제 contentOwners.list 메서드를 https://www.googleapis.com/auth/youtubepartner-content-owner-readonly 범위를 지정하는 승인 토큰으로 호출할 수 있습니다.

  • policy 리소스의 새 timeUpdated 속성은 정책이 마지막으로 업데이트된 시간을 지정합니다.

  • 이제 policies.list 메서드에서 선택적 sort 매개변수를 지원합니다. 이 매개변수를 사용하면 결과를 마지막으로 업데이트된 시간의 오름차순 또는 내림차순으로 정렬해야 함을 지정할 수 있습니다.

  • referenceConflict 리소스의 새 expiryTime 속성은 참조 충돌의 검토 기간이 종료되어 충돌이 만료되는 시간을 지정합니다.

  • videoAdvertisingOption 리소스의 새 autoGeneratedBreaks 속성은 YouTube가 자동으로 결정하는 광고 시점에 동영상에 미드롤 인스트림 광고를 게재할지 여부를 나타냅니다.

• 신규 및 업데이트된 오류

  아래 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다. 예를 들어 필수 메타데이터 필드가 누락된 asset 리소스를 삽입하려고 하면 required 오류가 반환됩니다. 실제로 필수 메타데이터 필드는 2개 이상일 수 있으며, 각 필드는 약간 다른 메시지와 함께 오류를 반환합니다.

  자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  메서드	오류
  assets.insert assets.update	badRequest – API가 아트 트랙 저작물의 쓰기 작업을 지원하지 않습니다.
  claimSearch.list	invalidValue – 요청의 pageToken 매개변수가 잘못된 페이지 토큰을 지정합니다.
  claims.insert	badRequest – 동영상의 채널이 활성 상태가 아니므로 제출하려는 소유권 주장이 유효하지 않습니다. badRequest – 소유권 주장을 제기하려는 동영상이 게시 중단 정책의 적용을 받지 않습니다. 문의사항이 있으면 copyright@youtube.com으로 문의해 주세요. badRequest – 지정된 동영상에 제3자 소유권 주장을 제기할 수 없으므로 요청을 처리할 수 없습니다. conflict – 동영상이 게시 중단 알림에 반론했기 때문에 YouTube에서 요청된 소유권 주장을 생성할 수 없습니다. conflict – 동영상에 게시 중단 요청이 접수되어 있으므로 YouTube에서 요청된 소유권 주장을 생성할 수 없습니다.
  references.insert	badRequest – 사용하려는 동영상에 대한 소유권 주장이 제기되어 삭제되었거나 거부되었거나 처리가 실패했습니다.

• 특정 API 메서드와 관련이 없는 contentOwnerNotProvided 및 internalError 오류는 더 이상 모든 메서드 페이지에 표시되지 않습니다. 이러한 오류에 대한 설명은 API 오류 문서의 일반 오류 섹션에서 계속 확인할 수 있습니다.

2013년 9월 12일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새로운 리소스 및 메서드

  • 새 referenceConflict 리소스는 두 참조 파일 간의 충돌을 식별하고 충돌이 식별될 때 해당 파일 간에 존재했던 일치를 나열합니다. referenceConflicts.list 메서드를 사용하면 승인된 콘텐츠 소유자와 연결된 해결되지 않은 참조 충돌 목록을 가져올 수 있습니다. referenceConflicts.get 메서드를 사용하면 고유한 참조 충돌 ID를 지정하여 참조 충돌을 가져올 수 있습니다.

  기존 리소스 및 메서드 업데이트

  • 이제 API에서 저작물의 유효한 동영상 일치 관련 정책을 검색하는 기능을 지원합니다. 이 변경사항은 저작물의 표준 메타데이터 및 소유권 데이터 세트를 검색하는 지원이 포함된 2013년 7월 16일에 출시된 변경사항과 유사합니다.

    애셋의 유효 일치 정책을 검색하려면 assets.get 또는 assets.list 메서드를 호출할 때 fetchMatchPolicy 매개변수 값을 effective로 설정합니다. API 응답에서 반환된 각 asset 리소스의 matchPolicyEffective 객체에는 해당 애셋의 유효한 일치 정책이 포함됩니다.

  • asset 리소스의 새 ownershipConflicts 객체에는 저작물의 소유권 분쟁에 관한 정보가 포함되어 있습니다. 객체의 구조는 저작물 소유자가 보유할 수 있는 각 권리 유형을 식별하는 ownership 리소스의 구조와 유사합니다. 대부분의 저작물 유형의 경우 소유자가 일반적인 저작물 소유권만 가질 수 있지만 음악작품 저작물의 경우 소유자가 공연권, 동기화 권리 또는 기계적 복제권의 소유권을 항목별로 분류할 수 있습니다.

    마찬가지로 ownershipConflicts 객체에는 일반 소유권, 공연권, 동기화 권한, 기계적 복제권의 충돌을 식별하는 별도의 목록이 포함되어 있습니다. 각 분쟁에 대해 데이터는 분쟁이 발생한 지역, 상충하는 소유권 데이터를 제공한 소유자, 각 상충하는 소유자가 소유권을 주장하는 저작물의 비율을 식별합니다.

  • 이제 assets.get 및 assets.get 메서드가 새 fetchOwnershipConflicts 매개변수를 지원합니다. 이 매개변수에는 API 요청이 API 응답에서 저작물의 소유권 충돌을 검색해야 하는지 여부를 나타내는 불리언 값이 있습니다. 기본값은 false이며, 소유권 충돌이 반환되지 않음을 의미합니다.

  • YouTube에서 검색하는 메타데이터 필드를 식별하도록 assetSearch.list 메서드의 q 매개변수 정의가 업데이트되었습니다.

  • 이제 references.insert 메서드의 요청 본문 문서에 contentType 속성의 값을 설정해야 한다고 안내됩니다. 이 변경사항은 실제 API 기능을 올바르게 반영하도록 문서를 업데이트하지만 API 기능의 변경사항을 나타내지는 않습니다.

• 신규 및 업데이트된 오류

  • API는 특정 메서드에 국한되지 않고 요청된 작업을 서비스 계정에서 승인할 수 없음을 나타내는 새로운 forbidden 오류를 지원합니다.

  • 이제 assets.insert 메서드는 2013년 7월 16일 API 업데이트 시 지원 중단된 metadata 객체가 아닌 metadataMine 객체의 속성에서 발생하는 메타데이터 오류를 식별합니다.

  • update 및 patch 메서드를 지원하는 각 리소스에 대해 errors 페이지에 두 메서드에서 반환된 오류를 나열하는 표가 하나 포함되도록 페이지가 업데이트되었습니다. 이전에는 목록이 항상 동일했지만 페이지에 각 메서드의 오류가 별도로 나열되었습니다.

2013년 7월 16일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새로운 리소스 및 메서드

  • 새 claimHistory.get 메서드를 사용하면 특정 소유권 주장에 관한 정보를 식별하고 검색할 수 있습니다. 반환된 claimHistory 리소스에는 소유권 주장이 생성, 업데이트, 이의 제기, 종료되는 등 소유권 주장과 관련된 이벤트 목록이 포함됩니다.

  • 새 claimSearch.list 메서드를 사용하면 다음 기준 중 일부 또는 전부를 충족하는 소유권 주장을 검색할 수 있습니다.

    • 소유권 주장은 특정 저작물과 연결됩니다.
    • 소유권 주장은 특정 동영상과 연결됩니다.
    • 요청에 제공된 쿼리 문자열과 일치하는 클레임입니다.

    API 응답의 각 claimSnippet 리소스에는 소유권 주장의 고유 소유권 주장 ID, 상태, 유형 (audio, video 또는 audiovisual), 소유권 주장과 연결된 저작물 및 동영상을 비롯한 소유권 주장에 관한 세부정보가 포함됩니다. 또한 이 리소스는 소유권 주장이 제기된 동영상의 조회수와 소유권 주장이 제기된 동영상의 제목을 지정합니다.

• 기존 리소스 및 메서드 업데이트

  • 이제 문서에 열거형 값 집합이 있는 속성에 지원되는 값이 나와 있습니다. 이러한 속성에는 asset 리소스의 type 속성과 claim 리소스의 status 속성이 포함됩니다.

  • 이제 assets.get 및 assets.list 메서드의 경우 API에서 fetchMetadata 및 fetchOwnership 요청 매개변수의 쉼표로 구분된 값을 지원하므로 여러 메타데이터 또는 소유권 데이터 세트를 검색할 수 있습니다.

    아래 목록에서는 asset 리소스 구조의 상응하는 변경사항과 이러한 변경사항이 get, list, insert, update 또는 patch asset 리소스를 사용하는 API 메서드에 미치는 영향을 설명합니다.

    • metadata 객체가 지원 중단되고 metadataMine 및 metadataEffective 객체로 대체되었습니다. 새 객체를 사용하면 asset 리소스가 API 요청을 실행하는 콘텐츠 소유자가 제공한 메타데이터 세트와 YouTube에서 저작물의 가장 정확하고 완전한 메타데이터 세트로 판단한 표준 메타데이터 세트를 모두 포함할 수 있습니다.

    • 마찬가지로 ownership 객체가 ownershipMine 및 ownershipEffective 객체로 대체되었습니다.

    • matchPolicy 객체가 matchPolicyMine 객체로 교체되었습니다. (API는 현재 확장 소재의 유효한 일치 관련 정책을 검색하는 기능을 지원하지 않습니다.)

    참고: 하위 호환성을 보장하기 위해 저작물에 메타데이터 버전, 소유권 데이터 세트 또는 동영상 일치 관련 정책이 하나만 요청된 경우 API 응답에는 지원 중단된 객체와 새로 지원되는 객체가 모두 포함됩니다. 예를 들어 요청에서 fetchMetadata 매개변수를 mine로 설정하면 API 응답에는 metadata 객체와 metadataMine 객체가 포함되며, 둘 다 동일한 데이터를 포함합니다. (fetchMetadata=mine를 설정하는 기능은 여러 메타데이터 버전을 검색할 수 있는 기능 업데이트 이전에 지원되었습니다.)
    
    그러나 fetchMetadata 매개변수가 mine,effective로 설정된 경우 API 응답에는 metadataMine 및 metadataEffective 객체가 포함되지만 metadata 객체는 포함되지 않습니다. (이 기능 업데이트 이전에는 fetchMetadata=mine,effective를 설정하는 기능이 지원되지 않았으므로 이전 버전과의 호환성을 위해 metadata 객체를 반환할 필요가 없습니다.) fetchOwnership 및 fetchMatchPolicy 매개변수에도 동일한 원칙이 적용됩니다.
    
    마찬가지로 하위 호환성을 위해 asset 리소스의 insert, update 또는 patch에 대한 요청에는 metadataMine 객체 또는 metadata 객체가 포함될 수 있습니다. asset 리소스의 소유권 데이터 또는 일치 정책을 설정할 때도 동일한 원칙이 적용됩니다.

  • claims.list 메서드의 assetId, q, videoId 매개변수가 지원 중단되었습니다. 이러한 기준을 사용하여 소유권 주장을 검색하려면 이러한 모든 매개변수를 지원하는 claimSearch.list 메서드를 사용하세요.

  • ownership 리소스에서 general[].ratio, performance[].ratio, synchronization[].ratio, mechanical[].ratio 속성의 값은 모두 integer 대신 double 콘텐츠 형식을 갖습니다.

  • 이제 policy 리소스의 rules[].action 속성 정의에 해당 속성의 유효한 값인 block, monetize, takedown, track이 나열됩니다. 그러나 API를 사용하여 소유권 주장에 게시 중단 정책을 적용할 수는 없습니다.

  • 저작물을 CMS 계정에 연결된 YouTube 채널에 업로드된 기존 YouTube 동영상과 연결하여 참조를 만든 경우 reference 리소스의 새 claimId 속성이 표시됩니다. 이 경우 이 필드에는 저작물과 동영상 간의 연결을 나타내는 소유권 주장의 ID가 포함됩니다.

  • reference 리소스의 새 excludedIntervals[] 속성은 참조를 일치시키려고 할 때 YouTube가 무시해야 하는 참조 내 시간 간격 목록을 지정합니다. 각 간격은 동영상 시작 부분부터 초 단위로 측정된 시작 시간과 종료 시간을 지정합니다.

  • API는 더 이상 references.update 또는 references.patch 요청의 본문으로 전송되는 reference 리소스에 status 속성을 설정할 필요가 없습니다.

  • videoAdvertisingOptions.getEnabledAds 메서드의 API 응답 형식을 올바르게 설명하도록 문서가 수정되었습니다. youtubePartner#videoAdvertisingOptionGetEnabledAds 리소스인 응답에는 다음 정보가 포함됩니다.

    • id: YouTube에서 설정과 연결된 소유권 주장이 제기된 동영상을 고유하게 식별하는 데 사용하는 ID입니다.

    • adBreaks – 각 객체에 광고가 게재될 수 있는 동영상 재생 전, 도중, 후의 지점에 관한 정보가 포함된 객체 목록입니다. 각 객체는 광고 시점 중에 발생하는 광고 슬롯, 각 슬롯 중에 게재할 수 있는 광고 유형과 같은 광고 시점의 다른 속성을 지정할 수도 있습니다.

    • adsOnEmbeds – 동영상이 삽입된 플레이어에서 재생될 때 YouTube에서 광고를 게재할 수 있는지 여부를 나타내는 불리언 필드입니다.

    • countriesRestriction – 각 객체가 해당 지역의 동영상 재생 중에 사용되는 지역 목록과 광고 형식을 식별하는 객체 목록입니다.

• 신규 및 업데이트된 오류

  • 아래 표에는 API에서 지원하는 새로운 오류와 각 오류를 반환할 수 있는 메서드가 나와 있습니다. 또한 변경된 오류도 식별합니다. 메서드는 동일한 오류 유형을 가진 여러 오류를 반환할 수 있습니다. 예를 들어 필수 메타데이터 필드가 누락된 asset 리소스를 삽입하려고 하면 required 오류가 반환됩니다. 실제로 필수 메타데이터 필드는 2개 이상일 수 있으며, 각 필드는 약간 다른 메시지와 함께 오류를 반환합니다.

    자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

    메서드	오류
    assets.insert assets.update assets.patch	이전에 metadata 객체의 하위 속성과 연결된 invalidValue 및 required 오류가 이제 metadataMine 객체의 동일한 하위 속성과 연결됩니다.
    claimHistory.get	notFound – 기록을 검색하려는 소유권 주장을 찾을 수 없습니다. required – 요청에 claimId 매개변수의 값이 지정되지 않았습니다.
    claimSearch.list claims.list	badRequest – 요청에 잘못된 기준이 지정되었습니다. q, assetId, videoId 필터 매개변수 중 최대 하나만 지정할 수 있습니다.
    claims.insert	badRequest – 요청된 콘텐츠 소유자가 소유권 주장과 연결된 저작물의 소유자가 아니므로 생성하려는 소유권 주장이 잘못되었습니다. badRequest – 대리하는 콘텐츠 소유자에게 지정된 작업이 포함된 정책을 만들 권한이 없습니다. invalidValue – 대리하는 콘텐츠 소유자에게 API를 통해 사용자 업로드 동영상에 대한 소유권 주장 권한이 없습니다.
    contentOwners.list	badRequest – 요청에 잘못된 기준이 지정되었습니다. fetchMine, id 필터 매개변수 중 하나를 정확하게 지정해야 합니다. 이전에는 has_conflicts_with, restrict_to_user, name_prefix, id와 같은 다른 필터 매개변수가 오류에 표시되었습니다.
    ownership.update ownership.patch	badRequest – 음악작품 저작물의 소유권 데이터를 업데이트하는 요청은 general 소유권이 아닌 세분화된 소유권 데이터(mechanical, performance, synchronization 또는 lyric 권리)를 지정해야 합니다. lyric 권리 유형이 새로 지원됩니다.
    policies.insert policies.update policies.patch	invalidValue – API에서 takedown 작업을 지정하는 정책의 생성 또는 수정을 지원하지 않으므로 요청에 잘못된 정책 규칙이 포함되어 있습니다. invalidPolicyTakedownAction 이유를 보고하는 이 오류는 지원 중단된 invalidPolicyConditionalTakedown 오류를 대체합니다.
    references.insert	badRequest – 요청이 미디어 파일을 전송하거나 claimId 요청 매개변수의 값을 지정해야 합니다. 그러나 요청이 미디어 파일을 전송하지 않고 claimId 요청 매개변수의 값을 지정할 수도 있습니다. badRequest – 동일한 YouTube 동영상에 제기된 다른 소유권 주장에서 동일한 콘텐츠의 참조가 이미 생성되었습니다. badRequest – API는 참조를 만들 때 fpDirect 속성의 값을 설정하는 기능을 지원하지 않습니다. internalError – 업로드된 미디어 파일에 문제가 있습니다. invalidValue – contentType, assetId 또는 claimId 요청 매개변수의 값이 잘못되었습니다. 오류는 잘못된 값을 식별합니다. notFound – 지정한 저작물 또는 소유권 주장을 찾을 수 없습니다. 요청에서 assetId 및 claimId 매개변수 값을 확인하세요. required – 요청에서 contentType 매개변수의 값을 지정해야 합니다.
    references.insert references.update references.patch	invalidValue – 참조에 지정된 excludedIntervals가 유효하지 않습니다. 참조를 비활성화할 때는 제외 간격을 지정할 수 없습니다.

2013년 5월 10일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• YouTube는 더 이상 실험용 API 기능과 서비스를 식별하지 않습니다. 대신에 지원 중단 정책에 따라 달라지는 YouTube API 목록을 제공합니다.

2013년 4월 8일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• API의 이름이 YouTube Content ID API로 변경되었습니다.

• assetMatchPolicy 리소스의 여러 속성이 변경되었습니다.

  • kind 속성 값이 youtubePartner#policy에서 youtubePartner#assetMatchPolicy로 변경되었습니다.
  • 새 policyId 속성에는 저장된 정책 리소스를 고유하게 식별하는 값이 포함됩니다.
  • 이제 rules[].subaction 속성 값은 문자열이 아닌 문자열 목록입니다.
  • 이제 rules[].conditions.contentMatchType 속성 값은 문자열이 아닌 문자열 목록입니다.
  • id, name, description 속성이 삭제되었습니다.

• 메서드를 호출할 때 policyId 속성 또는 rules[] 객체의 값을 설정할 수 있다는 사실을 반영하도록 assetMatchPolicy.update 메서드의 문서가 업데이트되었습니다.

• 이제 claims 리소스에서 다음과 같은 몇 가지 새로운 속성을 지원합니다.

  속성 이름	값	설명
  timeCreated	datetime	소유권 주장이 생성된 날짜 및 시간입니다.
  matchInfo	object	matchInfo 객체에는 소유권 주장을 생성한 일치하는 콘텐츠에 관한 정보가 포함됩니다. 이 정보는 업로드된 동영상이 기존 참조 파일과 일치하여 소유권 주장이 자동으로 생성된 경우에만 claim 리소스에 포함됩니다.
  matchInfo.referenceId	string	YouTube에서 일치를 생성한 참조 reference를 식별하는 데 사용하는 고유 ID입니다.
  matchInfo.longestMatch	object	longestMatch 객체에는 참조와 업로드된 동영상 간의 가장 긴 일치에 관한 정보가 포함되어 있습니다.
  matchInfo.longestMatch.durationSecs	unsigned long	일치 시간(초)입니다.
  matchInfo.longestMatch.userVideoOffset	unsigned long	일치가 시작되는 시간 오프셋으로, 업로드된 동영상 시작 부분부터 초 단위로 측정됩니다.
  matchInfo.longestMatch.referenceOffset	unsigned long	일치가 시작되는 시간 오프셋으로, 참조 시작 부분부터 초 단위로 측정됩니다.
  matchInfo.totalMatch	object	totalMatch 객체에는 참조와 일치하는 업로드된 동영상의 총량과 업로드된 동영상과 일치하는 참조의 총량에 관한 정보가 포함되어 있습니다. 일치하는 콘텐츠가 업로드된 동영상 또는 참조 동영상에서 루프로 실행되는 경우 이러한 값이 다를 수 있습니다. 예를 들어 업로드된 동영상에 참조 동영상의 10초 클립이 포함되어 있지만 클립이 6번 반복되는 경우 업로드된 동영상의 총 일치 콘텐츠는 60초이지만 참조 동영상의 총 일치 콘텐츠는 10초입니다.
  matchInfo.totalMatch.userVideoDurationSecs	unsigned long	참조와 일치하는 업로드된 동영상 콘텐츠의 총 길이(초)입니다.
  matchInfo.totalMatch.referenceDurationSecs	unsigned long	업로드된 동영상과 일치하는 참조 콘텐츠의 총 길이(초)입니다.
  origin	object	origin 객체에는 소유권 주장의 출처를 설명하는 정보가 포함됩니다.
  origin.source	string	클레임의 소스로서

• AudioSwap 소유권 주장의 값을 업데이트할 수 없음을 나타내도록 claims 리소스의 policy 속성이 업데이트되었습니다.

• metadataHistory 리소스의 timeProvidedMs 속성의 이름이 timeProvided로 변경되었습니다.

• ownershipHistory 리소스의 timeProvidedMs 속성의 이름이 timeProvided로 변경되었습니다.

• ownershipHistory.list 메서드의 정의가 업데이트되어 이 메서드가 각 콘텐츠 소유자의 최신 소유권 데이터만 검색한다는 점이 명시되었습니다. 콘텐츠 소유자가 여러 데이터 소스(API, 콘텐츠 피드 등)를 통해 소유권 데이터를 제출한 경우에는 목록에 각 콘텐츠 소유자 및 데이터 소스에 대한 가장 최근의 데이터가 포함됩니다.

• policy 리소스의 여러 속성이 변경되었습니다.

  • rule 속성의 이름이 rules로 변경되었습니다.
  • 이제 rules[].subaction 속성 값은 문자열이 아닌 문자열 목록입니다.
  • 이제 rules[].conditions.contentMatchType 속성 값은 문자열이 아닌 문자열 목록입니다.

• policies.insert 및 policies.update 메서드를 호출할 때 rules[] 객체의 값을 설정할 수 있다는 사실을 반영하도록 policies.insert 및 policies.update 메서드의 문서가 업데이트되었습니다.

• 여러 API 메서드가 새로운 오류 유형을 지원합니다. 아래 표에는 메서드가 나와 있으며 새로 지원되는 오류 유형이 간단히 설명되어 있습니다. 많은 경우 특정 유형에 여러 오류가 있을 수 있습니다. 예를 들어 필수 메타데이터 필드가 누락된 asset 리소스를 삽입하려고 하면 required 오류가 반환됩니다. 실제로 필수 메타데이터 필드는 2개 이상일 수 있으며, 각 필드는 약간 다른 메시지와 함께 오류를 반환합니다.

  자세한 내용은 각 메서드의 오류 문서 또는 오류 페이지를 참고하세요.

  메서드	오류
  assets.insert	invalidValue – 저작물 메타데이터 입력란에 잘못된 값이 포함되어 있습니다. required – 필수 저작물 메타데이터 필드가 누락되었습니다.
  assets.update assets.patch	forbidden – 업데이트를 완료하려는 파트너가 업데이트 중인 저작물을 소유하지 않습니다. invalidValue – 저작물 메타데이터 입력란에 잘못된 값이 포함되어 있습니다. notFound – 저작물이 찾을 수 없는 시즌 저작물 또는 프로그램 저작물과 연결되고 있습니다. required – 필수 저작물 메타데이터 필드가 누락되었습니다.
  claims.insert	badRequest – 요청에서 동영상에 대한 소유권 주장을 제기하려고 하지만 소유권 주장이 허용되지 않습니다.
  ownership.update ownership.patch	badRequest – 요청에서 특정 지역 내 총 소유권을 100%를 초과하도록 정의합니다.
  policies.insert policies.patch policies.update	conflictingPolicyRules – 정책에 충돌하는 정책 규칙이 포함되어 있습니다.

• 새 오류 페이지에는 API에서 반환할 수 있는 오류가 나열됩니다. 이 페이지에는 여러 API 메서드에서 발생할 수 있는 일반적인 오류와 메서드별 오류가 포함되어 있습니다.

2013년 1월 18일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

• 새로 문서화된 videoAdvertisingOptions.getEnabledAds 메서드를 사용하면 지정된 파트너 또는 사용자가 업로드한 동영상에 허용되는 광고 유형에 관한 세부정보를 검색할 수 있습니다.

• assetSearch.list 메서드의 ownershipRestriction 매개변수 정의가 업데이트되어 기본 매개변수 값이 mine임을 나타냅니다. 이는 API가 현재 사용자가 소유한 저작물만 가져와야 함을 나타냅니다.

• assets.list 메서드 문서에는 다음과 같은 변경사항이 반영되어 있습니다.

  • 이제 id 매개변수가 필요합니다.

  • 새로 지원되는 fetchMatchPolicy 매개변수를 사용하면 API 요청에서 저작물에 설정된 동영상 일치 관련 정책도 검색해야 하는지 여부를 지정할 수 있습니다.

  • 새로 지원되는 fetchOwnership 매개변수를 사용하면 API 요청에서 저작물의 소유권 데이터도 가져와야 하는지 지정할 수 있습니다.

  • API가 반환하는 확장 소재 목록에 더 이상 페이징 데이터가 포함되지 않습니다. 그 결과 nextPageToken 속성과 pageInfo 객체가 모두 API 응답에서 삭제되었습니다. pageInfo 객체에는 totalResults, resultsPerPage, startIndex 속성이 포함되어 있습니다.

• 소유권 주장을 만들 때 정책을 지정해야 한다는 내용이 포함되도록 claims 리소스 문서가 업데이트되었습니다. 이전 문서에서는 삽입된 소유권 주장에 정책이 지정되지 않은 경우 YouTube에서 기본 사용 정책이 적용된다고 안내했지만, 현재는 그렇지 않습니다.

• policy 리소스의 hasUnpublishedDraft 속성이 지원 중단되었습니다.

• policies.list 메서드의 새로 지원되는 id 매개변수를 사용하면 API 요청에서 가져와야 하는 저장된 정책을 식별할 수 있습니다. 현재 인증된 콘텐츠 소유자의 정책만 검색할 수 있습니다.

• 소유권 주장의 상태가 inactive로 업데이트될 때만 매개변수가 작동한다는 점을 명시하도록 references.patch 및 references.update 메서드의 releaseClaims 매개변수 정의가 업데이트되었습니다. 이 경우 releaseClaims 매개변수의 값을 true로 설정하여 참조에서 생성된 모든 일치 소유권 주장을 해제할 수도 있습니다.

• references.patch 및 references.update 메서드가 모두 업데이트되어 이러한 작업 중 하나를 실행할 때 참조의 상태를 지정해야 한다고 명시합니다.

• 여러 API 메서드가 새로운 오류 유형을 지원합니다. 아래 표에는 메서드와 새로 지원되는 오류가 나와 있습니다.

  메서드	오류 유형	오류 세부정보	설명
  guideCategories.list	notFound	Unavailable	동영상 일치 관련 정책을 검색하려는 저작물을 찾을 수 없습니다.
  claims.get	notFound	Unavailable	가져오려는 소유권 주장을 찾을 수 없습니다.
  ownership.patch	invalidValue	Unavailable	제공한 소유권 데이터에 잘못된 값이 포함되어 있습니다.
  ownership.update	invalidValue	Unavailable	제공한 소유권 데이터에 잘못된 값이 포함되어 있습니다.