Omówienie interfejsu Reseller API

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Jednym ze sposobów oferowania usług Google użytkownikom są kanały dystrybucji usług, takie jak autoryzowani sprzedawcy Google Workspace. Podczas pracy z interfejsem Seller API musisz wiedzieć, czym są relacje między sprzedawcami a klientami, abonamentami, kodami SKU produktów i licencjami.

Sprzedawca

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

Sprzedawcy mogą wybierać spośród tych abonamentów:

  • zobowiązanie roczne: sprzedawca kupuje ustaloną liczbę licencji od Google na rok. Klienci mogą utworzyć maksymalną liczbę licencji, ale sprzedawcy są obciążani liczbą zamówionych licencji. Jeśli klienci potrzebują dodatkowych licencji, sprzedawcy mogą skorzystać z wywołania interfejsu API subscriptions.changeSeats, aby zwiększyć liczbę zamówionych licencji.
  • elastyczny: za każdym razem, gdy klient tworzy nowego użytkownika, Google nalicza opłatę za tę licencję. Umowa sprzedawcy z Google zawiera cenę, specyfikację i maksymalną liczbę licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca (lub jego integratorzy świadczący usługi partnerskie) oferuje klientom wiele usług dodatkowych, takich jak szkolenia, promocje, reklamy, ceny, dostosowania wdrożeń, rozwiązywanie problemów i konserwacja.

Licencje

Licencja umożliwia użytkownikom posiadającym konto Google dostęp do usług Google Workspace. Gdy klient przypisze licencję użytkownikowi, stanie się ona aktywną licencją. Przy obliczaniu łącznej liczby użytkowników liczone są tylko aktywne licencje.

Klient

Klient Google zaczyna od konta Google Workspace skonfigurowanego przez sprzedawcę. Podczas konfigurowania konta klienta sprzedawca podaje nazwę domeny podstawowej, dodatkowy adres e-mail i adres pocztowy. Następnie tworzy też subskrypcję dla każdego kodu SKU produktu dostępnego dla klienta. Klient przechowuje poszczególne konta użytkowników. Więcej informacji znajdziesz w artykule Zamawianie nowego konta klienta.

Plany

Abonament określa warunki płatności sprzedawcy w Google. Te plany nie definiują relacji rozliczeniowej między sprzedawcą a jego klientami. Sprzedawcy określają własne warunki płatności dla swoich klientów.

Interfejs Seller API obsługuje miesięczny system płatności po wykonaniu usługi w 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: roczne zobowiązanie z płatnością raz w roku
  • FLEXIBLE: abonament bez zobowiązania z płatnościami miesięcznymi
  • TRIAL: bezpłatny okres próbny
    • Może mieć maksymalnie 30 dni.
    • Dzienny limit wysyłania wiadomości w Gmailu wynoszący 500 wiadomości na użytkownika.
  • FREE: 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 relacją między abonamentem klienta Google a kodem SKU usługi, licencjami użytkowników, 30-dniowym bezpłatnym okresem próbnym i opcjami odnowienia. Główna rola sprzedawcy to zarządzanie subskrypcjami klientów Google.

W interfejsie Reseller API subskrypcja jest głównym zasobem interfejsu API. Określa ona ustawienia abonamentu, licencji, 30-dniowego bezpłatnego okresu próbnego, odnowienia i zamówienia zakupu sprzedawcy. Klient może mieć więcej niż 1 subskrypcję, po 1 na każdy SKU produktu przypisany przez sprzedawcę do klienta.

Każda subskrypcja ma unikalny identyfikator – subscriptionId. Ponieważ subscriptionId zmienia się po zmianie subskrypcji, nie używaj wartości subscriptionId jako klucza w trwałych danych. Ten klucz przestanie działać w przypadku zmiany subskrypcji.

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

Produkty i kody SKU produktów

Produkt to komercyjna oferta specjalistycznego zestawu funkcji i usług Google. Produkt może mieć dostosowane wersje warunków, cennika i innych szczegółów umowy. Każda z tych wersji jest oznaczona identyfikatorem produktu. W tej wersji interfejs Reseller API oferuje subskrypcje dla poszczególnych kodów SKU w usługach Google Workspace, Google Vault i Dysk Google. Więcej informacji znajdziesz w artykule Produkty i kody SKU.