Omówienie interfejsu Seller API

Jedną z form, w której Google oferuje usługi związane z usługami Google, są kanały dystrybucji usług, takie jak autoryzowani sprzedawcy Google Workspace. Podczas pracy z interfejsem Reseller API ważne jest, aby zrozumieć relacje między sprzedawcami a klientami, abonamentami, kodami SKU produktów i licencjami.

Sprzedawca

Sprzedawca kupuje licencje użytkownika 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 stałą liczbę licencji na okres 1 roku. Klienci mogą utworzyć maksymalną liczbę licencji, ale sprzedawcy są obciążani 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.
  • elastyczny: za każdym razem, gdy klient utworzy nowego użytkownika, Google obciąży sprzedawcę opłatą za tę licencję. Umowa z Google zawiera informacje o cenie, specyfikacji i maksymalnej liczbie licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca (lub jego partnerzy integrujący usługi) zapewnia klientom szeroki zakres usług dodatkowych, takich jak szkolenia, promocje, reklama, ceny, 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, 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 reseller podaje podstawowe nazwy domen, alternatywne adresy e-mail i adresy fizyczne. Następnie sprzedawca tworzy subskrypcję dla każdego kodu SKU produktu dostępnego dla klienta. Klient hostuje każde konto użytkownika. Więcej informacji znajdziesz w artykule Zamawianie nowego konta klienta.

Abonamenty

Abonament określa warunki rozliczeń sprzedawcy z Google. Te abonamenty nie określają relacji rozliczeniowych między sprzedawcą a jego klientami. Sprzedawcy określają własne warunki rozliczeń z klientami.

Interfejs API dla sprzedawców obsługuje system płatności miesięcznych Google Workspace, który oferuje kilka 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ązań z płatnościami miesięcznymi
  • TRIAL: bezpłatny okres próbny
    • Długość wersji próbnej może się zmieniać, ale nie może przekroczyć 30 dni.
    • dzienny limit wysyłania Gmaila wynoszący 500 wiadomości na użytkownika.
  • FREE: tylko bezpłatny plan subskrypcji Cloud Identity Free Edition

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

Subskrypcja

Subskrypcja zarządza relacją planu płatności klienta Google z wartością SKU produktu, licencjami użytkownika, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Głównym zadaniem sprzedawcy jest zarządzanie subskrypcjami klienta Google.

W interfejsie Reseller API subskrypcja jest podstawowym zasobem interfejsu API. Określa on ustawienia abonamentu, licencji, 30-dniowego bezpłatnego okresu próbnego, odnowienia oraz zamówienia sprzedawcy. Klient może mieć więcej niż 1 abonament, po 1 dla każdego identyfikatora SKU produktu, który sprzedawca przypisze klientowi.

Każda subskrypcja ma unikalny identyfikator, czyli subscriptionId. Wartość subscriptionId zmienia się wraz ze zmianą subskrypcji, dlatego nie używaj jej jako klucza danych trwałych.subscriptionId Ten klucz przestanie działać, jeśli abonament ulegnie zmianie.

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

Produkty i kody SKU produktów

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