Method: subscriptions.changePlan

Aktualizuje abonament. Korzystając z tej metody, możesz zaktualizować plan na 30-dniowy okres próbny lub abonament elastyczny na abonament z rocznym zobowiązaniem z płatnościami miesięcznymi lub rocznymi.

Sposób aktualizacji abonamentu różni się w zależności od abonamentu i produktów. Więcej informacji znajdziesz w opisie w artykule Zarządzanie subskrypcjami.

Żądanie HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Może to być nazwa domeny podstawowej klienta lub jego unikalny identyfikator. Jeśli nazwa domeny klienta się zmieni, nie będzie można uzyskać dostępu do klienta za pomocą starej nazwy domeny, ale zawsze będzie można użyć niepowtarzalnego identyfikatora klienta (zwróconego przez interfejs API). Zalecamy przechowywanie unikalnego identyfikatora w systemach.
subscriptionId

string

Ta właściwość jest wymagana. subscriptionId to identyfikator subskrypcji, który jest unikalny dla każdego klienta. subscriptionId zmienia się po aktualizacji subskrypcji, dlatego nie zalecamy używania tego identyfikatora jako klucza dla trwałych danych. subscriptionId można znaleźć za pomocą metody Pobierz wszystkie subskrypcje sprzedawcy.

Treść żądania

Treść żądania zawiera wystąpienie elementu ChangePlanRequest.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Subscription.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/apps.order

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ChangePlanRequest

Szablon JSON żądania RPC subscription.changePlan.

Zapis JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Pola
kind

string

Identyfikuje zasób jako żądanie zmiany abonamentu. Wartość: subscriptions#changePlanRequest
planName

string

Właściwość planName jest wymagana. Jest to nazwa abonamentu. Więcej informacji o abonamentach Google znajdziesz w artykule Pojęcia związane z interfejsem API.

Możliwe wartości to:

  • ANNUAL_MONTHLY_PAY – abonament z rocznym zobowiązaniem z płatnościami miesięcznymi.
  • ANNUAL_YEARLY_PAY – abonament z rocznym zobowiązaniem z płatnościami rocznymi
  • FLEXIBLE – abonament elastyczny
  • TRIAL – 30-dniowy bezpłatny okres próbny

seats

object (Seats)

Ta właściwość jest wymagana. Właściwość stanowisk to liczba licencji użytkowników.
purchaseOrderId

string

Ta właściwość jest opcjonalna. Te informacje o zamówieniu zakupu są przeznaczone dla sprzedawców do wykorzystania w firmowym systemie śledzenia. Jeśli podasz wartość purchaseOrderId, pojawi się ona w odpowiedziach interfejsu API i na fakturze. W obiekcie można użyć maksymalnie 80 znaków zwykłego tekstu.
dealCode

string

Kod od Google (maksymalnie 100 znaków) umożliwiający skorzystanie z rabatów na abonamenty. Aby skorzystać z rabatu, w żądaniu changePlan należy podać kod umowy. Ta właściwość jest opcjonalna. Jeśli kod oferty został już dodany do subskrypcji, ta właściwość może pozostać pusta, a obecna obniżona cena nadal będzie obowiązywać (jeśli kod oferty nie jest pusty, podaj tylko ten kod, który występuje już w subskrypcji). Jeśli kod oferty nigdy nie został dodany do subskrypcji, a ta właściwość jest pusta, obowiązywać będą standardowe ceny.