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

Observação:a API Content ID do YouTube é destinada a parceiros de conteúdo do YouTube e não é acessível para todos os desenvolvedores ou usuários da plataforma. Se a API Content ID do YouTube não estiver listada no Console de APIs do Google, acesse a Central de Ajuda do YouTube para saber mais sobre o Programa de Parcerias do YouTube.

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

26 de março de 2025

A partir de 31 de março de 2025, o YouTube vai mudar a forma como as visualizações dos Shorts são contabilizadas. Antes, as visualizações dos Shorts eram contabilizadas depois que o conteúdo era reproduzido por alguns segundos. Agora, as visualizações vão contar o número de vezes que o Short 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 da seguinte forma:

  • 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 de contagem de visualizações.
  • 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 vai ser atualizada da seguinte forma:

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

14 de janeiro de 2025

O campo autoGeneratedBreaks[] do recurso videoAdvertisingOption foi atualizado, já que 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 e postroll. Consulte o artigo de suporte para mais detalhes.

1º de junho de 2023

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

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 do 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 licenciabilidade foram adicionadas ao asset resource.

18 de julho de 2022

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

  • O Studio já havia removido o suporte para Audio Swap e Song Erase. Os valores da API correspondentes, audio_removed e song_erased, foram ignorados silenciosamente e agora foram descontinuados.
  • channel_whitelisted foi substituído por channel_allowlisted. O valor anterior não está mais documentado, mas ainda é aceito.
  • Os valores closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced e video_modified agora têm suporte.

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, com cada valor especificando 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 as 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 de reivindicação.

2 de maio de 2022

A documentação da Resposta do método assetSearch.list foi atualizada para refletir melhorias de 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 oferece suporte à 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 este método abrange:

  • Pesquisar por ID (recurso, referência ou vídeo) ou string de consulta
  • Pesquisar por data de criação, 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 aceitos em cada caso de uso.

17 de novembro de 2021

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

  • O método claims.update agora oferece suporte à capacidade de atualizar o status de uma reivindicação inativa ou potencial para active. A definição da propriedade status do recurso claim fornece 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 contiver mais de 10 IDs de vídeo.

6 de dezembro de 2018

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

A documentação da API foi atualizada para remover as referências ao recurso contentOwnerAdvertisingOptions e aos métodos dele. Esses métodos foram usados de forma mínima, e os usuários da API que os usaram 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 agora precisa ser definida sempre que você inserir, atualizar ou corrigir um recurso de vídeo de música ou gravação de som. A API agora retorna um erro se a propriedade não estiver definida para esses tipos de recurso. Além disso, a propriedade metadataMine.artist só tem suporte para artistas de videoclipes e gravações de som.

24 de julho de 2017

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

  • O novo recurso package representa um grupo de arquivos enviados pela Web, SFTP ou outro mecanismo de envio. A API oferece suporte a dois métodos para esse recurso:

    • O método package.insert valida e envia um pacote somente de metadados contendo 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 indicar que o valor não identifica o parceiro de conteúdo que faz o upload dos dados, mas um valor como web-google ou yt-google que identifica a conta de envio específica que o proprietário do conteúdo está usando.

  • A propriedade status do recurso reference não usa mais o valor duplicate_on_hold para indicar que uma referência é uma cópia 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ó é preenchida se a referência for duplicada. Se estiver definido, o valor dessa 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 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 o próprio 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 muitas gravações de som.

    O recurso assetShare identifica uma relação entre uma visualização de composição e uma compartilhamento de composição. O novo método assetShares.list permite fazer o seguinte:

    • Forneça o ID de uma visualização de composição e extraia a respectiva participação de composição pertencente ao parceiro que autorizou a solicitação, se ela existir.
    • Forneça o ID de uma cota de composição pertencente ao parceiro de conteúdo e extraia 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 compartilhamentos de composição.

  • A nova propriedade claimedVideoOptions.autoGeneratedBreaks do recurso contentOwnerAdvertisingOptions indica se o YouTube deve gerar automaticamente intervalos de anúncios em vídeos reivindicados com mais de 10 minutos. 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 um vídeo 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 de atualizações dos Termos de Serviço atuais. Além dos termos atualizados, que vão entrar em vigor em 10 de fevereiro de 2017, essa atualização inclui vários documentos de apoio para 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 apoio 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. 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 oferecem suporte ao seguinte erro. Vale lembrar que um método pode oferecer suporte a vários erros com o mesmo tipo. Consulte a documentação de erro de cada método ou a página errors para conferir uma lista completa de possíveis erros.

      Erros
      invalidValue (400) parameters.assetId
      A solicitação falhou porque o recurso que está sendo atualizado foi mesclado a outro. Envie novamente a solicitação 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 declaraçã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 for igual ao de um vídeo de referência, haverá dois segmentos de correspondência. Um segmento descreve a correspondência de áudio e o outro, a correspondência de vídeo.

      Para cada segmento de correspondência, 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 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 oferece suporte ao seguinte erro. Vale lembrar que um método pode oferecer suporte a vários erros com o mesmo tipo. Consulte a documentação de erro de cada método ou a página errors para conferir uma lista completa de possíveis erros.

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

    • O método assets.list às vezes expira 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 recurso 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 o 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, a referência pode não ser processada. Recomendamos que, após inserir uma referência, você faça uma pesquisa usando o método references.list para confirmar se a referência 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

    • A API agora é compatível com anúncios de lista de produtos. Os anúncios de listagem de produtos destacam produtos relacionados ou em destaque no conteúdo de um vídeo. 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:

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

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

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

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

      Parâmetros
      referenceId Esse parâmetro de filtro especifica o ID de referência do YouTube da referência para a qual você está recuperando as reivindicações.
      inactiveReasons Esse parâmetro opcional permite restringir a resposta da API para incluir apenas reivindicações inativas com base em motivos especificados. A definição do parâmetro lista os tipos de reivindicações inativas que podem ser pesquisados.
      partnerUploaded Esse parâmetro booleano opcional permite especificar que a resposta da API deve incluir apenas declarações enviadas pelo parceiro ou não 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 oferece suporte ao 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 por upload.

      Com essa mudança, a API não retorna mais um erro se você tentar definir a propriedade fpDirect ao fazer o 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 com o mesmo tipo. Consulte a documentação de erros de cada método ou a página errors para mais informações.

    Erros
    badRequest (400) inappropriateCampaignTarget
    Os métodos campaigns.insert e campaigns.update retornam esse erro se uma campanha tentar exibir um vídeo que pode 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 uma reivindicação já existir 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 por 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 da referência ou às condições de propriedade.
    badRequest (400) videoNotClaimed
    O método videoAdvertisingOptions.get vai retornar esse erro se você não tiver reivindicado o vídeo para o qual está tentando recuperar as 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 divulgações sejam feitas e consentimentos sejam obtidos dos usuários finais na UE. Portanto, para usuários finais na União Europeia, você precisa obedecer à Política de consentimento para 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 oferece suporte aos novos valores a seguir. 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 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. Você também pode 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 tempo 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 aceito. 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 podem conter no máximo 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 com o mesmo tipo.

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

    Tipo de erro Detalhe do erro Descrição
    badRequest (400) tooManyIsrcs O método assetSearch.list vai retornar 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 particular. 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 vai retornar esse erro se a flag blockOutsideOwnership na declaração não tiver sido 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 uma análise manual com base em uma regra na política de correspondência de um recurso.

    • A propriedade event[].reason do recurso claimHistory oferece suporte aos novos valores a seguir. 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 declaraçã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 uma correção na documentação atual.

      • Se a solicitação estiver fazendo o upload de um novo arquivo de referência, o endpoint correto é:

        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 com o mesmo tipo.

    Consulte a documentação de erros de cada método ou a página errors 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 a 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 no momento.
    badRequest (400) tooManyLabelsOnOneAsset Os métodos assets.insert e assets.update retornam esse erro se um recurso já estiver associado a 30 rótulos, que é o número máximo permitido no momento.
    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 do 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 por humanos como ID, como "qrs_network".

    Essa mudança afeta a funcionalidade da API a seguir e provavelmente vai afetar os parceiros que codificaram os códigos de parceiros 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 oferecem suporte ao parâmetro onBehalfOfContentOwner, que identifica o proprietário do conteúdo em nome de quem a solicitação da API está sendo feita. Após a mudança, o parâmetro precisa ser definido como o novo ID, e não o código do parceiro. Para evitar falhas no código, o parâmetro aceita qualquer valor durante um período de transição.
    • Após a mudança, o parâmetro contentOwnerId do método contentOwners.list precisa 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 do recurso que você quer pesquisar, bem como os valores que você quer pesquisar nesses campos. O valor do parâmetro é uma lista de pares de campo e valor separados por vírgulas. 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 aplica para a reivindicação. O valor do objeto é um recurso policy. Esse recurso contém informações sobre a política para os países em que o proprietário do conteúdo que enviou a solicitação é proprietário do recurso reivindicado.

      A política aplicada pode ser diferente da política 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 do conteúdo que enviou a solicitação da API.

      2. Ele considera as políticas administrativas do YouTube que se aplicam nos territórios em que o proprietário do conteúdo é o proprietário 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. Os rótulos permitem que você coloque recursos em categorias personalizadas, o que facilita a organização da sua 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. Também é possível criar novos rótulos chamando o método assets.update e atualizando os rótulos de um recurso. O servidor da API vai criar automaticamente um novo recurso assetLabel para qualquer rótulo indefinido.

  • 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 para 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 os rótulos de recursos explica como criar e recuperar rótulos de recursos, além de atualizar os rótulos de um recurso ou pesquisar recursos associados a rótulos específicos.

  • Erros novos e atualizados

    A API oferece suporte a vários novos erros para os 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 do proprietário do conteúdo

    Historicamente, a API usava um código de parceiro legível por humanos, como "qrs_network", para identificar exclusivamente 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 de conteúdo. A mudança afeta a funcionalidade da API a seguir e provavelmente vai afetar os parceiros que codificaram os códigos de parceiros nos apps.

    • A API vai retornar o ID de 22 caracteres como o valor das propriedades de recursos que anteriormente retornavam o código do parceiro, como a propriedade id do recurso contentOwner.
    • Todos os métodos da API oferecem suporte ao parâmetro onBehalfOfContentOwner, que identifica o proprietário do conteúdo em nome de quem a solicitação da API está sendo feita. Após a mudança, o parâmetro precisa ser definido como o ID de 22 caracteres em vez do código do parceiro. Para evitar falhas no código, o parâmetro aceita qualquer valor durante um período de transição.
    • Após a mudança, o parâmetro contentOwnerId do método contentOwners.list precisa 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 oferece suporte à propriedade label, que especifica uma lista de rótulos associados ao recurso. Você pode aplicar um marcador a diversos recursos para agrupá-los. Você pode usar os rótulos como filtros de pesquisa para fazer atualizações em massa, fazer o download de relatórios ou filtrar o YouTube Analytics.

    • O método assetSearch.list agora oferece suporte aos seguintes parâmetros opcionais:

      • labels: restringe os resultados para incluir apenas os recursos associados aos rótulos especificados. Por padrão, a API retorna recursos que correspondem a todos os rótulos especificados. No entanto, você pode usar o parâmetro includeAnyProvidedLabel para instruir a API a retornar recursos que correspondem a qualquer um dos rótulos especificados.
      • includeAnyProvidedLabel: usado com o parâmetro labels, esse parâmetro instrui a API a retornar os recursos associados a qualquer um dos identificadores especificados no valor do parâmetro labels.

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

    • O método claimSearch.list agora oferece suporte aos seguintes parâmetros opcionais:

      • createdAfter: restringe os resultados para incluir apenas as reivindicações criadas após a data especificada.
      • createdBefore: restringe os resultados para incluir apenas as reivindicações criadas antes da data especificada.
      • includeThirdPartyClaims: usado com o parâmetro videoId, indica se é necessário incluir declarações de terceiros 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 com o mesmo tipo. Por exemplo, um erro required é retornado se você tentar inserir um recurso asset que não tem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles vai retornar um erro com uma mensagem um pouco diferente.

    Consulte a documentação de erros de cada método ou a página errors 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 aceito.
    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 oferece suporte à conversão do tipo de recurso que você tentou.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest: não é possível atualizar a propriedade de um recurso de arte da faixa.
    references.patch
    references.update
    • badRequest: a referência está em um estado inválido para a operação que você está tentando fazer.

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 novas propriedades:

      • O objeto origin contém informações que descrevem a maneira como a declaraçã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 do associado ao usuário que realiza a pesquisa.

    • O método claimSearch.list agora oferece suporte aos seguintes parâmetros opcionais:

      • contentType: restringe os resultados para incluir apenas reivindicações de áudio, de 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 oferece suporte aos seguintes valores adicionais: appealed, disputed, potential, takedown e unknown.

    • A nova propriedade blockOutsideOwnership do recurso claim indica se o vídeo reivindicado precisa ser bloqueado em territórios em que não é explicitamente de propriedade. Por padrão, um vídeo reivindicado ainda poderia ser visualizado em países em que 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 mostrar anúncios intermediários in-stream em intervalos determinados automaticamente pelo YouTube.

    • O método contentOwners.list agora 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 o momento em que a política foi atualizada pela última vez.

    • O método policies.list agora oferece suporte a um parâmetro sort opcional, que pode ser usado para especificar que os resultados precisam ser classificados em ordem crescente ou decrescente da última vez que foram atualizados.

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

    • A nova propriedade autoGeneratedBreaks do recurso videoAdvertisingOption indica se o vídeo precisa mostrar anúncios intermediários in-stream nos 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 com o mesmo tipo. Por exemplo, um erro required é retornado se você tentar inserir um recurso asset que não tem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles vai retornar um erro com uma mensagem um pouco diferente.

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

    Método Erros
    assets.insert
    assets.update
    • badRequest: a API não oferece suporte a operações de gravação em recursos de arte da faixa.
    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 dúvidas, entre em contato com copyright@youtube.com
    • badRequest: não é possível processar sua solicitação porque não é possível 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 específico, não são mais listados em todas as páginas de método. 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 esses arquivos 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 do 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 extrair 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 a recuperação do 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 eficaz para esse 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 de direito que um proprietário de recurso pode ter. Na maioria dos tipos de recursos, os proprietários podem ter apenas a propriedade geral, mas, no caso de recursos de composição, eles podem detalhar a propriedade dos direitos de execução, de sincronização ou mecânicos.

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

    • Os métodos assets.get e assets.get agora oferecem suporte ao novo parâmetro fetchOwnershipConflicts. O parâmetro tem um valor booleano que indica se a solicitação da API precisa recuperar conflitos de propriedade dos recursos na resposta da API. O valor padrão é false, o que significa que os 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 de um método references.insert agora indica que você precisa 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, que 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 que ocorrem em propriedades no objeto metadataMine, em vez de no objeto metadata, que foi descontinuado desde a atualização da API em 16 de julho de 2013.

    • A página errors foi atualizada para que, em cada recurso compatível com os métodos update e patch, ela 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, mas as listas eram 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 a criação, atualização, contestação ou encerramento dela.

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

      • As reivindicações sã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, o status e o tipo (audio, video ou audiovisual) dela, além do recurso e do vídeo associados à reivindicação. 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 oferece suporte a valores separados por vírgulas para os parâmetros de solicitação fetchMetadata e fetchOwnership, permitindo que você recupere vários conjuntos de metadados ou dados de propriedade.

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

      • 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 da API, bem como o conjunto canônico de metadados que o YouTube determinou como 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 à capacidade de recuperar a política de correspondência em vigor 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 forem solicitados para um recurso, a resposta da API vai incluir o objeto descontinuado e o novo. Por exemplo, se uma solicitação definir o parâmetro fetchMetadata como mine, a resposta da API vai conter um objeto metadata e um metadataMine, ambos com os mesmos dados. A capacidade de definir fetchMetadata=mine era compatível antes da atualização do recurso que permite recuperar várias versões de metadados.

      No entanto, se o parâmetro fetchMetadata for 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 de um recurso asset pode incluir o objeto metadataMine ou 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 aceita 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 de 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 está presente se a referência foi criada pela associação de um recurso a um vídeo do YouTube enviado para um canal 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 precisa ignorar ao tentar fazer a correspondência. Cada intervalo especifica um horário de início e término medido em segundos a partir do 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 exclusivamente o vídeo reivindicado associado às configurações.

      • adBreaks: uma lista de objetos em que cada um deles 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 durante 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úncios usados durante as exibiçõ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 foram alterados. Um método pode retornar vários erros com o mesmo tipo. Por exemplo, um erro required é retornado se você tentar inserir um recurso asset que não tem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles vai retornar um erro com uma mensagem um pouco diferente.

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

      Método Erros
      assets.insert
      assets.update
      assets.patch
      • Os erros invalidValue e required que antes estavam associados a propriedades filhas do objeto metadata agora estão associados às mesmas propriedades filhas 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 pela 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. Anteriormente, 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, como mechanical, performance, synchronization e/ou direitos lyric, em vez de direitos de propriedade general. O tipo de direitos lyric agora é aceito.
      policies.insert
      policies.update
      policies.patch
      • invalidValue: a solicitação contém uma regra de política inválida porque a API não oferece suporte à 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: uma referência para o mesmo conteúdo já foi criada com base em uma reivindicação diferente no mesmo vídeo do YouTube.
      • badRequest: a API não oferece suporte à capacidade de definir um valor para a propriedade fpDirect ao criar uma referência.
      • internalError: há um problema com o arquivo de mídia enviado por upload.
      • invalidValue: o valor do parâmetro de solicitação contentType, assetId ou claimId é inválido. O erro identifica o valor inválido.
      • notFound: o recurso ou a reivindicação especificados não foram encontrados. Verifique os valores dos parâmetros assetId e claimId na 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 para 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 exclusivamente um recurso de política salvo.
    • 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 oferece suporte a várias novas propriedades:

    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 declaração. Essas informações só serão incluídas em um recurso claim se a reivindicação foi gerada automaticamente porque um vídeo enviado correspondeu a um arquivo de referência.
    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 correspondência, em segundos.
    matchInfo.longestMatch.userVideoOffset unsigned long A dedução dos próximos ganhos no início da correspondência, medida em segundos a partir do início do vídeo enviado.
    matchInfo.longestMatch.referenceOffset unsigned long A dedução dos próximos ganhos quando a partida começa, medida em segundos a partir do 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 inclui um clipe de 10 segundos de uma referência, mas o clipe é repetido seis vezes, o conteúdo total correspondente no vídeo enviado é de 60 segundos, mas o conteúdo total correspondente na referência é 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 declaraçã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 para uma reivindicação de AudioSwap.

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

  • A propriedade timeProvidedMs do recurso ownershipHistory foi renomeada para 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 do 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 são compatíveis com novos tipos de erro. A tabela abaixo identifica o método e os tipos de erros com suporte recém-adicionados. Em muitos casos, pode haver vários erros para um determinado tipo. Por exemplo, um erro required é retornado se você tentar inserir um recurso asset que não tem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles vai retornar um erro com uma mensagem um pouco diferente.

    Consulte a documentação de erros de cada método ou a página errors 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 de metadados do recurso obrigatório está ausente.
    assets.update
    assets.patch
    • forbidden: o recurso que está sendo atualizado não pertence ao 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 de programa que não pode ser encontrado.
    • required: um campo de metadados do recurso obrigatório 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 a 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 errors 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, e erros específicos de método.

18 de janeiro de 2013

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

  • O método videoAdvertisingOptions.getEnabledAds, que foi documentado recentemente, permite que você extraia detalhes sobre os tipos de anúncios permitidos para um vídeo enviado por um parceiro ou usuário específico.

  • A definição do parâmetro ownershipRestriction do método assetSearch.list foi atualizada para indicar que o valor padrão do parâmetro é mine, o que indica que a API só pode recuperar os 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, que agora tem suporte, permite indicar se a solicitação da API também precisa recuperar a política de correspondência definida para o recurso.

    • O novo parâmetro fetchOwnership permite indicar se a solicitação da API também precisa recuperar dados de propriedade do recurso.

    • A lista de recursos que a API retorna 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 você precisa 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 está sendo atualizado para inactive. Nesse caso, também é possível 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 você precisa especificar o status da referência ao realizar qualquer uma dessas operações.

  • Vários métodos de API são compatíveis com novos tipos de erro. 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 O recurso para o qual você está tentando recuperar a política de correspondência não foi encontrado.
    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 que você forneceu contêm um valor inválido.
    ownership.update invalidValue Unavailable Os dados de propriedade que você forneceu contêm um valor inválido.