Pobieranie i aktualizowanie informacji o koncie klienta

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 i customerType, 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:

  1. 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ść.
  2. 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:

  1. Zamów konto klienta.
  2. 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:

  1. 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.
  2. Zamów nowe konto klienta.
  3. Utwórz subskrypcję dla tego nowego konta klienta.

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ład example.com
• NAME: nazwa klienta, na przykład Alex Cruz.
• ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
• POSTAL_CODE: kod pocztowy Twojego klienta, na przykład 94043.
• COUNTRY_CODE: kod ISO kraju klienta składający się z 2 znaków.
• EMAIL_ADDRESS: adres e-mail klienta – na przykład [e-mail].

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"
}