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
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.
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.
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.