API YouTube Content ID - Cronologia delle revisioni

Nota:l'API YouTube Content ID è destinata all'utilizzo da parte dei partner di contenuti di YouTube e non è accessibile a tutti gli sviluppatori o a tutti gli utenti di YouTube. Se l'API YouTube Content ID non è presente tra i servizi elencati nella console API di Google, consulta il Centro assistenza YouTube per scoprire di più sul Programma partner di YouTube.

Questa pagina elenca le modifiche all'API YouTube Content ID e gli aggiornamenti della documentazione.

26 marzo 2025

A partire dal 31 marzo 2025, YouTube cambierà il modo in cui vengono conteggiate le visualizzazioni degli Short. In passato, per gli Short, una visualizzazione veniva conteggiata dopo che uno Short era stato riprodotto per una determinata quantità di secondi. Ora le visualizzazioni terranno conto del numero di volte in cui uno Short viene riprodotto o rivisto, senza alcun requisito di tempo di visualizzazione minimo. Scopri di più

Entro il 30 giugno 2025, l'API Content ID verrà aggiornata nei seguenti modi in base a questa modifica:

  • I criteri di ordinamento di claimSearch.list.sort verranno aggiornati:
    • DAILY_ENGAGED_VIEWS verrà aggiunto ai conteggi delle visualizzazioni giornaliere in base alla metodologia di conteggio delle visualizzazioni precedente.
    • LIFETIME_ENGAGED_VIEWS verranno aggiunte al conteggio delle visualizzazioni totali in base alla metodologia di conteggio delle visualizzazioni precedente.
  • I criteri di ordinamento di assetSearch.list.sort verranno aggiornati:
    • DAILY_ENGAGED_VIEWS verrà aggiunto ai conteggi delle visualizzazioni giornaliere in base alla metodologia di conteggio delle visualizzazioni precedente.

Entro il 30 settembre 2025, l'API Content ID verrà aggiornata nei seguenti modi in base a questa modifica:

  • L'ordinamento assetSearch.list.sort VIEWS verrà ritirato.
  • L'ordinamento claimSearch.list.sort VIEW_COUNT verrà ritirato.
  • claimSearch.claimSnippet.videoViews verrà aggiornato in base alla metodologia di conteggio delle visualizzazioni aggiornata per le visualizzazioni di Short.
  • claimSearch.claimSnippet.engagedViews verrà aggiunto ai conteggi delle visualizzazioni in base alla metodologia precedente

14 gennaio 2025

Il campo autoGeneratedBreaks[] della risorsa videoAdvertisingOption è stato aggiornato perché ora consentiamo di fornire contemporaneamente ad_breaks e autoGeneratedBreaks. Se autoGeneratedBreaks è impostato su true in un video con adBreaks definito, i nostri sistemi identificheranno i punti in cui pubblicare gli annunci, oltre a quelle scelte manualmente da te. Per maggiori dettagli, consulta questo articolo del Centro assistenza.

10 novembre 2023

Il campo adFormats[] della risorsa videoAdvertisingOption è stato aggiornato in modo che third_party sia l'unico valore valido per quel campo. I seguenti formati degli annunci non sono più supportati: instream_trueview, instream_standard, display, preroll, postroll. Per maggiori dettagli, consulta l'articolo del Centro assistenza.

1 giugno 2023

Nota: questo è un annuncio relativo al ritiro.

Questo aggiornamento include le seguenti modifiche:

20 dicembre 2022

La definizione del parametro di query ownershipRestriction del metodo assetSearch.list è stata aggiornata per chiarire che se il valore di quel parametro è none, il valore del parametro metadataSearchFields deve utilizzare anche almeno un filtro ID. Questa modifica alla documentazione non riflette una modifica del comportamento dell'API.

9 novembre 2022

La documentazione dei metodi asset.get e asset.list è stata aggiornata per chiarire in che modo sono supportati più valori per:

28 settembre 2022

Le informazioni sull'idoneità alla concessione in licenza sono state aggiunte al asset resource.

18 luglio 2022

La documentazione del metodo claimSearch.list inactiveReasons è stata aggiornata per riflettere i miglioramenti apportati in termini di coerenza con YouTube Studio:

  • In precedenza, Studio aveva rimosso il supporto per Audio Swap e Song Erase. I valori API corrispondenti, audio_removed e song_erased, sono stati ignorati silenziosamente e ora non sono più documentati.
  • channel_whitelisted è stato sostituito da channel_allowlisted. Il valore precedente non è più documentato, ma è ancora supportato.
  • Ora sono supportati i valori closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced e video_modified.

14 giugno 2022

La documentazione della risorsa assetSearch è stata aggiornata per riflettere le due nuove proprietà: isrcs[] e iswcs[]. I nuovi valori delle proprietà isrcs[] e iswcs[] contengono ciascuno un array di valori di stringa, con ciascun valore che specifica un codice ISRC o ISWC, a seconda dei casi, che mappa la risorsa identificata dal risultato di ricerca.

Le nuove proprietà sono consigliate rispetto alle proprietà isrc e iswc già incluse nelle risorse assetSearch perché forniscono dati più accurati. Mentre le nuove proprietà elencano potenzialmente un array di valori di stringa, le proprietà isrc e iswc identificano ciascuna un solo codice ISRC o ISWC associato al risultato di ricerca.

12 maggio 2022

I link alle librerie client sono stati aggiornati in modo da puntare alle librerie client delle API di Google standard. Le associazioni predefinite per PHP sono state aggiornate.

3 maggio 2022

Il parametro status del metodo claimSearch.list ora supporta più filtri in base ai potenziali dettagli della rivendicazione.

2 maggio 2022

La documentazione relativa al parametro Response del metodo assetSearch.list è stata aggiornata per riflettere i miglioramenti apportati in termini di coerenza con l'AIP-158:

  • La descrizione di pageInfo.totalResults menziona esplicitamente che il valore è una stima e non il valore effettivo
  • I campi pageInfo.resultsPerPage e pageInfo.startIndex sono stati rimossi

25 aprile 2022

La documentazione della risorsa assetLabels.list è stata aggiornata per chiarire il significato dei parametri di richiesta labelPrefix e q e per documentare che la richiesta / risposta supporta la paginazione.

8 dicembre 2021

La documentazione della risorsa claimSearch.list è stata aggiornata per riflettere correttamente i due casi d'uso coperti da questo metodo:

  • Cerca per ID (risorsa, riferimento o video) o stringa di query
  • Cercare per data di creazione, data di modifica o stato della rivendicazione

Ogni caso d'uso supporta un insieme diverso di parametri di query. La documentazione del metodo claimSearch.list è stata aggiornata per spiegare quali parametri sono supportati per ogni caso d'uso.

17 novembre 2021

Questo aggiornamento include le seguenti modifiche:

  • Il metodo claims.update ora supporta la possibilità di aggiornare lo stato di un reclamo inattivo o potenziale su active. La definizione della proprietà status della risorsa claim fornisce ulteriori dettagli.
  • La documentazione delle risorse claim e claimSearch è stata aggiornata per riflettere l'aggiunta del nuovo oggetto studioInfo, che contiene link alle pagine di YouTube Studio relative alla rivendicazione.
  • L'elenco dei valori supportati per il parametro origin del metodo claimSearch.list è cambiato. Ora il parametro supporta quattro valori aggiuntivi: batchTool, inProductShorts, melodyMatch e youTubeAdmin. Inoltre, i valori dropboxUpload e webUpload non sono più supportati.

26 febbraio 2021

La documentazione del parametro videoId del metodo claimSearch.list è stata aggiornata per indicare che il valore del parametro ora accetta un massimo di 10 ID video separati da virgole. L'API restituirà un errore badRequest (codice di risposta HTTP 400) se il valore contiene più di 10 ID video.

6 dicembre 2018

Nota: questo è un annuncio relativo al ritiro.

La documentazione dell'API è stata aggiornata per rimuovere i riferimenti alla risorsa contentOwnerAdvertisingOptions e ai relativi metodi. Questi metodi sono stati utilizzati in misura minima e gli utenti dell'API che li hanno utilizzati sono stati contattati separatamente prima di questo annuncio.

21 marzo 2018

Questo aggiornamento contiene le seguenti modifiche:

  • Ora la proprietà metadataMine.artist deve essere impostata ogni volta che inserisci, aggiorni o esegui la patch di una risorsa video musicale o registrazione audio. Ora l'API restituisce un errore se la proprietà non è impostata per questi tipi di risorse. Inoltre, tieni presente che la proprietà metadataMine.artist è supportata solo per gli artisti di video musicali e registrazioni audio.

24 luglio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova risorsa package rappresenta un gruppo di file caricati tramite il web, SFTP o un altro meccanismo di caricamento. L'API supporta due metodi per questa risorsa:

    • Il metodo package.insert convalida e carica un pacchetto contenente solo metadati e contenente esattamente un file di metadati.
    • Il metodo package.get recupera le informazioni su un pacchetto caricato in precedenza.

  • Per il metodo validator.validate, la definizione della proprietà uploaderName è stata aggiornata per indicare che il valore non identifica il partner di contenuti che carica i dati, ma piuttosto un valore come web-google o yt-google che identifica l'account dello specifico utente che carica i contenuti utilizzato dal proprietario dei contenuti.

  • La proprietà status della risorsa reference non utilizza più il valore duplicate_on_hold per indicare che un riferimento è un duplicato di un altro riferimento. Se un riferimento è un duplicato, il valore della proprietà status viene impostato su inactive e il valore della proprietà statusReason su REASON_DUPLICATE_FOR_OWNERS.

    Tuttavia, come in precedenza, la proprietà duplicateLeader della risorsa viene compilata solo se il riferimento è un duplicato. Se è impostato, il valore della proprietà identifica il riferimento duplicato.

17 aprile 2017

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova risorsa assetShare, pertinente solo per gli asset composizione, identifica una relazione tra due rappresentazioni di una risorsa asset. Queste rappresentazioni riflettono un nuovo modello di dati di pubblicazione progettato per offrire maggiore trasparenza e controllo sulla modalità di associazione dei tuoi diritti alle risorse registrazione audio.

    Nel nuovo modello, ogni registrazione audio viene associata a una sola risorsa univoca, chiamata visualizzazione della composizione. I metadati della risorsa rappresentano l'insieme canonico di informazioni che YouTube mostra sui diritti di composizione associati a una determinata registrazione e possono sintetizzare le informazioni di più fornitori di dati.

    Inoltre, ogni proprietario della composizione ha la propria risorsa quota della composizione. La quota della composizione rappresenta le informazioni fornite da un determinato editore per una risorsa composizione. La quota della composizione può essere associata a molte registrazioni audio.

    La risorsa assetShare identifica una relazione tra una visualizzazione della composizione e una condivisione della composizione. Il nuovo metodo assetShares.list ti consente di eseguire una delle seguenti operazioni:

    • Fornisci l'ID di una visualizzazione della composizione e recupera la quota della composizione corrispondente di proprietà del partner che autorizza la richiesta, se esistente.
    • Fornisci l'ID di una quota della composizione di proprietà del partner per i contenuti e recupera un elenco di tutte le visualizzazioni della composizione a cui è collegata la quota.

  • La nuova guida Gestire le risorse composizione spiega in che modo i diversi metodi dell'API gestiscono le richieste a seconda che gli ID risorsa inviati a questi metodi identifichino le visualizzazioni della composizione o le quote della composizione.

  • La nuova proprietà claimedVideoOptions.autoGeneratedBreaks della risorsa contentOwnerAdvertisingOptions indica se YouTube deve generare automaticamente interruzioni pubblicitarie nei video rivendicati di durata superiore a 10 minuti. Sebbene la proprietà riguardi tutti i video del proprietario dei contenuti di durata superiore a 10 minuti, se un video presenta più rivendicazioni, il primo partner che rivendica un video imposta il comportamento predefinito per questa proprietà in relazione al video in questione.

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

  • I Termini di servizio dei servizi API di YouTube appena pubblicati ("i Termini aggiornati"), descritti in dettaglio nel blog di YouTube dedicato a ingegneri e sviluppatori, forniscono una serie completa di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto che aiutano a spiegare le norme che gli sviluppatori devono seguire.

    L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti a supporto verranno spiegate anche nella cronologia delle revisioni. Puoi iscriverti a un feed RSS che elenca le modifiche nella cronologia delle revisioni da un link nel documento.

31 maggio 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e nuovi metodi

    • Il nuovo metodo validator.validate consente di determinare se un file di metadati contiene errori di convalida che potrebbero impedire a YouTube di elaborarlo correttamente. Se il file contiene errori, la proprietà errors della risposta dell'API contiene un elenco di errori di convalida che ne identificano la gravità, la causa e la posizione.

  • Errori nuovi e aggiornati

    • I metodi assets.patch e assets.update ora supportano il seguente errore. Ti ricordiamo che un metodo può supportare più errori dello stesso tipo. Per un elenco completo dei possibili errori, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

      Errori
      invalidValue (400) parameters.assetId
      La richiesta non è andata a buon fine perché l'asset da aggiornare è stato unito a un altro asset. Invia nuovamente la richiesta utilizzando l'ID della risorsa, restituito nel messaggio di errore, come valore del parametro assetId.

28 marzo 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • La nuova proprietà matchInfo.matchSegments[] della risorsa claim contiene un elenco in cui ogni elemento descrive un segmento del video rivendicato che corrisponde a una parte del video di riferimento. Una rivendicazione può avere più segmenti di corrispondenza. Ad esempio, se i contenuti audio e video di un video caricato corrispondono a quelli di un video di riferimento, ci saranno due segmenti di corrispondenza. Un segmento descrive la corrispondenza audio e l'altro la corrispondenza video.

      Per ogni segmento di corrispondenza, l'API restituisce la durata e il tipo (audio o video) dei contenuti corrispondenti. L'API identifica anche gli offset di tempo in cui inizia e termina ogni segmento di corrispondenza sia nel video rivendicato sia nel video di riferimento.

    • Ora il valore della proprietà claimedVideoOptions.newVideoDefaults[] della risorsa contentOwnerAdvertisingOptions può essere aggiornato quando chiami i metodi contentOwnerAdvertisingOptions.patch o contentOwnerAdvertisingOptions.update.

    • La proprietà allowedOptions.autoGeneratedBreaks di sola lettura della risorsa contentOwnerAdvertisingOptions è stata ritirata.

  • Errori nuovi e aggiornati

    • Il metodo claims.update dell'API ora supporta il seguente errore. Ti ricordiamo che un metodo può supportare più errori dello stesso tipo. Per un elenco completo dei possibili errori, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

      Errori
      badRequest (400) alreadyClaimed
      La rivendicazione è un duplicato di un'altra rivendicazione esistente e non può essere aggiornata.

    • Il metodo assets.list occasionalmente scade e restituisce un codice di risposta HTTP 500 (Internal Server Error), in particolare quando la richiesta recupera i dati per molti asset e il valore del parametro fetchMatchPolicy è effective. Se la richiesta assets.list specifica più ID risorsa e restituisce un errore 500, prova a inviare nuovamente la richiesta per una singola risorsa o per un numero inferiore di risorse.

    • La documentazione relativa all'errore references.insert è stata aggiornata per indicare che, se la richiesta carica un file di riferimento danneggiato, il problema non viene identificato finché il riferimento stesso non viene elaborato. Pertanto, anche se la richiesta references.insert restituisce una risposta positiva, il riferimento potrebbe non essere elaborato correttamente. Dopo aver inserito un riferimento, ti consigliamo di eseguire il polling utilizzando il metodo references.list per verificare che il riferimento sia attivato come previsto.

3 febbraio 2016

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • L'API ora supporta gli annunci con scheda di prodotto. Gli annunci della scheda di prodotto mettono in evidenza i prodotti correlati o presenti nei contenuti di un video. Questi annunci sono schede sponsorizzate che vengono visualizzate durante la riproduzione del video. Le schede vengono aggiunte automaticamente dal sistema di gestione degli annunci. Gli spettatori vedono un teaser della scheda per alcuni secondi e possono fare clic sull'icona nell'angolo superiore destro del video per sfogliare le schede.

      A seguito di questa modifica, product_listing ora può essere incluso nei valori delle seguenti proprietà:

      Metodo API/risorsa Proprietà
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • I nuovi createdBefore e createdAfter del metodo assetSearch.list chiedono all'API di restituire solo gli asset creati prima e/o dopo una determinata data.

    • Nella risposta dell'API a una richiesta assetSearch.list, la proprietà type ora supporta il valore art_track_video. Il Centro assistenza YouTube fornisce maggiori informazioni sui video degli art track.

    • Il metodo claimSearch.list supporta i seguenti nuovi parametri:

      Parametri
      referenceId Questo parametro di filtro specifica l'ID riferimento di YouTube del riferimento per cui stai recuperando le rivendicazioni.
      inactiveReasons Questo parametro facoltativo ti consente di limitare la risposta dell'API in modo da includere solo le rivendicazioni non attive in base ai motivi specificati per cui sono diventate non attive. La definizione del parametro elenca i tipi di rivendicazioni non attive per cui puoi eseguire ricerche.
      partnerUploaded Questo parametro booleano facoltativo ti consente di specificare che la risposta dell'API deve includere solo le rivendicazioni caricate dal partner o non caricate dal partner.

    • Il nuovo oggetto references#origination della risorsa reference contiene informazioni che descrivono l'origine del riferimento.

    • Il metodo references.insert ora supporta la possibilità di caricare i riferimenti generati utilizzando il software gfp_gen di YouTube. Se fornisci un'impronta pregenerata, imposta il valore della proprietà fpDirect su true nella risorsa reference caricata.

      Tieni presente che, con questa modifica, l'API non restituisce più un errore se provi a impostare la proprietà fpDirect durante il caricamento di un riferimento.

  • Errori nuovi e aggiornati

    La documentazione ora elenca gli errori restituiti dai metodi della risorsa whitelist.

    Inoltre, la tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Tieni presente che un metodo può restituire più errori dello stesso tipo. Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Errori
    badRequest (400) inappropriateCampaignTarget
    I metodi campaigns.insert e campaigns.update restituiscono questo errore se una campagna tenta di mostrare un video che potrebbe essere inappropriato per alcuni utenti. Per risolvere l'errore, scegli contenuti diversi da mettere in evidenza.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    Il metodo claims.insert restituisce questo errore se provi a creare una rivendicazione caricata dal partner con una risorsa registrazione audio o composizione.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    Il metodo claims.insert restituisce questo errore se esiste già una rivendicazione per la musica registrata nel video specificato. Le rivendicazioni di composizione diretta non possono essere aggiunte tramite l'API.
    badRequest (400) asset_id
    Il metodo references.insert restituisce questo errore se la richiesta ha tentato di creare un riferimento tramite un file, ma non ha specificato un assetId.
    badRequest (400) canNotBeActivated
    Il metodo references.update restituisce questo errore se non è possibile attivare il riferimento, probabilmente a causa del suo stato o delle condizioni di proprietà.
    badRequest (400) videoNotClaimed
    Il metodo videoAdvertisingOptions.get restituisce questo errore se non hai rivendicato il video per il quale stai tentando di recuperare le opzioni pubblicitarie, rendendo così non disponibili le informazioni richieste.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) richiedono che determinate informative vengano fornite agli utenti finali e che i loro consensi vengano ottenuti nell'UE. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una notifica di questo requisito nei nostri Termini di servizio dell'API YouTube.

21 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

30 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Il nuovo parametro isrcs del metodo assetSearch.list consente di specificare un elenco di massimo 50 codici ISRC. La risposta dell'API includerà gli asset associati a questi codici ISRC.

    • La proprietà event[].reason della risorsa claimHistory supporta i seguenti nuovi valori. Ogni motivo spiega perché si è verificato un determinato evento correlato alla rivendicazione:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • Il nuovo parametro sort del metodo claimSearch.list specifica il metodo che verrà utilizzato per ordinare le risorse nella risposta dell'API. Per impostazione predefinita, le risorse vengono ordinate in ordine cronologico inverso (dalla più recente alla meno recente) in base alle date di creazione. Puoi anche ordinare le risorse dal numero di visualizzazioni più alto a quello più basso per i contenuti rivendicati.

      Tieni presente che se la richiesta claimSearch.list imposta anche il valore del parametro status su appealed, disputed, pending, potential o routedForReview, i risultati vengono ordinati in base alla data di scadenza del periodo di revisione della rivendicazione.

    • I metodi ownership.update e ownership.patch ora elencano correttamente tutte le proprietà che possono essere aggiornate quando vengono chiamati. Questa modifica rappresenta una correzione alla documentazione dell'API e non identifica una modifica alla funzionalità dell'API.

    • I parametri fetchMatchPolicy per i metodi assets.get e assets.list ora elencano effective come valore supportato. Il valore indica al server API di recuperare la norma di corrispondenza applicata da YouTube alla risorsa.

    • I parametri id per i metodi assets.list, claims.list, contentOwners.list, policies.list, publishers.list e references.list ora indicano che i relativi valori possono contenere un massimo di 50 ID separati da virgola.

  • Errori nuovi e aggiornati

    La tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Tieni presente che un metodo può restituire più errori dello stesso tipo.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Tipo di errore Dettagli errore Descrizione
    badRequest (400) tooManyIsrcs Il metodo assetSearch.list restituisce questo errore se il parametro isrcs specifica più di 50 codici ISRC.
    badRequest (400) videoIsPrivate Il metodo claims.insert restituisce questo errore se provi a rivendicare un video privato. Puoi rivendicare un video solo se lo stato della privacy è public o unlisted.
    notModified (304) blockOutsideOwnershipUnchanged Il metodo claims.update restituisce questo errore se il flag blockOutsideOwnership della rivendicazione non è stato modificato correttamente. Esistono diversi motivi per cui questo errore potrebbe verificarsi. Un esempio comune è che la modifica specificata non ha alcun effetto sul video rivendicato.

7 novembre 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Il parametro status del metodo claimSearch.list ora supporta un valore routedForReview. Questo valore limita i risultati alle rivendicazioni che richiedono una revisione manuale in base a una regola nella norma di corrispondenza di una risorsa.

    • La proprietà event[].reason della risorsa claimHistory supporta i seguenti nuovi valori. Ogni motivo spiega perché si è verificato un determinato evento correlato alla rivendicazione:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • La proprietà origin.source della risorsa claim, che identifica la fonte di una rivendicazione, ora supporta il valore melodyMatch. Una rivendicazione per corrispondenza di melodia indica che il video rivendicato condivide una composizione musicale con un riferimento.

    • La documentazione del metodo references.insert è stata aggiornata per riflettere correttamente il fatto che l'API utilizza due endpoint diversi per questo metodo. Non si tratta di una modifica della funzionalità dell'API, ma di una correzione della documentazione esistente.

      • Se la richiesta prevede il caricamento di un nuovo file di riferimento, l'endpoint corretto è:

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

      • Se la richiesta riguarda la creazione di un riferimento utilizzando un video rivendicato come contenuto di riferimento, l'endpoint corretto è:

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

  • Errori nuovi e aggiornati

    La tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Tieni presente che un metodo può restituire più errori dello stesso tipo.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Tipo di errore Dettagli errore Descrizione
    badRequest (400) invalidLabelName I metodi assets.insert, assets.update e assetLabels.insert restituiscono questo errore se il nome di un'etichetta della risorsa non è valido. I nomi delle etichette devono avere una lunghezza compresa tra 2 e 30 caratteri. Non possono contenere parentesi angolari, virgole, due punti, e commerciale (&) o il carattere barra verticale (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels I metodi assets.insert, assets.update e assetLabels.insert restituiscono questo errore se un proprietario dei contenuti ha già definito 2500 etichette delle risorse univoche, ovvero il numero massimo attualmente consentito.
    badRequest (400) tooManyLabelsOnOneAsset I metodi assets.insert e assets.update restituiscono questo errore se una risorsa è già associata a 30 etichette delle risorse, ovvero il numero massimo attualmente consentito.
    badRequest (400) channelMonetizationSuspended I metodi claims.insert e claims.update restituiscono questo errore se il canale di un video è stato sospeso per rivendicazioni dei partner.
    badRequest (400) channelNotActive Il metodo claims.update restituisce questo errore se il canale di un video non è attivo.

  • I metodi assets.insert e assets.update non restituiscono più un errore badRequest per alcuni asset se la risorsa nel corpo della richiesta non contiene la proprietà metadataMine.contentType.

23 settembre 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Modifiche all'ID proprietario dei contenuti

    Le modifiche all'ID proprietario dei contenuti annunciate nella cronologia delle revisioni il 9 luglio 2014 sono entrate in vigore. A seguito di questa modifica, l'API ora restituisce un ID univoco generato per identificare il proprietario dei contenuti associato all'utente autenticato o a una risorsa gestita tramite l'API. In precedenza, l'API restituiva un nome leggibile come ID, ad esempio "qrs_network".

    Questa modifica interessa la seguente funzionalità dell'API e probabilmente avrà un impatto sui partner che hanno codici partner hardcoded nelle loro applicazioni.

    • Ora l'API restituisce il nuovo ID come valore delle proprietà della risorsa che in precedenza restituivano il codice partner, ad esempio la proprietà id della risorsa contentOwner.
    • Tutti i metodi dell'API supportano il parametro onBehalfOfContentOwner, che identifica il proprietario dei contenuti per conto del quale viene effettuata la richiesta API. A seguito della modifica, il parametro deve essere impostato sul nuovo ID anziché sul codice partner. Per evitare interruzioni del codice, il parametro accetterà entrambi i valori durante un periodo di transizione.
    • A seguito della modifica, il parametro contentOwnerId del metodo contentOwners.list deve specificare il nuovo ID anziché il codice partner.

  • Aggiornamenti a risorse e metodi esistenti

    • Il nuovo parametro metadataSearchFields del metodo assetSearch.list ti consente di specificare i campi dei metadati delle risorse in cui vuoi eseguire la ricerca, nonché i valori da cercare in questi campi. Il valore del parametro è un elenco separato da virgole di coppie di campi e valori; all'interno di una coppia, il campo e il valore sono separati da due punti.

    • Il nuovo oggetto appliedPolicy della risorsa claim specifica le norme effettivamente applicate da YouTube per la rivendicazione. Il valore dell'oggetto è una risorsa policy. Questa risorsa contiene informazioni sulle norme per i paesi in cui il proprietario dei contenuti che ha inviato la richiesta possiede la risorsa rivendicata.

      La norma applicata può differire da quella definita dal proprietario dei contenuti in due modi:

      1. Tiene conto delle norme impostate da altri proprietari che detengono la proprietà parziale della risorsa rivendicata in alcuni dei territori in cui si trova il proprietario dei contenuti che ha inviato la richiesta all'API.

      2. Tiene conto delle norme amministrative di YouTube che si applicano nei territori in cui il proprietario dei contenuti detiene la proprietà della risorsa rivendicata.

    • La nuova proprietà uploaderChannelId della risorsa claimHistory identifica l'ID canale del canale su cui è stato caricato il video oggetto della rivendicazione.

8 settembre 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e nuovi metodi

    • La nuova risorsa assetLabel identifica un'etichetta di testo che può essere assegnata a una risorsa. Le etichette ti consentono di inserire le risorse in categorie personalizzate, semplificando l'organizzazione della raccolta di asset. Puoi cercare le risorse in base alle loro etichette, le quali possono anche semplificare i casi di utilizzo che richiedono di aggiornare specifici gruppi di risorse.

      • Il metodo assetLabels.list consente di recuperare un elenco delle etichette di un proprietario dei contenuti.
      • Il metodo assetLabels.insert consente di creare una nuova etichetta della risorsa. Puoi anche creare nuove etichette chiamando il metodo assets.update e aggiornando le etichette di una risorsa. Il server API creerà automaticamente una nuova risorsa assetLabel per qualsiasi etichetta non definita in precedenza.

  • Aggiornamenti a risorse e metodi esistenti

    • La proprietà label[] della risorsa asset è stata aggiornata per indicare che puoi chiamare il metodo assets.update per aggiornare le etichette di una risorsa. Tuttavia, non puoi impostare le etichette di una risorsa quando chiami il metodo assets.insert.

      La nuova guida Utilizzo di etichette delle risorse spiega come creare e recuperare le etichette delle risorse, nonché come aggiornare le etichette di una risorsa o cercare risorse associate a etichette specifiche.

  • Errori nuovi e aggiornati

    L'API supporta diversi nuovi errori per i nuovi metodi assetLabels.list e assetLabels.insert.

9 luglio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Modifiche all'ID proprietario dei contenuti

    In passato, l'API utilizzava un codice partner leggibile, ad esempio "qrs_network", per identificare in modo univoco il proprietario dei contenuti associato all'utente autenticato o a una risorsa gestita tramite l'API. Nel terzo trimestre del 2014, l'API passerà a utilizzare un ID univoco di 22 caratteri per identificare i proprietari dei contenuti. La modifica interessa la seguente funzionalità dell'API e potrebbe influire sui partner che hanno codici partner hardcoded nelle loro applicazioni.

    • L'API restituirà l'ID di 22 caratteri come valore delle proprietà della risorsa che in precedenza restituivano il codice partner, ad esempio la proprietà id della risorsa contentOwner.
    • Tutti i metodi dell'API supportano il parametro onBehalfOfContentOwner, che identifica il proprietario dei contenuti per conto del quale viene effettuata la richiesta API. A seguito della modifica, il parametro deve essere impostato sull'ID di 22 caratteri anziché sul codice partner. Per evitare interruzioni del codice, il parametro accetterà entrambi i valori durante un periodo di transizione.
    • A seguito della modifica, il parametro contentOwnerId del metodo contentOwners.list deve specificare l'ID di 22 caratteri anziché il codice partner.

  • Aggiornamenti a risorse e metodi esistenti

    • Una risorsa asset ora supporta la proprietà label, che specifica un elenco di etichette della risorsa associate alla risorsa. Puoi raggruppare più risorse assegnando loro la stessa etichetta. Puoi utilizzare le etichette come filtri di ricerca per eseguire aggiornamenti collettivi, scaricare report o per filtrare i dati di YouTube Analytics.

    • Il metodo assetSearch.list ora supporta i seguenti parametri facoltativi:

      • labels: limita i risultati in modo da includere solo le risorse associate alle etichette specificate. Per impostazione predefinita, l'API restituisce le risorse corrispondenti a tutte le etichette specificate. Tuttavia, puoi utilizzare il parametro includeAnyProvidedLabel per indicare all'API di restituire gli asset corrispondenti a una delle etichette specificate.
      • includeAnyProvidedLabel: utilizzato in combinazione con il parametro labels, questo parametro indica all'API di restituire le risorse associate a una delle etichette specificate nel valore del parametro labels.

    • Una risorsa claimHistory ora contiene le seguenti nuove proprietà:

    • Il metodo claimSearch.list ora supporta i seguenti parametri facoltativi:

      • createdAfter: limita i risultati in modo da includere solo le rivendicazioni create dopo la data specificata.
      • createdBefore: limita i risultati in modo da includere solo le richieste create prima della data specificata.
      • includeThirdPartyClaims: utilizzato in combinazione con il parametro videoId, indica se includere i rivendicazioni di terze parti nei risultati dell'API.

  • Informazioni più dettagliate sugli errori

    La documentazione relativa agli errori ora specifica il codice di risposta HTTP per ogni tipo di errore.

  • Errori nuovi e aggiornati

    La tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Tieni presente che un metodo può restituire più errori dello stesso tipo. Ad esempio, viene restituito un errore required se provi a inserire una risorsa asset a cui manca un campo dei metadati obbligatorio. Infatti, potrebbe essere presente più di un campo dei metadati obbligatori, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Metodo Errori
    assetSearch.list
    • invalidValue: l'API non supporta la possibilità di cercare risorse di programmi o stagioni. Modifica il valore del parametro type in un valore supportato.
    assets.insert
    • conflict: esistono già troppe risorse con lo stesso identificatore (ad es. ID personalizzato, ISRC e così via).
    • conflict: esistono già troppe copie dell'asset specificato.
    • invalidValue: l'utente che chiama l'API non dispone dell'autorizzazione per creare asset del tipo specificato.
    assets.patch
    assets.update
    • badRequest: l'API non supporta la conversione del tipo di asset che hai tentato.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest: non puoi aggiornare la proprietà di una risorsa art track.
    references.patch
    references.update
    • badRequest: il riferimento è in uno stato non valido per l'operazione che stai tentando.

3 febbraio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Aggiornamenti a risorse e metodi esistenti

    • Ora una risorsa asset può avere un valore type pari a art_track_video.

    • Una risorsa claimSearch ora include le seguenti nuove proprietà:

      • L'oggetto origin contiene informazioni che descrivono il modo in cui è stato creato il reclamo.
      • La proprietà thirdPartyClaim contiene un valore booleano che indica se la rivendicazione è stata effettuata da un proprietario dei contenuti diverso da quello associato all'utente che esegue la ricerca.

    • Il metodo claimSearch.list ora supporta i seguenti parametri facoltativi:

      • contentType: limita i risultati in modo da includere solo rivendicazioni solo audio, solo video o audiovisive.
      • origin: specifica una o più origini delle rivendicazioni, ad esempio descriptiveSearch o videoMatch, per le quali vuoi trovare le rivendicazioni.
      • status: limita i risultati in modo da includere solo le rivendicazioni con lo stato specificato.

    • La proprietà status della risorsa claim ora supporta i seguenti valori aggiuntivi: appealed, disputed, potential, takedown e unknown.

    • La nuova proprietà blockOutsideOwnership della risorsa claim indica se il video rivendicato deve essere bloccato nei territori in cui non è di proprietà esplicita. Per impostazione predefinita, un video rivendicato sarebbe comunque visualizzabile nei paesi in cui non erano stati definiti i dati di proprietà per la risorsa associata alla rivendicazione.

    • La nuova proprietà allowedOptions.autoGeneratedBreaks della risorsa contentOwnerAdvertisingOption indica se il partner può scegliere di mostrare annunci mid-roll in-stream negli intervalli determinati automaticamente da YouTube.

    • Ora il metodo contentOwners.list può essere chiamato con un token di autorizzazione che specifica l'ambito https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

    • La nuova proprietà timeUpdated della risorsa policy specifica l'ora dell'ultimo aggiornamento del criterio.

    • Il metodo policies.list ora supporta un parametro facoltativo sort, che può essere utilizzato per specificare che i risultati devono essere ordinati in ordine crescente o decrescente in base all'ora dell'ultimo aggiornamento.

    • La nuova proprietà expiryTime della risorsa referenceConflict specifica il momento in cui termina il periodo di revisione del conflitto di riferimento, causando la scadenza del conflitto.

    • La nuova proprietà autoGeneratedBreaks della risorsa videoAdvertisingOption indica se nel video devono essere mostrati annunci mid-roll in-stream negli intervalli determinati automaticamente da YouTube.

  • Errori nuovi e aggiornati

    La tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Tieni presente che un metodo può restituire più errori dello stesso tipo. Ad esempio, viene restituito un errore required se provi a inserire una risorsa asset a cui manca un campo dei metadati obbligatorio. Infatti, potrebbe essere presente più di un campo dei metadati obbligatori, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Metodo Errori
    assets.insert
    assets.update
    • badRequest: l'API non supporta le operazioni di scrittura sulle risorse art track.
    claimSearch.list
    • invalidValue: il parametro pageToken nella richiesta specifica un token della pagina non valido.
    claims.insert
    • badRequest – La rivendicazione che stai tentando di creare non è valida perché il canale del video non è attivo.
    • badRequest: il video che stai tentando di rivendicare è esente da una norma sulla rimozione. Per informazioni, contatta copyright@youtube.com
    • badRequest: non è possibile elaborare la tua richiesta perché non puoi creare una rivendicazione di terze parti sul video specificato.
    • conflict – YouTube non può creare la rivendicazione richiesta perché il video ha ricevuto una notifica di rimozione.
    • conflict: YouTube non può creare la rivendicazione richiesta perché per il video è presente una rivendicazione di rimozione attiva.
    references.insert
    • badRequest: il video rivendicato che stai cercando di utilizzare è stato eliminato o rifiutato oppure l'elaborazione non è andata a buon fine.

  • Gli errori contentOwnerNotProvided e internalError, che non sono specifici di un determinato metodo dell'API, non sono più elencati in ogni pagina del metodo. Le relative descrizioni sono comunque disponibili nella sezione Errori generali della documentazione relativa agli errori dell'API.

12 settembre 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e nuovi metodi

    • La nuova risorsa referenceConflict identifica un conflitto tra due file di riferimento ed elenca le corrispondenze esistenti tra questi file quando è stato identificato il conflitto. Il metodo referenceConflicts.list consente di recuperare un elenco di conflitti di riferimento irrisolti associati al proprietario dei contenuti autorizzato. Il metodo referenceConflicts.get consente di recuperare un conflitto di riferimento specificandone l'ID univoco.

    Aggiornamenti a risorse e metodi esistenti

    • L'API ora supporta la possibilità di recuperare il criterio di corrispondenza efficace per un asset. Questa modifica è simile a quella rilasciata il 16 luglio 2013, che includeva il supporto per il recupero dell'insieme canonico di metadati e dati di proprietà per una risorsa.

      Per recuperare il criterio di corrispondenza efficace per una risorsa, imposta il valore del parametro fetchMatchPolicy su effective quando chiami i metodi assets.get o assets.list. Nella risposta dell'API, l'oggetto matchPolicyEffective in ogni risorsa asset restituita contiene il criterio di corrispondenza efficace per l'asset.

    • Il nuovo oggetto ownershipConflicts della risorsa asset contiene informazioni sui conflitti di proprietà della risorsa. La struttura dell'oggetto è simile a quella di una risorsa ownership, che identifica ogni tipo diverso di diritti che un proprietario della risorsa può detenere. Per la maggior parte dei tipi di asset, i proprietari possono avere solo la proprietà generale delle risorse, ma per le risorse di composizione possono indicare la proprietà dei diritti di esecuzione, di sincronizzazione o di riproduzione meccanica.

      Analogamente, l'oggetto ownershipConflicts contiene elenchi separati che identificano i conflitti per i diritti di proprietà generale, i diritti di esecuzione, i diritti di sincronizzazione e i diritti di riproduzione meccanica. Per ogni conflitto, i dati identificano i territori in cui si verifica il conflitto, i proprietari che hanno fornito dati sulla proprietà in conflitto e la percentuale della risorsa che ciascun proprietario in conflitto dichiara di possedere.

    • I metodi assets.get e assets.get ora supportano il nuovo parametro fetchOwnershipConflicts. Il parametro ha un valore booleano che indica se la richiesta API deve recuperare i conflitti di proprietà per le risorse nella risposta dell'API. Il valore predefinito è false, il che significa che i conflitti di proprietà non vengono restituiti.

    • La definizione del parametro q del metodo assetSearch.list è stata aggiornata per identificare i campi dei metadati che YouTube cerca.

    • La documentazione del corpo della richiesta per un metodo references.insert ora indica che devi impostare il valore della proprietà contentType. Questa modifica aggiorna la documentazione in modo che rifletta correttamente la funzionalità effettiva dell'API, ma non rappresenta una modifica della funzionalità dell'API.

  • Errori nuovi e aggiornati

    • L'API supporta un nuovo errore forbidden, non specifico per un determinato metodo, che indica che l'operazione richiesta non può essere autorizzata da un service account.

    • Il metodo assets.insert ora identifica gli errori nei metadati come eventi che si verificano nelle proprietà dell'oggetto metadataMine anziché nell'oggetto metadata, che è stato ritirato a partire dall'aggiornamento dell'API del 16 luglio 2013.

    • La pagina errors è stata aggiornata in modo che per ogni risorsa che supporta i metodi update e patch, la pagina contenga una tabella che elenca gli errori restituiti da questi due metodi. In precedenza, la pagina elencava gli errori per ciascun metodo separatamente, anche se gli elenchi erano sempre gli stessi.

16 luglio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Nuove risorse e nuovi metodi

    • Il nuovo metodo claimHistory.get consente di identificare e recuperare informazioni su una rivendicazione specifica. La risorsa claimHistory restituita contiene un elenco di eventi relativi alla rivendicazione, ad esempio la creazione, l'aggiornamento, la contestazione o la chiusura della rivendicazione.

    • Il nuovo metodo claimSearch.list ti consente di cercare le rivendicazioni che soddisfano uno o più dei seguenti criteri:

      • Le rivendicazioni sono associate a una risorsa specifica.
      • Le rivendicazioni sono associate a un video specifico.
      • Le rivendicazioni corrispondono a una stringa di query fornita nella richiesta.

      Ogni risorsa claimSnippet nella risposta dell'API contiene i dettagli di una rivendicazione, tra cui l'ID rivendicazione univoco, lo stato, il tipo (audio, video o audiovisual) e la risorsa e il video associati alla rivendicazione. La risorsa specifica anche il numero di visualizzazioni del video rivendicato e il titolo del video rivendicato.

  • Aggiornamenti a risorse e metodi esistenti

    • La documentazione ora elenca i valori supportati per le proprietà che hanno un insieme di valori enumerati. Queste proprietà includono la proprietà type della risorsa asset e la proprietà status della risorsa claim.

    • Per i metodi assets.get e assets.list, l'API ora supporta i valori separati da virgola per i parametri di richiesta fetchMetadata e fetchOwnership, consentendoti di recuperare più insiemi di metadati o dati di proprietà.

      L'elenco seguente illustra le modifiche corrispondenti alla struttura della risorsa asset, nonché le ripercussioni di queste modifiche sui metodi dell'API utilizzati dalle risorse get, list, insert, update o patch asset.

      • L'oggetto metadata è stato ritirato e sostituito dagli oggetti metadataMine e metadataEffective. I nuovi oggetti consentono a una risorsa asset di includere sia l'insieme di metadati fornito dal proprietario dei contenuti che effettua la richiesta all'API sia l'insieme di metadati canonici che YouTube ha stabilito essere l'insieme di metadati più accurato e completo per la risorsa.

      • Analogamente, l'oggetto ownership è stato sostituito con gli oggetti ownershipMine e ownershipEffective.

      • L'oggetto matchPolicy è stato sostituito con l'oggetto matchPolicyMine. Al momento l'API non supporta la possibilità di recuperare il criterio di corrispondenza effettivo per una risorsa.

      Nota:per garantire la compatibilità con le versioni precedenti, se per una risorsa viene richiesta una sola versione dei metadati, un solo insieme di dati sulla proprietà o una sola norma di corrispondenza, la risposta dell'API includerà l'oggetto deprecato e l'oggetto di nuova introduzione. Ad esempio, se una richiesta imposta il parametro fetchMetadata su mine, la risposta dell'API conterrà un oggetto metadata e un oggetto metadataMine, entrambi contenenti gli stessi dati. (La possibilità di impostare fetchMetadata=mine era supportata prima dell'aggiornamento della funzionalità che ti consentiva di recuperare più versioni dei metadati.)

      Tuttavia, se il parametro fetchMetadata è impostato su mine,effective, la risposta dell'API conterrà gli oggetti metadataMine e metadataEffective, ma non un oggetto metadata. La possibilità di impostare fetchMetadata=mine,effective non era supportata prima di questo aggiornamento della funzionalità, pertanto non è necessario restituire l'oggetto metadata per la compatibilità con le versioni precedenti. Lo stesso principio vale anche per i parametri fetchOwnership e fetchMatchPolicy.

      Analogamente, per la compatibilità con le versioni precedenti, una richiesta a insert, update o patch una risorsa asset può includere l'oggetto metadataMine o l'oggetto metadata. Lo stesso principio vale per l'impostazione dei dati di proprietà o delle norme di corrispondenza di una risorsa asset.

    • I parametri assetId, q e videoId del metodo claims.list sono stati ritirati. Per cercare le rivendicazioni utilizzando uno di questi criteri, utilizza il metodo claimSearch.list, che supporta tutti questi parametri.

    • In una risorsa ownership, i valori delle proprietà general[].ratio, performance[].ratio, synchronization[].ratio e mechanical[].ratio ora hanno tutti un formato dei contenuti double anziché integer.

    • La definizione della proprietà rules[].action della risorsa policy ora elenca i valori validi per quella proprietà: block, monetize, takedown e track. Tuttavia, tieni presente che non puoi utilizzare l'API per applicare le norme relative alla rimozione a una rivendicazione.

    • La nuova proprietà claimId della risorsa reference è presente se il riferimento è stato creato associando una risorsa a un video di YouTube esistente caricato su un canale YouTube collegato al tuo account CMS. In questo caso, questo campo contiene l'ID della rivendicazione che rappresenta l'associazione risultante tra la risorsa e il video.

    • La nuova proprietà excludedIntervals[] della risorsa reference specifica un elenco di intervalli di tempo durante il riferimento che YouTube deve ignorare quando cerca una corrispondenza. Ogni intervallo specifica un'ora di inizio e di fine misurata in secondi dall'inizio del video.

    • L'API non richiede più l'impostazione della proprietà status nella risorsa reference inviata nel corpo di una richiesta references.update o references.patch.

    • La documentazione è stata corretta per descrivere correttamente il formato della risposta dell'API per il metodo videoAdvertisingOptions.getEnabledAds. La risposta, che è una risorsa youtubePartner#videoAdvertisingOptionGetEnabledAds, contiene le seguenti informazioni:

      • id: l'ID utilizzato da YouTube per identificare in modo univoco il video rivendicato associato alle impostazioni.

      • adBreaks: un elenco di oggetti in cui ogni oggetto contiene informazioni su un punto prima, durante o dopo la riproduzione del video in cui è consentito pubblicare gli annunci. Ogni oggetto può specificare anche altri attributi dell'interruzione pubblicitaria, ad esempio le aree annuncio che si verificano durante l'interruzione e i tipi di annunci che possono essere pubblicati durante ogni area.

      • adsOnEmbeds: un campo booleano che indica se YouTube può mostrare annunci quando il video viene riprodotto in un player incorporato.

      • countriesRestriction: un elenco di oggetti in cui ogni oggetto identifica un elenco di territori e i formati degli annunci utilizzati durante la riproduzione del video in questi territori.

  • Errori nuovi e aggiornati

    • La tabella seguente identifica i nuovi errori supportati dall'API e i metodi che potrebbero restituire ciascun errore. Identifica inoltre gli errori che sono stati modificati. Tieni presente che un metodo può restituire più errori dello stesso tipo. Ad esempio, viene restituito un errore required se provi a inserire una risorsa asset a cui manca un campo dei metadati obbligatorio. Infatti, potrebbe essere presente più di un campo dei metadati obbligatori, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

      Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

      Metodo Errori
      assets.insert
      assets.update
      assets.patch
      • Gli errori invalidValue e required precedentemente associati alle proprietà secondarie dell'oggetto metadata sono ora associati alle stesse proprietà secondarie nell'oggetto metadataMine.
      claimHistory.get
      • notFound: non è possibile trovare la rivendicazione per la quale stai tentando di recuperare la cronologia.
      • required: la richiesta non specifica un valore per il parametro claimId.
      claimSearch.list
      claims.list
      • badRequest: la richiesta specifica criteri non validi. È possibile specificare al massimo uno dei seguenti parametri di filtro: q, assetId, videoId.
      claims.insert
      • badRequest: la rivendicazione che stai tentando di creare non è valida perché il proprietario dei contenuti richiesto non è proprietario della risorsa associata alla rivendicazione.
      • badRequest: il proprietario dei contenuti per conto del quale agisci non ha l'autorizzazione per creare criteri con l'azione specificata.
      • invalidValue: il proprietario dei contenuti per conto del quale agisci non ha l'autorizzazione a rivendicare i video caricati dagli utenti tramite l'API.
      contentOwners.list
      • badRequest: la richiesta specifica criteri non validi. Deve essere specificato esattamente uno dei seguenti parametri di filtro: fetchMine, id. In precedenza, l'errore elencava un insieme diverso di parametri di filtro: has_conflicts_with, restrict_to_user, name_prefix e id.
      ownership.update
      ownership.patch
      • badRequest: una richiesta che aggiorna i dati di proprietà di un asset composizione deve specificare dati di proprietà granulari &ndahs; diritti mechanical, performance, synchronization e/o lyric, anziché diritti di proprietà general. Il tipo di diritti lyric è di nuova introduzione.
      policies.insert
      policies.update
      policies.patch
      • invalidValue: la richiesta contiene una regola di criteri non valida perché l'API non supporta la creazione o la modifica di criteri che specificano un'azione takedown. Questo errore, che riporta un motivo invalidPolicyTakedownAction, sostituisce l'errore invalidPolicyConditionalTakedown deprecato.
      references.insert
      • badRequest: la richiesta deve inviare un file multimediale o specificare un valore per il parametro di richiesta claimId. Tuttavia, una richiesta non può inviare un file multimediale e specificare un valore per il parametro di richiesta claimId.
      • badRequest: è già stato creato un riferimento per gli stessi contenuti da una rivendicazione diversa sullo stesso video di YouTube.
      • badRequest: l'API non supporta la possibilità di impostare un valore per la proprietà fpDirect durante la creazione di un riferimento.
      • internalError: si è verificato un problema con il file multimediale caricato.
      • invalidValue: il valore del parametro di richiesta contentType, assetId o claimId non è valido. L'errore identifica il valore non valido.
      • notFound: non è possibile trovare la risorsa o la rivendicazione specificata. Controlla i valori dei parametri assetId e claimId nella richiesta.
      • required: la richiesta deve specificare un valore per il parametro contentType.
      references.insert
      references.update
      references.patch
      • invalidValue: i valori excludedIntervals specificati per il riferimento non sono validi. Tieni presente che non puoi specificare intervalli di esclusione quando disattivi un riferimento.

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

8 aprile 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API è stata rinominata in API YouTube Content ID.

  • Diverse proprietà sono cambiate nella risorsa assetMatchPolicy:

    • Il valore della proprietà kind è passato da youtubePartner#policy a youtubePartner#assetMatchPolicy.
    • La nuova proprietà policyId contiene un valore che identifica in modo univoco una risorsa criterio salvata.
    • Il valore della proprietà rules[].subaction ora è un elenco di stringhe anziché una stringa.
    • Il valore della proprietà rules[].conditions.contentMatchType ora è un elenco di stringhe anziché una stringa.
    • Le proprietà id, name e description sono state rimosse.

  • La documentazione del metodo assetMatchPolicy.update è stata aggiornata per riflettere il fatto che puoi impostare valori per la proprietà policyId o per l'oggetto rules[] quando chiami il metodo.

  • La risorsa claims ora supporta diverse nuove proprietà:

    Nome proprietà Valore Descrizione
    timeCreated datetime La data e l'ora di creazione della rivendicazione.
    matchInfo object L'oggetto matchInfo contiene informazioni sui contenuti corrispondenti che hanno generato la rivendicazione. Queste informazioni sono incluse in una risorsa claim solo se la rivendicazione è stata generata automaticamente perché un video caricato corrispondeva a un file di riferimento esistente.
    matchInfo.referenceId string L'ID univoco utilizzato da YouTube per identificare il riferimento reference che ha generato la corrispondenza.
    matchInfo.longestMatch object L'oggetto longestMatch contiene informazioni sulla corrispondenza più lunga tra il riferimento e il video caricato.
    matchInfo.longestMatch.durationSecs unsigned long La durata della corrispondenza, in secondi.
    matchInfo.longestMatch.userVideoOffset unsigned long Lo sfasamento temporale all'inizio della partita, misurato in secondi dall'inizio del video caricato.
    matchInfo.longestMatch.referenceOffset unsigned long L'offset di tempo all'inizio della partita, misurato in secondi dall'inizio del riferimento.
    matchInfo.totalMatch object L'oggetto totalMatch contiene informazioni sulla quantità totale del video caricato che corrisponde al riferimento e sulla quantità totale del riferimento che corrisponde al video caricato. Questi valori possono variare se i contenuti corrispondenti vengono riprodotti in loop nel video caricato o nel riferimento. Ad esempio, se un video caricato include un clip di 10 secondi di un riferimento, ma il clip viene ripetuto sei volte, la durata totale dei contenuti corrispondenti nel video caricato è di 60 secondi, mentre nel riferimento è di soli 10 secondi.
    matchInfo.totalMatch.userVideoDurationSecs unsigned long La durata totale, in secondi, dei contenuti del video caricato che corrispondono al riferimento.
    matchInfo.totalMatch.referenceDurationSecs unsigned long La durata totale, in secondi, dei contenuti di riferimento che corrispondono al video caricato.
    origin object L'oggetto origin contiene informazioni che descrivono la fonte della rivendicazione.
    origin.source string La fonte della rivendicazione.

  • La proprietà policy nella risorsa claims è stata aggiornata per indicare che il valore non può essere aggiornato per una rivendicazione AudioSwap.

  • La proprietà timeProvidedMs della risorsa metadataHistory è stata rinominata in timeProvided.

  • La proprietà timeProvidedMs della risorsa ownershipHistory è stata rinominata in timeProvided.

  • La definizione del metodo ownershipHistory.list è stata aggiornata per indicare che il metodo recupera solo i dati di proprietà più recenti per ciascun proprietario dei contenuti. Tuttavia, se il proprietario dei contenuti ha inviato i dati sulla proprietà tramite più origini dati (API, feed di contenuti e così via), l'elenco conterrà i dati più recenti per ogni proprietario dei contenuti e origine dati.

  • Diverse proprietà sono cambiate nella risorsa policy:

    • La proprietà rule è stata rinominata in rules.
    • Il valore della proprietà rules[].subaction ora è un elenco di stringhe anziché una stringa.
    • Il valore della proprietà rules[].conditions.contentMatchType ora è un elenco di stringhe anziché una stringa.

  • La documentazione dei metodi policies.insert e policies.update è stata aggiornata per riflettere il fatto che puoi impostare valori per l'oggetto rules[] quando chiami questi metodi.

  • Diversi metodi API supportano nuovi tipi di errori. La tabella riportata di seguito identifica il metodo e i tipi di errori di nuova introduzione. In molti casi, potrebbero verificarsi più errori per un determinato tipo. Ad esempio, viene restituito un errore required se provi a inserire una risorsa asset a cui manca un campo dei metadati obbligatorio. Infatti, potrebbe essere presente più di un campo dei metadati obbligatori, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori di ciascun metodo o la pagina errori.

    Metodo Errori
    assets.insert
    • invalidValue: un campo dei metadati della risorsa contiene un valore non valido.
    • required: manca un campo obbligatorio dei metadati della risorsa.
    assets.update
    assets.patch
    • forbidden: l'asset in fase di aggiornamento non è di proprietà del partner che sta tentando di completare l'aggiornamento.
    • invalidValue: un campo dei metadati della risorsa contiene un valore non valido.
    • notFound: la risorsa è associata a una risorsa stagione o programma non trovata.
    • required: manca un campo obbligatorio dei metadati della risorsa.
    claims.insert
    • badRequest: la richiesta tenta di rivendicare un video, ma la rivendicazione non è consentita.
    ownership.update
    ownership.patch
    • badRequest: la richiesta definisce una proprietà totale superiore al 100% all'interno di un territorio.
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules: il criterio contiene regole in conflitto.

  • La nuova pagina errors elenca gli errori che l'API può restituire. La pagina include errori generali, che potrebbero verificarsi per più metodi API diversi, nonché errori specifici per ogni metodo.

18 gennaio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Il metodo videoAdvertisingOptions.getEnabledAds, di cui è stata recentemente completata la documentazione, ti consente di recuperare i dettagli sui tipi di annunci consentiti per un video caricato da un partner o da un utente specifico.

  • La definizione del parametro ownershipRestriction del metodo assetSearch.list è stata aggiornata per indicare che il valore predefinito del parametro è mine, il che indica che l'API deve recuperare solo gli asset di proprietà dell'utente corrente.

  • La documentazione del metodo assets.list riflette le seguenti modifiche:

    • Il parametro id è ora obbligatorio.

    • Il parametro fetchMatchPolicy, di nuova introduzione, consente di indicare se la richiesta API deve recuperare anche il criterio di corrispondenza impostato per l'asset.

    • Il parametro fetchOwnership di nuova introduzione ti consente di indicare se la richiesta API deve recuperare anche i dati sulla proprietà della risorsa.

    • L'elenco di asset restituito dall'API non contiene più i dati di paginazione. Di conseguenza, la proprietà nextPageToken e l'oggetto pageInfo sono stati rimossi dalla risposta dell'API. L'oggetto pageInfo conteneva le proprietà totalResults, resultsPerPage e startIndex.

  • La documentazione della risorsa claims è stata aggiornata per indicare che devi specificare una norma quando crei una rivendicazione. Al momento YouTube non applica le tue norme di utilizzo predefinite se una rivendicazione inserita non ne specifica una, anche se in precedenza la documentazione indicava che ciò avveniva.

  • La proprietà hasUnpublishedDraft della risorsa policy è stata ritirata.

  • Il parametro id, di recente supporto del metodo policies.list, consente di identificare le norme salvate che la richiesta API deve recuperare. È possibile recuperare solo i criteri appartenenti al proprietario dei contenuti attualmente autenticato.

  • La definizione del parametro releaseClaims sia per il metodo references.patch che per il metodo references.update è stata aggiornata per indicare che il parametro funziona solo quando lo stato della rivendicazione viene aggiornato in inactive. In questo caso, puoi anche impostare il valore del parametro releaseClaims su true per rilasciare tutte le rivendicazioni di corrispondenza prodotte dal riferimento.

  • I metodi references.patch e references.update sono stati entrambi aggiornati per indicare che devi specificare lo stato del riferimento quando esegui una di queste operazioni.

  • Diversi metodi API supportano nuovi tipi di errori. La tabella riportata di seguito identifica il metodo e gli errori di nuova introduzione:

    Metodo Tipo di errore Dettagli errore Descrizione
    guideCategories.list notFound Unavailable Impossibile trovare la risorsa per cui stai tentando di recuperare la norma di corrispondenza.
    claims.get notFound Unavailable Impossibile trovare la rivendicazione che stai tentando di recuperare.
    ownership.patch invalidValue Unavailable I dati di proprietà che hai fornito contengono un valore non valido.
    ownership.update invalidValue Unavailable I dati di proprietà che hai fornito contengono un valore non valido.