Method: subscriptions.changePlan

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

Sposób aktualizowania abonamentu różni się w zależności od abonamentu i usług. 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 ulegnie zmianie, nie będzie można używać starej nazwy domeny, aby uzyskać dostęp do klienta, ale zawsze można użyć unikalnego identyfikatora klienta (wyświetlonego przez interfejs API). W stosownych przypadkach zalecamy przechowywanie unikalnego identyfikatora w swoich systemach.

subscriptionId

string

Jest to właściwość wymagana. subscriptionId to identyfikator subskrypcji, który jest unikalny dla każdego klienta. Identyfikator subscriptionId zmienia się po zaktualizowaniu subskrypcji, dlatego nie zalecamy używania tego identyfikatora jako klucza dla danych trwałych. subscriptionId można znaleźć przy użyciu 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 na temat autoryzacji.

ChangePlanRequest

Szablon JSON dla żądania RPC subskrypcji.changePlan.

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

string

Wskazuje 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 interfejsami API.

Możliwe wartości:

  • 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)

Jest to właściwość wymagana. Właściwość miejsc to liczba licencji użytkowników.

purchaseOrderId

string

Jest to właściwość opcjonalna. Sprzedawcy mogą używać tych informacji o zamówieniach do śledzenia ich użytkowania w firmie. Jeśli podana jest wartość purchaseOrderId, pojawia się ona w odpowiedziach interfejsu API i pojawia się na fakturze. Właściwość może zawierać maksymalnie 80 znaków zwykłego tekstu.

dealCode

string

Kod wydany przez Google (maks. 100 znaków) umożliwiający korzystanie z rabatu na abonamenty. Aby otrzymać zniżkę, musisz uwzględnić kod umowy w żądaniu changePlan. Ta właściwość jest opcjonalna. Jeśli kod oferty został już dodany do subskrypcji, ta usługa może być pusta, a dotychczasowa obniżona cena nadal będzie obowiązywać (jeśli nie jest pusta, podaj tylko kod oferty, który jest już przypisany do subskrypcji). Jeśli kod umowy nie został nigdy dodany do subskrypcji, a ta usługa jest pusta, będą obowiązywać standardowe ceny.