Partilhar via

Obter todas as extensões

Use esse método na API de envio da Microsoft Store para recuperar dados de todos os complementos de todos os aplicativos registrados na sua conta do Partner Center.

Pré-requisitos

Para usar esse método, você precisa primeiro fazer o seguinte:

  • Se você ainda não tiver feito isso, preencha todos os pré-requisitos para a API de envio da Microsoft Store.
  • Obtenha um token de acesso do Azure AD para usar no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.

Solicitação

Este método tem a seguinte sintaxe. Consulte as seções a seguir para obter exemplos de uso e descrições do cabeçalho e do corpo da solicitação.

Método Solicitar URI
Obtém https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização corda Obrigatório O token de acesso do Azure AD no formato Bearer<token>.

Parâmetros de solicitação

Todos os parâmetros de solicitação são opcionais para esse método. Se você chamar esse método sem parâmetros, a resposta conterá dados para todos os complementos de todos os aplicativos registrados na sua conta.

Parâmetro Tipo Descrição Obrigatório
Início Int O número de itens a serem retornados na solicitação (ou seja, o número de complementos a serem retornados). Se sua conta tiver mais complementos do que o valor especificado na consulta, o corpo da resposta incluirá um caminho de URI relativo que você pode acrescentar ao URI do método para solicitar a próxima página de dados. Não
pular Int O número de itens a serem ignorados na consulta antes de retornar os itens restantes. Use este parâmetro para percorrer conjuntos de dados. Por exemplo, top=10 e skip=0 recupera itens de 1 a 10, top=10 e skip=10 recupera itens de 11 a 20 e assim por diante. Não

Corpo de solicitação

Não forneça um conteúdo de solicitação para este método.

Exemplos de solicitações

O exemplo a seguir demonstra como recuperar todos os dados de extensões para todas as aplicações que estão registadas na sua conta.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer <your access token>

O exemplo a seguir demonstra como recuperar apenas os primeiros 10 complementos.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Resposta

O exemplo a seguir demonstra o corpo de resposta JSON retornado por uma solicitação bem-sucedida para os primeiros 5 complementos registrados em uma conta de desenvolvedor com 1072 complementos no total. Por uma questão de brevidade, este exemplo mostra apenas os dados dos dois primeiros complementos retornados pela solicitação. Para obter mais detalhes sobre os valores no corpo da resposta, consulte a seção a seguir.

{
  "@nextLink": "inappproducts/?skip=5&top=5",
  "value": [
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMP",
      "productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243619",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243705",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
      }
    },
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMN",
      "productId": "6a3c9788-a350-448a-bd32-16160a13018a",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243538",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243106",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
      }
    },

  // Other add-ons omitted for brevity...
  ],
  "totalCount": 1072
}

Corpo da resposta

Valor Tipo Descrição
@nextLink corda Se houver páginas adicionais de dados, esta cadeia de caracteres contém um caminho relativo que pode ser adicionado ao URI de solicitação base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar a próxima página de dados. Por exemplo, se o parâmetro superior do corpo da solicitação inicial estiver definido como 10, mas houver 100 complementos registrados na sua conta, o corpo da resposta incluirá um valor @nextLink de inappproducts?skip=10&top=10, o que indica que você pode chamar https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 para solicitar os próximos 10 complementos.
valor conjunto Uma matriz que contém objetos que fornecem informações sobre cada complemento. Para obter mais informações, consulte recurso de complemento.
contagem total Int O número de objetos da aplicação na matriz do valor do corpo da resposta.

Códigos de erro

Se a solicitação não puder ser concluída com êxito, a resposta conterá um dos seguintes códigos de erro HTTP.

Código de erro Descrição
404 Nenhum complemento foi encontrado.
409 Os aplicativos ou complementos usam recursos do Partner Center que atualmente não são suportados pela API de envio da Microsoft Store.
  • Last updated on