Nota:l'API YouTube Content ID è destinata ai partner per i contenuti di YouTube e non è accessibile a tutti gli sviluppatori o a tutti gli utenti di YouTube. Se l'API YouTube Content ID non rientra tra i servizi elencati nella console API di Google, visita il Centro assistenza YouTube per scoprire di più sul Programma partner di YouTube.
Nota: le informazioni contenute in questa guida si applicano specificamente alle risorse di composizione.
In YouTube Studio, puoi richiedere modifiche alle risorse musicali di proprietà. Puoi utilizzare l'API Content ID anche per:
- Crea richieste di modifica
- Elenca lo stato delle richieste di modifica
Questa pagina fornisce una panoramica dei metodi MusicChangeRequest nell'API Content ID. Fornisce inoltre esempi su come creare ed elencare le richieste di modifica.
Requisiti
Per utilizzare questa API, devi ottenere le credenziali di autorizzazione. Utilizzerai il token di autorizzazione nelle richieste.Se utilizzi cURL, assicurati di creare una variabile AUTH_TOKEN
da utilizzare in questi comandi:
export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"
Crea una richiesta di modifica della musica
Per modificare una release o un canale, puoi utilizzare il metodo musicChangeRequests.create
. La richiesta deve includere una risorsa per la richiesta di modifica che specifichi il tipo di modifica da apportare. Puoi quindi elencare le tue richieste di modifica per verificarne lo stato.
Tipi di richieste di modifica
I tipi di richiesta validi includono:
misreconciledArtist
: richiedi di cambiare l'artista di un'uscita o di una traccia. Richiede una risorsaDesiredArtist
. Utilizza questa opzione se non è associata all'artista principale o in primo piano desiderato.undesiredDiscography
: richiedi di modificare il Canale dell'artista associato a un'uscita. Utilizza questa opzione se l'uscita di un altro artista viene visualizzata erroneamente sul canale di un artista.incorrectPlayability
: richiedi di modificare la giocabilità di una release o una traccia. Utilizza questa opzione se non può essere riprodotta o visualizzata come previsto nel prodotto.incorrectMusicVideo
: richiedi la modifica del video musicale di una traccia. Richiede una risorsaDesiredMusicVideo
. Utilizza questa opzione se non è associata al video musicale desiderato.incorrectMetadata
: richiedi di modificare l'ortografia, la formattazione o la traduzione di un'uscita o di una traccia.
Esempio: l'uscita non è associata all'artista principale o in primo piano desiderato
Supponiamo che tu abbia inviato un'uscita su YouTube Music, ma alla quale è associato un artista errato. Per richiedere questa modifica:
-
Individua la release interessata in YouTube Studio. Copia il numero di identificazione (ad es. il codice UPC) dalla pagina di YouTube Studio.
-
Crea una richiesta contenente la seguente istruzione JSON:
'{ "release": "releases/0012345678901", "misreconciledArtist": { "channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change" } }'
release
è l'ID dell'uscita, che puoi trovare in YouTube Studio.misreconciledArtist
utilizza una risorsadesiredArtist
composta da:channelId
: ID canale dell'artista a cui vuoi trasferire l'uscita. Puoi ottenere l'ID canale visitando il canale dell'artista su YouTube e copiando l'ID dall'URL. Se l'artista non esiste ed è un nuovo artista, lascia vuoto il campochannelId
e contrassegnanewArtist: true
.newArtist
: se l'artista al momento non è presente su YouTube Music, contrassegna questo campo:true
. Altrimenti, se hai fornito un ID canale, contrassegna questo campo comefalse
.supplementalInfo
: commenti facoltativi sulla richiesta.
-
Utilizza il metodo
musicChangeRequests.create
per effettuare la richiesta. Includi il codice JSON contenente la richiesta. Ad esempio, il seguente comando mostra come eseguire questa richiesta con cURL:curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests
Richieste di modifica dell'elenco
Per recuperare un elenco delle richieste di modifica della musica segnalate, utilizza il metodo musicChangeRequests.list
. Il metodo risponde con un elenco di richieste di modifica, filtrate in base al proprietario dei contenuti. Puoi anche filtrare i risultati per uscita, traccia e proprietario dei contenuti.
Esempio: richieste di modifica dell'elenco per una release specifica
Supponiamo che tu abbia bisogno di ricevere le richieste di modifica per una release specifica con un altro proprietario dei contenuti. Il seguente comando è un esempio di come si effettua questa richiesta con cURL:
curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999
dove:
onBehalfOfContentOwner
è l'ID canale del proprietario dei contenuti che possiede l'uscita o la traccia.filter
specifica unrelease/[RELEASE_ID_NUMBER]
o untrack/[TRACK_ID_NUMBER]
.