Compartilhar via


Introdução ao acesso programático aos dados de análise do Microsoft Marketplace

Este guia ajuda você a se integrar ao acesso programático aos dados de análise do Microsoft Marketplace. Você aprenderá a acessar programaticamente relatórios analíticos para monitorar vendas, avaliar o desempenho e otimizar ofertas no Microsoft Marketplace. As ferramentas de análise aprimoradas permitem que você atue sobre os resultados de desempenho e mantenha melhores relações com seus clientes e revendedores.

Importante

A versão 1.1 das APIs agora está ativa. Migre a implementação existente para a versão mais recente

Sobre este guia

Você pode usar este guia para acessar programaticamente os dados de análise do Microsoft Marketplace. Usando os métodos e APIs documentados neste guia, você pode agendar relatórios personalizados e ingerir conjuntos de dados de chave em seus sistemas de análise internos. Você pode monitorar efetivamente as vendas, avaliar o desempenho e otimizar suas ofertas no Microsoft Marketplace.

A API para acessar relatórios do Microsoft Marketplace permite agendar relatórios personalizados de seus dados de análise de forma assíncrona. A funcionalidade permite definir consultas/modelos de relatório com base em suas necessidades, definir um agendamento e obter relatórios oportunos e confiáveis em intervalos agendados.

O principal valor do acesso programático dos dados de análise do Microsoft Marketplace é relatórios personalizados e integração com sistemas e plataformas internas de BI.

Observação

Os parceiros precisam de recursos de engenharia dedicados para fazer uma integração única na interface da API.

Alterar o log da versão 1.1

  • Contagem de recorrência: o parâmetro de contagem de recorrência agora é obrigatório. Isso significa que todos os relatórios agendados devem ter uma contagem de recorrência.

  • API GET de execução: a versão 1.1 da API de Execução GET retornará informações adicionais sobre a contagem de recorrência (restante), a data de término e a próxima hora de início da execução.

  • API PUT de Relatório Agendado: A versão 1.1 da API permitirá que os usuários atualizem a data de término de seus relatórios agendados, além da contagem de recorrência.

  • Os limites de contagem de recorrência são baseados no Intervalo de Recorrência dos relatórios agendados.

Aviso

A versão 1.0 da API será preterida em seis meses que terminam em 30 de junho de 2024. Isso significa que não forneceremos mais suporte ou atualizações para esta versão após essa data. Planeje a migração adequadamente.

Instruções de migração da v1 para a v1.1: Para migrar para a versão 1.1 da API, siga estas etapas:

  • Atualize seu código para usar o novo ponto de extremidade para a versão 1.1 da API.

  • Atualize as solicitações ou respostas que referenciam campos que foram adicionados ou alterados na versão 1.1.

  • Teste seu código minuciosamente para garantir que ele seja compatível com a versão 1.1 da API.

  • Monitore seu aplicativo para garantir que ele esteja funcionando corretamente com a nova versão da API.