L'elemento <ResourceList>
contiene i dettagli relativi alle risorse principali (registrazioni audio o video) e alle risorse secondarie (copertina associata) incluse nel caricamento. Ad esempio, su un album audio con 10 tracce, i riferimenti da A1 ad A10 sono le registrazioni audio, mentre A11 è la copertina dell'album. YouTube usa la copertina dell'album come elemento visivo chiave negli art track generati per le registrazioni dell'album. I feed Single Resource Release (Release risorsa singola) non devono includere copertine, in conformità al profilo DDEX.
<ResourceList>
. Se il messaggio include più versioni dei metadati per una traccia, YouTube utilizza solo quella che compare per prima nel messaggio.Elementi proprietari di YouTube
Espandi la sezione di seguito per vedere al volo gli elementi proprietari di YouTube. Per maggiori dettagli ed esempi, consulta di volta in volta le sezioni corrispondenti che trovi in questa pagina.
Elementi proprietari di YouTube
Gli elementi riportati di seguito sono inclusi nello spazio dei nomi proprietario di YouTube:
Registrazioni audio
<SoundRecordingId>
[...]
<!--- Imposta l'ID personalizzato sulla risorsa registrazione audio -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Identifica la risorsa registrazione audio da aggiornare mediante l'ID risorsa -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Aggiunge un'etichetta delle risorse alla risorsa registrazione audio -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Art track
<SoundRecordingId>
[...]
<!--- Imposta l'ID personalizzato sulla risorsa art track -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Aggiunge un'etichetta delle risorse alla risorsa art track -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Video musicali
<VideoId>
[...]
<!--- Imposta l'ID personalizzato sulla risorsa video musicale -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Identifica la risorsa video musicale da aggiornare mediante l'ID risorsa -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Aggiunge un'etichetta delle risorse alla risorsa video musicale -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Aggiorna una specifica risorsa video musicale -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Specifica in quale canale deve essere caricato il video -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Video sul Web
<VideoId>
[...]
<!--- Imposta l'ID personalizzato sulla risorsa video sul Web -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Identifica la risorsa web da aggiornare mediante l'ID risorsa -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222
</ProprietaryId>
<!--- Aggiunge un'etichetta delle risorse alla risorsa video sul Web -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Aggiorna una specifica risorsa video sul Web -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Specifica in quale canale deve essere caricato il video -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Playlist
<CollectionId>
[...]
<ProprietaryId
Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Risorse di registrazione audio
ID delle registrazioni audio
YouTube richiede che ciascun elemento <SoundRecording>
includa un codice ISRC valido. Se monitori le registrazioni anche mediante un codice ID proprietario, puoi includere l'elemento <ProprietaryId>
come elemento di pari livello dell'elemento <ISRC>
all'interno di <SoundRecordingId>
. Il formato dell'elemento <ProprietaryId>
è:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
Sono necessari sia il tuo DDEX Party ID (spazio dei nomi) sia l'ID proprietario della traccia. YouTube memorizza il valore dell'ID proprietario nel campo custom_id della risorsa registrazione audio (per le pubblicazioni di Content ID) e della risorsa art track (per le pubblicazioni di YouTube Premium). Ad esempio, il codice XML riportato sopra genera una risorsa con ISRC USRE10400888 e un valore custom_id pari a custom_id_1234.
Per aggiungere valori custom_id diversi alle risorse registrazione audio e art track, puoi utilizzare gli spazi dei nomi dedicati "YOUTUBE:SR_CUSTOM_ID" e "YOUTUBE:AT_CUSTOM_ID":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Imposta l'ID personalizzato sulla risorsa registrazione audio -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Imposta l'ID personalizzato sulla risorsa art track -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Se invii un aggiornamento di una risorsa registrazione audio esistente, puoi identificare la risorsa in questione mediante il relativo ID risorsa, utilizzando lo spazio dei nomi dedicato "YOUTUBE:SR_ASSET_ID":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Identifica la risorsa registrazione audio da aggiornare mediante l'ID risorsa -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Per aggiungere le etichette delle risorse alle risorse registrazione audio e art track, puoi utilizzare gli spazi dei nomi dedicati "YOUTUBE:SR_ASSET_LABEL" e "YOUTUBE:AT_ASSET_LABEL":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Aggiunge due etichette delle risorse alla risorsa registrazione audio -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Aggiunge un'etichetta delle risorse alla risorsa art track -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Metadati delle registrazioni audio
Per le linee guida su come compilare i metadati delle registrazioni audio, consulta la Music Metadata Style Guide della Music Business Association. I metadati del tag <SoundRecording>
vengono utilizzati per:
- Pubblicazioni di Content ID: metadati memorizzati sulla risorsa registrazione audio.
- Pubblicazioni di YouTube Premium: creazione di art track e metadati memorizzati sulla risorsa art track.
Proprietà delle registrazioni audio
<RightsController>
nell'elemento <SoundRecording>
. ln conformità allo standard DDEX, il tag <RightsController>
indica dove detieni la proprietà dei diritti esclusivi della registrazione. Queste informazioni sono distinte da quelle delle offerte fornite, ma dovresti fornire solo offerte di Content ID per i territori in cui detieni i diritti esclusivi.La proprietà delle registrazioni audio viene applicata tramite il tag <RightsController>
nell'elemento <SoundRecording>
. L'elemento <PartyId>
deve corrispondere a quello del tag <MessageSender>
(o del tag <SentOnBehalfOf>
, se presente).
Nel seguente esempio di codice XML viene specificato che la casa discografica ABC detiene la proprietà della registrazione audio in Sudafrica:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Specifica il territorio o i territori in cui deve essere applicata
la proprietà. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Questa sezione imposta la proprietà della registrazione audio. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Proprietà degli art track
<RightsController>
viene ignorato nei feed che creano solo art track.Risorse dei video musicali
Tipo di video
Il tipo di video può essere specificato con l'elemento <VideoType>
. Sono consentiti i seguenti tipi di video musicale:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
ID dei video musicali
YouTube richiede che ciascun elemento <Video>
di un video musicale includa un codice ISRC valido. Questo codice ISRC deve essere diverso da quello utilizzato per la registrazione audio in base alle linee guida IFPI. Se monitori le risorse video anche mediante un codice ID proprietario, puoi includere l'elemento <ProprietaryId>
come elemento di pari livello dell'elemento <ISRC>
all'interno di <VideoId>
. Il formato dell'elemento <ProprietaryId> è:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube memorizza il valore dell'ID proprietario nel campo custom_id della risorsa video musicale (per le pubblicazioni di Content ID). Ad esempio, il codice XML riportato sopra genera una risorsa video musicale con ISRC USRE10400889 e un valore custom_id pari a custom_id_1234.
Per aggiungere un valore custom_id alla risorsa video musicale, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:MV_CUSTOM_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Imposta l'ID personalizzato sulla risorsa video musicale -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Se invii un aggiornamento di una risorsa video musicale esistente, puoi identificare la risorsa in questione mediante il relativo ID risorsa, utilizzando lo spazio dei nomi dedicato "YOUTUBE:MV_ASSET_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Identifica la risorsa video musicale da aggiornare mediante l'ID risorsa -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Per aggiungere le etichette delle risorse alla risorsa video musicale, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:MV_ASSET_LABEL":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Aggiunge due etichette delle risorse alla risorsa video musicale →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Per indicare il canale in cui deve essere caricato il video, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:CHANNEL_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Specifica in quale canale deve essere caricato il video -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Se non viene indicato alcun canale nel feed, il video verrà caricato nel canale predefinito configurato nell'account dell'utente che carica il video.
Per aggiornare un video precedentemente caricato, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:VIDEO_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Per caricare un video musicale come non in elenco, puoi utilizzare lo spazio dei nomi dedicato "YouTube: IS_DISCOVERBALE":
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Metadati dei video musicali
Per le linee guida su come inserire i metadati dei video musicali in DDEX, consulta la Music Metadata Style Guide della Music Business Association. I seguenti elementi del tag <Video>
vengono utilizzati per inserire i metadati e i video su YouTube:
Video: titolo | <VideoDetailsByTerritory> |
Video: tag/parole chiave | <VideoDetailsByTerritory> |
Risorsa: brano | <Video> |
Risorsa: nome casa discografica | <VideoDetailsByTerritory> |
Risorsa: artisti |
|
Risorsa: genere musicale | <VideoDetailsByTerritory> |
La descrizione del video viene compilata dall'elemento <Release>
, non da <Video>
. Consulta la sezione Elenco delle pubblicazioni per ulteriori informazioni.
Proprietà dei video musicali
<RightsController>
nell'elemento <Video>
. ln conformità allo standard DDEX, il tag <RightsController>
indica dove detieni la proprietà dei diritti esclusivi del video. Queste informazioni sono distinte da quelle delle offerte fornite, ma dovresti fornire solo offerte di Content ID per i territori in cui detieni i diritti esclusivi.La proprietà di una risorsa video musicale viene applicata utilizzando il tag <RightsController>
nell'elemento <Video>
. L'elemento <PartyId>
deve corrispondere a quello del tag <MessageSender>
(o del tag <SentOnBehalfOf>
, se presente).
Nel seguente esempio di codice XML viene specificato che la casa discografica ABC detiene la proprietà della risorsa video musicale in Sudafrica:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!-- Specifica il territorio o i territori in cui deve essere applicata la proprietà. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Questa sezione imposta la proprietà della risorsa video musicale. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Risorse video sul web
Tipo di video
Il tipo di video può essere specificato con l'elemento <VideoType>
. Sono consentiti i seguenti tipi di video sul Web:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
ID dei video sul Web
Se monitori le risorse video mediante un codice ID proprietario, puoi includere <ProprietaryId>
come elemento di pari livello dell'elemento <ISRC>
all'interno di <VideoId>
. Il formato dell'elemento <ProprietaryId> è:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
YouTube memorizza il valore dell'ID proprietario nel campo custom_id della risorsa video sul web (per le pubblicazioni di Content ID). Ad esempio, il codice XML riportato sopra genera una risorsa web con un valore custom_id pari a custom_id_1234.
Per aggiungere un valore custom_id alla risorsa web, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:WEB_CUSTOM_ID":
<VideoId>
<!--- Imposta l'ID personalizzato sulla risorsa web -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
Se invii un aggiornamento di una risorsa web esistente, puoi identificare la risorsa in questione mediante il relativo ID risorsa, utilizzando lo spazio dei nomi dedicato "YOUTUBE:WEB_ASSET_ID":
<VideoId>
<!--- Identifica la risorsa web da aggiornare mediante l'ID risorsa -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Per aggiungere le etichette delle risorse alla risorsa web, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:WEB_ASSET_LABEL":
<VideoId>
<!--- Aggiunge due etichette delle risorse alla risorsa web →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Per indicare il canale in cui deve essere caricato il video, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:CHANNEL_ID":
<VideoId>
<!-- Specifica su quale canale deve essere caricato il video -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Se non viene indicato alcun canale nel feed, il video verrà caricato nel canale predefinito configurato nell'account dell'utente che carica il video.
Per aggiornare un video precedentemente caricato, puoi utilizzare lo spazio dei nomi dedicato "YOUTUBE:VIDEO_ID":
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Metadati dei video sul web
I seguenti elementi del tag <Video>
vengono utilizzati per inserire i metadati e i video su YouTube:
Video: titolo | <VideoDetailsByTerritory> |
Video: tag/parole chiave | <VideoDetailsByTerritory> |
La descrizione del video viene compilata dall'elemento <Release>
, non da <Video>
. Consulta la sezione Elenco delle pubblicazioni per ulteriori informazioni.
Proprietà dei video sul Web
<RightsController>
nell'elemento <Video>
. ln conformità allo standard DDEX, il tag <RightsController>
indica dove detieni la proprietà dei diritti esclusivi del video. Queste informazioni sono distinte da quelle delle offerte fornite, ma dovresti fornire solo offerte di Content ID per i territori in cui detieni i diritti esclusivi.La proprietà delle risorse web viene applicata utilizzando il tag <RightsController>
nell'elemento <Video>
. L'elemento <PartyId>
deve corrispondere a quello del tag <MessageSender>
(o del tag <SentOnBehalfOf>
, se presente).
Nel seguente esempio di codice XML viene specificato che la casa discografica ABC detiene la proprietà della risorsa web in Sudafrica:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!-- Specifica il territorio o i territori in cui deve essere applicata la proprietà. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Questa sezione imposta la proprietà della risorsa web. -->
<RightsController>
<PartyName>
<FullName>Casa discografica ABC</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Impostare il pubblico dei video
Impostare il pubblico dei tuoi video
Impostare un video come destinato ai bambini o meno
Per caricare un video non art track (ovvero un video musicale o un video sul web) come destinato o meno ai bambini, utilizza l'elemento <AvRating>
con MadeForKids
o NotMadeForKids
in questo formato:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
Il campo è facoltativo o obbligatorio, a seconda delle impostazioni predefinite scelte per il canale su cui verrà caricato il video.
Flag "destinato ai bambini" facoltativo
- "Sì, imposta questo canale come destinato ai bambini. Carico sempre contenuti destinati ai bambini."
- "No, imposta questo canale come non destinato ai bambini. Non carico mai contenuti destinati ai bambini".
Se hai già definito il pubblico per i tuoi video e YouTube individua un errore o un comportamento illecito, il tuo video verrà contrassegnato come "Destinato ai bambini - impostato da YouTube". Non potrai modificare l'impostazione relativa al pubblico. Se non sei d'accordo, puoi utilizzare il pulsante "Invia feedback".
Flag "destinato ai bambini" necessario
- "Voglio rivedere questa impostazione per ogni video".
Se hai già definito il pubblico per i tuoi video e YouTube individua un errore o un comportamento illecito, il tuo video verrà contrassegnato come "Destinato ai bambini - impostato da YouTube". Non potrai modificare l'impostazione relativa al pubblico. Se non sei d'accordo, puoi utilizzare il pulsante "Invia feedback".