Pobieranie i aktualizowanie informacji o koncie klienta

Aby pobrać i zaktualizować informacje o kliencie za pomocą interfejsu Reseller API, możesz wyszukać klienta na 2 sposoby:

  • Unikalny identyfikator klienta, np. C0123456
  • Nazwa domeny klienta, np. 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 symbol CUSTOMER_ID unikalnym identyfikatorem lub nazwą domeny klienta.

Zwracanie odpowiedzi

Gdy pobierzesz informacje o koncie klienta, możesz otrzymać jedną z tych odpowiedzi:

  • Zwraca pełne ustawienia klienta. Klient jest jednym z Twoich obecnych klientów. Za pomocą interfejsu Reseller API możesz zarządzać ustawieniami konta i subskrypcji tego klienta.

  • Zwraca minimalne informacje o koncie klienta. Jeśli odpowiedź zawiera tylko customerId, customerDomain i customerType, oznacza to, że klientem zarządza Google lub inny sprzedawca. Nie możesz utworzyć kolejnego klienta zweryfikowanego za pomocą adresu e-mail. Aby zarządzać tym klientem, wykonaj te czynności:

    1. Pobierz wszystkie usługi, które można przenieść na konto klienta, aby sprawdzić, czy można przenieść subskrypcję, oraz minimalną liczbę stanowisk użytkowników potrzebną do przeniesienia.
    2. Przenieś subskrypcję.

  • ZwrotyMultiple teams exist on this domain Z tą domeną jest powiązanych co najmniej 1 klient reprezentujący zespół. Aby dodać do tej domeny kolejny zespół, wykonaj te czynności:

    1. Zamów konto klienta.
    2. Aby utworzyć klienta weryfikowanego za pomocą domeny, poproś klienta o zakup subskrypcji bezpośrednio w Google i zweryfikowanie 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. Sprawdź, czy w rekordach klientów nie ma starych danych klientów, w przypadku których może wystąpić niezgodność między podstawową nazwą domeny klienta a unikalnym identyfikatorem klienta Google. Gdy wcześniej usunięte konto Google zostanie przywrócone, jest traktowane jako nowe konto i ma nową wartość customerId, mimo że może zachować tę samą wartość customerDomain.
    2. Zamówienie nowego konta klienta
    3. Utwórz subskrypcję na tym nowym koncie klienta.

Aktualizowanie ustawień klienta

Za pomocą interfejsu Reseller 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 uwzględnij unikalny identyfikator klienta:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Treść żądania w formacie 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 klienta, np. example.com
  • NAME: imię i nazwisko klienta, np. Alex Cruz.
  • ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
  • POSTAL_CODE: kod pocztowy klienta, np. 94043.
  • COUNTRY_CODE: 2-znakowy kod kraju klienta zgodny z normą ISO.
  • EMAIL_ADDRESS: adres e-mail klienta, np. cruz@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"
}