Aby pobrać i zaktualizować informacje o kliencie przy użyciu interfejsu Seller API, możesz wyszukać klienta na dwa sposoby:
- Unikalny identyfikator klienta, np.
C0123456
- Nazwa domeny klienta – na przykład
example.com
Pobieranie informacji o koncie klienta
Aby pobrać informacje o koncie klienta, użyj tego żądania GET
i dołącz token autoryzacji:
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID
Zastąp CUSTOMER_ID
unikalnym identyfikatorem klienta lub nazwą domeny.
Zwrot odpowiedzi
Po pobraniu informacji o koncie klienta możesz zobaczyć jedną z tych odpowiedzi:
Zwraca pełne ustawienia klienta. Klient jest jednym z Twoich obecnych klientów. Za pomocą interfejsu Seller API możesz zarządzać ustawieniami konta i subskrypcji tego klienta.
Zwraca minimum informacji o koncie klienta. Jeśli w odpowiedzi zwracane są tylko wartości
customerId
,customerDomain
icustomerType
, klientem zarządza Google lub inny sprzedawca. Nie możesz utworzyć dla tego klienta kolejnego klienta ze zweryfikowanym adresem e-mail. Aby zarządzać tym klientem, wykonaj te czynności:- Pobierz wszystkie subskrypcje klienta, które można przenieść, aby dowiedzieć się, czy można przenieść subskrypcję, oraz jaka jest minimalna liczba stanowisk użytkowników, które można przenieść.
- Przeniesienie subskrypcji
Zwraca
Multiple teams exist on this domain
. Z tą domeną jest powiązanych co najmniej 1 klienta reprezentującego zespół. Aby dodać do tej domeny kolejny zespół, wykonaj te czynności:- Zamów konto klienta.
- Aby utworzyć dla klienta weryfikowanego za pomocą domeny, poproś klienta o zakup subskrypcji bezpośredniej w Google i potwierdzenie własności domeny, przejęcie istniejących zespołów, a następnie przeniesienie subskrypcji na Twoje konto.
Zwraca błąd HTTP
404
. Klient jest nowy w Google i nie ma konta. Aby zarządzać tym klientem, wykonaj te czynności:- Upewnij się, że rekordy klientów nie przechowują starych danych klientów, które mogą nie pasować do nazwy domeny podstawowej klienta i unikalnego identyfikatora klienta Google. Przywrócenie usuniętego wcześniej konta Google jest traktowane jak nowe konto i ma nową wartość
customerId
, mimo że może zachować tę samą wartośćcustomerDomain
. - Zamów nowe konto klienta.
- Utwórz subskrypcję dla tego nowego konta klienta.
- Upewnij się, że rekordy klientów nie przechowują starych danych klientów, które mogą nie pasować do nazwy domeny podstawowej klienta i unikalnego identyfikatora klienta Google. Przywrócenie usuniętego wcześniej konta Google jest traktowane jak nowe konto i ma nową wartość
Aktualizowanie ustawień klienta
Za pomocą interfejsu Seller API nie możesz zaktualizować customerType
, ale możesz zweryfikować domenę klienta team
i zostać klientem domain
.
Aby zaktualizować ustawienia klienta, użyj tego żądania PUT
i podaj jego unikalny identyfikator:
PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID
Treść żądania JSON aktualizuje te ustawienia klienta:
{ "customerId": "C0CUSTOMER_ID123456", "customerDomain": "DOMAIN_NAME", "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
Zastąp następujące elementy:
DOMAIN_NAME
: domena Twojego klienta, na przykładexample.com
NAME
: nazwa klienta, na przykładAlex Cruz
.ORGANIZATION_NAME
: nazwa organizacji klienta, np.Example Organization
.POSTAL_CODE
: kod pocztowy Twojego klienta, na przykład94043
.COUNTRY_CODE
: kod ISO kraju klienta składający się z 2 znaków.EMAIL_ADDRESS
: adres e-mail klienta – na przykładcruz@example.com
.
Pomyślna odpowiedź JSON zwraca kod stanu HTTP 200
i zaktualizowane ustawienia klienta:
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME", "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }