Partilhar via

Obter dados da aplicação

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

Antes de poder usar esses métodos, o aplicativo já deve existir na 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
Obtém https://manage.devcenter.microsoft.com/v1.0/my/applications Obter dados para todas as suas aplicações
Obtém https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obter dados para uma aplicação específica
Obtém https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Obter complementos para um aplicativo
Obtém https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obter voos organizados para uma aplicação

Pré-requisitos

Se você ainda não tiver feito isso, preencha 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 da API de envio da Microsoft Store para obter dados do aplicativo usam os seguintes recursos de dados JSON.

Recurso de aplicação

Este recurso representa uma aplicação registada na 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 tem os seguintes valores.

Valor Tipo Descrição
ID corda A ID da Loja da aplicação. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
nome principal corda O nome principal do aplicativo.
nomeDeFamíliaDoPacote corda O nome da família de pacotes da aplicação.
nomeDeIdentidadeDoPacote corda O nome da identidade do pacote da aplicação.
Nome do publicador corda A ID do editor do Windows associada ao aplicativo. Isso corresponde ao valor Package/Identity/Publisher que aparece na página Identidade do aplicativo no Partner Center.
Data de Primeira Publicação corda A data em que o aplicativo foi publicado pela primeira vez, no formato ISO 8601.
última submissão de aplicação publicada objeto Um recurso de envio de que fornece informações sobre o último envio publicado para o aplicativo.
pendenteCandidaturaSubmissão objeto Um recurso de submissão que fornece informações sobre a submissão pendente atual para a aplicação.
temPermissãoDeListagemAvançada Booleano Indica se você pode configurar as opções de jogos ou trailers para envios para o aplicativo. Esse valor é válido para envios criados após maio de 2017.

Recurso complementar

Este recurso fornece informações sobre um complemento.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Este recurso tem os seguintes valores.

Valor Tipo Descrição
ID do Produto no App corda O ID da loja do add-on. Este valor é fornecido pela Loja. Um exemplo de ID da Loja é 9NBLGGH4TNMP.

Recurso de voo

Este recurso fornece informações sobre um voo de pacote 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 tem os seguintes valores.

Valor Tipo Descrição
flightId corda O ID do voo do pacote. Este valor é fornecido pelo Partner Center.
Nome amigável corda O nome do voo do pacote, conforme especificado pelo desenvolvedor.
últimaSubmissãoDeVooPublicada objeto Um recurso de submissão que fornece informações sobre a última submissão publicada para o voo de pacote.
SubmissãoDeVooPendente objeto Um recurso de submissão que fornece informações sobre a submissão pendente atual para o pacote de voo.
IDs de grupo conjunto Uma matriz de cadeias de caracteres que contêm os IDs dos grupos de voo associados ao voo do pacote. Para obter mais informações sobre grupos de voos, consulte Voos organizados.
classificarMaisAltoQue corda O nome amigável do voo de pacote que está posicionado imediatamente abaixo do voo de pacote atual. Para obter mais informações sobre como classificar grupos de voos, consulte Voos em pacote.

Ferramenta de submissão

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 tem os seguintes valores.

Valor Tipo Descrição
ID corda O identificador da submissão.
LocalizaçãoDoRecurso corda Um caminho relativo que se pode anexar ao URI de solicitação de base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar todos os dados completos da submissão.

 

  • Last updated on