Requisitos de metadados de itens de feed MSN
Esta página descreve campos de metadados obrigatórios e opcionais para artigos, vídeos, galerias e imagens em feeds MSN. Utilize este guia para garantir que os itens cumprem os padrões mínimos de ingestão e suportam a composição de alta qualidade no MSN.
Os requisitos de itens de feed aplicam-se a todos os mercados e a todos os editores, mas determinados mercados ou casos empresariais podem exigir campos adicionais. Contacte-nos em partnerhubsupport@microsoft.com caso de requisitos adicionais de itens de feed.
Neste artigo
Atualizar itens ingeridos anteriormente
Artigos
Um artigo tem de ter um ID Exclusivo, Título, Data de publicação, Corpo e URL de Ligação. Todos os outros metadados são opcionais.
Campos obrigatórios
| Nome do campo | Descrição |
|---|---|
| ID Exclusivo | Um GUID durável (sem alterações) para identificar exclusivamente o artigo no feed. Também pode ser o URL exclusivo completo do artigo. Este valor tem de ser exclusivo em todos os itens de conteúdo provenientes do mesmo parceiro. |
| Título | O título do item de conteúdo tem de ter mais de 20 carateres, mas não pode exceder os 150 carateres, a menos que também seja fornecido um título curto. Os títulos que excedam os 150 carateres sem um título curto podem ser removidos. Não são permitidas etiquetas HTML. |
| Corpo | Corpo do item de conteúdo. O HTML é permitido para os formatos RSS e Atom. |
| Data de publicação | A hora da publicação. A data tem de estar no passado e ter menos de 365 dias, caso contrário, não será ingerida. Os formatos de data suportados são RFC 822 Sim e RFC 3339. |
| Ligação (URL da Web) | Um URL utilizado para localizar exclusivamente o item de feed no site do publicador. Esta ligação pode ser utilizada na partilha de redes sociais consoante o seu contrato. |
Campos opcionais, mas recomendados
| Nome do campo | Descrição |
|---|---|
| Abstrato | Tem de estar em texto simples. Não é suportado nenhum HTML. |
| Data atualizada | Se esta data for fornecida, será utilizada para identificar se o conteúdo neste item de feed é uma versão mais recente de um documento originalmente ingerido com o ID Não especificado. Caso contrário, será utilizada a "Data de Publicação" para esta finalidade. |
| Data de expiração | O item de feed será removido do back-end do Hub de Parceiros do MSN e dos front-ends pela data especificada. Se este valor não for fornecido, o item de conteúdo expirará dentro de 365 dias após a ingestão. A data de expiração tem de ser superior a 2 horas no futuro. |
| Subtítulo | Um título explicativo ou alternativo que é utilizado para ser apresentado abaixo do título em Cartões Promocionais. |
| Título curto | O valor "título curto", também conhecido como "Cabeçalho da Web", é utilizado ao apresentar conteúdo em definições compactas, como um cartão promocional. O valor neste campo deve ter 54 carateres ou menos. |
| Autor | O autor ou contribuidor de um artigo. |
| Imagens | Se uma imagem for referenciada, determinados metadados têm de ser especificados de acordo com a secção de campos necessários da imagem. Embora as imagens sejam opcionais, são necessárias para a publicação automática. |
| Ligações relacionadas | As ligações relacionadas podem ser especificadas para serem apresentadas com conteúdo. Tem de ser fornecida pelo menos três ligações relacionadas por artigo. |
| Categorias | Especifique etiquetas relevantes para a parte do conteúdo. Utilize <category> elementos para adicionar etiquetas no RSS e no ATOM. |
| Palavras-chave | Palavras-chave contextuais por item de conteúdo. Várias palavras-chave podem ser especificadas num único nó separado por vírgulas. Para especificar este valor no RSS ou no ATOM, não precisa de utilizar o elemento RSS <media:keywords> de Multimédia. |
| Apresentação de diapositivos incorporada | Os artigos podem ter apresentações de diapositivos incorporadas. Veja os exemplos de Apresentações de Diapositivos para obter mais detalhes. |
| Vídeo incorporado | Os artigos podem ter vídeos incorporados. Veja Exemplos de vídeo para obter mais detalhes. |
| SubscriptionProductType | Alguns itens de feed podem ser acessíveis através de um modelo de subscrição. Para especificar itens de feed pago Premium no feed RSS /ATOM, tem de utilizar <mi:SubscriptionProductType> o elemento . Por exemplo, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Apresentações de diapositivos
Uma apresentação de diapositivos tem de ter um Título, um ID Exclusivo e uma Data de publicação. Além disso, tem de conter vários diapositivos por ordem (dois (2) é o menor número de diapositivos, 200 é o máximo) em que cada diapositivo é composto por um objeto de imagem. A deteção de itens atualizados segue o mesmo algoritmo utilizado para artigos.
Campos obrigatórios
| Nome do campo | Descrição |
|---|---|
| ID Exclusivo | Um GUID durável (sem alterações) para identificar exclusivamente a Apresentação de Diapositivos. Também pode ser o URL exclusivo completo da Apresentação de Diapositivos no site do publicador. Este valor tem de ser exclusivo em todos os itens de conteúdo provenientes do mesmo publicador. |
| Título | O título do item de conteúdo tem de ter mais de 20 carateres, mas não pode exceder os 150 carateres, a menos que também seja fornecido um título curto. Os títulos que excedam os 150 carateres sem um título curto podem ser removidos. Não são permitidas etiquetas HTML. |
| Data de publicação | A hora da publicação. A data tem de estar no passado e ter menos de 365 dias, caso contrário, não será ingerida. Os formatos de data suportados são RFC 822 Sim e RFC 3339. |
| Diapositivos | Cada Apresentação de Diapositivos tem de incluir uma matriz de diapositivos (imagens). Cada diapositivo na Apresentação de Diapositivos é construído a partir dos metadados de imagem correspondentes; mais notavelmente:
|
| Ligação (URL da Web) | Um URL utilizado para localizar exclusivamente o item de feed no site do publicador. Esta ligação pode ser utilizada na partilha de redes sociais consoante o contrato. |
Campos opcionais, mas recomendados
| Nome do campo | Descrição |
|---|---|
| Abstrato | Uma descrição da Apresentação de Diapositivos. (Necessário se o título do diapositivo estiver em falta) Tem de estar em texto simples. Não é suportado nenhum HTML. |
| Data atualizada | Se esta data for fornecida, será utilizada para identificar se o conteúdo neste item de feed é uma versão mais recente de um documento originalmente ingerido com o ID Não especificado. Caso contrário, será utilizada a "Data de Publicação" para esta finalidade. |
| Data de expiração | O item de feed será removido do back-end do Hub de Parceiros do MSN e dos front-ends pela data especificada. Se este valor não for fornecido, o item de conteúdo expirará dentro de 365 dias após a ingestão. A data de expiração tem de ser superior a 2 horas no futuro. |
| Subtítulo | Um título explicativo ou alternativo que é utilizado para ser apresentado abaixo do título em Cartões Promocionais. |
| Título curto | O valor "título curto", também conhecido como "Cabeçalho da Web", é utilizado ao apresentar conteúdo em definições compactas, como cartões promocionais. O valor neste campo deve ter 54 carateres ou menos. |
| Autor | O autor ou contribuidor da apresentação de diapositivos. |
| Ligações relacionadas | As ligações relacionadas podem ser especificadas para serem apresentadas com conteúdo. Tem de ser fornecida pelo menos três ligações relacionadas por artigo. |
| Categorias | Especifique etiquetas relevantes para a parte do conteúdo. Utilize <category> elementos para adicionar etiquetas no RSS e no ATOM. |
| Palavras-chave | Palavras-chave contextuais por item de conteúdo. Várias palavras-chave podem ser especificadas num único nó separado por vírgulas. Para especificar este valor no RSS ou no ATOM, não precisa de utilizar o elemento RSS <media:keywords> de Multimédia. |
| SubscriptionProductType | Alguns itens de feed podem ser acessíveis através de um modelo de subscrição. Para especificar itens de feed pago Premium no feed RSS /ATOM, tem de utilizar <mi:SubscriptionProductType> o elemento . Por exemplo, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Vídeo
Um vídeo especificado num feed apenas de vídeo tem de ter um ID Exclusivo, URL, Data publicada, Título, Atribuição e Legendagem de áudio (apenas se for exigido por lei nos mercados de destino). Se não for fornecido um ID Exclusivo ou se o vídeo estiver incorporado num artigo, o URL será utilizado como identificador.
Campos obrigatórios
| Nome do campo | Descrição |
|---|---|
| ID Exclusivo | Um GUID durável (sem alterações) para identificar exclusivamente o vídeo. Também pode ser o URL exclusivo completo do vídeo no site do publicador. Este valor tem de ser exclusivo em todos os itens de conteúdo provenientes do mesmo publicador. |
| Título | Título do vídeo. Isto é utilizado como cabeçalho/título da página. |
| Data de publicação | A hora da publicação. A data tem de estar no passado e ter menos de 365 dias, caso contrário, não será ingerida. |
| URL do Vídeo | Localização do ficheiro de origem de vídeo. O URL tem de ser absoluto e todas as formas de URLs relativos falharão na ingestão. |
| Ligação (URL da Web) | Um URL utilizado para localizar exclusivamente o item de feed no site do publicador. Esta ligação pode ser utilizada na partilha de redes sociais consoante o contrato. |
| Atribuição | Informações sobre direitos de autor do vídeo. |
| Legendagem de áudio | As legendas de áudio são apresentadas nos vídeos juntamente com a duração do vídeo. Só é exigido se for exigido por lei nos mercados-alvo. |
| Duração | Apenas necessário para vídeos 3PP. |
| Miniatura(s) |
Apenas necessário para vídeos 3PP. Uma imagem em miniatura para ligar ao vídeo. Pode utilizar todas as propriedades da imagem aqui, mas só é necessário um URL para a miniatura. Recomendamos uma única imagem JPG em:
|
Campos opcionais, mas recomendados
| Nome do campo | Descrição |
|---|---|
| Descrição (Abstrato) | Texto a apresentar por baixo do vídeo. |
| Duração | A duração do vídeo em segundos. (Necessário para vídeos 3PP). |
| Data atualizada | Se esta data for fornecida, será utilizada para identificar se o conteúdo neste item de feed é uma versão mais recente de um documento originalmente ingerido com o ID Não especificado. Caso contrário, será utilizada a "Data de Publicação" para esta finalidade. |
| Data de expiração | O item de feed será removido do back-end do Hub de Parceiros do MSN e dos front-ends pela data especificada. Se este valor não for fornecido, o item de conteúdo expirará dentro de 365 dias após a ingestão. A data de expiração tem de ser superior a 2 horas no futuro. |
| Subtítulo | Um título explicativo ou alternativo que é utilizado para ser apresentado abaixo do título em Cartões Promocionais. |
| Título curto | O valor "título curto", também conhecido como "Cabeçalho da Web", é utilizado ao apresentar conteúdo em definições compactas, como um cartão promocional. O valor neste campo deve ter 54 carateres ou menos. |
| Autor | O autor ou contribuidor do vídeo. |
| Miniatura(s) | Uma imagem em miniatura para ligar ao vídeo. Pode utilizar todas as propriedades da imagem aqui, mas só é necessário um URL para a miniatura. Recomendamos uma única imagem JPG em:
|
| Legendagem de áudio | As legendas de áudio são apresentadas nos vídeos juntamente com a duração do vídeo. Só é exigido se for exigido por lei nos mercados-alvo. |
| Ligações relacionadas | As ligações relacionadas podem ser especificadas para serem apresentadas com conteúdo. Tem de ser fornecida pelo menos três ligações relacionadas por artigo. |
| Categorias | Especifique etiquetas relevantes para a parte do conteúdo. Utilizar <category> elementos para adicionar etiquetas no RSS |
| Palavras-chave | Palavras-chave contextuais por item de conteúdo. Várias palavras-chave podem ser especificadas num único nó separado por vírgulas. Para especificar este valor no RSS ou no ATOM, não precisa de utilizar o elemento RSS <media:keywords> de Multimédia. |
| Tipo de Produto de Subscrição | Alguns itens de feed podem ser acessíveis através de um modelo de subscrição. Para especificar itens de feed pago Premium no feed RSS /ATOM, tem de utilizar <mi:SubscriptionProductType> o elemento . Por exemplo, <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType>. |
Imagens
As imagens de tamanho completo nos artigos têm de ter um URL válido. As imagens nas apresentações de diapositivos têm de ter um título e um URL. As miniaturas de vídeos, ligações relacionadas ou imagens de tamanho completo só precisam de um URL. Os Direitos de Distribuição de Imagens são necessários para a publicação automática.
Campos obrigatórios
| Nome do campo | Descrição |
|---|---|
| URL | Localização de origem da imagem. O URL tem de ser absoluto e todas as formas Sim de URLs relativos irão falhar a ingestão. |
| Título | Título da imagem. Além disso, utilizado como um legenda que é apresentado ao longo da imagem. Só é necessário se a imagem for utilizada como um diapositivo numa apresentação de diapositivos. |
| Direitos de Distribuição de Imagens |
Apenas necessário para a publicação automática. Se tiver Direitos de Distribuição para as suas imagens: Caso 1: este campo será predefinido como Verdadeiro porque a maioria dos publicadores tem direitos de distribuição para as respetivas imagens. Se não tiver Direitos de Distribuição para imagens, existem duas opções: Caso 2: não envie as imagens, a menos que possa fornecer as informações necessárias no Caso 3. Caso 3: licenciou a imagem a partir de um dos fornecedores de imagens listados na página Direitos de licenciamento e distribuição de imagens :
|
| ID da licença de imagem | O Imageld é o ID utilizado para identificar exclusivamente uma imagem. Os imagelds são usados por grandes licenciadores de imagens como Getty, Image e Associated Press para acompanhar a sindicalização das suas imagens. |
| Nome do licenciador de imagens | Nome do licenciador de imagens. (Consulte a página Direitos de licenciamento e distribuição de imagens – se a imagem não for uma destas, não a forneça) |
| Descrição | Informações textuais sobre o conteúdo da imagem. Este valor tem de ser fornecido em texto simples, exceto quando a imagem é utilizada numa apresentação de diapositivos; nesse caso, é permitido HTML. |
| Texto alternativo da imagem | Uma alternativa de texto breve e descritiva para a imagem. Utilizado para melhorar a acessibilidade e suportar leitores de ecrã e também pode ser apresentado se a imagem não conseguir carregar. |
| Ponto focal da imagem | O ponto focal da imagem. Para ser utilizado quando a imagem é recortada Não para apresentar em dispositivos de tamanho diferente. |
Ligações relacionadas
As ligações relacionadas não são tipos de conteúdo de raiz, mas podem ser anexadas a artigos ou apresentações de diapositivos. Uma ligação relacionada tem de ter, no mínimo, uma imagem de URL, Título e Miniatura válida.
Campos obrigatórios
| Nome do campo | Descrição |
|---|---|
| URL | URL da ligação relacionada. |
| Título | Título a apresentar como texto da ligação. |
| Imagem em miniatura | Tem de fornecer um URL de miniatura em ligações relacionadas, caso contrário, estas serão ignoradas |
Campos opcionais, mas recomendados
| Nome do campo | Descrição |
|---|---|
| Relation | Atualmente, só suportamos "text/html" como tipo. |
| Tipo de suporte de dados | Título opcional a utilizar no URL de definições compactas da ligação relacionada. |
| Título curto | Este valor será definido como "relacionado" por predefinição. |
Atualizar itens ingeridos anteriormente
Os conteúdos atualizados têm de ser sinalizados para os Serviços de Ingestão da Microsoft através de alterações aos campos Data atualizada ou Data de publicação . Os conteúdos atualizados sem alterações a um destes campos serão ignorados. Lembre-se de preservar o mesmo ID Exclusivo.
Os Serviços de Ingestão da Microsoft analisam o feed e dividem-no em itens, decidindo se pretende publicar um novo item, atualizar um item existente ou ignorá-lo.
Atualizar vídeos inline
Os vídeos podem ser publicados inline através de Multimédia RSS ou HTML. O URL de vídeo é o seu ID exclusivo. Qualquer vídeo HTML com o mesmo URL será sinalizado como duplicado e ignorado, mas os vídeos que utilizem o Media RSS podem ser atualizados se <dcterms:modified> forem atualizados. Se este campo não for atualizado, o vídeo será considerado duplicado.
Atualizar apresentações de diapositivos
As apresentações de diapositivos publicadas através do Media RSS podem ser definidas <dcterms:modified> para uma nova data para indicar que a apresentação de diapositivos foi atualizada.
A atualizar imagens
O URL de origem de uma imagem é o seu ID exclusivo. As imagens com o mesmo URL serão sinalizadas como duplicadas e ignoradas.
Evitar duplicados
Os itens de feed são identificados pelo ID Exclusivo. Os itens com o mesmo ID Exclusivo são considerados duplicados e ignorados, a menos que tenham sido sinalizados como atualizações através de alterações aos campos Data de atualização ou Data de publicação . Os feeds que atualizam automaticamente o ID Exclusivo, a Data atualizada ou a Data de publicação sempre que o feed for consultado não serão ingeridos.
Evitar defeitos
Defeitos como formatação com falhas, datas inválidas ou incorporações de suportes de dados de baixa qualidade podem resultar numa má experiência de utilizador e podem limitar o alcance do conteúdo. Saiba mais sobre os defeitos a evitar na página Classificação de conteúdo na secção Diretrizes de publicação .
Formatos de data
Para garantir que os nossos conteúdos são relevantes para os nossos consumidores, temos de garantir que os artigos que lhes mostramos têm uma data exata. As datas têm de ser expressas com formatos de data RFC 3339 ou RFC 822. Qualquer texto na cadeia de data deve estar em inglês e os fusos horários devem ser expressos em UTC e não em qualquer fuso horário local, como a Hora Padrão do Leste.
RFC3339
2022-12-28T07:20:50.52Z
2022-12-28T14:20:50.52+00:00
2022-12-28T03:20:50.52+00:00
RFC822
Casa, 02 out 2002 13:00:00 GMT
Casa, 02 out 2002 15:00:00 +0200