YouTube Content ID API - 업데이트 기록

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

이 페이지에는 YouTube Content ID API 변경사항 및 문서 업데이트가 나와 있습니다.

2023년 11월 10일

third_party_ads가 이 필드에 유일하게 유효한 값이 되도록 videoAdvertisingOption 리소스의 adFormats[] 필드가 업데이트되었습니다. 다음 광고 형식은 더 이상 지원되지 않습니다. 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 (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

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일

AIP-158과의 일관성 개선 사항을 반영하도록 assetSearch.list 메서드의 응답 문서를 업데이트했습니다.

• 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의 4가지 추가 값을 지원합니다. 또한 dropboxUpload 및 webUpload 값은 더 이상 지원되지 않습니다.

2021년 2월 26일

이제 매개변수 값이 쉼표로 구분된 동영상 ID를 최대 10개 허용한다는 점을 명시하도록 claimSearch.list 메서드의 videoId 매개변수에 관한 문서를 업데이트했습니다. 값에 포함된 동영상 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 메서드는 정확히 하나의 메타데이터 파일이 포함된 메타데이터 전용 패키지의 유효성을 검사하고 업로드합니다.
  • package.get 메서드는 이전에 업로드된 패키지에 관한 정보를 검색합니다.

• validator.validate 메서드의 경우 값이 데이터를 업로드하는 콘텐츠 파트너가 아니라 콘텐츠 소유자가 사용 중인 특정 업로더 계정을 식별하는 web-google 또는 yt-google와 같은 값을 식별하도록 uploaderName 속성의 정의가 업데이트되었습니다.

• 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 속성은 소유권 주장이 제기된 10분을 초과하는 동영상에서 YouTube가 자동으로 광고 시점을 생성해야 하는지 여부를 나타냅니다. 속성은 길이가 10분을 초과하는 콘텐츠 소유자의 모든 동영상에 영향을 미치지만, 동영상에 소유권 주장이 여러 개 제기된 경우 동영상의 소유권을 주장하는 첫 번째 파트너가 해당 동영상과 관련하여 이 속성의 기본 동작을 설정합니다.

2016년 8월 11일

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

• 새로 게시된 YouTube API 서비스 약관 ('업데이트된 약관')은 YouTube 엔지니어링 및 개발자 블로그에서 자세히 논의되었으며 현재 서비스 약관에 대한 다양한 업데이트 사항을 제공합니다. 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 소유권 주장이 기존의 다른 소유권 주장과 중복되어 업데이트할 수 없습니다.

  • 특히 요청이 여러 애셋의 데이터를 검색하고 fetchMatchPolicy 매개변수의 값이 effective인 경우 assets.list 메서드가 간혹 타임아웃되어 500 HTTP 응답 코드 (Internal Server Error)를 반환합니다. assets.list 요청에서 여러 저작물 ID를 지정하고 500 오류를 반환하면 저작물 1개 또는 개수보다 적은 수의 저작물에 대한 요청을 다시 제출해 보세요.

  • 요청에서 손상된 참조 파일을 업로드하는 경우 참조 자체가 처리될 때까지 문제가 파악되지 않는다는 점을 명시하도록 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 사용자 동의 정책을 준수해야 합니다. 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를 지원 값으로 나열합니다. 이 값은 YouTube가 저작물에 적용하는 동영상 일치 관련 정책을 검색하도록 API 서버에 지시합니다.

  • 이제 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는 인증된 사용자 또는 API를 통해 관리되는 리소스와 연결된 콘텐츠 소유자를 식별하기 위해 생성된 고유 ID를 반환합니다. 이전에는 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 결과에 제3자 소유권 주장을 포함할지 여부를 나타냅니다.

• 자세한 오류 정보

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

• 새로운 오류 및 업데이트된 오류

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

  자세한 내용은 각 방법의 오류 문서 또는 오류 페이지를 참조하세요.

  메서드	오류
  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 리소스는 art_track_video의 type 값을 가질 수 있습니다.

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

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

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

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

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

  • claim 리소스의 새로운 blockOutsideOwnership 속성은 소유권 주장이 제기된 동영상을 명시적으로 소유하지 않은 지역에서 차단해야 하는지 여부를 나타냅니다. 기본적으로 소유권 주장이 제기된 동영상은 소유권 주장과 관련된 저작물에 소유권 데이터가 정의되지 않은 국가에서 계속 볼 수 있습니다.

  • contentOwnerAdvertisingOption 리소스의 새로운 allowedOptions.autoGeneratedBreaks 속성은 파트너가 YouTube가 자동으로 결정하는 미드롤 인스트림 광고를 표시할 수 있는지를 나타냅니다.

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

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

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

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

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

• 새로운 오류 및 업데이트된 오류

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

  자세한 내용은 각 방법의 오류 문서 또는 오류 페이지를 참조하세요.

  메서드	오류
  assets.insert assets.update	badRequest - API가 아트 트랙 저작물에 대한 쓰기 작업을 지원하지 않습니다.
  claimSearch.list	invalidValue – 요청의 pageToken 매개변수가 잘못된 페이지 토큰을 지정합니다.
  claims.insert	badRequest – 만들려는 소유권 주장은 동영상의 채널이 활성 상태가 아니므로 유효하지 않습니다. badRequest – 소유권을 주장하려는 동영상이 게시 중단 정책에서 제외됩니다. 문의사항이 있으면 krcopyright@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 메서드를 지원하는 각 리소스별로 이 두 메서드에서 반환하는 오류가 나열된 표 하나를 페이지에 포함하도록 오류 페이지가 업데이트되었습니다. 이전에는 페이지에 각 메서드에 대한 오류가 별도로 나열되어 있었지만 목록은 항상 동일했습니다.

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는 저작물에 유효한 동영상 일치 관련 정책을 가져오는 기능을 지원하지 않습니다.)

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

    자세한 내용은 각 방법의 오류 문서 또는 오류 페이지를 참조하세요.

    메서드	오류
    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	클레임의 소스로서

• claims 리소스의 policy 속성이 AAC 소유권 주장에 대한 값을 업데이트할 수 없음을 명시하도록 업데이트되었습니다.

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

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

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

• policy 리소스에서 몇 가지 속성이 변경되었습니다.

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

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

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

  자세한 내용은 각 방법의 오류 문서 또는 오류 페이지를 참조하세요.

  메서드	오류
  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	입력한 소유권 데이터에 잘못된 값이 포함되어 있습니다.