Omówienie interfejsu Seller 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. W przypadku korzystania z interfejsu Seller API ważne jest zrozumienie koncepcyjnych relacji sprzedawców z 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 następujące abonamenty:

  • zobowiązanie roczne: sprzedawca kupuje od Google stałą liczbę licencji na rok. Klienci mogą tworzyć licencje, ale sprzedawcy są obciążani za liczbę zamawianych licencji. Jeśli klienci potrzebują dodatkowych licencji, sprzedawcy mogą użyć wywołania interfejsu API subscriptions.changeSeats, aby zwiększyć liczbę zamawianych licencji.
  • elastyczność: za każdym razem, gdy klient tworzy nowe konto użytkownika, Google obciąża sprzedawcę za tę licencję. Umowa sprzedawcy z Google zawiera cenę, specyfikacje i maksymalną liczbę licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca (lub jego współpracujący z nimi integrator usług) zapewnia klientom szeroki zakres 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 użytkownikowi licencję, staje się ona aktywną licencją. Przy obliczaniu łącznej liczby użytkowników klienta uwzględniane są tylko aktywne licencje.

Klient

Klient Google zaczyna od konta Google Workspace skonfigurowanego przez sprzedawcę. Podczas konfigurowania konta klienta sprzedawca dostarcza nazwę domeny podstawowej, dodatkowy adres e-mail i adres fizyczny. Następnie sprzedawca tworzy też subskrypcję na każdy kod SKU usługi dostępny 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 nie określają relacji między sprzedawcą a jego klientami. Sprzedawcy ustalają własne warunki płatności u klientów.

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

  • ANNUAL_MONTHLY_PAY: zobowiązanie roczne z płatnościami miesięcznymi
  • ANNUAL_YEARLY_PAY: zobowiązanie roczne z jedną płatnością roczną
  • FLEXIBLE: abonament bez zobowiązania z płatnościami miesięcznymi
  • TRIAL: bezpłatny abonament próbny
    • Długość okresu próbnego może być zmienna i wynosi maksymalnie 30 dni.
    • Dzienny limit wysyłania w Gmailu do 500 wiadomości na użytkownika.
  • FREE: bezpłatny abonament 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. Określa 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 1 na każdy kod SKU usługi, który sprzedawca przypisał klientowi.

Każda subskrypcja ma unikalny identyfikator: subscriptionId. Ponieważ właściwość subscriptionId zmienia się, gdy zmienia się subskrypcja, nie używaj wartości subscriptionId jako klucza dla danych trwałych. Klucz ten zostanie uszkodzony, jeśli subskrypcja się zmieni.

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

Produkty i kody SKU produktów

Produkt to komercyjna oferta specjalistycznego zestawu 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 usługi. W tej wersji interfejs Seller API oferuje subskrypcję na każdy kod SKU w usługach Google Workspace, Google Vault i Dysku Google. Więcej informacji znajdziesz w artykule Produkty i kody SKU.