Method: subscriptions.suspend

Zawiesza aktywną subskrypcję.

Tej metody możesz użyć, aby zawiesić płatną subskrypcję, która obecnie ma stan ACTIVE.

  • Płatności za subskrypcje (FLEXIBLE) są wstrzymane.
  • W przypadku subskrypcji ANNUAL_MONTHLY_PAY lub ANNUAL_YEARLY_PAY:
    • Zawieszenie subskrypcji nie zmienia pierwotnej daty odnowienia.
    • Zawieszona subskrypcja nie odnawia się.Jeśli aktywujesz subskrypcję po pierwotnej dacie odnowienia, zostanie utworzona nowa subskrypcja roczna w dniu aktywacji.

Zdecydowanie zalecamy, aby zawieszać subskrypcje tylko na krótki czas, ponieważ zawieszenie po upływie 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 się zmieni, nie będzie można uzyskać dostępu do klienta za pomocą starej nazwy domeny, ale zawsze będzie można użyć niepowtarzalnego identyfikatora klienta (zwróconego przez interfejs API). Zalecamy przechowywanie unikalnego identyfikatora w systemach.

subscriptionId

string

Ta właściwość jest wymagana. subscriptionId to identyfikator subskrypcji, który jest unikalny dla każdego klienta. subscriptionId zmienia się po aktualizacji subskrypcji, dlatego nie zalecamy używania tego identyfikatora jako klucza dla trwałych danych. subscriptionId można znaleźć za pomocą metody Pobierz wszystkie subskrypcje 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 po autoryzacji.