Method: subscriptions.changePlan

Aktualizuje abonament. Użyj tej metody, aby zaktualizować abonament na okres próbny (30 dni) lub abonament elastyczny na abonament roczny z płatnościami miesięcznymi lub rocznymi.

Sposób aktualizowania planu zależy od planu i usług. Więcej informacji znajdziesz 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 jej używać do uzyskiwania dostępu do klienta, ale zawsze można użyć jego unikalnego identyfikatora (zwracanego przez interfejs API). W stosownych przypadkach zalecamy przechowywanie w swoich systemach unikalnego identyfikatora.
subscriptionId

string

To jest wymagana usługa. subscriptionId to identyfikator subskrypcji, który jest unikalny dla każdego klienta. Ponieważ identyfikator subscriptionId zmienia się po zaktualizowaniu subskrypcji, zalecamy, aby nie używać tego identyfikatora jako klucza do danych trwałych. Wartość subscriptionId można znaleźć, korzystając z metody pobierania wszystkich subskrypcji 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 dotyczącym autoryzacji.

ChangePlanRequest

Szablon JSON dla żądania RPC subscriptions.changePlan.

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

string

Określa zasób jako prośbę o zmianę abonamentu subskrypcji. Wartość: subscriptions#changePlanRequest
planName

string

Właściwość planName jest wymagana. To jest nazwa abonamentu. Więcej informacji o planach płatności Google znajdziesz w artykule Koncepcje interfejsu API.

Możliwe wartości:

  • ANNUAL_MONTHLY_PAY – roczny plan z miesięcznymi płatnościami
  • ANNUAL_YEARLY_PAY – abonament roczny z płatnościami rocznymi
  • FLEXIBLE – abonament elastyczny,
  • TRIAL – 30-dniowy bezpłatny okres próbny

seats

object (Seats)

To jest wymagana usługa. Właściwość seats to liczba licencji na stanowiska użytkowników.
purchaseOrderId

string

To jest właściwość opcjonalna. Informacje o zamówieniu (numer zamówienia) są przeznaczone dla sprzedawców i służą do śledzenia wykorzystania przez ich firmę. Jeśli podana jest wartość purchaseOrderId, pojawia się ona w odpowiedziach interfejsu API i na fakturze. Właściwość ta może zawierać maksymalnie 80 znaków zwykłego tekstu.
dealCode

string

Kod wydany przez Google (maksymalnie 100 znaków) uprawniający do rabatu na abonamenty. Aby otrzymać zniżkę, należy podać kod oferty w changePlan. Ta właściwość jest opcjonalna. Jeśli kod rabatowy został już dodany do subskrypcji, możesz pozostawić to pole puste, a obecna stawka z rabatem będzie nadal obowiązywać (jeśli nie jest puste, podaj tylko kod rabatowy, który jest już obecny w subskrypcji). Jeśli kod rabatowy nigdy nie został dodany do subskrypcji i ta właściwość jest pusta, obowiązują ceny regularne.