API YouTube Content ID - Cronologia delle revisioni

Nota:l'API YouTube Data è destinata all'uso da parte dei partner di contenuti di YouTube e non è accessibile a tutti gli sviluppatori o a tutti gli utenti di YouTube. L'accesso richiede un account YouTube Content Manager. Se hai un account YouTube Content Manager, ma non vedi l'API YouTube Data tra i servizi elencati nella console Google Cloud, contatta il tuo partner manager o l'assistenza partner.

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

27 agosto 2026

YouTube allineerà il conteggio delle visualizzazioni pubbliche per tutti i formati video: video nel formato lungo, live e Short. YouTube conteggerà le visualizzazioni pubbliche nel momento in cui inizia la riproduzione di un video.

L'idoneità alla monetizzazione e la maggior parte delle metriche sul rendimento principali non sono interessate, in quanto rimangono ancorate alle metriche sul coinvolgimento. Gli utili dei creator continueranno a essere basati sulle Visualizzazioni di Short "engaged" e sulle Ore di visualizzazione "engaged", visibili in YouTube Analytics > Modalità avanzata.

Non sono state apportate modifiche ai requisiti di idoneità per il Programma partner di YouTube. I requisiti di accesso al Programma partner di YouTube saranno ora indicati come "visualizzazioni di Short idonee" e "ore di visualizzazione idonee" (in precedenza "visualizzazioni pubbliche di Short valide" e "ore di visualizzazione pubblica valide").

Per saperne di più, consulta l'articolo Comprendere il rendimento dei contenuti di YouTube.

Metrica	Stato	Trigger	Utilizzata per
Visualizza	Data/ora aggiornamento	Il video viene riprodotto dal primo fotogramma (include riproduzione automatica, passaggio del puntatore e clic/tocco per la riproduzione).	Conteggi delle visualizzazioni pubbliche standard.
Visualizzazione "engaged"	Invariato	La riproduzione continua oltre il primo fotogramma oppure l'utente fa clic/tocca per riprodurre.	Monetizzazione tramite il Programma partner di YouTube, maggior parte delle analisi di base (percentuale di clic, durata media della visualizzazione) e report sul coinvolgimento.
Impressione della miniatura	Invariato	La miniatura viene visualizzata senza interazione o riproduzione automatica.	Misura l'esposizione e il packaging a livello di feed.

4 agosto 2026

La documentazione dell'API Content ID di YouTube è stata aggiornata per chiarire l'ordine delle operazioni durante l'aggiornamento delle risorse già di proprietà di un altro proprietario di contenuti:

• Se una risorsa è già di proprietà di un altro proprietario di contenuti, devi aggiungere la tua proprietà alla risorsa utilizzando ownership.update o ownership.patch prima di poter impostare o aggiornare i relativi metadati o la norma di corrispondenza.
• Se tenti di aggiornare i metadati (assets.update o assets.patch) o la norma di corrispondenza (assetMatchPolicy.update o assetMatchPolicy.patch) prima di rivendicare la proprietà, la richiesta non va a buon fine e viene visualizzato un errore PERMISSION_DENIED.
• La guida Aggiornare le etichette di una risorsa è stata aggiornata con istruzioni passo passo per aggiungere etichette alle risorse di proprietà di un altro proprietario dei contenuti.

26 marzo 2025

A partire dal 31 marzo 2025, YouTube modificherà 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 un certo numero 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:

• L'ordine di visualizzazione di claimSearch.list.sort verrà aggiornato:
  • DAILY_ENGAGED_VIEWS verrà aggiunto per i conteggi giornalieri delle visualizzazioni in base alla precedente metodologia di conteggio delle visualizzazioni.
  • LIFETIME_ENGAGED_VIEWS verranno aggiunte ai conteggi delle visualizzazioni totali in base alla metodologia di conteggio delle visualizzazioni precedente.
• L'ordine di visualizzazione di assetSearch.list.sort verrà aggiornato:
  • DAILY_ENGAGED_VIEWS verrà aggiunto per i conteggi giornalieri delle visualizzazioni in base alla precedente metodologia di conteggio delle visualizzazioni.

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

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

14 gennaio 2025

Il campo videoAdvertisingOption della risorsa autoGeneratedBreaks[] è stato aggiornato perché ora consentiamo di fornire ad_breaks e autoGeneratedBreaks contemporaneamente. Se autoGeneratedBreaks è impostato su true in un video con adBreaks definito, i nostri sistemi identificheranno i punti in cui mostrare gli annunci, oltre alle aree annunci posizionate manualmente. Per maggiori dettagli, consulta l'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 questo campo. I seguenti formati dell'annuncio non sono più supportati: instream_trueview, instream_standard, display, preroll, postroll. Per maggiori dettagli, consulta questo articolo del Centro assistenza.

1 giugno 2023

Nota:questo è un annuncio di ritiro.

Questo aggiornamento include le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • Il campo breakPosition[] della risorsa videoAdvertisingOption è stato contrassegnato come ritirato e verrà rimosso nel 2024.
    I metodi videoAdvertisingOptions.update e videoAdvertisingOptions.patch ignorano già il campo.
  • Il campo adBreaks[].slot[] deprecato della risorsa videoAdvertisingOption è stato rimosso.
  • I campi category e showCustomId deprecati della risorsa asset sono stati rimossi.
  • Il campo timeStatusLastModified della nuova risorsa claim indica l'ora dell'ultima modifica di una rivendicazione.
  • Il parametro isVideoShortsEligible del nuovo metodo claimSearch.list può essere utilizzato per filtrare i video rivendicati in base alla loro idoneità a YouTube Shorts.

• Nuove risorse e nuovi metodi

  • L'API ora supporta l'elenco delle risorse di YouTube Music:
    • Le risorse musicRelease possono essere elencate con il metodo musicReleases.list.
    • Le risorse musicTrack possono essere elencate con il metodo musicTracks.list.
    • Le risorse musicChangeRequest possono essere elencate con il metodo musicChangeRequests.list.

20 dicembre 2022

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

9 novembre 2022

La documentazione per i metodi asset.get e asset.list è stata aggiornata per chiarire come vengono supportati più valori per:

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

28 settembre 2022

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

18 luglio 2022

La documentazione del metodo claimSearch.list inactiveReasons è stata aggiornata per riflettere i miglioramenti apportati per garantire la 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 automaticamente 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 stringa in cui ogni valore specifica un ISRC o un ISWC, a seconda dei casi, che mappa all'asset identificato 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 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 rimandare alle librerie client standard delle API di Google. Sono stati aggiornati i binding pregenerati per PHP.

3 maggio 2022

Il parametro status del metodo claimSearch.list ora supporta più filtri basati sui potenziali dettagli della rivendicazione.

2 maggio 2022

La documentazione relativa alla risposta del metodo assetSearch.list è stata aggiornata per riflettere i miglioramenti apportati per garantire la coerenza con AIP-158:

• La descrizione di pageInfo.totalResults indica 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 per la 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 trattati da questo metodo:

• Cerca per ID (risorsa, riferimento o video) o stringa di query
• Cerca 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 una rivendicazione inattiva o potenziale a 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 correlate alla rivendicazione.
• L'elenco dei valori supportati per il parametro origin del metodo claimSearch.list è cambiato. Il parametro ora 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, ovvero il codice di risposta HTTP 400, se il valore contiene più di 10 ID video.

6 dicembre 2018

Nota:questo è un annuncio di ritiro.

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

21 marzo 2018

Questo aggiornamento contiene le seguenti modifiche:

• La proprietà metadataMine.artist deve ora essere impostata ogni volta che inserisci, aggiorni o applichi una patch a una risorsa video musicale o registrazione audio. L'API ora 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 pubblicati tramite web, SFTP o un altro meccanismo di pubblicazione. L'API supporta due metodi per questa risorsa:

  • Il metodo package.insert convalida e carica un pacchetto contenente solo metadati e un solo 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 di caricamento specifico 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. Se un riferimento è un duplicato, il valore della proprietà status viene ora impostato su inactive e il valore della proprietà statusReason è REASON_DUPLICATE_FOR_OWNERS.

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

17 aprile 2017

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa assetShare, pertinente solo per le risorse di composizione, identifica una relazione tra due rappresentazioni di una risorsa. Queste rappresentazioni riflettono un nuovo modello dei 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 mappata 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 quota della composizione. Il nuovo metodo assetShares.list ti consente di:

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

• La nuova guida Gestione delle risorse di composizione spiega in che modo i diversi metodi 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à influenzi 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 di questa proprietà in relazione a quel video.

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

• I nuovi Termini di servizio dei servizi API di YouTube ("i Termini aggiornati"), descritti in dettaglio nel blog YouTube Engineering and Developers, forniscono un ricco insieme 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 per spiegare le norme che gli sviluppatori devono rispettare.

  L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, le modifiche future ai Termini aggiornati o ai documenti di 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 ti consente di determinare se un file di metadati contiene errori di convalida che impedirebbero 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 identificano la gravità, la causa e la posizione di ciascun errore.

• 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. Consulta la documentazione relativa agli errori per ogni metodo o la pagina Errori per un elenco completo dei possibili errori.

    Errori
    invalidValue (400)	parameters.assetId La richiesta non è andata a buon fine perché l'asset in fase di aggiornamento è stato unito a un altro asset. Invia nuovamente la richiesta utilizzando l'ID dell'asset, 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 descriverà 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) del contenuto corrispondente. L'API identifica anche gli offset temporali in corrispondenza dei quali inizia e termina ogni segmento di corrispondenza sia nel video rivendicato sia nel video di riferimento.

  • Il valore della proprietà claimedVideoOptions.newVideoDefaults[] della risorsa contentOwnerAdvertisingOptions ora 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. Consulta la documentazione relativa agli errori per ogni metodo o la pagina Errori per un elenco completo dei possibili errori.

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

  • Il metodo assets.list a volte scade e restituisce un codice di risposta HTTP 500 (Internal Server Error), in particolare quando la richiesta recupera dati per molte risorse e il valore del parametro fetchMatchPolicy è effective. Se la tua richiesta assets.list specifica più ID risorsa e restituisce un errore 500, prova a inviare di nuovo la richiesta per una singola risorsa o 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 viene identificato solo dopo l'elaborazione del riferimento stesso. Pertanto, anche se la richiesta references.insert restituisce una risposta positiva, il riferimento potrebbe non essere elaborato correttamente. Ti consigliamo di eseguire il polling utilizzando il metodo references.list dopo aver inserito un riferimento per verificare che 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 con 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à:

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

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

  • Nella risposta 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 art track.

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

    Parametri
    referenceId	Questo parametro di filtro specifica l'ID riferimento YouTube del riferimento per il quale stai recuperando le rivendicazioni.
    inactiveReasons	Questo parametro facoltativo ti consente di limitare la risposta dell'API in modo da includere solo le rivendicazioni inattive in base ai motivi specificati per cui le rivendicazioni sono diventate inattive. La definizione del parametro elenca i tipi di rivendicazioni inattive per cui puoi eseguire la ricerca.
    partnerUploaded	Questo parametro booleano facoltativo ti consente di specificare che la risposta dell'API deve includere solo 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 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 per ogni 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 altri contenuti da mettere in evidenza.
  badRequest (400)	canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets Il metodo claims.insert restituisce questo errore se provi a creare una rivendicazione caricata da un partner con una risorsa composizione o asset registrazione audio.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim Il metodo claims.insert restituisce questo errore se esiste già una rivendicazione per la musica registrata sul 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 il riferimento non può essere attivato, probabilmente a causa dello stato del riferimento 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ì le informazioni richieste non disponibili.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) richiedono che vengano fornite determinate informative e che venga ottenuto il consenso degli utenti finali nell'UE. Pertanto, per gli utenti finali dell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto un avviso di questo requisito nei nostri Termini di servizio dell'API di YouTube.

21 aprile 2015

Questo aggiornamento contiene le seguenti modifiche:

• La nuova risorsa campaign rappresenta una campagna di un proprietario dei contenuti specifica, che consente al proprietario dei contenuti di utilizzare le annotazioni per promuovere i contenuti nei video rivendicati caricati dagli utenti. Ad esempio, un proprietario dei contenuti potrebbe creare una campagna che aggiunge link alla pagina di visualizzazione di un film per tutti i video rivendicati e caricati dagli utenti che contengono scene di quel film.

  L'API supporta i metodi per get, list, insert, update, patch e delete risorse campaign.

• L'API supporta diversi nuovi errori per i nuovi metodi campaigns.get, campaigns.insert, campaigns.update e campaigns.delete.

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à le risorse associate a questi ISRC.

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

    • 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 sono ordinate in ordine cronologico inverso (dalla più recente alla meno recente) in base alla data di creazione. Puoi anche ordinare le risorse dal numero più alto a quello più basso di visualizzazioni per i contenuti rivendicati.

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

  • 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 che YouTube applica 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 valori dei parametri possono contenere un massimo di 50 ID separati da virgole.

• 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 per ogni metodo o la pagina Errori.

  Tipo di errore	Dettaglio 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 il suo stato della privacy è public o unlisted.
  notModified (304)	blockOutsideOwnershipUnchanged	Il metodo claims.update restituisce questo errore se il flag blockOutsideOwnership nella rivendicazione non è stato modificato correttamente. Questo errore può verificarsi per diversi motivi. 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 di routedForReview. Questo valore limita i risultati alle rivendicazioni che richiedono una revisione manuale in base a una regola in una 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 richiesta:

    • closed_invalid_reference_segment
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • La proprietà origin.source della risorsa claim, che identifica l'origine di un'affermazione, ora supporta il valore melodyMatch. Una rivendicazione di corrispondenza della 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 prevede 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 per ogni metodo o la pagina Errori.

  Tipo di errore	Dettaglio errore	Descrizione
  badRequest (400)	invalidLabelName	I metodi assets.insert, assets.update e assetLabels.insert restituiscono questo errore se il nome di un'etichetta asset non è valido. I nomi delle etichette devono essere compresi tra 2 e 30 caratteri. Non possono contenere parentesi angolari, virgole, due punti, la "e" commerciale (&) o la 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 uniche, 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 è 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 codificato i codici partner nelle loro applicazioni.

  • L'API ora restituisce il nuovo ID come valore delle proprietà delle risorse 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. Dopo la 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.
  • Dopo la 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 degli asset in cui vuoi eseguire la ricerca, nonché i valori che vuoi cercare in questi campi. Il valore parametro è un elenco separato da virgole di coppie campo-valore; all'interno di una coppia, il campo e il valore sono separati da due punti.

  • Il nuovo oggetto appliedPolicy della risorsa claim specifica la norma che YouTube applica effettivamente alla 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 l'asset rivendicato.

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

    1. Tiene conto delle norme stabilite da altri proprietari che detengono la proprietà parziale della risorsa rivendicata in alcuni degli stessi territori del proprietario dei contenuti che ha inviato la richiesta API.

    2. Tiene conto delle norme amministrative di YouTube applicabili nei territori in cui il proprietario dei contenuti possiede la 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 un asset. Le etichette 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 delle etichette delle risorse spiega come creare e recuperare le etichette delle risorse, nonché come aggiornare le etichette di una risorsa o cercare le 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 inizierà a utilizzare un ID univoco di 22 caratteri per identificare i proprietari dei contenuti. La modifica interessa la seguente funzionalità API e probabilmente avrà un impatto sui partner che hanno codificato i codici partner nelle loro applicazioni.

  • L'API restituirà l'ID di 22 caratteri come valore delle proprietà delle risorse 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. Dopo la 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.
  • Dopo la 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 delle risorse 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 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 che corrispondono a tutte le etichette specificate. Tuttavia, puoi utilizzare il parametro includeAnyProvidedLabel per indicare all'API di restituire asset che corrispondono a una qualsiasi delle etichette specificate.
    • includeAnyProvidedLabel: utilizzato insieme al parametro labels, questo parametro indica all'API di restituire le risorse associate a una qualsiasi delle etichette specificate nel valore del parametro labels.

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

    • La proprietà event[].source.userEmail fornisce l'indirizzo email dell'utente che ha avviato l'evento.
    • La proprietà event[].typeDetails.disputeNotes contiene note sulla contestazione per un evento dispute_create.

  • 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 rivendicazioni create prima della data specificata.
    • includeThirdPartyClaims: utilizzato in combinazione con il parametro videoId, questo parametro indica se includere le rivendicazioni di terze parti nei risultati dell'API.

• Informazioni più dettagliate sull'errore

  La documentazione sugli 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 di metadati obbligatorio. Infatti, potrebbe esserci più di un campo di metadati obbligatorio, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

  Per ulteriori informazioni, consulta la documentazione relativa agli errori per ogni metodo o la pagina Errori.

  Metodo	Errori
  assetSearch.list	invalidValue: l'API non supporta la possibilità di cercare asset 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	badRequest: il parametro includeThirdPartyClaims può essere utilizzato solo insieme al filtro videoId.
  ownership.patch ownership.update	badRequest: non puoi aggiornare la proprietà di un asset di traccia artistica.
  references.patch references.update	badRequest: il riferimento è in uno stato non valido per l'operazione che stai tentando di eseguire.

3 febbraio 2014

Questo aggiornamento contiene le seguenti modifiche:

• Aggiornamenti a risorse e metodi esistenti

  • Una risorsa asset ora 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 la modalità di creazione della richiesta.
    • La proprietà thirdPartyClaim contiene un valore booleano che indica se la rivendicazione è stata presentata 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 audio, video o audiovisive.
    • origin: specifica una o più origini delle rivendicazioni, ad esempio descriptiveSearch o videoMatch, per le quali vuoi trovare 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 i dati di proprietà non erano stati definiti per la risorsa associata alla rivendicazione.

  • La nuova proprietà allowedOptions.autoGeneratedBreaks della risorsa contentOwnerAdvertisingOption indica se il partner può scegliere di mostrare annunci in-stream mid-roll 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 della norma.

  • Il metodo policies.list ora supporta un parametro sort facoltativo, 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 l'ora in cui terminerà il periodo di revisione del conflitto di riferimento, causando la scadenza del conflitto.

  • La nuova proprietà autoGeneratedBreaks della risorsa videoAdvertisingOption indica se il video deve mostrare annunci in-stream mid-roll 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 di metadati obbligatorio. Infatti, potrebbe esserci più di un campo di metadati obbligatorio, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

  Per ulteriori informazioni, consulta la documentazione relativa agli errori per ogni 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 di 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 di rimozione. Per qualsiasi domanda, contatta [e-mail] badRequest: la tua richiesta non può essere elaborata perché non puoi creare una rivendicazione di terze parti sul video specificato. conflict: YouTube non può creare la rivendicazione richiesta perché il video ha contestato un avviso di rimozione. conflict: YouTube non può creare la rivendicazione richiesta perché il video è soggetto a una richiesta di rimozione attiva.
  references.insert	badRequest: l'elaborazione del video rivendicato che stai cercando di utilizzare non è riuscita, è stato eliminato o rifiutato.

• Gli errori contentOwnerNotProvided e internalError, che non sono specifici di un particolare metodo API, non sono più elencati in ogni pagina del metodo. Le descrizioni sono ancora 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 al momento dell'identificazione del 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 ti consente di recuperare un conflitto di riferimento specificando il relativo ID univoco.

  Aggiornamenti a risorse e metodi esistenti

  • L'API ora supporta la possibilità di recuperare la norma di corrispondenza effettiva per un asset. Questa modifica è analoga a quelle rilasciate il 16 luglio 2013, che includevano il supporto per il recupero del set canonico di metadati e dati di proprietà di una risorsa.

    Per recuperare la norma di corrispondenza effettiva per una risorsa, imposta il valore 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 le norme di corrispondenza effettive 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 diverso tipo di diritti che un proprietario di asset può detenere. Per la maggior parte dei tipi di asset, i proprietari possono avere solo la proprietà generale dell'asset, ma per gli asset di composizione, i proprietari possono elencare in dettaglio 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à generali, 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 di proprietà in conflitto e la percentuale della risorsa che ogni 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 gli asset nella risposta 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 in cui YouTube esegue la ricerca.

  • 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 da riflettere 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 presenti nelle proprietà dell'oggetto metadataMine anziché nell'oggetto metadata, che è stato ritirato a partire dall'aggiornamento dell'API del 16 luglio 2013.

  • La pagina Errori è 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 ogni 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 correlati 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 dettagli su una rivendicazione, tra cui l'ID univoco della rivendicazione, il relativo stato, il tipo (audio, video o audiovisual) e l'asset 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 valori separati da virgole per i parametri di richiesta fetchMetadata e fetchOwnership, consentendoti di recuperare più set di metadati o dati di proprietà.

    L'elenco seguente illustra le modifiche corrispondenti alla struttura della risorsa asset, nonché gli impatti di queste modifiche sui metodi API che get, list, insert, update o patch risorse 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 API sia l'insieme canonico di metadati che YouTube ha stabilito essere il più accurato e completo per la risorsa.

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

    • L'oggetto matchPolicy è stato sostituito con l'oggetto matchPolicyMine. L'API non supporta attualmente la possibilità di recuperare la norma di corrispondenza effettiva 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à sia l'oggetto ritirato sia l'oggetto appena supportato. 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 consente 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 conterrà 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 di insert, update o patch di una risorsa asset può includere l'oggetto metadataMine o l'oggetto metadata. Lo stesso principio si applica all'impostazione dei dati di proprietà o della norma di corrispondenza di una risorsa asset.

  • I parametri assetId, q e videoId del metodo claims.list sono stati ritirati. Per cercare 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 un formato dei contenuti double anziché integer.

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

  • La nuova proprietà claimId della risorsa reference è presente se il riferimento è stato creato associando un asset a un video di YouTube esistente caricato su un canale YouTube collegato al tuo account CMS. In questo caso, il 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 tenta di trovare 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 è consentita la pubblicazione degli annunci. Ogni oggetto può anche specificare 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 in 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. Inoltre, identifica 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 di metadati obbligatorio. Infatti, potrebbe esserci più di un campo di metadati obbligatorio, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

    Per ulteriori informazioni, consulta la documentazione relativa agli errori per ogni 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 ora sono associati alle stesse proprietà secondarie nell'oggetto metadataMine.
    claimHistory.get	notFound: non è possibile trovare la richiesta per cui 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. Può essere specificato 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 dispone dell'autorizzazione per creare criteri con l'azione specificata. invalidValue: il proprietario dei contenuti per conto del quale agisci non dispone dell'autorizzazione per 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, ovvero diritti mechanical, performance, synchronization e/o lyric, anziché diritti di proprietà general. Il tipo di diritti lyric è supportato di recente.
    policies.insert policies.update policies.patch	invalidValue: la richiesta contiene una regola di policy non valida perché l'API non supporta la creazione o la modifica di policy che specificano un'azione takedown. Questo errore, che indica il motivo invalidPolicyTakedownAction, sostituisce l'errore invalidPolicyConditionalTakedown obsoleto.
    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: impossibile trovare l'asset o la rivendicazione che hai specificato. 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: il valore excludedIntervals specificato per il riferimento non è valido. Tieni presente che non puoi specificare intervalli di esclusione quando disattivi un riferimento.

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

• YouTube non identifica più i servizi e le funzionalità API sperimentali. Ora forniamo un elenco delle API di YouTube soggette alle norme sul ritiro.

8 aprile 2013

Questo aggiornamento contiene le seguenti modifiche:

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

• Diverse proprietà sono state modificate nella risorsa assetMatchPolicy:

  • Il valore della proprietà kind è cambiato da youtubePartner#policy a youtubePartner#assetMatchPolicy.
  • La nuova proprietà policyId contiene un valore che identifica in modo univoco una risorsa di criteri salvati.
  • 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 i 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 in cui è stata creata la rivendicazione.
  matchInfo	object	L'oggetto matchInfo contiene informazioni sui contenuti corrispondenti che hanno generato la rivendicazione. Queste informazioni vengono 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 reference di riferimento 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 partita, in secondi.
  matchInfo.longestMatch.userVideoOffset	unsigned long	L'offset temporale all'inizio della partita, misurato in secondi dall'inizio del video caricato.
  matchInfo.longestMatch.referenceOffset	unsigned long	L'offset temporale 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, il totale dei contenuti corrispondenti nel video caricato è di 60 secondi, ma il totale dei contenuti corrispondenti 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	L'origine 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 ogni 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 state modificate nella risorsa policy:

  • La proprietà rule è stata rinominata 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 i 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 brevemente i tipi di errori appena supportati. In molti casi, potrebbero esserci 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 di metadati obbligatorio. Infatti, potrebbe esserci più di un campo di metadati obbligatorio, ognuno dei quali restituirà un errore con un messaggio leggermente diverso.

  Per ulteriori informazioni, consulta la documentazione relativa agli errori per ogni metodo o la pagina Errori.

  Metodo	Errori
  assets.insert	invalidValue: un campo metadati della risorsa contiene un valore non valido. required: manca un campo metadati della risorsa obbligatorio.
  assets.update assets.patch	forbidden: l'asset in fase di aggiornamento non è di proprietà del partner che tenta di completare l'aggiornamento. invalidValue: un campo metadati della risorsa contiene un valore non valido. notFound: la risorsa viene associata a una risorsa stagione o programma che non è possibile trovare. required: manca un campo metadati della risorsa obbligatorio.
  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% in un territorio.
  policies.insert policies.patch policies.update	conflictingPolicyRules: la policy contiene regole in conflitto.

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

18 gennaio 2013

Questo aggiornamento contiene le seguenti modifiche:

• Il metodo videoAdvertisingOptions.getEnabledAds appena documentato consente di recuperare i dettagli sui tipi di annunci consentiti per un video specificato caricato da un partner o da un utente.

• 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 le risorse di proprietà dell'utente corrente.

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

  • Il parametro id è ora obbligatorio.

  • Il parametro fetchMatchPolicy appena supportato consente di indicare se la richiesta API deve recuperare anche la norma di corrispondenza impostata per l'asset.

  • Il parametro fetchOwnership appena supportato consente di indicare se la richiesta API deve recuperare anche i dati sulla proprietà dell'asset.

  • L'elenco degli asset restituiti dall'API non contiene più dati di paginazione. Di conseguenza, sia la proprietà nextPageToken che 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 la norma di utilizzo predefinita se una rivendicazione inserita non specifica una norma, anche se la documentazione indicava in precedenza che ciò avveniva.)

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

• Il parametro id appena supportato del metodo policies.list consente di identificare le norme salvate che la richiesta API deve recuperare. Possono essere recuperate solo le norme appartenenti al proprietario dei contenuti attualmente autenticato.

• La definizione del parametro releaseClaims per i metodi references.patch e references.update è stata aggiornata per indicare che il parametro funziona solo quando lo stato della rivendicazione viene aggiornato a 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 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 appena supportati:

  Metodo	Tipo di errore	Dettaglio errore	Descrizione
  guideCategories.list	notFound	Unavailable	Impossibile trovare la risorsa per la quale stai tentando di recuperare la norma di corrispondenza.
  claims.get	notFound	Unavailable	Impossibile trovare la richiesta 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.