Converter uma assinatura de avaliação em pagaConvert a trial subscription to paid

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Você pode converter uma assinatura de avaliação para paga.You can convert a trial subscription to paid.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.This scenario supports authentication with App+User credentials only.

  • Uma ID do cliente (customer-tenant-id).A customer ID (customer-tenant-id). Se você não souber a ID do cliente, poderá procurar no painel do Partner Center.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecione CSP no menu do Partner Center e, em seguida, Clientes.Select CSP from the Partner Center menu, followed by Customers. Selecione o cliente na lista de clientes e selecione Conta.Select the customer from the customer list, then select Account. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Uma ID de assinatura para uma assinatura de avaliação ativa.A subscription ID for an active trial subscription.

  • Uma oferta de conversão disponível.An available conversion offer.

Converter uma assinatura de avaliação para pago pelo códigoConvert a trial subscription to paid through code

Para converter uma assinatura de avaliação em uma paga, primeiro você deve obter uma coleção das conversões de avaliação disponíveis.To convert a trial subscription to a paid one, you must first obtain a collection of the trial conversions available. Em seguida, você deve escolher a oferta de conversão que deseja comprar.Then, you must choose the conversion offer that you want to purchase.

As ofertas de conversão especificarão uma quantidade que usa como padrão o mesmo número de licenças que a assinatura de avaliação.The conversion offers will specify a quantity that defaults to the same number of licenses as the trial subscription. Você pode alterar essa quantidade definindo a propriedade Quantity como o número de licenças que deseja comprar.You can change this quantity by setting the Quantity property to the number of licenses that you want to purchase.

Observação

Independentemente do número de licenças adquiridas, a ID da assinatura da avaliação é reutilizada para as licenças adquiridas.Regardless of the number of licenses purchased, the subscription ID of the trial is reused for the purchased licenses. Como resultado, a avaliação em vigor desaparece e é substituída pela compra.As a result, the trial in effect disappears and is replaced by the purchase.

Use as etapas a seguir para converter uma assinatura de avaliação por meio de código:Use the following steps to convert a trial subscription through code:

  1. Obtenha uma interface para as operações de assinatura disponíveis.Get an interface to the subscription operations available. Você deve identificar o cliente e especificar o identificador da assinatura de avaliação.You must identify the customer and specify the subscription identifier of the trial subscription.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
    
  2. Obtenha uma coleção das ofertas de conversão disponíveis.Get a collection of the available conversion offers. 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.For more information and details on the request/response for this method, see Get a list of trial conversion offers.

    var conversions = subscriptionOperations.Conversions.Get();
    
  3. Escolha uma oferta de conversão.Choose a conversion offer. O código a seguir escolhe a primeira oferta de conversão na coleção.The following code chooses the first conversion offer in the collection.

    var selectedConversion = conversions.Items.ToList()[0];
    
  4. Opcionalmente, especifique o número de licenças a serem compradas.Optionally, specify the number of licenses to purchase. O padrão é o número de licenças na assinatura de avaliação.The default is the number of licenses in the trial subscription.

    selectedConversion.Quantity = 10;
    
  5. Chame o método Create ou createasync para converter a assinatura de avaliação para pago.Call the Create or CreateAsync method to convert the trial subscription to paid.

    var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
    

C#C#

Para converter uma assinatura de avaliação em uma paga:To convert a trial subscription to a paid one:

  1. Use o método IAggregatePartner. Customers. ById com a ID do cliente para identificar o cliente.Use the IAggregatePartner.Customers.ById method with the customer ID to identify the customer.

  2. Obtenha uma interface para as operações de assinatura chamando o método subscriptions . ById com a ID de assinatura de avaliação.Get an interface to subscription operations by calling the Subscriptions.ById method with the trial subscription ID. Salve uma referência à interface de operações de assinatura em uma variável local.Save a reference to the subscription operations interface in a local variable.

  3. Use a propriedade conversões 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.Use the Conversions property to obtain an interface to the available operations on conversions, and then call the Get or GetAsync method to retrieve a collection of available Conversion offers. Você deve escolher um.You must choose one. O exemplo a seguir usa como padrão a primeira conversão disponível.The following example defaults to the first conversion available.

  4. Use a referência à interface de operações de assinatura que você salvou em uma variável local e a propriedade conversões para obter uma interface para as operações disponíveis em conversões.Use the reference to the subscription operations interface that you saved in a local variable and the Conversions property to obtain an interface to the available operations on conversions.

  5. Passe o objeto de oferta de conversão selecionado para o método Create ou createasync para tentar a conversão de avaliação.Pass the selected conversion offer object to the Create or CreateAsync method to attempt the trial conversion.

#Exemplo CC# example

// 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'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);
}

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-ID}/subscriptions/{Subscription-ID}/Conversions http/1.1{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

Parâmetro do URIURI parameter

Use os seguintes parâmetros de caminho para identificar o cliente e a assinatura de avaliação.Use the following path parameters to identify the customer and trial subscription.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
id do clientecustomer-id stringstring SimYes Uma cadeia de caracteres formatada de GUID que identifica o cliente.A GUID formatted string that identifies the customer.
id da assinaturasubscription-id stringstring SimYes Uma cadeia de caracteres formatada GUID que identifica a assinatura de avaliação.A GUID formatted string that identifies the trial subscription.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Um recurso de conversão preenchido deve ser incluído no corpo da solicitação.A populated Conversion resource must be included in the request body.

Exemplo de solicitaçãoRequest example

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/488745B5-2086-4912-802C-6ABB9F7C3638/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
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 RESTREST response

Se for bem-sucedido, o corpo da resposta conterá um recurso ConversionResult .If successful, the response body contains a ConversionResult resource.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, consulte códigos de erro do Partner Center.For the full list, see Partner Center error codes.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "488745B5-2086-4912-802C-6ABB9F7C3638",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}