Omówienie interfejsu Seller API

Google oferuje produkty użytkownikom za pośrednictwem kanałów dystrybucji, takich jak autoryzowani sprzedawcy Google Workspace. Podczas korzystania z interfejsu Reseller API musisz rozumieć relacje między sprzedawcami, klientami, planami płatności, kodami SKU produktów i licencjami.

Sprzedawca

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

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

  • roczne zobowiązanie: sprzedawca kupuje od Google określoną liczbę licencji na 1 rok. Klienci mogą utworzyć maksymalnie liczbę licencji, ale sprzedawcy są obciążani opłatą za liczbę zamówionych licencji. Aby zwiększyć liczbę licencji, sprzedawcy mogą użyć metody subscriptions.changeSeats.
  • Elastyczny: za każdym razem, gdy klient utworzy nowego użytkownika, Google obciąża sprzedawcę licencją. Umowa odsprzedawcy z Google określa cenę, specyfikacje i maksymalną liczbę licencji.

Oprócz zarządzania licencjami użytkowników sprzedawca lub jego partnerzy będący integratorami usług świadczą klientom usługi takie 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, staje się ona aktywna. Do łącznej liczby użytkowników klienta wliczane są tylko aktywne licencje.

Klient

Klient Google zaczyna od konta Google Workspace, które konfiguruje odsprzedawca. Podczas konfigurowania konta sprzedawca podaje domenę podstawową, dodatkowy e-mail i adres pocztowy. Sprzedawca tworzy też 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 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 Google Workspace, który obejmuje te abonamenty:

  • 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ść okresu próbnego może wynosić do 30 dni.
    • Dzienny limit wysyłania z Gmaila wynosi 500 wiadomości na użytkownika.
  • FREE: Bezpłatny plan tylko w przypadku subskrypcji Cloud Identity Free Edition.

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

Subskrypcja

Subskrypcja zarządza relacją między abonamentem klienta Google, kodem SKU produktu, licencjami użytkowników, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Główną rolą sprzedawcy jest zarządzanie tymi subskrypcjami.

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ć kilka subskrypcji, po jednej na każdy przypisany do niego kod SKU produktu.

Każda subskrypcja ma unikalny identyfikator subscriptionId. Ponieważ wartość parametru subscriptionId zmienia się wraz ze zmianą subskrypcji, nie używaj go jako klucza do trwałych danych.

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

Produkty i kody SKU produktów

Produkt to komercyjna oferta usług i aplikacji Google. Produkt może mieć dostosowane wersje warunków, cen i innych szczegółów umowy. Każda wersja jest identyfikowana za pomocą jednostki SKU produktu. Interfejs Reseller API oferuje subskrypcje SKU w usługach Google Workspace, Google Vault i Dysk Google. Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.