Method: subscriptions.insert

tworzy lub przenosi subskrypcję.

Utwórz subskrypcję na koncie klienta, które zostało zamówione za pomocą metody Zamawianie nowego konta klienta. Więcej informacji o tworzeniu subskrypcji dla różnych planów płatności znajdziesz w artykule Zarządzanie subskrypcjami.\

Jeśli nie zamówisz konta klienta za pomocą metody wstawiania klienta, podczas tworzenia subskrypcji dla tego klienta użyj jego customerAuthToken.

Jeśli przenosisz subskrypcję G Suite z powiązaną subskrypcją Dysku Google lub Google Vault, użyj operacji zbiorczej, aby przenieść wszystkie te subskrypcje. Więcej informacji znajdziesz w artykule o przenoszeniu subskrypcji.

Żądanie HTTP

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

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.

Parametry zapytania

Parametry
customerAuthToken

string

Parametr zapytania customerAuthToken jest wymagany podczas tworzenia konta sprzedawcy, które przenosi subskrypcję klienta indywidualnego lub przenosi subskrypcję innego klienta sprzedawcy do zarządzania przez sprzedawcę. To szesnastkowy token uwierzytelniania potrzebny do przeniesienia subskrypcji. Więcej informacji znajdziesz w Centrum pomocy dla administratorów.

Treść żądania

Treść żądania zawiera wystąpienie elementu Subscription.

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję 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.