Introdução à API de Conteúdo

Para usar a API de conteúdo, você precisará de algumas coisas:

  1. Uma conta Microsoft
  2. Uma conta Microsoft Advertising
  3. Um token de programador

Para obter uma conta do Microsoft Advertising, aceda a https://ads.microsoft.com. Se não tiveres iniciado sessão na tua conta Microsoft, serás redirecionado para iniciares sessão na tua conta ou para iniciares sessão numa conta. Após iniciar sessão, terá a opção de se inscrever numa nova conta do Microsoft Advertising. Selecione a opção de inscrição e clique em Continuar.

Em seguida, se ainda não tiver um token de programador do Microsoft Advertising para o ambiente de produção, aceda ao Portal do Programador. Clique em Request Token e forneça as informações solicitadas. Se você usar a API para gerenciar sua própria conta, receberá seu token imediatamente; No entanto, se estiver a gerir contas de outras pessoas, pode demorar até cinco dias úteis para obter um token.

Autenticar as suas credenciais

Importante

A partir de 1 de junho de 2022, exigiremos autenticação multifator para todos os utilizadores que iniciarem sessão através de uma aplicação de terceiros que utilize a API Bing Ads, a API de Conteúdo e as APIs de Hotel.

Tem de atualizar a sua aplicação para obter o consentimento do utilizador utilizando o novo msads.manage âmbito. Todos os desenvolvedores de aplicativos devem tomar medidas para usar o novo escopo.

Para obter mais informações, consulte o Guia de requisitos de autenticação multifator .

A API de Conteúdo usa os mesmos esquemas de autenticação da API do Bing Ads. Para obter detalhes sobre como autenticar credenciais da conta da Microsoft com OAuth, consulte Autenticação com o plataforma de identidades da Microsoft.

Você pode usar o SDK do Bing Ads para .NET, Java ou Python para autenticar as credenciais da conta da Microsoft. Para obter detalhes sobre como usar o SDK para obter o token de acesso, consulte C# | Java | Python. Para obter um exemplo de API de conteúdo que usa o SDK para autenticação, consulte Exemplo de gerenciamento de produtos.

(Observe que o SDK do Bing Ads não fornece interfaces para a API de conteúdo. Só deverá utilizar o SDK para obter o token de acesso se também estiver a utilizar o SDK para campanhas do Microsoft Advertising. Caso contrário, pode não valer a pena a sobrecarga de instalar o SDK.)

Se você não usa o SDK do Bing Ads para autenticação, consulte Autenticando credenciais da conta da Microsoft em C# para obter um exemplo que mostra como usar OAuth para autenticar credenciais da conta da Microsoft.

Onde usar suas credenciais e tokens de desenvolvedor?

Todas as chamadas devem especificar:

  • O cabeçalho do DeveloperToken que está definido para o seu token de desenvolvedor.
  • O cabeçalho AuthenticationToken que está definido para o seu token de acesso.

Se gerir catálogos em nome de outros clientes, também tem de definir os seguintes cabeçalhos:

  • O cabeçalho CustomerId que está definido para o ID de cliente do cliente cuja loja está a gerir
  • O cabeçalho CustomerAccountId que está definido para o ID de conta de qualquer uma das contas do cliente que gere (não importa qual é a conta gerida).

Para obter informações sobre esses e outros cabeçalhos que a solicitação e a resposta podem conter, consulte Cabeçalhos.

Configurar o Centro de Comerciantes da Microsoft para utilizar a API

Para obter uma visão geral do Centro de Comerciantes da Microsoft (MMC), consulte O que é o Centro de Comerciantes da Microsoft? O tópico inclui links para todos os tópicos do Merchant Center e vídeos relacionados.

Tem de concluir os passos seguintes, caso ainda não o tenha feito.

  1. Verificar e reivindicar o URL do seu site Para obter as ferramentas para webmasters mencionadas em Verificar e reivindicar o URL do seu site, consulte Ferramentas do Bing para webmasters. Inicie sessão com a mesma conta Microsoft que utiliza para o Microsoft Advertising. Para obter mais informações sobre como usar a ferramenta, consulte Verificar a propriedade do seu site.
  2. Criar uma loja no Centro de Comerciantes da Microsoft
  3. Adicionar um catálogo

Quando você cria uma loja MMC, o processo cria um catálogo padrão para você. A loja e todos os catálogos criados são ativados automaticamente para gerenciamento de API. O Store contém um catálogo padrão ao qual todas as operações de produtos (adicionar, atualizar, excluir e obter) se aplicam por padrão. Para especificar um catálogo diferente, use o parâmetro de consulta bmc-catalog-id na URL do recurso.

Para adicionar e ativar catálogos, utilize o recurso Catálogos . Para obter mais informações, consulte Gerenciando seus catálogos.

Nota

Em determinadas circunstâncias, você pode usar a API e o FTP/SFTP para atualizar um feed de catálogo. Para obter informações sobre como usar a API com FTP/SFTP, consulte Posso usar a API e FTP/SFTP?

Passos Seguintes

Agora que você está pronto para começar a usar a API, consulte as seções a seguir.

  • Última atualização a