A <ResourceList>
contém detalhes sobre os recursos principais (gravações de som ou vídeos) e secundários (a arte associada) que compõem o envio. Em um álbum de áudio de 10 faixas, por exemplo, as referências de recurso A1 até A10 são as gravações de som e A11 é a capa do álbum. O YouTube usa a capa do álbum como um elemento visual chave nas Faixas de arte geradas para gravações deste álbum. Os feeds de lançamento de recurso de single não podem incluir artes, de acordo com o perfil DDEX.
<ResourceList>
. Caso a mensagem inclua várias versões dos metadados para uma faixa, o YouTube utilizará somente a que aparecer primeiro na mensagem.Elementos reservados do YouTube
Abra a seção abaixo para dar uma olhada nos elementos de propriedade do YouTube. Consulte as seções correspondentes ao longo desta página para ver mais exemplos e informações detalhadas.
Elementos reservados do YouTube
Os seguintes elementos fazem parte do namespace reservado do YouTube:
Gravações de som
<SoundRecordingId>
[...]
<!--- Define o ID personalizado no recurso de gravação de som -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Identifica o recurso de gravação de som a ser atualizado pelo código do recurso -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A222222222222222</ProprietaryId>
<!--- Adiciona um rótulo ao recurso de gravação de som -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Faixas de arte
<SoundRecordingId>
[...]
<!--- Define o ID personalizado na arte da capa -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
<!--- Adiciona um rótulo à arte da capa (use
YOUTUBE:CLEAR_AT_ASSET_LABELS para remover os rótulos do recurso) -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
[...]
</SoundRecordingId>
Vídeos de música
<VideoId>
[...]
<!--- Define o ID personalizado no recurso de vídeo de música -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
<!--- Identifica o recurso de vídeo de música a ser atualizado pelo código do recurso -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A333333333333333</ProprietaryId>
<!--- Adiciona um rótulo ao recurso de vídeo de música -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<!--- Atualiza um recurso de vídeo de música específico -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Especifica o canal para enviar o vídeo -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Vídeos da Web
<VideoId>
[...]
<!--- Define o ID personalizado no recurso de vídeo da Web -->
<ProprietaryId
Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
<!--- Identifica o recurso da Web a ser atualizado pelo código do recurso -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222
</ProprietaryId>
<!--- Adiciona um rótulo ao recurso de vídeo da Web -->
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<!--- Atualiza um recurso de vídeo da Web específico -->
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
<!-- Especifica o canal para enviar o vídeo -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
[...]
</VideoId>
Playlists
<CollectionId>
[...]
<ProprietaryId Namespace="YOUTUBE:PLAYLIST_ID">PLONRDPtQh-FLMXFMM-
SJHySwjpidVXmzw</ProprietaryId>
[...]
</CollectionId>
Recursos de gravação de som
IDs de gravação de som
O YouTube solicita que cada elemento de <SoundRecording>
inclua um código ISRC válido. Se você também monitora gravações usando um ID reservado, pode incluir o elemento <ProprietaryId>
como irmão do elemento <ISRC>
no <SoundRecordingId>
. O formato do elemento <ProprietaryId>
é:
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</SoundRecordingId>
O ID DDEX Party (namespace) e o ID reservado para a música são obrigatórios. O YouTube armazena o valor do ID reservado no campo "custom_id" do recurso de gravação de som (para envios do Content ID) e da arte da capa (para envios do YouTube Premium). Por exemplo, o XML acima resulta em um recurso com ISRC USRE10400888 e um valor custom_id de custom_id_1234.
Para adicionar diferentes valores de custom_id à gravação de som e à arte da capa, use os namespaces dedicados "YOUTUBE:SR_CUSTOM_ID" e "YOUTUBE:AT_CUSTOM_ID":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Define o ID personalizado no recurso de gravação de som -->
<ProprietaryId
Namespace="YOUTUBE:SR_CUSTOM_ID">sound_recording_id_1234</ProprietaryId>
<!--- Define o ID personalizado na arte da capa -->
<ProprietaryId
Namespace="YOUTUBE:AT_CUSTOM_ID">art_track_id_1234</ProprietaryId>
</SoundRecordingId>
Se você estiver enviando uma atualização a um recurso de gravação de som atual, será possível identificar o recurso pelo código usando o namespace dedicado "YOUTUBE:SR_ASSET_ID":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Identifica o recurso de gravação de som a ser atualizado por um código do recurso -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_ID">A111111111111111</ProprietaryId>
</SoundRecordingId>
Para adicionar rótulos aos recursos de arte da capa e gravação de som, use os namespaces dedicados "YOUTUBE:SR_ASSET_LABEL" e "YOUTUBE:AT_ASSET_LABEL":
<SoundRecordingId>
<ISRC>USRE10400888</ISRC>
<!--- Adiciona dois rótulos ao recurso de gravação de som -->
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:SR_ASSET_LABEL">sr_asset_label2</ProprietaryId>
<!--- Adiciona um rótulo à arte da capa -->
<ProprietaryId
Namespace="YOUTUBE:AT_ASSET_LABEL">at_asset_label</ProprietaryId>
</SoundRecordingId>
Para remover todos os rótulos do recurso de gravação de som, use o namespace dedicado
”YOUTUBE:CLEAR_SR_ASSET_LABELS”:
<SoundRecordingId>
[...]
<!--- Remove todos os rótulos do recurso de gravação de som -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_SR_ASSET_LABELS">True</ProprietaryId>
[...]
</SoundRecordingId>
Metadados de gravação de som
Para ver diretrizes sobre como preencher os metadados de gravação de som, consulte o Guia de estilo de metadados de música (em inglês) da Music Business Association. Os metadados da tag <SoundRecording>
são usados para:
- Envios do Content ID: metadados armazenados no recurso de gravação de som.
- O YouTube Premium permite a criação de músicas com arte da capa e de metadados que ficam armazenados nos recursos.
Propriedade da gravação de som
<RightsController>
, no elemento <SoundRecording>
. De acordo com o padrão DDEX, a tag <RightsController>
indica em quais locais você tem os direitos exclusivos da gravação. Essa informação é independente das ofertas fornecidas, mas especifique as ofertas do Content ID para territórios em que você tem direitos exclusivos.A propriedade da Gravação de som é aplicada usando a tag <RightsController>
no elemento <SoundRecording>
. O <PartyId>
precisa ser igual ao ID da tag <MessageSender>
(ou da tag <SentOnBehalfOf>
, se fornecido).
O exemplo de XML abaixo especifica que a Gravadora ABC é proprietária das gravações de som na África do Sul:
<ResourceList>
<SoundRecording>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<SoundRecordingDetailsByTerritory>
<!--Especifica em quais territórios a propriedade deverá
ser aplicada. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Esta seção define a propriedade da gravação de som. -->
<RightsController>
<PartyName>
<FullName>Gravadora ABC</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100,00</RightSharePercentage>
</RightsController>
[...]
</SoundRecordingDetailsByTerritory>
[...]
</SoundRecording>
</ResourceList>
Propriedade da música com arte da capa
<RightsController>
é ignorado em feeds que criam apenas músicas com arte da capa.Recursos de vídeo de música
Tipos de vídeo
Eles podem ser especificados usando <VideoType>
. Os tipos de vídeo de música permitidos são:
- LongFormMusicalWorkVideo
- ShortFormMusicalWorkVideo
IDs de vídeos de música
O YouTube solicita que cada elemento <Video>
dos vídeos de música inclua um código ISRC válido. Esse código ISRC precisa ser diferente do que foi utilizado na gravação de som, de acordo com as diretrizes da Federação Internacional da Indústria Fonográfica (IFPI, na sigla em inglês) (link em inglês). Se você também rastrear recursos de vídeo usando um ID reservado, será possível incluir o elemento <ProprietaryId>
como um par do elemento <ISRC>
no <VideoId>
. O formato do elemento <ProprietaryId> é:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
O YouTube armazena o valor do ID reservado no campo "custom_id" do recurso de vídeo de música (para envios do Content ID). Por exemplo, o XML acima resulta em um recurso de vídeo de música com ISRC USRE10400889 e um valor "custom_id" de custom_id_1234.
Para adicionar um valor custom_id ao recurso de vídeo de música, é possível usar o namespace dedicado "YOUTUBE:MV_CUSTOM_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Define o ID personalizado no recurso de vídeo de música -->
<ProprietaryId
Namespace="YOUTUBE:MV_CUSTOM_ID">music_video_id_1234</ProprietaryId>
</VideoId>
Se você estiver enviando uma atualização a um recurso de vídeo de música, será possível identificá-lo pelo código do recurso usando o namespace dedicado "YOUTUBE:MV_ASSET_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Identifica o recurso de vídeo de música a ser atualizado pelo código do recurso -->
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Para adicionar rótulos aos recursos de vídeo de música, use o namespace dedicado "YOUTUBE: MV_ASSET_LABEL":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!--- Adiciona dois rótulos ao recurso de vídeo de música →
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:MV_ASSET_LABEL">mv_asset_label2</ProprietaryId>
</VideoId>
Para remover todos os rótulos de recursos do vídeo de música, use o namespace dedicado
”YOUTUBE:CLEAR_MV_ASSET_LABELS”:
<VideoId>
[...]
<!--- Remove todos os rótulos de recurso do vídeo de música -->
<ProprietaryId
Namespace="YOUTUBE:CLEAR_MV_ASSET_LABELS">True</ProprietaryId>
[...]
</VideoId>
Para especificar o canal de envio do vídeo, use o namespace dedicado "YOUTUBE:CHANNEL_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<!-- Especifica o canal para enviar o vídeo -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Quando nenhum canal é especificado no feed, o upload do vídeo é feito no canal padrão configurado na conta do usuário que fez o envio.
Para atualizar um vídeo enviado anteriormente, é possível usar o namespace dedicado "YOUTUBE:VIDEO_ID":
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Para enviar um vídeo de música como não listado, use o namespace dedicado “YouTube: IS_DISCOVERBALE”:
<VideoId>
<ISRC>USRE10400889</ISRC>
<ProprietaryId Namespace="YOUTUBE:IS_DISCOVERBALE">false</ProprietaryId>
</VideoId>
Metadados de vídeos de música
Para ver diretrizes sobre como preencher metadados de vídeos de música no DDEX, consulte o guia de estilo de metadados de música da Music Business Association. Os elementos a seguir da tag <Video>
são usados para preencher os metadados de vídeo no YouTube:
Vídeo: título | <VideoDetailsByTerritory> |
Vídeo: tags/palavras-chave | <VideoDetailsByTerritory> |
Recurso: música | <Video> |
Recurso: nome da gravadora | <VideoDetailsByTerritory> |
Recurso: artistas |
|
Recurso: gênero | <VideoDetailsByTerritory> |
A descrição do vídeo é preenchida pelo <Release>
, e não pelo <Video>
. Para mais informações, consulte a seção Lista de lançamentos.
Propriedade do vídeo de música
<RightsController>
, no elemento <Video>
. De acordo com o padrão DDEX, a tag <RightsController>
indica em quais locais você tem os direitos exclusivos do vídeo. Essa informação é independente das ofertas fornecidas, mas especifique as ofertas do Content ID para territórios em que você tem direitos exclusivos.A propriedade do recurso de vídeo de música é aplicada usando a tag <RightsController>
no elemento <Video>
. O <PartyId>
precisa ser igual ao ID da tag <MessageSender>
(ou da tag <SentOnBehalfOf>
, se fornecido).
O exemplo de XML abaixo especifica que a Gravadora ABC é proprietária do recurso de vídeo de música na África do Sul:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Especifica em quais territórios a propriedade deverá ser aplicada. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Esta seção define a propriedade do recurso de vídeo de música. -->
<RightsController>
<PartyName>
<FullName>ABC Label</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100.00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Recursos de vídeos da Web
Tipos de vídeo
Eles podem ser especificados usando <VideoType>
. Os tipos de vídeos da Web permitidos são:
- LongFormNonMusicalWorkVideo
- ShortFormNonMusicalWorkVideo
IDs de vídeo da Web
Se você rastrear recursos de vídeo usando um ID reservado, será possível incluir o elemento <ProprietaryId>
como um par do elemento <ISRC>
no <VideoId>
. O formato do elemento <ProprietaryId> é:
<VideoId>
<ProprietaryId Namespace="DPID:your_DPid">custom_id_1234</ProprietaryId>
</VideoId>
O YouTube armazena o valor do ID reservado no campo custom_id do recurso de vídeo da Web (para envios do Content ID). Por exemplo, o XML acima resulta em um recurso da Web com valor custom_id de custom_id_1234.
Para adicionar um valor custom_id ao recurso da Web, é possível usar o namespace dedicado "YOUTUBE:WEB_CUSTOM_ID":
<VideoId>
<!--- Define o ID personalizado no recurso da Web -->
<ProprietaryId Namespace="YOUTUBE:WEB_CUSTOM_ID">web_video_id_1234</ProprietaryId>
</VideoId>
Se você estiver enviando uma atualização a um recurso da Web, será possível identificá-lo pelo código do recurso usando o namespace dedicado "YOUTUBE:WEB_ASSET_ID":
<VideoId>
<!--- Identifica o recurso da Web a ser atualizado pelo código do recurso -->
<ProprietaryId Namespace="YOUTUBE:Web_ASSET_ID">A222222222222222</ProprietaryId>
</VideoId>
Para adicionar rótulos aos recursos da Web, é possível usar o namespace dedicado "YOUTUBE:WEB_ASSET_LABEL":
<VideoId>
<!--- Adiciona dois rótulos ao recurso da Web →
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label1</ProprietaryId>
<ProprietaryId
Namespace="YOUTUBE:WEB_ASSET_LABEL">web_asset_label2</ProprietaryId>
</VideoId>
Para especificar o canal de envio do vídeo, use o namespace dedicado "YOUTUBE:CHANNEL_ID":
<VideoId>
<!-- Especifica o canal para enviar o vídeo -->
<ProprietaryId Namespace="YOUTUBE:CHANNEL_ID">MyChannel</ProprietaryId>
</VideoId>
Quando nenhum canal é especificado no feed, o upload do vídeo é feito no canal padrão configurado na conta do usuário que fez o envio.
Para atualizar um vídeo enviado anteriormente, é possível usar o namespace dedicado "YOUTUBE:VIDEO_ID":
<VideoId>
<ProprietaryId Namespace="YOUTUBE:VIDEO_ID">9bZkp7q19f0</ProprietaryId>
</VideoId>
Metadados de vídeos da Web
Os elementos a seguir da tag <Video>
são usados para preencher os metadados de vídeo no YouTube:
Vídeo: título | <VideoDetailsByTerritory> |
Vídeo: tags/palavras-chave | <VideoDetailsByTerritory> |
A descrição do vídeo é preenchida pelo <Release>
, e não pelo <Video>
. Para mais informações, consulte a seção Lista de lançamentos.
Propriedade dos vídeos da Web
<RightsController>
, no elemento <Video>
. De acordo com o padrão DDEX, a tag <RightsController>
indica em quais locais você tem os direitos exclusivos do vídeo. Essa informação é independente das ofertas fornecidas, mas especifique as ofertas do Content ID para territórios em que você tem direitos exclusivos.A propriedade dos recursos da Web é aplicada usando a tag <RightsController>
no elemento <Video>
. O <PartyId>
precisa ser igual ao ID da tag <MessageSender>
(ou da tag <SentOnBehalfOf>
, se fornecido).
O exemplo de XML abaixo especifica que a Gravadora ABC é proprietária do recurso da Web na África do Sul:
<ResourceList>
<Video>
[...]
<ResourceReference>A1</ResourceReference>
[...]
<VideoDetailsByTerritory>
<!--Especifica em quais territórios a propriedade deverá ser aplicada. -->
<TerritoryCode>ZA</TerritoryCode>
[...]
<!-- Esta seção define a propriedade do recurso da Web. -->
<RightsController>
<PartyName>
<FullName>Gravadora ABC</FullName>
</PartyName>
<PartyId>PADPIDAZZZZXXXXXXU</PartyId>
<RightsControllerRole>RightsController</RightsControllerRole>
<RightSharePercentage>100,00</RightSharePercentage>
</RightsController>
[...]
</VideoDetailsByTerritory>
[...]
</Video>
</ResourceList>
Configurar o público do seu vídeo
Configurar o público do seu vídeo
Classificar um vídeo como conteúdo para crianças ou não
Para fazer upload de um vídeo sem arte da capa (por exemplo, um vídeo de música ou um vídeo da Web) como um conteúdo para crianças ou não, use o elemento <AvRating>
com as tags MadeForKids
ou NotMadeForKids
seguindo este formato:
<VideoDetailsByTerritory>
<TerritoryCode>Worldwide</TerritoryCode>
[...]
<AvRating>
<RatingText>MadeForKids</RatingText>
<RatingAgency Namespace="YOUTUBE">UserDefined</RatingAgency>
</AvRating>
[...]
</VideoDetailsByTerritory>
Esse campo pode ser opcional ou obrigatório, isso depende do padrão que você definiu para o canal em que o vídeo será enviado.
Sinalização opcional "conteúdo para crianças"
- "Sim, configurar este canal como conteúdo para crianças. Eu sempre faço envios para esse público."
- "Não, configurar este canal como não sendo de conteúdo para crianças. Eu nunca envio conteúdo para crianças."
Caso já tenha definido o público do vídeo e o YouTube detectar erro ou abuso, você verá seu vídeo marcado como "Conteúdo para crianças". Não será possível alterar as configurações de público. Mas você discordar, use o botão "Enviar feedback".
Sinalização obrigatória de conteúdo para crianças
- "Quero revisar esta configuração para cada vídeo".
Caso já tenha definido o público do vídeo e o YouTube detectar erro ou abuso, você verá seu vídeo marcado como "Conteúdo para crianças". Não será possível alterar as configurações de público. Mas você discordar, use o botão "Enviar feedback".