Converter uma assinatura de avaliação em paga usando APIs do Partner Center

Artigo
10/01/2024

Nota

Estas etapas não são aplicáveis a Novos Produtos de Comércio. Consulte Transição de uma nova documentação de assinatura de comércio para converter avaliações do New Commerce em assinaturas pagas

Você pode converter uma assinatura de avaliação em paga.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).
Um ID de assinatura para uma assinatura de avaliação ativa.
Uma oferta de conversão disponível.

Converter uma subscrição de avaliação numa subscrição paga através de código

Para converter uma assinatura de avaliação em uma paga, você deve primeiro obter uma coleção das conversões de avaliação disponíveis. Em seguida, você deve escolher a oferta de conversão que deseja comprar.

As ofertas de conversão especificarão uma quantidade que assume como padrão o mesmo número de licenças que a assinatura de avaliação. Você pode alterar essa quantidade definindo a propriedade Quantity como o número de licenças que deseja comprar.

Nota

Independentemente do número de licenças adquiridas, o ID de subscrição da versão experimental é reutilizado para as licenças adquiridas. Como resultado, o julgamento em vigor desaparece e é substituído pela compra.

Use as seguintes etapas para converter uma assinatura de avaliação por meio de código:

Obtenha uma interface para as operações de subscrição disponíveis. Você deve identificar o cliente e especificar o identificador de assinatura da assinatura de avaliação.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
Obtenha uma coleção das ofertas de conversão disponíveis. Para obter mais informações e detalhes sobre a solicitação/resposta para esse método, consulte Obter uma lista de ofertas de conversão de avaliação.
```
var conversions = subscriptionOperations.Conversions.Get();
```
Escolha uma oferta de conversão. O código a seguir escolhe a primeira oferta de conversão na coleção.
```
var selectedConversion = conversions.Items.ToList()[0];
```
Opcionalmente, especifique o número de licenças a comprar. O padrão é o número de licenças na assinatura de avaliação.
```
selectedConversion.Quantity = 10;
```
Chame o método Create ou CreateAsync para converter a assinatura de avaliação em paga.
```
var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
```

C#

Para converter uma subscrição de avaliação numa subscrição paga:

Use o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente.
Obtenha uma interface para operações de assinatura chamando o método Subscriptions.ById com a ID da assinatura de avaliação. Salve uma referência à interface de operações de assinatura em uma variável local.
Use a propriedade Conversions para obter uma interface para as operações disponíveis em conversões e, em seguida, chame o método Get ou GetAsync para recuperar uma coleção de ofertas de conversão disponíveis. Você deve escolher um. O exemplo a seguir assume como padrão a primeira conversão disponível.
Use a referência à interface de operações de assinatura que você salvou em uma variável local e a propriedade Conversions para obter uma interface para as operações disponíveis em conversões.
Passe o objeto de oferta de conversão selecionado para o método Create ou CreateAsync para tentar a conversão de avaliação.

Exemplo de C#

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get subscription operations for the trial subscription.
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

// Get the available conversions.
var conversions = subscriptionOperations.Conversions.Get();

// If there are no conversions available, we&#39;re done.
// Otherwise, convert the trial to the first available conversion offer.
if (conversions.TotalCount <= 0)
{
    System.Console.WriteLine("This subscription has no conversions");
}
else
{
    // Default to the first conversion.
    var selectedConversion = conversions.Items.ToList()[0];

    // Convert the trial and return the result.
    var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
}

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversões HTTP/1.1

Parâmetro URI

Use os seguintes parâmetros de caminho para identificar o cliente e a assinatura de avaliação.

Nome	Type	Necessário	Descrição
ID do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.
ID da subscrição	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica a assinatura de avaliação.

Cabeçalhos do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Um recurso de Conversão preenchido deve ser incluído no corpo da solicitação.

Exemplo de solicitação

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 234
Expect: 100-continue

{
    "OfferId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "TargetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "OrderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
    "Quantity": 25,
    "BillingCycle": "monthly",
    "Attributes": {
        "ObjectType": "Conversion"
    }
}

Resposta do REST

Se bem-sucedida, o corpo da resposta contém um recurso ConversionResult .

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}

Partilhar via