Compartilhar via

Obter dados de app

  • Artigo

Use os métodos a seguir na API de envio da Microsoft Store para obter dados de aplicativos existentes em sua conta do Partner Center. Para obter uma introdução à API de envio da Microsoft Store, incluindo pré-requisitos para usar a API, consulte Criar e gerenciar envios usando os serviços da Microsoft Store.

Antes de usar esses métodos, o aplicativo já deve existir em sua conta do Partner Center. Para criar ou gerenciar envios para aplicativos, consulte os métodos em Gerenciar envios de aplicativos.

Método URI Descrição
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Obter dados para todos os seus aplicativos
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obter dados para um aplicativo específico
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Obter complementos para um aplicativo
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obter pacotes de pré-lançamento para um aplicativo

Pré-requisitos

Se você ainda não tiver feito isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store antes de tentar usar qualquer um desses métodos.

Recursos de dados

Os métodos de API de envio da Microsoft Store para obter dados do aplicativo usam os seguintes recursos de dados JSON.

Recurso de aplicativo

Esse recurso representa um aplicativo registrado em sua conta.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Este recurso possui os seguintes valores.

Valor Type Descrição
id string A ID da Loja do aplicativo. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
nome_primário string O nome principal do aplicativo.
packageFamilyName string O nome da família de pacotes do aplicativo.
nome_da_identidade do pacote string O nome do identificador do pacote do aplicativo.
publisherName string A ID do editor do Windows associada ao aplicativo. Isso corresponde ao valor Pacote/Identidade/Editor que aparece na página Identidade do aplicativo para o aplicativo no Partner Center.
firstPublishedDate string A data em que o aplicativo foi publicado pela primeira vez, no formato ISO 8601.
lastPublishedApplicationSubmission objeto Um recurso de envio que fornece informações sobre o último envio publicado para o aplicativo.
pendingApplicationSubmission objeto Um recurso de envio que fornece informações sobre o envio pendente atual para o aplicativo.
hasAdvancedListingPermission boolean Indica se você pode configurar o gamingOptions ou trailers para envios para o aplicativo. Esse valor é verdadeiro para envios criados após maio de 2017.

Recurso complementar

Este recurso fornece informações sobre um complemento.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Este recurso possui os seguintes valores.

Valor Type Descrição
inAppProductId string A ID da Loja do complemento. Esse valor é fornecido pela Loja. Um exemplo de ID da Loja é 9NBLGGH4TNMP.

Recurso de voo

Este recurso fornece informações sobre um pacote de pré-lançamento para um aplicativo.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Este recurso possui os seguintes valores.

Valor Type Descrição
ID do voo string O ID do pacote de pré-lançamento. Esse valor é fornecido pelo Partner Center.
friendlyName string O nome do pacote de pré-lançamento, conforme especificado pelo desenvolvedor.
lastPublishedFlightSubmission objeto Um recurso de envio que fornece informações sobre o último envio publicado para o pacote de pré-lançamento.
pendingFlightSubmission objeto Um recurso de envio que fornece informações sobre o envio pendente atual para o pacote de pré-lançamento.
groupIds matriz Uma matriz de strings que contém as IDs dos grupos de pré-lançamento associados ao pacote de pré-lançamento. Para obter mais informações sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.
rankHigherThan string O nome amigável do pacote de pré-lançamento classificado imediatamente abaixo do pacote de pré-lançamento atual. Para obter mais informações sobre como classificar grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.

Recurso de envio

Este recurso fornece informações sobre um envio. O exemplo a seguir demonstra o formato desse recurso.

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Este recurso possui os seguintes valores.

Valor Type Descrição
id string A ID do envio.
resourceLocation string Um caminho relativo que você pode acrescentar ao URI de solicitação base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar os dados completos do envio.