Partilhar via

Notas de Versão da API de Conteúdo de Compras

  • Artigo

Este tópico descreve as alterações recentes feitas à Versão 9.1 da API de Conteúdo.

1 de outubro de 2020

Esta versão inclui as seguintes alterações:

  • Foi adicionado o recurso loja . Este recurso permite-lhe adicionar e obter lojas no Microsoft Merchant Center. Saiba mais. O recurso está disponível apenas para participantes de beta fechada.
  • Foi adicionado o recurso ProductStatuses . Este recurso permite-lhe obter o estado das ofertas de produtos numa loja. Saiba mais. O recurso está disponível apenas para participantes de beta fechada.

13 de agosto de 2019

Esta versão inclui as seguintes alterações:

14 de junho de 2019

Segue-se uma alteração apenas de documentação.

9 de novembro de 2018

Esta versão inclui as seguintes alterações:

  • Foi adicionado o recurso inventário que utiliza para atualizar o preço e a disponibilidade de um produto. O recurso está disponível apenas para participantes piloto fechados. Saiba mais.

1 de agosto de 2018

Esta versão inclui as seguintes alterações:

  • Suporte removido para credenciais legadas; já não pode utilizar o nome de utilizador e a palavra-passe para aceder à API de Conteúdo. Agora tem de utilizar o OAuth para aceder à API de Conteúdo. Se ainda não o fez, migre a sua conta para utilizar contas Microsoft. Para obter informações, consulte Estamos a alterar a forma como inicia sessão. Para obter detalhes sobre como utilizar o OAuth, veja Introdução à API de Conteúdo.

Julho de 2017

Esta versão inclui as seguintes alterações:

  • Foram removidas todas as referências à versão 9.0 do documento. A versão 9.0 já não é suportada.

Maio de 2017

Esta versão inclui as seguintes alterações:

  • Os seguintes campos Produto são agora necessários se o fabricante os atribuir.

    Se o fabricante atribuir valores a estes campos, tem de especificá-los na sua oferta. Se não o fizer, a MMC aceitará a oferta por enquanto, mas devolverá uma mensagem de aviso na resposta (ver avisos). Deve atualizar o código o mais rapidamente possível para começar a fornecer estas informações.

  • Se não especificar os brandcampos , gtinou mpn , tem de definir o campo identifierExists como falso. A predefinição é verdadeira.

  • Adicionado o warnings campo ao objeto BatchItemError .

Março de 2017

Esta versão inclui as seguintes alterações:

  • Foi atualizada a documentação para refletir que o arquivo MMC e os catálogos estão automaticamente ativados para utilizar a API de Conteúdo. Já não tem de utilizar a aplicação Web Microsoft Advertising para permitir que a loja e os catálogos utilizem a API.

Fevereiro de 2017

Esta versão inclui as seguintes alterações:

  • O campo de disponibilidade do objeto foi atualizado Product para aceitar valores de stock e de pré-encomenda. Apenas os utilizadores no programa piloto podem especificar estes valores.

Setembro de 2016

Esta versão inclui as seguintes alterações:

  • Foi adicionado o campo promotionId ao Product objeto . Utilize o ID de promoção para associar uma oferta de produto a uma promoção no seu feed Promoções.
  • Foram atualizados os campos preço e preço de venda do Product objeto para permitir um preço mínimo de 0,0 (zero) em determinadas condições. Anteriormente, o preço mínimo permitido era 0,01 (1 cêntimo).

Dezembro de 2015

Para obter informações sobre as alterações aos serviços da API de Conteúdo incluídos nesta versão, veja a secção seguinte.

Recurso de Gestão de Catálogos

Esta versão apresenta o catalogs recurso.

Para obter uma descrição geral e informações de referência sobre o catalogs recurso, veja o tópico Recurso de Gestão de Catálogos. Os exemplos de código estarão disponíveis numa próxima versão.

Outubro de 2015

Para obter informações sobre as alterações aos serviços da API de Conteúdo incluídos nesta versão, veja as secções seguintes.

Recurso de Estado

Esta versão apresenta o status recurso.

Para obter uma descrição geral e informações de referência sobre o status recurso, veja o tópico Recurso de Estado do Catálogo.

Para obter um exemplo de utilização do status recurso no código, veja o tópico Exemplos de Código de Recurso de Estado do Catálogo.

Reorganização da Documentação

A API de Conteúdo foi documentada anteriormente como "Versão 1" e "Versão 2". Para tornar a documentação consistente, o número da versão utilizado na documentação foi alterado para utilizar a versão no URI.

Abril de 2015

Para obter informações sobre as alterações aos serviços da API de Conteúdo incluídos nesta versão, veja as secções seguintes.

Recurso produtos

A versão de abril de 2015 atualizou o products recurso para a versão 9.1.

A versão 9 (anteriormente versão 1) do recurso de produtos será preterida. Utilize a versão 9.1.

A versão 9.1 do recurso da products API de Conteúdo foi documentada anteriormente como versão 2. Recurso produtos