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 pode ser acessada por todos os desenvolvedores ou usuários do YouTube. Se você não encontrar a API Content ID do YouTube como um dos serviços listados no Console de APIs do Google, consulte a Central de Ajuda do YouTube para saber mais sobre o Programa de Parcerias do YouTube.

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

10 de novembro de 2023

O campo adFormats[] do recurso videoAdvertisingOption foi atualizado para que third_party_ads seja o único valor válido para esse campo. Os seguintes formatos de anúncio não são mais compatíveis: 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:

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

  • O campo breakPosition[] do recurso videoAdvertisingOption foi marcado como descontinuado e será removido em 2024.
    Os métodos videoAdvertisingOptions.update e videoAdvertisingOptions.patch já ignoram o campo.
  • O campo adBreaks[].slot[] descontinuado do recurso videoAdvertisingOption foi removido.
  • Os campos category e showCustomId descontinuados do recurso asset foram removidos.
  • O campo timeStatusLastModified do novo recurso claim informa a hora em que uma declaração foi modificada pela última vez.
  • O parâmetro isVideoShortsEligible do novo método claimSearch.list pode ser usado para filtrar vídeos reivindicados pela qualificação para o YouTube Shorts.

• Novos recursos e métodos

  • Agora a API é compatível com a listagem de recursos do YouTube Music:
    • Os recursos musicRelease podem ser listados com o método musicReleases.list.
    • Os recursos musicTrack podem ser listados com o método musicTracks.list.
    • Os recursos musicChangeRequest podem ser listados com o método musicChangeRequests.list.

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 alteração 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 diversos valores são compatíveis com:

• fetchMatchPolicy (get, list)
• fetchMetadata (get, list)
• fetchOwnership (get, list)

28 de setembro de 2022

Informações de licenciamento foram adicionadas a asset resource.

18 de julho de 2022

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

• Anteriormente, o Studio removeu o suporte a Audio Swap e Song Erase. Os valores da API correspondentes, audio_removed e song_erased, foram ignorados silenciosamente e não foram 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 compatíveis.

14 de junho de 2022

A documentação do recurso assetSearch foi atualizada para refletir as duas novas propriedades: isrcs[] e iswcs[]. Cada um dos 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 elas fornecem dados mais precisos. Enquanto as novas propriedades podem listar uma matriz de valores de string, as propriedades isrc e iswc identificam somente 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 oferece suporte a 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 as melhorias na consistência com o 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 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 adequadamente 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 oferece suporte a um conjunto diferente de parâmetros de consulta. A documentação do método claimSearch.list foi atualizada para explicar quais parâmetros têm suporte 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 potencial ou inativa 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 à declaração.
• A lista de valores compatíveis com o parâmetro origin do método claimSearch.list mudou. O parâmetro agora é compatível com mais quatro valores: batchTool, inProductShorts, melodyMatch e youTubeAdmin. Além disso, os valores dropboxUpload e webUpload não são mais compatíveis.

26 de fevereiro de 2021

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

6 de dezembro de 2018

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

A documentação da API foi atualizada para remover referências ao recurso contentOwnerAdvertisingOptions e aos métodos dele. Esses métodos eram pouco usados, e os usuários da API que os utilizavam 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 vídeo de música ou recurso de gravação de som. A API vai retornar um erro se a propriedade não estiver configurada para esses tipos de recurso. Além disso, a propriedade metadataMine.artist é compatível apenas com 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 é compatível com dois métodos para este recurso:

  • O método package.insert valida e faz upload de 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 mostrar que o valor não identifica o parceiro de conteúdo que está enviando os dados, mas um valor como web-google ou yt-google que identifica a conta específica do usuário que fez o envio 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ó será preenchida se a referência for duplicada. Se for definido, o valor dessa propriedade 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. Essas representações refletem um novo modelo de dados de publicação desenvolvido para fornecer mais transparência e controle sobre como seus direitos são associados a recursos de gravação de som.

  No novo modelo, cada gravação de som é mapeada para exatamente um recurso exclusivo, que é chamado de visualização de composição. Os metadados desse recurso representam o conjunto canônico de informações que o YouTube exibe sobre os direitos de composição associados a uma gravação. Além disso, eles 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 cota de composição. O novo método assetShares.list permite realizar uma das seguintes ações:

  • Informe o ID de uma visualização de composição e recupere a cota de composição correspondente de propriedade do parceiro que autoriza a solicitação, se houver.
  • Informe o código de uma cota de composição do parceiro de conteúdo e recupere uma lista de todas as visualizações de composição às quais esse compartilhamento está vinculado.

• O novo guia Como gerenciar recursos de composição explica como diferentes métodos de API lidam com solicitações, dependendo se os códigos enviados para esses métodos identificam visualizações ou cotas de composição.

• A nova propriedade claimedVideoOptions.autoGeneratedBreaks do recurso contentOwnerAdvertisingOptions indica se o YouTube precisa gerar automaticamente intervalos de anúncio 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 de duração, se um vídeo tiver várias reivindicações, o primeiro parceiro que reivindica um vídeo define o comportamento padrão dessa propriedade em relação ao vídeo.

11 de agosto de 2016

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

• Os Termos de Serviço da API YouTube recém-publicados ("os Termos Atualizados"), discutidos em detalhes no Blog de engenharia e desenvolvedores do YouTube, fornecem um rico conjunto de atualizações para os Termos de Serviço atuais. Além dos Termos atualizados, que entrarão em vigor em 10 de fevereiro de 2017, esta atualização inclui vários documentos de suporte 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 futuras mudanças nos Termos Atualizados ou nos documentos de apoio também serão explicadas no histórico de revisões. Você pode se inscrever em um feed RSS que lista as alterações do histórico de revisões a partir de um link nesse 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 impedem o YouTube de processá-lo. Se o arquivo contiver erros, a propriedade errors da resposta da API vai incluir 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 erro a seguir. Como um lembrete, um método pode ser compatível com vários erros com o mesmo tipo. Consulte a documentação de cada método ou a página de erros para ver uma lista completa dos possíveis erros.

    Erros
    invalidValue (400)	parameters.assetId Ocorreu uma falha na solicitação porque o recurso que está sendo atualizado foi mesclado com outro recurso. Reenvie a solicitação usando o ID desse 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 descreve a correspondência de áudio e o outro descreve 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 tempo 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

  • O uso da 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 erro a seguir. Como um lembrete, um método pode ser compatível com vários erros com o mesmo tipo. Consulte a documentação de cada método ou a página de erros para ver uma lista completa dos possíveis erros.

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

  • Ocasionalmente, o método assets.list 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. Caso sua solicitação assets.list especifique vários IDs de recurso e retorne um erro 500, tente reenviar a solicitação para um único recurso ou um número menor de recursos.

  • A documentação do erro references.insert foi atualizada para indicar que, se a solicitação fizer upload de um arquivo de referência corrompido, esse problema não será identificado até que a própria 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ê pesquise usando o método references.list para confirmar se a referência está 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 suporta anúncios da lista de produtos. Os anúncios da lista de produtos destacam produtos relacionados ou que são apresentados 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 seguintes valores das propriedades:

    Método de recurso/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 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 aceita o valor art_track_video. A Central de Ajuda do YouTube contém mais informações sobre vídeos com arte da capa.

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

    Parâmetros
    referenceId	Este parâmetro de filtro especifica o ID de referência do YouTube referente à referência para a qual você está recuperando reivindicações.
    inactiveReasons	Este parâmetro opcional permite restringir a resposta da API para incluir apenas declarações inativas com base em motivos específicos que explicam por que as declarações ficaram inativas. A definição do parâmetro lista os tipos de reivindicações inativas que você pode pesquisar.
    partnerUploaded	Este parâmetro Booleano opcional permite que você especifique que a resposta da API deve incluir apenas reivindicações enviadas por parceiros ou não.

  • 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 recurso de enviar 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 vai mais retornar um erro se você tentar definir a propriedade fpDirect ao fazer upload de uma referência.

• Erros novos e atualizados

  Agora, a documentação 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 de erro. Consulte a documentação de erros de cada método ou a página de erros para mais informações.

  Erros
  badRequest (400)	inappropriateCampaignTarget Os métodos campaigns.insert e campaigns.update retornam esse erro quando uma campanha tenta exibir um vídeo que pode ser inadequado para alguns usuários. Para resolver 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 por um 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 músicas gravadas no vídeo especificado. As reivindicações de composição direta não podem ser adicionadas usando a API.
  badRequest (400)	asset_id O método references.insert retornará esse erro se a solicitação tiver tentado criar uma referência por meio de um arquivo, mas não tiver especificado um assetId.
  badRequest (400)	canNotBeActivated O método references.update vai retornar esse erro se a referência não puder ser ativada, possivelmente devido ao status dela ou às condições de propriedade.
  badRequest (400)	videoNotClaimed O método videoAdvertisingOptions.get retorna esse erro se você não tiver reivindicado o vídeo para o qual está tentando recuperar opções de publicidade, tornando assim as informações solicitadas indisponíveis.

18 de dezembro de 2015

As leis da União Europeia (UE) exigem que algumas divulgações sejam dadas e recebam o consentimento dos usuários finais na UE. Portanto, os usuários finais na União Europeia precisam 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:

• O novo recurso campaign representa uma campanha do proprietário do conteúdo específica, que permite que o proprietário do conteúdo use anotações para promover o conteúdo em vídeos reivindicados enviados pelo usuário. Por exemplo, um proprietário de conteúdo pode criar uma campanha que adiciona links à página de exibição de um filme para todos os vídeos reivindicados enviados por usuários que contenham cenas desse filme.

  A API oferece suporte a métodos para recursos get, list, insert, update, patch e delete campaign.

• A API é compatível com vários erros novos para os novos métodos campaigns.get, campaigns.insert, campaigns.update e campaigns.delete.

30 de março de 2015

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

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

  • Com o novo parâmetro isrcs do método assetSearch.list, você pode especificar uma lista de até 50 ISRCs. A resposta da API incluirá os recursos associados a esses ISRCs.

  • A propriedade event[].reason do recurso claimHistory é compatível com os novos valores a seguir. Cada motivo explica por que um determinado evento 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 em que foram criados. Você também pode ordenar 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 de acordo com o 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 alteração representa uma correção na documentação da API e não identifica uma alteração na funcionalidade da API.

  • Os parâmetros fetchMatchPolicy para os 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 para o recurso.

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

• Erros novos e atualizados

  A tabela abaixo identifica novos erros com suporte da API e os métodos que podem retornar cada erro. Um método pode retornar vários erros com o mesmo tipo de erro.

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

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	tooManyIsrcs	O método assetSearch.list retornará esse erro se o parâmetro isrcs especificar mais de 50 ISRCs.
  badRequest (400)	videoIsPrivate	O método claims.insert retornará esse erro se você tentar reivindicar um vídeo privado. Você só poderá reivindicar um vídeo se o status de privacidade dele for public ou unlisted.
  notModified (304)	blockOutsideOwnershipUnchanged	O método claims.update retornará esse erro se a sinalização blockOutsideOwnership na declaração não tiver sido modificada. Há vários motivos para esse erro ocorrer. Um exemplo comum é que a modificação especificada não afeta o 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 é compatível com um valor de routedForReview Este 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 é compatível com os novos valores a seguir. Cada motivo explica por que um determinado evento 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 existente.

    • Se a solicitação estiver fazendo upload de 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 com suporte da API e os métodos que podem retornar cada erro. Um método pode retornar vários erros com o mesmo tipo de erro.

  Consulte a documentação de erros de cada método ou a página de 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 de rótulos precisam ter entre 2 e 30 caracteres. Eles não podem conter colchetes, vírgulas, dois-pontos, "e" comercial (&) nem 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 está suspenso por reivindicações de parceiros.
  badRequest (400)	channelNotActive	O método claims.update retornará esse erro se o canal de um vídeo não estiver ativo.

• Os métodos assets.insert e assets.update não vão mais retornar um erro badRequest para alguns recursos se o recurso no corpo da solicitação não tiver 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 por meio da API. Anteriormente, a API retornava um nome legível como o ID, como "qrs_network".

  Essa mudança afeta a funcionalidade da API a seguir e provavelmente afetará os parceiros que têm códigos de parceiro codificados nos aplicativos.

  • A API agora retorna o novo ID como o valor das propriedades do recurso 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 da API está sendo feita. Após a mudança, o parâmetro deverá ser definido como o novo ID em vez do código do parceiro. Para evitar quebras de código, o parâmetro 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 precisa especificar o novo ID em vez do código do parceiro.

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

  • Com o novo parâmetro metadataSearchFields do método assetSearch.list, é possível especificar os campos de metadados do recurso e os valores a serem pesquisados nesses campos. O valor do parâmetro é uma lista separada por vírgulas de pares de campo e valor; dentro de 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 sobre as políticas dos países em que o proprietário do conteúdo que enviou a solicitação é o proprietário 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 que o proprietário do conteúdo que enviou a solicitação de API.

    2. Ela inclui as políticas administrativas do YouTube que se aplicam aos 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 que recebeu o vídeo reivindicado.

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 sua biblioteca. 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 dos 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 identificador indefinido antes.

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

  • A propriedade label[] do recurso asset foi atualizada para mostrar que é possível 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 rótulos de recursos explica como criar e recuperar rótulos de recursos e como atualizar ou pesquisar recursos associados a rótulos específicos.

• Erros novos e atualizados

  A API é compatível com vários erros novos 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 do proprietário do conteúdo

  Historicamente, a API utiliza um código de parceiro legível, 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 passará a usar um ID exclusivo de 22 caracteres para identificar os proprietários do conteúdo. A mudança afeta a funcionalidade da API a seguir e provavelmente afetará os parceiros que têm códigos de parceiro codificados nos aplicativos.

  • A API vai retornar o ID de 22 caracteres como o valor das propriedades do recurso que 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 da API está sendo feita. Após a alteração, o parâmetro deverá ser definido como o ID de 22 caracteres em vez do código do parceiro. Para evitar quebras de código, o parâmetro 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 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. Use os marcadores 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, é 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, este parâmetro instrui a API de retorno de recursos associados a qualquer um dos rótulos especificados no valor do parâmetro labels.

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

    • A propriedade event[].source.userEmail fornece o endereço de e-mail do usuário que iniciou o evento.
    • A propriedade event[].typeDetails.disputeNotes contém notas de disputa para um evento dispute_create.

  • O método claimSearch.list agora oferece suporte aos 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, esse parâmetro indica se declarações de terceiros precisam ser incluídas nos resultados da API.

• Informações mais detalhadas sobre os erros

  Agora, a documentação de erros especifica o código de resposta HTTP para cada tipo de erro.

• Erros novos e atualizados

  A tabela abaixo identifica novos erros com suporte da API e os métodos que podem retornar cada erro. Um método pode retornar vários erros com o mesmo tipo de erro. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset sem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles retornará um erro com uma mensagem um pouco diferente.

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

  Método	Erros
  assetSearch.list	invalidValue: a API não oferece suporte ao recurso de pesquisa de recursos de programa ou temporada. Mude o valor do parâmetro type para um 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.
  claimSearch.list	badRequest: o parâmetro includeThirdPartyClaims só pode ser usado em conjunto com o filtro videoId.
  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.

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

    • O objeto origin contém informações que descrevem o modo 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 daquele associado ao usuário que realizou 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, apenas 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 as reivindicaçõ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 precisa ser bloqueado em territórios em que ele não é de propriedade explícita. Por padrão, um vídeo reivindicado ficaria visível em países onde os dados de propriedade não tinham sido definidos para o recurso associado à reivindicação.

  • A nova propriedade allowedOptions.autoGeneratedBreaks do recurso contentOwnerAdvertisingOption indica se o parceiro pode veicular anúncios in-stream intermediários em períodos de pausa 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 a hora 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 a partir da ú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 termina, fazendo com que o conflito expire.

  • A nova propriedade autoGeneratedBreaks do recurso videoAdvertisingOption indica se o vídeo precisa mostrar anúncios intermediários in-stream em períodos de pausa determinados automaticamente pelo YouTube.

• Erros novos e atualizados

  A tabela abaixo identifica novos erros com suporte da API e os métodos que podem retornar cada erro. Um método pode retornar vários erros com o mesmo tipo de erro. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset sem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles retornará um erro com uma mensagem um pouco diferente.

  Consulte a documentação de erros de cada método ou a página de erros 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 capa.
  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. Em caso de dúvidas, entre em contato com [email protected] badRequest – Sua solicitação não pode ser processada porque você não pode criar uma reivindicação de terceiros para o vídeo especificado. conflict – O YouTube não pode criar a reivindicação solicitada porque o vídeo recebeu 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 recusado ou o processamento falhou.

• Os erros contentOwnerNotProvided e internalError, que não são específicos de um método de API específico, não estão mais listados em todas as páginas dos métodos. As descrições delas ainda podem ser encontradas na seção Erros gerais na 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 que você extraia um conflito de referência especificando o ID de conflito de referência exclusivo.

  Atualizações de recursos e métodos atuais

  • Agora a API é compatível com a capacidade de recuperar a política de correspondência efetiva de um recurso. Essa alteração é paralela às alterações lançadas em 16 de julho de 2013, que incluíram a compatibilidade com a recuperação do conjunto canônico de metadados e os 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 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 diferente de direitos que um proprietário de recurso pode ter. Para a maioria dos tipos de recursos, os proprietários podem apenas ter a propriedade geral do recurso. No entanto, para recursos de composição, os proprietários podem discriminar a propriedade dos direitos de desempenho, direitos de sincronização ou direitos mecânicos.

    Da mesma forma, o objeto ownershipConflicts contém listas separadas que identificam os conflitos de direitos gerais de propriedade, de desempenho, de sincronização e de mecânica. 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 conflitante declara ser proprietário.

  • 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 de API deve recuperar os conflitos de propriedade para os 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 para um método references.insert agora indica que você precisa definir o valor da propriedade contentType. Essa alteração 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 é compatível com um novo erro forbidden, que não é específico de um determinado método. Ele 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 de no objeto metadata, que foi descontinuado na atualização da API em 16 de julho de 2013.

  • A página errors foi atualizada para que, para cada recurso compatível com os métodos update e patch, a página contenha uma tabela que lista os erros retornados por esses dois métodos. Anteriormente, 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 declaração específica. O recurso claimHistory retornado contém uma lista de eventos relacionados à reivindicação, como a que está sendo criada, atualizada, disputada ou encerrada.

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

    • 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), o recurso e o vídeo associados à reivindicação. O recurso também especifica o número de visualizações do vídeo reivindicado e o título dele.

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

  • A documentação agora lista os valores compatíveis de 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írgula 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 alterações correspondentes na estrutura do recurso asset, bem como os impactos dessas alterações nos métodos de API que get, list, insert, update ou patch 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 fornecidos pelo proprietário do conteúdo que fez a solicitação de API e o conjunto canônico de metadados que o YouTube determinou como o conjunto de metadados mais preciso e completo do 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 tem o recurso de recuperar a 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 solicitado para um recurso, a resposta da API vai incluir o objeto descontinuado e o objeto que recebeu suporte recentemente. 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. Antes da atualização do recurso, era possível definir fetchMetadata=mine. Agora, era possível 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 os objetos metadataMine e metadataEffective, mas não vai conter um objeto metadata. Antes dessa atualização do recurso, não havia suporte para a definição de fetchMetadata=mine,effective. Por isso, 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 metadata. O mesmo princípio se aplica à configuração dos dados de propriedade ou da política de correspondência de um recurso asset.

  • O uso dos parâmetros assetId, q e videoId do método claims.list foi descontinuado. Para pesquisar reivindicações usando qualquer um desses critérios, use o método claimSearch.list, que suporta 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 os valores válidos para essa propriedade: block, monetize, takedown e track. No entanto, você não pode 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 tiver sido criada por meio da associação de um recurso a um vídeo existente do YouTube 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 precisa ignorar ao tentar fazer a correspondência. Cada intervalo especifica um horário de início e de término medidos 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 de forma exclusiva o vídeo reivindicado associado às configurações.

    • adBreaks: uma lista de objetos em que cada objeto 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 exibidos em cada espaço.

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

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

• Erros novos e atualizados

  • A tabela abaixo identifica novos erros com suporte da 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 de erro. Por exemplo, um erro required será retornado se você tentar inserir um recurso asset sem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles retornará um erro com uma mensagem um pouco diferente.

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

    Método	Erros
    assets.insert assets.update assets.patch	Os erros invalidValue e required anteriormente associados às propriedades filhas do objeto metadata agora estão associados às mesmas propriedades filhas no objeto metadataMine.
    claimHistory.get	notFound – A reivindicação para a qual você está tentando recuperar o histórico não foi encontrada. 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 é o proprietário do recurso associado à reivindicação. badRequest – O proprietário do conteúdo em nome do qual 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 do qual 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. Exatamente um dos seguintes parâmetros de filtro precisa ser especificado: 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; direitos de mechanical, performance, synchronization e/ou lyric, em vez de direitos de propriedade de general. O tipo de direitos lyric recebeu suporte recentemente.
    policies.insert policies.update policies.patch	invalidValue: a solicitação contém uma regra de política inválida porque a API não é compatível com a criação ou modificação de políticas que especificam uma ação takedown. Este erro, que informa um motivo de invalidPolicyTakedownAction, substitui o erro invalidPolicyConditionalTakedown, que teve o uso suspenso.
    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 a partir de 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 – O recurso ou a reivindicação que você especificou não foi encontrado. 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: os excludedIntervals especificados para a referência não são válidos. 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:

• O YouTube não identifica mais os recursos e serviços experimentais da API. Em vez disso, agora fornecemos uma lista de APIs do YouTube sujeitas à política de suspensão de uso.

8 de abril de 2013

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

• A API foi renomeada como API do Content ID do YouTube.

• 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 em vez de uma string.
  • O valor da propriedade rules[].conditions.contentMatchType agora é uma lista de strings em vez de 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 para o objeto rules[] ao chamar o método.

• O recurso claims agora é compatível com várias novas propriedades:

  Nome da propriedade	Valor	Descrição
  timeCreated	datetime	Data e 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. Estas informações só serão incluídas em um recurso claim se a reivindicação tiver sido gerada automaticamente porque um vídeo enviado corresponde a um arquivo de referência existente.
  matchInfo.referenceId	string	O ID exclusivo que o YouTube usa para identificar a referência reference que gerou a correspondência.
  matchInfo.longestMatch	object	O objeto longestMatch contém informações sobre a correspondência mais longa 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	O ajuste de horário do início da correspondência, medido em segundos a partir do início do vídeo enviado.
  matchInfo.longestMatch.referenceOffset	unsigned long	O ajuste de horário quando a correspondência começa, medido 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 corresponde à referência e sobre o valor total da referência que corresponde 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 conteúdo correspondente total no vídeo enviado será de 60 segundos, mas o conteúdo total 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 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 declaração do AdExchange.

• 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 mostrar que o método recupera apenas 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 para rules.
  • O valor da propriedade rules[].subaction agora é uma lista de strings em vez de uma string.
  • O valor da propriedade rules[].conditions.contentMatchType agora é uma lista de strings em vez de uma string.

• A documentação dos métodos policies.insert e policies.update foi atualizada para refletir 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 identifica brevemente os tipos de erros recém-suportados. 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 sem um campo de metadados obrigatório. Na verdade, pode haver mais de um campo de metadados obrigatório, e cada um deles retornará um erro com uma mensagem um pouco diferente.

  Consulte a documentação de erros de cada método ou a página de 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 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 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 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 erros que a API pode retornar. A página inclui erros gerais, que podem ocorrer para vários métodos de API diferentes, assim como erros específicos dos métodos.

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 enviado por um parceiro ou usuário especificado.

• A definição do parâmetro ownershipRestriction do método assetSearch.list foi atualizada para mostrar que o valor padrão do parâmetro é mine, o que indica que a API precisa extrair apenas os recursos do 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-aceito 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-aceito permite indicar se a solicitação de API também precisa recuperar os dados de propriedade do recurso.

  • A lista de recursos retornados 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 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 aconteceu.

• O uso da propriedade hasUnpublishedDraft do recurso policy foi descontinuado.

• O parâmetro id recém-aceitado 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 mostrar que o parâmetro só funciona quando o status da reivindicação está sendo atualizado para inactive. Nesse caso, você também pode definir o valor do parâmetro releaseClaims como true para liberar todas as declarações de correspondência produzidas pela referência.

• Os métodos references.patch e references.update foram atualizados para indicar 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 recém-suportados:

  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.