Partilhar via

Criar um complemento

Use esse método na API de envio da Microsoft Store para criar um complemento (também conhecido como produto no aplicativo ou IAP) para um aplicativo registrado em sua conta do Partner Center.

Observação

Este método cria um suplemento sem submissões. Para criar um envio para um complemento, consulte os métodos em Gerenciar envios de complementos.

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
Publicação 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>.

Corpo de solicitação

O corpo da solicitação tem os seguintes parâmetros.

Parâmetro Tipo Descrição Obrigatório
IDs de aplicação conjunto Uma matriz que contém a ID da Loja do aplicativo ao qual esse complemento está associado. Apenas um item é suportado nesta matriz. Sim
productId corda A ID do produto do complemento. Este é um identificador que pode ser usado no código para fazer referência ao complemento. Para obter mais informações, consulte Definir o tipo de produto e a ID do produto. Sim
tipoDeProduto corda O tipo de produto do complemento. Os seguintes valores são suportados: Durable e Consumable. Sim

Exemplo de solicitação

O exemplo a seguir demonstra como criar um novo complemento consumível para um aplicativo.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

Resposta

O exemplo a seguir demonstra o corpo de resposta JSON para uma chamada bem-sucedida para esse método. Para mais detalhes sobre os valores no corpo da resposta, consulte o recurso adicional .

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

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
400 O pedido é inválido.
409 O complemento não pôde ser criado devido ao seu estado atual ou usa um recurso do Partner Center que não é suportado atualmente pela API de envio da Microsoft Store.
  • Last updated on