API Content ID do YouTube - histórico de revisões

Observação:a API YouTube Data é destinada a parceiros de conteúdo do YouTube e não está disponível para todos os desenvolvedores ou usuários da plataforma. O acesso exige uma conta do Gerenciador de conteúdo do YouTube. Se você tiver uma conta do Gerenciador de conteúdo do YouTube, mas não encontrar a API YouTube Data como um dos serviços listados no console do Google Cloud, entre em contato com seu gerente de parceiros ou suporte a parceiros.

Esta página lista as mudanças na API Content ID do YouTube e as atualizações da documentação.

27 de agosto de 2026

O YouTube vai alinhar a contagem de visualizações públicas para todos os formatos de vídeo: vídeos mais longos, lives e Shorts. O YouTube vai contabilizar as visualizações públicas assim que um vídeo começar a ser reproduzido.

A qualificação para monetização e a maioria das principais métricas de performance não são afetadas, já que permanecem ancoradas nas métricas de engajamento. Os ganhos dos criadores vão continuar baseados nas "Visualizações intencionais de Shorts" e nas "Horas intencionais de exibição", que podem ser conferidas no YouTube Analytics > Modo avançado.

A qualificação para o Programa de Parcerias do YouTube não mudou. Os requisitos de entrada no Programa de Parcerias do YouTube também serão chamados de "visualizações qualificadas de Shorts" e "horas qualificadas de exibição" (antes eram "visualizações públicas válidas de Shorts" e "horas de exibição públicas válidas").

Para saber mais, consulte Como funciona o desempenho do conteúdo no YouTube.

Métrica Status Gatilho Uso
Ver Atualizado O vídeo é reproduzido desde o primeiro frame (inclui reprodução automática, manter o ponteiro sobre o vídeo e clicar/tocar para reproduzir). Contagens de visualizações públicas padrão.
Visualização engajada Não alterado A reprodução continua após o primeiro frame ou o usuário clica/toca para reproduzir. Monetização pelo Programa de Parcerias do YouTube, maioria das análises principais (taxa de cliques, duração média da visualização) e relatórios de engajamento.
Impressão de miniatura Não alterado A miniatura é mostrada sem interação ou reprodução automática. Mede a exposição e o pacote no nível do feed.

4 de agosto de 2026

A documentação da API Content ID do YouTube foi atualizada para esclarecer a ordem das operações ao atualizar recursos que já pertencem a outro proprietário de conteúdo:

26 de março de 2025

A partir de 31 de março de 2025, o YouTube vai mudar a forma de contar as visualizações dos Shorts. Antes, para os Shorts, uma visualização era contabilizada depois que o vídeo era exibido por alguns segundos. Agora, as visualizações vão contabilizar quantas vezes o Shorts começa a ser reproduzido ou reprisado, sem um tempo mínimo de exibição. Saiba mais

Até 30 de junho de 2025, a API Content ID será atualizada das seguintes maneiras, de acordo com essa mudança:

  • As ordens de classificação de claimSearch.list.sort serão atualizadas:
    • DAILY_ENGAGED_VIEWS será adicionado às contagens de visualizações diárias com base na metodologia anterior.
    • LIFETIME_ENGAGED_VIEWS será adicionado às contagens de visualizações vitalícias com base na metodologia anterior.
  • As ordens de classificação de assetSearch.list.sort serão atualizadas:
    • DAILY_ENGAGED_VIEWS será adicionado às contagens de visualizações diárias com base na metodologia anterior.

Até 30 de setembro de 2025, a API Content ID será atualizada das seguintes maneiras, de acordo com essa mudança:

  • A ordem de classificação assetSearch.list.sort VIEWS será descontinuada.
  • A ordem de classificação claimSearch.list.sort VIEW_COUNT será descontinuada.
  • claimSearch.claimSnippet.videoViews será atualizado para refletir a metodologia de contagem de visualizações atualizada dos Shorts.
  • claimSearch.claimSnippet.engagedViews será adicionado às contagens de visualizações com base na metodologia anterior.

14 de janeiro de 2025

O campo autoGeneratedBreaks[] do recurso videoAdvertisingOption foi atualizado porque agora permitimos que ad_breaks e autoGeneratedBreaks sejam fornecidos ao mesmo tempo. Se autoGeneratedBreaks estiver definido como "true" em um vídeo com adBreaks definido, nossos sistemas vão identificar locais para mostrar anúncios, além dos espaços de anúncios inseridos manualmente. Consulte o artigo de suporte para mais detalhes.

10 de novembro de 2023

O campo adFormats[] do recurso videoAdvertisingOption foi atualizado para que third_party seja o único valor válido para esse campo. Os seguintes formatos de anúncio não são mais aceitos: instream_trueview, instream_standard, display, preroll, postroll. Consulte o artigo de suporte para mais detalhes.

1º de junho de 2023

Observação:este é um anúncio de suspensão de uso.

Essa atualização inclui as seguintes alterações:

20 de dezembro de 2022

A definição do parâmetro de consulta ownershipRestriction do método assetSearch.list foi atualizada para esclarecer que, se o valor desse parâmetro for none, o valor do parâmetro metadataSearchFields também precisará usar pelo menos um filtro de ID. Essa mudança na documentação não reflete uma mudança no comportamento da API.

9 de novembro de 2022

A documentação dos métodos asset.get e asset.list foi atualizada para esclarecer como vários valores são aceitos para:

28 de setembro de 2022

As informações de licenciamento foram adicionadas ao asset resource.

18 de julho de 2022

A documentação do inactiveReasons do método claimSearch.list foi atualizada para refletir melhorias na consistência com o YouTube Studio:

  • O Studio já havia removido a compatibilidade com Audio Swap e Song Erase. Os valores correspondentes da API, audio_removed e song_erased, foram ignorados silenciosamente e agora não estão documentados.
  • channel_whitelisted foi substituído por channel_allowlisted. O valor anterior não está mais documentado, mas ainda é compatível.
  • Os valores closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced e video_modified agora são aceitos.

14 de junho de 2022

A documentação do recurso assetSearch foi atualizada para refletir as duas novas propriedades: isrcs[] e iswcs[]. Os novos valores de propriedade isrcs[] e iswcs[] contêm uma matriz de valores de string, em que cada valor especifica um ISRC ou ISWC, conforme apropriado, que é mapeado para o recurso identificado pelo resultado da pesquisa.

As novas propriedades são recomendadas em vez das propriedades isrc e iswc já incluídas nos recursos assetSearch porque fornecem dados mais precisos. Enquanto as novas propriedades podem listar uma matriz de valores de string, as propriedades isrc e iswc identificam apenas um código ISRC ou ISWC associado ao resultado da pesquisa.

12 de maio de 2022

Os links para bibliotecas de cliente foram atualizados para apontar para as bibliotecas de cliente padrão das APIs do Google. As vinculações pré-geradas para PHP foram atualizadas.

3 de maio de 2022

O parâmetro status do método claimSearch.list agora é compatível com mais filtros com base em possíveis detalhes da reivindicação.

2 de maio de 2022

A documentação da Response do método assetSearch.list foi atualizada para refletir melhorias na consistência com a AIP-158:

  • A descrição de pageInfo.totalResults menciona explicitamente que o valor é uma estimativa e não o valor real.
  • Os campos pageInfo.resultsPerPage e pageInfo.startIndex foram removidos

25 de abril de 2022

A documentação do recurso assetLabels.list foi atualizada para esclarecer o significado dos parâmetros de solicitação labelPrefix e q e para documentar que a solicitação / resposta aceita paginação.

9 de dezembro de 2020 .

A documentação do recurso claimSearch.list foi atualizada para refletir corretamente os dois casos de uso que esse método abrange:

  • Pesquisar por ID (recurso, referência ou vídeo) ou string de consulta
  • Pesquisar por data de criação, data de modificação ou status da reivindicação

Cada caso de uso aceita um conjunto diferente de parâmetros de consulta. A documentação do método claimSearch.list foi atualizada para explicar quais parâmetros são compatíveis com cada caso de uso.

17 de novembro de 2021

Essa atualização inclui as seguintes alterações:

  • O método claims.update agora permite atualizar o status de uma reivindicação inativa ou potencial para active. A definição da propriedade status do recurso claim oferece mais detalhes.
  • A documentação dos recursos claim e claimSearch foi atualizada para refletir a adição do novo objeto studioInfo, que contém links para páginas do YouTube Studio relacionadas à reivindicação.
  • A lista de valores aceitos para o parâmetro origin do método claimSearch.list mudou. Agora, o parâmetro aceita quatro valores adicionais: batchTool, inProductShorts, melodyMatch e youTubeAdmin. Além disso, os valores dropboxUpload e webUpload não são mais aceitos.

26 de fevereiro de 2021

A documentação do parâmetro videoId do método claimSearch.list foi atualizada para informar que o valor do parâmetro agora aceita um máximo de 10 IDs de vídeo separados por vírgulas. A API vai retornar um erro badRequest (código de resposta HTTP 400) se o valor tiver mais de 10 IDs de vídeo.

6 de dezembro de 2018

Observação:este é um anúncio de suspensão de uso.

A documentação da API foi atualizada para remover referências ao recurso contentOwnerAdvertisingOptions e aos métodos dele. Esses métodos eram usados de forma muito mínima, e os usuários da API que os usavam foram contatados separadamente antes deste anúncio.

21 de março de 2018

Esta atualização contém as seguintes alterações:

  • A propriedade metadataMine.artist precisa ser definida sempre que você inserir, atualizar ou adicionar patch a um recurso de vídeo de música ou gravação de som. Agora, a API retorna um erro se a propriedade não estiver definida para esses tipos de recursos. Além disso, a propriedade metadataMine.artist só é compatível com artistas de gravação de som e vídeo de música.

24 de julho de 2017

Esta atualização contém as seguintes alterações:

  • O novo recurso package representa um grupo de arquivos entregues pela Web, SFTP ou outro mecanismo de entrega. A API aceita dois métodos para esse recurso:

    • O método package.insert valida e faz upload de um pacote somente de metadados que contém exatamente um arquivo de metadados.
    • O método package.get recupera informações sobre um pacote enviado anteriormente.

  • Para o método validator.validate, a definição da propriedade uploaderName foi atualizada para informar que o valor não identifica o parceiro de conteúdo que está enviando os dados, mas sim um valor como web-google ou yt-google, que identifica a conta específica de upload usada pelo proprietário do conteúdo.

  • A propriedade status do recurso reference não usa mais o valor duplicate_on_hold para indicar que uma referência é duplicada de outra. Em vez disso, se uma referência for duplicada, o valor da propriedade status será definido como inactive, e o valor da propriedade statusReason será REASON_DUPLICATE_FOR_OWNERS.

    No entanto, como antes, a propriedade duplicateLeader do recurso só será preenchida se a referência for duplicada. Se ela estiver definida, o valor da propriedade vai identificar a referência duplicada.

17 de abril de 2017

Esta atualização contém as seguintes alterações:

  • O novo recurso assetShare, que é relevante apenas para recursos de composição, identifica uma relação entre duas representações de um recurso de recurso. Essas representações refletem um novo modelo de dados de publicação criado para oferecer mais transparência e controle sobre como seus direitos estão associados a recursos de gravação de som.

    No novo modelo, cada gravação de som é mapeada para exatamente um recurso exclusivo, chamado de visualização de composição. Os metadados desse recurso representam o conjunto canônico de informações que o YouTube mostra sobre os direitos de composição associados a uma determinada gravação e podem sintetizar informações de vários provedores de dados.

    Além disso, cada proprietário da composição tem um recurso de cota de composição. A cota de composição representa as informações que um editor específico forneceu para um recurso de composição. A cota de composição pode ser associada a várias gravações de som.

    O recurso assetShare identifica uma relação entre uma visualização e uma parcela de composição. Com o novo método assetShares.list, você pode fazer o seguinte:

    • Forneça o ID de uma visualização de composição e recupere a participação correspondente na composição de propriedade do parceiro que autoriza a solicitação, se houver.
    • Forneça o ID de uma cota de composição de propriedade do parceiro de conteúdo e recupere uma lista de todas as visualizações de composição vinculadas a essa cota.

  • O novo guia Gerenciar recursos de composição explica como diferentes métodos de API processam solicitações dependendo se os IDs de recursos enviados a esses métodos identificam visualizações ou cotas de composição.

  • A nova propriedade claimedVideoOptions.autoGeneratedBreaks do recurso contentOwnerAdvertisingOptions indica se o YouTube deve gerar automaticamente intervalos de anúncio em vídeos reivindicados com mais de 10 minutos de duração. Embora a propriedade afete todos os vídeos do proprietário do conteúdo com mais de 10 minutos, se um vídeo tiver várias reivindicações, o primeiro parceiro que reivindicar o conteúdo vai definir o comportamento padrão dessa propriedade em relação a ele.

11 de agosto de 2016

Esta atualização contém as seguintes alterações:

  • Os Termos de Serviço dos serviços de API do YouTube recém-publicados ("os Termos atualizados"), discutidos em detalhes no Blog de engenharia e desenvolvedores do YouTube, oferecem um conjunto abrangente de atualizações aos Termos de Serviço atuais. Além dos Termos atualizados, que vão entrar em vigor em 10 de fevereiro de 2017, esta atualização inclui vários documentos de apoio para ajudar a explicar as políticas que os desenvolvedores precisam seguir.

    O conjunto completo de novos documentos está descrito no histórico de revisões dos Termos atualizados. Além disso, as mudanças futuras nos Termos atualizados ou nos documentos de suporte também serão explicadas nesse histórico de revisões. Você pode se inscrever em um feed RSS que lista as mudanças no histórico de revisões usando um link no documento.

31 de maio de 2016

Esta atualização contém as seguintes alterações:

  • Novos recursos e métodos

    • O novo método validator.validate permite determinar se um arquivo de metadados contém erros de validação que impediriam o YouTube de processá-lo corretamente. Se o arquivo tiver erros, a propriedade errors da resposta da API vai conter uma lista de erros de validação, identificando a gravidade, a causa e o local de cada erro.

  • Erros novos e atualizados

    • Os métodos assets.patch e assets.update agora são compatíveis com o seguinte erro. Um método pode oferecer suporte a vários erros do mesmo tipo. Consulte a documentação de erros de cada método ou a página erros para ver uma lista completa de erros possíveis.

      Erros
      invalidValue (400) parameters.assetId
      A solicitação falhou porque o recurso que está sendo atualizado foi mesclado com outro. Envie a solicitação novamente usando o ID do recurso, que é retornado na mensagem de erro, como o valor do parâmetro assetId.

28 de março de 2016

Esta atualização contém as seguintes alterações:

  • Atualizações de recursos e métodos atuais

    • A nova propriedade matchInfo.matchSegments[] do recurso claim contém uma lista em que cada item descreve um segmento do vídeo reivindicado que corresponde a parte do vídeo de referência. Uma reivindicação pode ter vários segmentos de correspondência. Por exemplo, se o conteúdo de áudio e vídeo de um vídeo enviado corresponder ao de um vídeo de referência, haverá dois segmentos de correspondência. Um segmento descreveria a correspondência de áudio, e o outro, a de vídeo.

      Para cada segmento correspondente, a API retorna a duração e o tipo (áudio ou vídeo) do conteúdo correspondente. A API também identifica os ajustes de horário em que cada segmento de correspondência começa e termina no vídeo reivindicado e no vídeo de referência.

    • O valor da propriedade claimedVideoOptions.newVideoDefaults[] do recurso contentOwnerAdvertisingOptions agora pode ser atualizado quando você chama os métodos contentOwnerAdvertisingOptions.patch ou contentOwnerAdvertisingOptions.update.

    • A propriedade allowedOptions.autoGeneratedBreaks somente leitura do recurso contentOwnerAdvertisingOptions foi descontinuada.

  • Erros novos e atualizados

    • O método claims.update da API agora é compatível com o seguinte erro. Um método pode oferecer suporte a vários erros do mesmo tipo. Consulte a documentação de erros de cada método ou a página erros para ver uma lista completa de erros possíveis.

      Erros
      badRequest (400) alreadyClaimed
      A reivindicação é uma cópia de outra já existente e não pode ser atualizada.

    • O método assets.list às vezes atinge o tempo limite e retorna um código de resposta HTTP 500 (Internal Server Error), principalmente quando a solicitação recupera dados de muitos recursos e o valor do parâmetro fetchMatchPolicy é effective. Se a solicitação assets.list especificar vários IDs de recursos e retornar um erro 500, tente reenviar a solicitação para um único recurso ou um número menor de recursos.

    • A documentação de erros references.insert foi atualizada para informar que, se a solicitação fizer upload de um arquivo de referência corrompido, o problema não será identificado até que a referência seja processada. Portanto, mesmo que a solicitação references.insert retorne uma resposta bem-sucedida, a referência pode não ser processada corretamente. Recomendamos que, depois de inserir uma referência, você faça uma pesquisa usando o método references.list para confirmar se ela foi ativada conforme o esperado.

3 de fevereiro de 2016

Esta atualização contém as seguintes alterações:

  • Atualizações de recursos e métodos atuais

    • Agora a API é compatível com anúncios de informações do produto. Os anúncios das informações do produto destacam produtos relacionados ao conteúdo de um vídeo ou que aparecem nele. Esses anúncios são cards patrocinados exibidos durante o vídeo. Os cartões são adicionados automaticamente pelo sistema de anúncios. Os espectadores veem um teaser do cartão por alguns segundos e também podem clicar no ícone no canto superior direito do vídeo para procurar os cartões do vídeo.

      Como resultado dessa mudança, product_listing agora pode ser incluído nos valores das seguintes propriedades:

      Recurso/método de API Propriedade
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • Os novos createdBefore e createdAfter do método assetSearch.list instruem a API a retornar apenas recursos criados antes e/ou depois de uma determinada data.

    • Na resposta da API a uma solicitação assetSearch.list, a propriedade type agora aceita o valor art_track_video. A Central de Ajuda do YouTube oferece mais informações sobre vídeos de músicas com a capa do álbum.

    • O método claimSearch.list é compatível com os seguintes parâmetros novos:

      Parâmetros
      referenceId Esse parâmetro de filtro especifica o ID de referência do YouTube para o qual você está recuperando reivindicações.
      inactiveReasons Esse parâmetro opcional permite restringir a resposta da API para incluir apenas reivindicações inativas com base em motivos específicos. A definição de parâmetro lista os tipos de reivindicações inativas que podem ser pesquisadas.
      partnerUploaded Esse parâmetro booleano opcional permite especificar que a resposta da API inclua apenas reivindicações enviadas pelo parceiro ou não enviadas pelo parceiro.

    • O novo objeto references#origination do recurso reference contém informações que descrevem a origem da referência.

    • O método references.insert agora permite fazer upload de referências geradas usando o software gfp_gen do YouTube. Se você fornecer uma impressão digital pré-gerada, defina o valor da propriedade fpDirect como true no recurso reference enviado.

      Com essa mudança, a API não retorna mais um erro se você tentar definir a propriedade fpDirect ao fazer upload de uma referência.

  • Erros novos e atualizados

    A documentação agora lista os erros retornados pelos métodos do recurso whitelist.

    Além disso, a tabela a seguir identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Um método pode retornar vários erros do mesmo tipo. Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Erros
    badRequest (400) inappropriateCampaignTarget
    Os métodos campaigns.insert e campaigns.update retornam esse erro se uma campanha tentar apresentar um vídeo que possa ser inadequado para alguns usuários. Para corrigir o erro, escolha outro conteúdo para destacar.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    O método claims.insert retorna esse erro se você tentar criar uma reivindicação enviada pelo parceiro com um recurso de composição ou gravação de som.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    O método claims.insert retorna esse erro se já houver uma reivindicação para a música gravada no vídeo especificado. Não é possível adicionar reivindicações de composição direta pela API.
    badRequest (400) asset_id
    O método references.insert retorna esse erro se a solicitação tentou criar uma referência usando um arquivo, mas não especificou um assetId.
    badRequest (400) canNotBeActivated
    O método references.update retorna esse erro se a referência não puder ser ativada, possivelmente devido ao status ou às condições de propriedade dela.
    badRequest (400) videoNotClaimed
    O método videoAdvertisingOptions.get retorna esse erro se você não reivindicou o vídeo para o qual está tentando recuperar opções de publicidade, o que torna as informações solicitadas indisponíveis.

18 de dezembro de 2015

As leis da União Europeia (UE) exigem que determinadas declarações sejam fornecidas e consentimentos sejam coletados dos usuários finais na UE. Portanto, para usuários finais na União Europeia, você precisa obedecer à Política de consentimento de usuários da União Europeia. Adicionamos um aviso sobre esse requisito nos Termos de Serviço da API do YouTube.

21 de abril de 2015

Esta atualização contém as seguintes alterações:

30 de março de 2015

Esta atualização contém as seguintes alterações:

  • Atualizações de recursos e métodos atuais

    • O novo parâmetro isrcs do método assetSearch.list permite especificar uma lista de até 50 ISRCs. A resposta da API vai incluir os recursos associados a esses ISRCs.

    • A propriedade event[].reason do recurso claimHistory aceita os seguintes valores novos. Cada motivo explica por que um evento específico relacionado à reivindicação ocorreu:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • O novo parâmetro sort do método claimSearch.list especifica o método que será usado para ordenar os recursos na resposta da API. Por padrão, os recursos são classificados em ordem cronológica inversa (do mais recente para o mais antigo) com base nas datas de criação. Também é possível classificar os recursos do maior para o menor número de visualizações do conteúdo reivindicado.

      Se a solicitação claimSearch.list também definir o valor do parâmetro status como appealed, disputed, pending, potential ou routedForReview, os resultados serão classificados pelo horário de expiração do período de análise da reivindicação.

    • Os métodos ownership.update e ownership.patch agora listam corretamente todas as propriedades que podem ser atualizadas ao chamar esses métodos. Essa mudança representa uma correção na documentação da API e não identifica uma mudança na funcionalidade da API.

    • Os parâmetros fetchMatchPolicy dos métodos assets.get e assets.list agora listam effective como um valor compatível. O valor instrui o servidor da API a recuperar a política de correspondência que o YouTube aplica ao recurso.

    • Os parâmetros id dos métodos assets.list, claims.list, contentOwners.list, policies.list, publishers.list e references.list agora informam que os valores de parâmetro podem conter um máximo de 50 IDs separados por vírgulas.

  • Erros novos e atualizados

    A tabela abaixo identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Um método pode retornar vários erros do mesmo tipo.

    Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Tipo de erro Detalhe do erro Descrição
    badRequest (400) tooManyIsrcs O método assetSearch.list retorna esse erro se o parâmetro isrcs especificar mais de 50 ISRCs.
    badRequest (400) videoIsPrivate O método claims.insert retorna esse erro se você tentar reivindicar um vídeo privado. Só é possível reivindicar um vídeo se o status de privacidade dele for public ou unlisted.
    notModified (304) blockOutsideOwnershipUnchanged O método claims.update retorna esse erro se a flag blockOutsideOwnership na reivindicação não foi modificada. Esse erro pode ocorrer por vários motivos. Um exemplo comum é quando a modificação especificada não tem efeito no vídeo reivindicado.

7 de novembro de 2014

Esta atualização contém as seguintes alterações:

  • Atualizações de recursos e métodos atuais

    • O parâmetro status do método claimSearch.list agora aceita o valor routedForReview. Esse valor restringe os resultados a reivindicações que exigem revisão manual com base em uma regra na política de correspondência de um recurso.

    • A propriedade event[].reason do recurso claimHistory aceita os seguintes valores novos. Cada motivo explica por que um evento específico relacionado à reivindicação ocorreu:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • A propriedade origin.source do recurso claim, que identifica a origem de uma reivindicação, agora aceita o valor melodyMatch. Uma reivindicação de correspondência de melodia indica que o vídeo reivindicado compartilha uma composição musical com uma referência.

    • A documentação do método references.insert foi atualizada para refletir corretamente que a API usa dois endpoints diferentes para esse método. Isso não representa uma mudança na funcionalidade da API, mas sim uma correção na documentação atual.

      • Se a solicitação estiver enviando um novo arquivo de referência, o endpoint correto será:

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

      • Se a solicitação estiver criando uma referência usando um vídeo reivindicado como conteúdo de referência, o endpoint correto será:

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

  • Erros novos e atualizados

    A tabela abaixo identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Um método pode retornar vários erros do mesmo tipo.

    Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Tipo de erro Detalhe do erro Descrição
    badRequest (400) invalidLabelName Os métodos assets.insert, assets.update e assetLabels.insert retornam esse erro se o nome de um rótulo de recurso for inválido. Os nomes dos rótulos precisam ter entre dois e 30 caracteres. Eles não podem ter colchetes, vírgulas, dois-pontos, "e" comercial (&) ou barra vertical (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels Os métodos assets.insert, assets.update e assetLabels.insert retornam esse erro se um proprietário de conteúdo já tiver definido 2.500 rótulos de recursos exclusivos, que é o número máximo permitido atualmente.
    badRequest (400) tooManyLabelsOnOneAsset Os métodos assets.insert e assets.update retornam esse erro se um recurso já estiver associado a 30 etiquetas de recurso, que é o número máximo permitido atualmente.
    badRequest (400) channelMonetizationSuspended Os métodos claims.insert e claims.update retornam esse erro se o canal de um vídeo for suspenso por reivindicações de parceiros.
    badRequest (400) channelNotActive O método claims.update retorna esse erro se o canal de um vídeo não estiver ativo.

  • Os métodos assets.insert e assets.update não retornam mais um erro badRequest para alguns recursos se o recurso no corpo da solicitação não contiver a propriedade metadataMine.contentType.

23 de setembro de 2014

Esta atualização contém as seguintes alterações:

  • Mudanças no ID de proprietário do conteúdo

    As mudanças no ID do proprietário do conteúdo anunciadas no histórico de revisões em 9 de julho de 2014 entraram em vigor. Como resultado dessa mudança, a API agora retorna um ID exclusivo gerado para identificar o proprietário do conteúdo associado ao usuário autenticado ou a um recurso gerenciado pela API. Antes, a API retornava um nome legível como ID, por exemplo, "qrs_network".

    Essa mudança afeta a seguinte funcionalidade da API e provavelmente vai impactar parceiros que codificaram códigos de parceiro nos aplicativos.

    • Agora, a API retorna o novo ID como o valor das propriedades de recursos que antes retornavam o código do parceiro, como a propriedade id do recurso contentOwner.
    • Todos os métodos da API aceitam o parâmetro onBehalfOfContentOwner, que identifica o proprietário do conteúdo em nome de quem a solicitação de API está sendo feita. Após a mudança, o parâmetro deve ser definido como o novo ID em vez do código do parceiro. Para evitar falhas no código, o parâmetro vai aceitar qualquer um dos valores durante um período de transição.
    • Após a mudança, o parâmetro contentOwnerId do método contentOwners.list vai especificar o novo ID em vez do código do parceiro.

  • Atualizações de recursos e métodos atuais

    • O novo parâmetro metadataSearchFields do método assetSearch.list permite especificar os campos de metadados de recursos que você quer pesquisar, bem como os valores que você quer encontrar nesses campos. O valor do parâmetro é uma lista separada por vírgulas de pares de campo e valor. Em um par, o campo e o valor são separados por dois pontos.

    • O novo objeto appliedPolicy do recurso claim especifica a política que o YouTube realmente aplica à reivindicação. O valor do objeto é um recurso policy. Esse recurso contém informações de política para os países em que o proprietário do conteúdo que enviou a solicitação tem a propriedade do recurso reivindicado.

      A política aplicada pode ser diferente da definida pelo proprietário do conteúdo de duas maneiras:

      1. Ela considera as políticas definidas por outros proprietários que têm propriedade parcial do recurso reivindicado em alguns dos mesmos territórios do proprietário de conteúdo que enviou a solicitação de API.

      2. Ela considera as políticas administrativas do YouTube aplicáveis em territórios onde o proprietário do conteúdo tem a propriedade do recurso reivindicado.

    • A nova propriedade uploaderChannelId do recurso claimHistory identifica o ID do canal em que o vídeo reivindicado foi enviado.

8 de setembro de 2014

Esta atualização contém as seguintes alterações:

  • Novos recursos e métodos

    • O novo recurso assetLabel identifica um rótulo de texto que pode ser atribuído a um recurso. Com os rótulos, é possível colocar recursos em categorias personalizadas, o que facilita a organização da Biblioteca de recursos. Você pode pesquisar recursos com base nos respectivos marcadores, o que também pode simplificar casos de utilização que requerem a atualização de grupos de recursos específicos.

      • O método assetLabels.list permite recuperar uma lista de rótulos de um proprietário de conteúdo.
      • O método assetLabels.insert permite criar um novo rótulo de recurso. Você também pode criar novos rótulos chamando o método assets.update e atualizando os rótulos de um recurso. O servidor de API vai criar automaticamente um novo recurso assetLabel para qualquer rótulo não definido anteriormente.

  • Atualizações de recursos e métodos atuais

    • A propriedade label[] do recurso asset foi atualizada para informar que você pode chamar o método assets.update e atualizar os rótulos de um recurso. No entanto, não é possível definir os rótulos de um recurso ao chamar o método assets.insert.

      O novo guia Como usar rótulos de recursos explica como criar e recuperar rótulos de recursos, além de como atualizar os rótulos de um recurso ou pesquisar recursos associados a rótulos específicos.

  • Erros novos e atualizados

    A API é compatível com vários novos erros para os novos métodos assetLabels.list e assetLabels.insert.

9 de julho de 2014

Esta atualização contém as seguintes alterações:

  • Mudanças no ID de proprietário do conteúdo

    Historicamente, a API usava um código de parceiro legível por humanos, como "qrs_network", para identificar de forma exclusiva o proprietário do conteúdo associado ao usuário autenticado ou a um recurso gerenciado pela API. No terceiro trimestre de 2014, a API vai passar a usar um ID exclusivo de 22 caracteres para identificar os proprietários do conteúdo. A mudança afeta a seguinte funcionalidade da API e provavelmente vai impactar parceiros que codificaram códigos de parceiro nos aplicativos.

    • A API vai retornar o ID de 22 caracteres como o valor das propriedades de recursos que antes retornavam o código do parceiro, como a propriedade id do recurso contentOwner.
    • Todos os métodos da API aceitam o parâmetro onBehalfOfContentOwner, que identifica o proprietário do conteúdo em nome de quem a solicitação de API está sendo feita. Após a mudança, o parâmetro deve ser definido como o ID de 22 caracteres em vez do código do parceiro. Para evitar falhas no código, o parâmetro vai aceitar qualquer um dos valores durante um período de transição.
    • Após a mudança, o parâmetro contentOwnerId do método contentOwners.list vai especificar o ID de 22 caracteres em vez do código do parceiro.

  • Atualizações de recursos e métodos atuais

    • Um recurso asset agora é compatível com a propriedade label, que especifica uma lista de rótulos de recursos associados ao recurso. Você pode aplicar um marcador a diversos recursos para agrupá-los. É possível usar os rótulos como filtros de pesquisa para fazer atualizações em massa, baixar relatórios ou filtrar o YouTube Analytics.

    • O método assetSearch.list agora é compatível com os seguintes parâmetros opcionais:

      • labels: restringe os resultados para incluir apenas recursos associados aos rótulos especificados. Por padrão, a API retorna recursos que correspondem a todos os rótulos especificados. No entanto, é possível usar o parâmetro includeAnyProvidedLabel para instruir a API a retornar recursos que correspondam a qualquer um dos rótulos especificados.
      • includeAnyProvidedLabel: usado em conjunto com o parâmetro labels, ele instrui a API a retornar recursos associados a qualquer um dos rótulos especificados no valor do parâmetro labels.

    • Um recurso claimHistory agora contém as seguintes propriedades:

    • O método claimSearch.list agora é compatível com os seguintes parâmetros opcionais:

      • createdAfter: restringe os resultados para incluir apenas reivindicações criadas após a data especificada.
      • createdBefore: restringe os resultados para incluir apenas reivindicações criadas antes da data especificada.
      • includeThirdPartyClaims: usado em conjunto com o parâmetro videoId, indica se as reivindicações de terceiros devem ser incluídas nos resultados da API.

  • Informações mais detalhadas sobre o erro

    A documentação de erros agora especifica o código de resposta HTTP para cada tipo de erro.

  • Erros novos e atualizados

    A tabela abaixo identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Um método pode retornar vários erros do mesmo tipo. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset que não tenha um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, cada um retornando um erro com uma mensagem ligeiramente diferente.

    Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Método Erros
    assetSearch.list
    • invalidValue: a API não oferece suporte à pesquisa de recursos de programas ou temporadas. Mude o valor do parâmetro type para um valor compatível.
    assets.insert
    • conflict: já existem muitos recursos com o mesmo identificador (por exemplo, ID personalizado, ISRC etc.).
    • conflict: já existem muitas cópias do recurso especificado.
    • invalidValue – O usuário que chama a API não tem permissão para criar recursos do tipo especificado.
    assets.patch
    assets.update
    • badRequest: a API não é compatível com a conversão de tipo de recurso que você tentou fazer.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest – Não é possível atualizar a propriedade de um recurso de arte da capa.
    references.patch
    references.update
    • badRequest: a referência está em um estado inválido para a operação que você está tentando realizar.

3 de fevereiro de 2014

Esta atualização contém as seguintes alterações:

  • Atualizações de recursos e métodos atuais

    • Um recurso asset agora pode ter um valor type de art_track_video.

    • Um recurso claimSearch agora inclui as seguintes propriedades:

      • O objeto origin contém informações que descrevem a maneira como a reivindicação foi criada.
      • A propriedade thirdPartyClaim contém um valor booleano que indica se a reivindicação foi feita por um proprietário de conteúdo diferente daquele associado ao usuário que realizou a pesquisa.

    • O método claimSearch.list agora é compatível com os seguintes parâmetros opcionais:

      • contentType: restringe os resultados para incluir apenas reivindicações de áudio, vídeo ou audiovisuais.
      • origin: especifica uma ou mais origens de reivindicação, como descriptiveSearch ou videoMatch, para as quais você quer encontrar reivindicações.
      • status: restringe os resultados para incluir apenas declarações com o status especificado.

    • A propriedade status do recurso claim agora aceita os seguintes valores adicionais: appealed, disputed, potential, takedown e unknown.

    • A nova propriedade blockOutsideOwnership do recurso claim indica se o vídeo reivindicado deve ser bloqueado em territórios onde não é explicitamente de propriedade. Por padrão, um vídeo reivindicado ainda pode ser visualizado em países onde os dados de propriedade não foram definidos para o recurso associado à reivindicação.

    • A nova propriedade allowedOptions.autoGeneratedBreaks do recurso contentOwnerAdvertisingOption indica se o parceiro pode optar por mostrar anúncios intermediários e in-stream em intervalos determinados automaticamente pelo YouTube.

    • Agora, o método contentOwners.list pode ser chamado com um token de autorização que especifica o escopo https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

    • A nova propriedade timeUpdated do recurso policy especifica a data da última atualização da política.

    • O método policies.list agora aceita um parâmetro sort opcional, que pode ser usado para especificar que os resultados sejam classificados em ordem crescente ou decrescente de acordo com a última atualização.

    • A nova propriedade expiryTime do recurso referenceConflict especifica o horário em que o período de revisão do conflito de referência vai terminar, fazendo com que ele expire.

    • A nova propriedade autoGeneratedBreaks do recurso videoAdvertisingOption indica se o vídeo deve mostrar anúncios intermediários e in-stream em intervalos determinados automaticamente pelo YouTube.

  • Erros novos e atualizados

    A tabela abaixo identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Um método pode retornar vários erros do mesmo tipo. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset que não tenha um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, cada um retornando um erro com uma mensagem ligeiramente diferente.

    Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Método Erros
    assets.insert
    assets.update
    • badRequest: a API não é compatível com operações de gravação em recursos de arte da música.
    claimSearch.list
    • invalidValue: o parâmetro pageToken na solicitação especifica um token de página inválido.
    claims.insert
    • badRequest – A reivindicação que você está tentando criar é inválida porque o canal do vídeo não está ativo.
    • badRequest – O vídeo que você está tentando reivindicar está isento de uma política de remoção. Para consultas, entre em contato com copyright@youtube.com
    • badRequest – Não é possível processar sua solicitação porque você não pode criar uma reivindicação de terceiros no vídeo especificado.
    • conflict: o YouTube não pode criar a reivindicação solicitada porque o vídeo contestou um aviso de remoção.
    • conflict – O YouTube não pode criar a reivindicação solicitada porque o vídeo tem uma reivindicação de remoção ativa.
    references.insert
    • badRequest – O vídeo reivindicado que você está tentando usar foi excluído ou rejeitado, ou o processamento dele falhou.

  • Os erros contentOwnerNotProvided e internalError, que não são específicos de um método de API, não são mais listados em todas as páginas de métodos. As descrições ainda podem ser encontradas na seção Erros gerais da documentação de erros da API.

12 de setembro de 2013

Esta atualização contém as seguintes alterações:

  • Novos recursos e métodos

    • O novo recurso referenceConflict identifica um conflito entre dois arquivos de referência e lista as correspondências que existiam entre eles quando o conflito foi identificado. O método referenceConflicts.list permite recuperar uma lista de conflitos de referência não resolvidos associados ao proprietário de conteúdo autorizado. O método referenceConflicts.get permite recuperar um conflito de referência especificando o ID exclusivo dele.

    Atualizações de recursos e métodos atuais

    • Agora a API oferece suporte à capacidade de recuperar a política de correspondência efetiva de um recurso. Essa mudança é semelhante às mudanças lançadas em 16 de julho de 2013, que incluíam suporte para recuperar o conjunto canônico de metadados e dados de propriedade de um recurso.

      Para recuperar a política de correspondência efetiva de um recurso, defina o valor do parâmetro fetchMatchPolicy como effective ao chamar os métodos assets.get ou assets.list. Na resposta da API, o objeto matchPolicyEffective em cada recurso asset retornado contém a política de correspondência efetiva desse recurso.

    • O novo objeto ownershipConflicts do recurso asset contém informações sobre os conflitos de propriedade do recurso. A estrutura do objeto é semelhante à de um recurso ownership, que identifica cada tipo diferente de direitos que um proprietário de recurso pode ter. Para a maioria dos tipos de recursos, os proprietários podem ter apenas a propriedade geral do recurso, mas, no caso de recursos de composição, eles podem detalhar a propriedade dos direitos de performance, sincronização ou reprodução mecânica.

      Da mesma forma, o objeto ownershipConflicts contém listas separadas que identificam conflitos para direitos gerais de propriedade, direitos de execução, direitos de sincronização e direitos mecânicos. Para cada conflito, os dados identificam os territórios em que ele ocorre, os proprietários que forneceram dados de propriedade conflitantes e a porcentagem do recurso que cada proprietário em conflito reivindica possuir.

    • Os métodos assets.get e assets.get agora são compatíveis com o novo parâmetro fetchOwnershipConflicts. O parâmetro tem um valor booleano que indica se a solicitação de API precisa recuperar conflitos de propriedade dos recursos na resposta da API. O valor padrão é false, o que significa que conflitos de propriedade não são retornados.

    • A definição do parâmetro q do método assetSearch.list foi atualizada para identificar os campos de metadados que o YouTube pesquisa.

    • A documentação do corpo da solicitação para um método references.insert agora indica que é necessário definir o valor da propriedade contentType. Essa mudança atualiza a documentação para refletir corretamente a funcionalidade real da API, mas não representa uma mudança na funcionalidade da API.

  • Erros novos e atualizados

    • A API oferece suporte a um novo erro forbidden, que não é específico de um determinado método e indica que a operação solicitada não pode ser autorizada por uma conta de serviço.

    • O método assets.insert agora identifica erros de metadados como ocorrendo em propriedades no objeto metadataMine em vez do objeto metadata, que foi descontinuado a partir da atualização da API em 16 de julho de 2013.

    • A página errors foi atualizada para que, em cada recurso que oferece suporte aos métodos update e patch, a página contenha uma tabela que lista os erros retornados por esses dois métodos. Antes, a página listava os erros de cada método separadamente, embora as listas fossem sempre as mesmas.

16 de julho de 2013

Esta atualização contém as seguintes alterações:

  • Novos recursos e métodos

    • O novo método claimHistory.get permite identificar e recuperar informações sobre uma reivindicação específica. O recurso claimHistory retornado contém uma lista de eventos relacionados à reivindicação, como criação, atualização, disputa ou encerramento.

    • O novo método claimSearch.list permite pesquisar reivindicações que atendam a um ou a todos os seguintes critérios:

      • As reivindicações estão associadas a um recurso específico.
      • As reivindicações estão associadas a um vídeo específico.
      • As declarações correspondem a uma string de consulta fornecida na solicitação.

      Cada recurso claimSnippet na resposta da API contém detalhes sobre uma reivindicação, incluindo o ID exclusivo dela, o status, o tipo (audio, video ou audiovisual) e o recurso e o vídeo associados a ela. O recurso também especifica o número de visualizações e o título do vídeo reivindicado.

  • Atualizações de recursos e métodos atuais

    • A documentação agora lista os valores aceitos para propriedades que têm um conjunto de valores enumerados. Essas propriedades incluem a propriedade type do recurso asset e a propriedade status do recurso claim.

    • Para os métodos assets.get e assets.list, a API agora aceita valores separados por vírgulas para os parâmetros de solicitação fetchMetadata e fetchOwnership, permitindo recuperar vários conjuntos de metadados ou dados de propriedade.

      A lista abaixo explica as mudanças correspondentes na estrutura do recurso asset, bem como os impactos dessas mudanças nos métodos da API que get, list, insert, update ou patch recursos asset.

      • O objeto metadata foi descontinuado e substituído pelos objetos metadataMine e metadataEffective. Os novos objetos permitem que um recurso asset inclua o conjunto de metadados fornecido pelo proprietário do conteúdo que faz a solicitação de API e o conjunto canônico de metadados que o YouTube determinou ser o mais preciso e completo para o recurso.

      • Da mesma forma, o objeto ownership foi substituído pelos objetos ownershipMine e ownershipEffective.

      • O objeto matchPolicy foi substituído pelo objeto matchPolicyMine. No momento, a API não oferece suporte à recuperação da política de correspondência efetiva de um recurso.

      Observação:para garantir a compatibilidade com versões anteriores, se apenas uma versão de metadados, um conjunto de dados de propriedade ou uma política de correspondência for solicitada para um recurso, a resposta da API vai incluir o objeto descontinuado e o objeto recém-compatível. Por exemplo, se uma solicitação definir o parâmetro fetchMetadata como mine, a resposta da API vai conter um objeto metadata e um objeto metadataMine, ambos com os mesmos dados. A capacidade de definir fetchMetadata=mine era compatível antes da atualização do recurso, permitindo recuperar várias versões de metadados.

      No entanto, se o parâmetro fetchMetadata estiver definido como mine,effective, a resposta da API vai conter objetos metadataMine e metadataEffective, mas não um objeto metadata. A capacidade de definir fetchMetadata=mine,effective não era compatível antes dessa atualização de recurso. Portanto, não é necessário retornar o objeto metadata para compatibilidade com versões anteriores. O mesmo princípio também se aplica aos parâmetros fetchOwnership e fetchMatchPolicy.

      Da mesma forma, para compatibilidade com versões anteriores, uma solicitação para insert, update ou patch um recurso asset pode incluir o objeto metadataMine ou o objeto metadata. O mesmo princípio se aplica à definição dos dados de propriedade ou da política de correspondência de um recurso asset.

    • Os parâmetros assetId, q e videoId do método claims.list foram descontinuados. Para pesquisar reivindicações usando qualquer um desses critérios, use o método claimSearch.list, que é compatível com todos esses parâmetros.

    • Em um recurso ownership, os valores das propriedades general[].ratio, performance[].ratio, synchronization[].ratio e mechanical[].ratio agora têm um formato de conteúdo double em vez de integer.

    • A definição da propriedade rules[].action do recurso policy agora lista valores válidos para essa propriedade: block, monetize, takedown e track. No entanto, não é possível usar a API para aplicar uma política de remoção a uma reivindicação.

    • A nova propriedade claimId do recurso reference estará presente se a referência foi criada associando um recurso a um vídeo do YouTube existente que foi enviado a um canal do YouTube vinculado à sua conta do CMS. Nesse caso, esse campo contém o ID da reivindicação que representa a associação resultante entre o recurso e o vídeo.

    • A nova propriedade excludedIntervals[] do recurso reference especifica uma lista de intervalos de tempo durante a referência que o YouTube deve ignorar ao tentar fazer a correspondência. Cada intervalo especifica um horário de início e término medido em segundos desde o início do vídeo.

    • A API não exige mais que a propriedade status seja definida no recurso reference enviado no corpo de uma solicitação references.update ou references.patch.

    • A documentação foi corrigida para descrever corretamente o formato de resposta da API para o método videoAdvertisingOptions.getEnabledAds. A resposta, que é um recurso youtubePartner#videoAdvertisingOptionGetEnabledAds, contém as seguintes informações:

      • id: o ID que o YouTube usa para identificar de forma exclusiva o vídeo reivindicado associado às configurações.

      • adBreaks: uma lista de objetos em que cada um contém informações sobre um ponto antes, durante ou depois da reprodução do vídeo, quando os anúncios podem ser veiculados. Cada objeto também pode especificar outros atributos do intervalo de anúncio, como os espaços de anúncio que ocorrem durante o intervalo e os tipos de anúncios que podem ser veiculados em cada espaço.

      • adsOnEmbeds: um campo booleano que indica se o YouTube pode mostrar anúncios quando o vídeo é reproduzido em um player incorporado.

      • countriesRestriction: uma lista de objetos em que cada um identifica uma lista de territórios e os formatos de anúncio usados durante as reproduções do vídeo nesses territórios.

  • Erros novos e atualizados

    • A tabela abaixo identifica novos erros compatíveis com a API e os métodos que podem retornar cada erro. Ele também identifica erros que mudaram. Um método pode retornar vários erros do mesmo tipo. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset que não tenha um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, cada um retornando um erro com uma mensagem ligeiramente diferente.

      Consulte a documentação de erros de cada método ou a página Erros para mais informações.

      Método Erros
      assets.insert
      assets.update
      assets.patch
      • Os erros invalidValue e required antes associados a propriedades secundárias do objeto metadata agora estão associados às mesmas propriedades secundárias no objeto metadataMine.
      claimHistory.get
      • notFound – Não foi possível encontrar a reivindicação para a qual você está tentando recuperar o histórico.
      • required: a solicitação não especifica um valor para o parâmetro claimId.
      claimSearch.list
      claims.list
      • badRequest: a solicitação especifica critérios inválidos. No máximo, um dos seguintes parâmetros de filtro pode ser especificado: q, assetId, videoId.
      claims.insert
      • badRequest: a reivindicação que você está tentando criar é inválida porque o proprietário do conteúdo solicitado não é proprietário do recurso associado a ela.
      • badRequest: o proprietário do conteúdo em nome de quem você está agindo não tem permissão para criar políticas com a ação especificada.
      • invalidValue – O proprietário do conteúdo em nome de quem você está agindo não tem permissão para reivindicar vídeos enviados por usuários usando a API.
      contentOwners.list
      • badRequest: a solicitação especifica critérios inválidos. É necessário especificar exatamente um dos seguintes parâmetros de filtro: fetchMine, id. Antes, o erro listava um conjunto diferente de parâmetros de filtro: has_conflicts_with, restrict_to_user, name_prefix e id.
      ownership.update
      ownership.patch
      • badRequest: uma solicitação que atualiza os dados de propriedade de um recurso de composição precisa especificar dados de propriedade granulares (direitos de mechanical, performance, synchronization e/ou lyric) em vez de direitos de propriedade general. O tipo de direitos lyric agora é compatível.
      policies.insert
      policies.update
      policies.patch
      • invalidValue: a solicitação contém uma regra de política inválida porque a API não aceita a criação ou modificação de políticas que especificam uma ação takedown. Esse erro, que informa o motivo invalidPolicyTakedownAction, substitui o erro invalidPolicyConditionalTakedown descontinuado.
      references.insert
      • badRequest: a solicitação precisa enviar um arquivo de mídia ou especificar um valor para o parâmetro de solicitação claimId. No entanto, uma solicitação não pode enviar um arquivo de mídia e especificar um valor para o parâmetro de solicitação claimId.
      • badRequest – Já foi criada uma referência para o mesmo conteúdo usando uma reivindicação diferente no mesmo vídeo do YouTube.
      • badRequest: a API não permite definir um valor para a propriedade fpDirect ao criar uma referência.
      • internalError – Há um problema com o arquivo de mídia enviado.
      • invalidValue: o valor do parâmetro de solicitação contentType, assetId ou claimId é inválido. O erro identifica o valor inválido.
      • notFound: não foi possível encontrar o recurso ou a reivindicação especificada. Verifique os valores dos parâmetros assetId e claimId na sua solicitação.
      • required: a solicitação precisa especificar um valor para o parâmetro contentType.
      references.insert
      references.update
      references.patch
      • invalidValue: o excludedIntervals especificado para a referência não é válido. Não é possível especificar intervalos de exclusão ao desativar uma referência.

10 de maio de 2013

Esta atualização contém as seguintes alterações:

8 de abril de 2013

Esta atualização contém as seguintes alterações:

  • A API foi renomeada como API YouTube Content ID.

  • Várias propriedades foram alteradas no recurso assetMatchPolicy:

    • O valor da propriedade kind mudou de youtubePartner#policy para youtubePartner#assetMatchPolicy.
    • A nova propriedade policyId contém um valor que identifica de forma exclusiva um recurso de política salva.
    • O valor da propriedade rules[].subaction agora é uma lista de strings, e não uma string.
    • O valor da propriedade rules[].conditions.contentMatchType agora é uma lista de strings, e não uma string.
    • As propriedades id, name e description foram removidas.

  • A documentação do método assetMatchPolicy.update foi atualizada para refletir o fato de que é possível definir valores para a propriedade policyId ou o objeto rules[] ao chamar o método.

  • O recurso claims agora aceita várias propriedades novas:

    Nome da propriedade Valor Descrição
    timeCreated datetime A data e a hora em que a reivindicação foi criada.
    matchInfo object O objeto matchInfo contém informações sobre o conteúdo correspondente que gerou a reivindicação. Essas informações só são incluídas em um recurso claim se a reivindicação foi gerada automaticamente porque um vídeo enviado correspondia a um arquivo de referência existente.
    matchInfo.referenceId string O ID exclusivo que o YouTube usa para identificar a reference de referência que gerou a correspondência.
    matchInfo.longestMatch object O objeto longestMatch contém informações sobre a maior correspondência entre a referência e o vídeo enviado.
    matchInfo.longestMatch.durationSecs unsigned long A duração da partida, em segundos.
    matchInfo.longestMatch.userVideoOffset unsigned long O ajuste de tempo quando a correspondência começa, medido em segundos desde o início do vídeo enviado.
    matchInfo.longestMatch.referenceOffset unsigned long O ajuste de tempo quando a correspondência começa, medido em segundos desde o início da referência.
    matchInfo.totalMatch object O objeto totalMatch contém informações sobre a quantidade total do vídeo enviado que correspondeu à referência e sobre a quantidade total da referência que correspondeu ao vídeo enviado. Esses valores podem ser diferentes se o conteúdo correspondente for executado em loop no vídeo enviado ou na referência. Por exemplo, se um vídeo enviado incluir um clipe de 10 segundos de uma referência, mas o clipe for repetido seis vezes, o total de conteúdo correspondente no vídeo enviado será de 60 segundos, mas o total de conteúdo correspondente na referência será de apenas 10 segundos.
    matchInfo.totalMatch.userVideoDurationSecs unsigned long A duração total, em segundos, do conteúdo do vídeo enviado que corresponde à referência.
    matchInfo.totalMatch.referenceDurationSecs unsigned long A duração total, em segundos, do conteúdo de referência que corresponde ao vídeo enviado.
    origin object O objeto origin contém informações que descrevem a origem da reivindicação.
    origin.source string A origem da reivindicação.

  • A propriedade policy no recurso claims foi atualizada para informar que o valor não pode ser atualizado em uma reivindicação do AudioSwap.

  • A propriedade timeProvidedMs do recurso metadataHistory foi renomeada como timeProvided.

  • A propriedade timeProvidedMs do recurso ownershipHistory foi renomeada como timeProvided.

  • A definição do método ownershipHistory.list foi atualizada para informar que ele só recupera os dados de propriedade mais recentes de cada proprietário de conteúdo. No entanto, se o proprietário do conteúdo enviou dados de propriedade por várias fontes de dados (API, feeds de conteúdo, etc.), a lista conterá os dados mais recentes para cada proprietário de conteúdo e fonte de dados.

  • Várias propriedades foram alteradas no recurso policy:

    • A propriedade rule foi renomeada como rules.
    • O valor da propriedade rules[].subaction agora é uma lista de strings, e não uma string.
    • O valor da propriedade rules[].conditions.contentMatchType agora é uma lista de strings, e não uma string.

  • A documentação dos métodos policies.insert e policies.update foi atualizada para refletir o fato de que é possível definir valores para o objeto rules[] ao chamar esses métodos.

  • Vários métodos de API agora são compatíveis com novos tipos de erros. A tabela abaixo identifica o método e os tipos de erros recém-compatíveis. Em muitos casos, pode haver vários erros para um determinado tipo. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset que não tenha um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, cada um retornando um erro com uma mensagem ligeiramente diferente.

    Consulte a documentação de erros de cada método ou a página Erros para mais informações.

    Método Erros
    assets.insert
    • invalidValue: um campo de metadados do recurso contém um valor inválido.
    • required: um campo obrigatório de metadados do recurso está ausente.
    assets.update
    assets.patch
    • forbidden – O recurso que está sendo atualizado não é de propriedade do parceiro que está tentando concluir a atualização.
    • invalidValue: um campo de metadados do recurso contém um valor inválido.
    • notFound: o recurso está sendo associado a um recurso de temporada ou programa que não foi encontrado.
    • required: um campo obrigatório de metadados do recurso está ausente.
    claims.insert
    • badRequest: a solicitação tenta reivindicar um vídeo, mas a reivindicação não é permitida.
    ownership.update
    ownership.patch
    • badRequest: a solicitação define uma propriedade total maior que 100% em um território.
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules: a política contém regras conflitantes.

  • A nova página erros lista os erros que a API pode retornar. A página inclui erros gerais, que podem ocorrer em vários métodos de API diferentes, além de erros específicos do método.

18 de janeiro de 2013

Esta atualização contém as seguintes alterações:

  • O método videoAdvertisingOptions.getEnabledAds recém-documentado permite recuperar detalhes sobre os tipos de anúncios permitidos para um vídeo específico enviado por um parceiro ou usuário.

  • A definição do parâmetro ownershipRestriction do método assetSearch.list foi atualizada para informar que o valor padrão do parâmetro é mine, o que indica que a API só deve recuperar recursos pertencentes ao usuário atual.

  • A documentação do método assets.list reflete as seguintes mudanças:

    • O parâmetro id agora é obrigatório.

    • O parâmetro fetchMatchPolicy recém-compatível permite indicar se a solicitação de API também precisa recuperar a política de correspondência definida para o recurso.

    • O parâmetro fetchOwnership recém-compatível permite indicar se a solicitação de API também precisa recuperar dados de propriedade do recurso.

    • A lista de recursos retornada pela API não contém mais dados de paginação. Como resultado, a propriedade nextPageToken e o objeto pageInfo foram removidos da resposta da API. O objeto pageInfo continha as propriedades totalResults, resultsPerPage e startIndex.

  • A documentação do recurso claims foi atualizada para informar que é necessário especificar uma política ao criar uma reivindicação. (No momento, o YouTube não aplica sua política de uso padrão se uma reivindicação inserida não especificar uma política, embora a documentação tenha indicado anteriormente que isso acontecia.)

  • A propriedade hasUnpublishedDraft do recurso policy foi descontinuada.

  • O parâmetro id recém-compatível do método policies.list permite identificar as políticas salvas que a solicitação de API precisa recuperar. Somente as políticas pertencentes ao proprietário do conteúdo autenticado no momento podem ser recuperadas.

  • A definição do parâmetro releaseClaims para os métodos references.patch e references.update foi atualizada para informar que o parâmetro só funciona quando o status da reivindicação é atualizado para inactive. Nesse caso, você também pode definir o valor do parâmetro releaseClaims como true para liberar todas as reivindicações de correspondência produzidas pela referência.

  • Os métodos references.patch e references.update foram atualizados para informar que é necessário especificar o status da referência ao realizar qualquer uma dessas operações.

  • Vários métodos de API agora são compatíveis com novos tipos de erros. A tabela abaixo identifica o método e os erros com suporte recente:

    Método Tipo de erro Detalhe do erro Descrição
    guideCategories.list notFound Unavailable Não foi possível encontrar o recurso para o qual você está tentando recuperar a política de correspondência.
    claims.get notFound Unavailable A reivindicação que você está tentando recuperar não pode ser encontrada.
    ownership.patch invalidValue Unavailable Os dados de propriedade fornecidos contêm um valor inválido.
    ownership.update invalidValue Unavailable Os dados de propriedade fornecidos contêm um valor inválido.