Pobieranie i aktualizowanie informacji o koncie klienta

Aby pobrać i zaktualizować informacje o kliencie za pomocą interfejsu Reseller API, możesz skorzystać z jednego z tych 2 sposobów:

• 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 dodaj token autoryzacji:

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

Zastąp CUSTOMER_ID unikalnym identyfikatorem lub nazwą domeny klienta.

Zwracanie odpowiedzi

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

• Zwraca pełne ustawienia klienta. Klient jest jednym z Twoich dotychczasowych 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 wartości customerId, customerDomain i customerType, klientem zarządza Google lub inny sprzedawca. Nie możesz utworzyć dla tego klienta kolejnego konta zweryfikowanego za pomocą adresu e-mail. Aby zarządzać tym klientem:

  1. Pobierz wszystkie subskrypcje, które można przenieść, aby dowiedzieć się, czy subskrypcję można przenieść, oraz jaka jest minimalna liczba miejsc dla użytkowników w ramach przeniesienia.
  2. Przenieś subskrypcję.

• Zwraca Multiple teams exist on this domain. Z tą domeną powiązanych jest co najmniej 1 klient reprezentujący zespół. Aby dodać do tej domeny inny zespół:

  1. Zamawianie konta klienta
  2. Aby utworzyć klienta weryfikowanego za pomocą domeny, poproś go o kupienie subskrypcji bezpośrednio w Google i zweryfikowanie swojej domeny, przejęcie istniejących zespołów, a następnie przeniesienie subskrypcji na swoje konto.

• Zwraca błąd HTTP 404. Klient jest nowym użytkownikiem Google i nie ma konta. Aby zarządzać tym klientem, wykonaj te czynności:

  1. Sprawdź, czy rekordy klientów nie zawierają starych danych klientów z potencjalnym niezgodnym z identyfikatorem klienta Google dopasowaniem nazwy domeny podstawowej klienta do jego unikalnego identyfikatora. Gdy wcześniej usunięte konto Google zostanie przywrócone, zostanie potraktowane jako nowe konto i będzie mieć nową wartość customerId, nawet jeśli konto może zachować tę samą wartość customerDomain.
  2. Zamawianie nowego konta klienta.
  3. Utwórz subskrypcję dla tego nowego konta klienta.

Aktualizowanie ustawień klienta

Za pomocą interfejsu Reseller API nie możesz zaktualizować customerType, ale możesz zweryfikować domenę klienta team i stać się klientem domain.

Aby zaktualizować ustawienia klienta, użyj tej PUTprośby i uwzględnij unikalny identyfikator klienta:

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 klienta, np. example.com
• NAME: nazwa klienta, np. Alex Cruz.
• ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
• POSTAL_CODE: kod pocztowy klienta, np. 94043.
• COUNTRY_CODE: 2-znakowy kod ISO kraju klienta.
• EMAIL_ADDRESS: adres e-mail klienta, na przykład [e-mail].

Pomyślna odpowiedź w formacie JSON zwraca kod stanu HTTP 200 oraz 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"
}