Method: subscriptions.suspend

Zawiesza aktywną subskrypcję.

Za pomocą tej metody możesz zawiesić płatną subskrypcję, która jest obecnie w stanie ACTIVE.

  • W przypadku subskrypcji FLEXIBLE rozliczenia są wstrzymane.
  • W przypadku subskrypcji ANNUAL_MONTHLY_PAY lub ANNUAL_YEARLY_PAY:
    • Zawieszenie subskrypcji nie zmienia pierwotnie ustalonej daty odnowienia.
    • Zawieszona subskrypcja nie jest odnawiana. Jeśli aktywujesz subskrypcję po pierwotnej dacie odnowienia, utworzymy nową subskrypcję roczną, która będzie obowiązywać od dnia aktywacji.

Gorąco zachęcamy do zawieszania subskrypcji tylko na krótki czas, ponieważ zawieszenie na ponad 60 dni może spowodować anulowanie subskrypcji.

Żądanie HTTP

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

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 musi być pusta.

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.