Compartilhar via


Obter ofertas direcionadas

Use esse método para obter as ofertas direcionadas que estão disponíveis para o usuário atual, com base em se o usuário faz parte ou não do segmento de clientes para a oferta de destino. Para obter mais informações, consulte Gerenciar ofertas direcionadas usando os serviços da Store.

Pré-requisitos

Para usar esse método, primeiro você precisa obter um token de conta da Microsoft para o usuário conectado atual do seu aplicativo. Você deve passar esse token no cabeçalho de solicitação Authorization para esse método. Esse token é usado pela Loja para obter ofertas direcionadas para o usuário atual.

Solicitação

Sintaxe da solicitação

Método URI de solicitação
OBTER https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização corda Obrigatório O token de Conta da Microsoft para o usuário atual conectado ao seu aplicativo na forma de portador <token>.

Parâmetros de solicitação

Esse método não tem parâmetros de URI ou consulta.

Exemplo de solicitação

GET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user HTTP/1.1
Authorization: Bearer <Microsoft Account token>

Resposta

Esse método retorna um corpo de resposta formatado por JSON que contém uma matriz de objetos com os campos a seguir. Cada objeto na matriz representa as ofertas direcionadas que estão disponíveis para o usuário especificado como parte de um segmento de cliente específico.

Campo Tipo Descrição
Oferece conjunto Uma matriz de IDs de produto para os complementos associados às ofertas direcionadas que estão disponíveis para o usuário atual. Essas IDs de produto são especificadas na página Ofertas Direcionadas para seu aplicativo no Partner Center.
ID de rastreamento corda Um GUID que você pode usar opcionalmente para acompanhar a oferta direcionada em seu próprio código ou serviços.

Exemplo

Veja a seguir um exemplo de corpo de resposta JSON para essa solicitação.

[
  {
    "offers": [
      "10x gold coins",
      "100x gold coins"
    ],
    "trackingId": "5de5dd29-6dce-4e68-b45e-d8ee6c2cd203"
  }
]