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. Podczas korzystania z interfejsu Reseller API ważne jest, aby rozumieć relacje koncepcyjne między sprzedawcami a klientami, abonamentami, kodami SKU produktów i licencjami.

Sprzedawca

Sprzedawca kupuje licencje użytkowników od Google i odsprzedaje je klientom Google. Sprzedawca może zarządzać subskrypcjami klientów bezpośrednio lub, jeśli dostosowuje wiele usług, może współpracować z integratorem usług w celu zarządzania klientami.

Sprzedawcy mają do wyboru te subskrypcje:

  • roczne zobowiązanie: sprzedawca kupuje od Google określoną liczbę licencji na rok. Klienci mogą utworzyć maksymalnie tyle licencji, ile wynosi ich liczba, ale sprzedawcy są obciążani opłatą za liczbę zamówionych licencji. Jeśli klienci potrzebują dodatkowych licencji, sprzedawcy mogą użyć wywołania interfejsu API subscriptions.changeSeats, aby zwiększyć liczbę zamówionych licencji.
  • elastyczna: za każdym razem, gdy klient utworzy nowe konto użytkownika, Google obciąża sprzedawcę kosztami tej licencji. Umowa odsprzedawcy z Google określa cenę, specyfikacje i maksymalną liczbę licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca (lub jego partnerzy zajmujący się integracją usług) zapewnia klientom szeroki zakres usług dodatkowych, takich jak szkolenia, promocje, reklamy, ustalanie cen, dostosowywanie wdrożeń, rozwiązywanie problemów i konserwacja.

Licencje

Licencja umożliwia użytkownikowi z kontem Google dostęp do usług Google Workspace. Gdy klient przypisze licencję użytkownikowi, stanie się ona aktywną licencją. Podczas obliczania łącznej liczby użytkowników klienta brane są pod uwagę tylko aktywne licencje.

Klient

Klient Google zaczyna od konta Google Workspace, które konfiguruje odsprzedawca. Podczas konfigurowania konta klienta odsprzedawca podaje podstawową nazwę domeny, dodatkowy adres e-mail i adres fizyczny. Następnie sprzedawca tworzy subskrypcję dla każdego kodu SKU produktu 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 rozliczeń sprzedawcy z Google. Te plany nie określają relacji rozliczeniowej między sprzedawcą a jego klientami. Sprzedawcy określają własne warunki rozliczeń z klientami.

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

  • 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 okres próbny
    • Długość okresu próbnego może się różnić, ale nie może przekraczać 30 dni.
    • Dzienny limit wysyłania wiadomości z Gmaila wynosi 500 wiadomości na użytkownika.
  • FREE: bezpłatny plan tylko w przypadku subskrypcji Cloud Identity Free Edition

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

Subskrypcja

Subskrypcja zarządza relacją między planem płatności klienta Google a wersją SKU produktu, licencjami użytkowników, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Podstawową rolą sprzedawcy jest zarządzanie subskrypcjami klienta Google.

W interfejsie Reseller API subskrypcja jest podstawowym zasobem 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 jednej na każdy kod SKU produktu przypisany do niego przez sprzedawcę.

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

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

Produkty i kody SKU produktów

Usługa to oferta komercyjna zawierająca specjalistyczny zestaw funkcji usług i aplikacji Google. Produkt może mieć dostosowane wersje warunków, cen i innych szczegółów umowy. Każda z tych wersji produktu jest identyfikowana za pomocą kodu SKU produktu. W tej wersji interfejs Reseller API oferuje subskrypcję dla każdego kodu SKU w Google Workspace, Google Vault i Google Drive. Więcej informacji znajdziesz w artykule Produkty i SKU.