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.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-09-09 UTC."],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]
