Omówienie interfejsu Reseller API

Jednym ze sposobów, w jaki Google oferuje użytkownikom usługi Google, są kanały dystrybucji usług, takie jak autoryzowani sprzedawcy Google Workspace. Podczas korzystania z interfejsu Seller API ważne jest zrozumienie koncepcji relacji między sprzedawcami a klientami, abonamentów, kodów SKU usług i licencji.

Sprzedawca

Sprzedawca kupuje od Google licencje użytkowników i sprzeda je klientom Google. Sprzedawca może bezpośrednio zarządzać subskrypcjami klientów, a w przypadku dostosowywania wielu usług może współpracować z integratorem usług, aby zarządzać klientami.

Sprzedawcy mają do wyboru te abonamenty:

  • Zobowiązanie roczne: sprzedawca kupuje stałą liczbę licencji od Google na rok. Klienci mogą utworzyć maksymalną liczbę licencji, ale sprzedawcy są rozliczani za liczbę zamówionych licencji. Jeśli klienci potrzebują dodatkowych licencji, sprzedawcy mogą zwiększyć liczbę zamawianych licencji za pomocą wywołania interfejsu API subscriptions.changeSeats.
  • elastyczność:za każdym razem, gdy klient tworzy nowego użytkownika, Google nalicza sprzedawcy tę licencję. Umowa sprzedawcy z Google określa cenę, specyfikacje i maksymalną liczbę licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca (lub współpracujący z nim integrator usług) zapewnia klientom szeroką gamę usług dodatkowych, takich jak szkolenia, promocje, reklamy, ceny, dostosowywanie wdrożeń, rozwiązywanie problemów i konserwacja.

Licencje

Licencja pozwala użytkownikowi z kontem Google korzystać z usług Google Workspace. Gdy klient przypisze licencję użytkownikowi, staje się ona aktywną licencją. Podczas obliczania łącznej liczby użytkowników klienta uwzględniane są tylko aktywne licencje.

Klient

Klient Google zaczyna od konta Google Workspace konfigurowanego przez sprzedawcę. Podczas konfigurowania konta klienta sprzedawca dostarcza nazwę domeny podstawowej, dodatkowy adres e-mail i adres fizyczny. Następnie sprzedawca tworzy też subskrypcję dla każdego kodu SKU usługi dostępnego dla klienta. Klient hostuje każde indywidualne konto użytkownika. Więcej informacji znajdziesz w artykule Zamawianie nowego konta klienta.

Abonamenty

Abonament określa warunki płatności sprzedawcy w Google. Abonamenty te nie definiują relacji rozliczeniowej między sprzedawcą a jego klientami. Sprzedawcy ustalają własne warunki płatności ze swoimi klientami.

Interfejs Seller API obsługuje miesięczny system płatności z dołu za Google Workspace, który ma kilka dostępnych abonamentów:

  • ANNUAL_MONTHLY_PAY: roczne zobowiązanie z płatnościami miesięcznymi.
  • ANNUAL_YEARLY_PAY: zobowiązanie roczne z jedną płatnością roczną
  • FLEXIBLE: abonament bez zobowiązań z płatnościami miesięcznymi
  • TRIAL: bezpłatny okres próbny
    • Długość okresu próbnego może być zmienna i może wynosić maksymalnie 30 dni.
    • Dzienny limit wysyłania w Gmailu do 500 wiadomości na użytkownika.
  • FREE: abonament bezpłatny tylko dla subskrypcji Cloud Identity Free Edition

Więcej informacji o tych abonamentach znajdziesz w artykule Wybieranie abonamentu dla klientów.

Subskrypcja

Subskrypcja zarządza relacjami między abonamentem klienta Google a SKU usługi, licencjami użytkowników, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Główna rola sprzedawcy to zarządzanie subskrypcjami klienta Google.

W interfejsie Seller API subskrypcja jest głównym zasobem interfejsu API. Definiuje ustawienia abonamentu, licencji, 30-dniowego bezpłatnego okresu próbnego, odnowienia i zamówienia sprzedawcy. Klient może mieć więcej niż 1 subskrypcję – po jednej na każdy kod SKU usługi przypisany przez sprzedawcę do klienta.

Każda subskrypcja ma unikalny identyfikator: subscriptionId. Ponieważ subscriptionId zmienia się wraz ze zmianą subskrypcji, nie używaj wartości subscriptionId jako klucza trwałych danych. Jeśli subskrypcja się zmieni, klucz przestanie działać.

Więcej informacji znajdziesz w artykule Zarządzanie subskrypcjami.

Produkty i kody SKU produktów

Produkt to oferta handlowa wyspecjalizowanego zestawu funkcji usług i aplikacji Google. Usługa może mieć dostosowane wersje warunków, cen i innych szczegółów umowy. Każda z tych wersji usługi jest identyfikowana przez kod SKU produktu. W tej wersji interfejs Seller API oferuje subskrypcję dla każdego kodu SKU w usługach Google Workspace, Google Vault i Dysk Google. Więcej informacji znajdziesz w artykule Produkty i kody SKU.