Kontoinformationen eines Kunden abrufen und aktualisieren

Wenn Sie Kundendaten mithilfe der Reseller API abrufen und aktualisieren möchten, haben Sie zwei Möglichkeiten:

• Die eindeutige Kennung des Kunden, z. B. C0123456
• Domainname des Kunden, z. B. example.com

Kontoinformationen eines Kunden abrufen

Verwenden Sie die folgende GET-Anfrage und fügen Sie das Autorisierungstoken ein, um die Kontoinformationen eines Kunden abzurufen:

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

Ersetzen Sie CUSTOMER_ID durch die eindeutige ID oder den Domainnamen Ihres Kunden.

Antwort wird zurückgegeben

Wenn Sie die Kontoinformationen eines Kunden abrufen, erhalten Sie möglicherweise eine der folgenden Antworten:

• Gibt die vollständigen Kundeneinstellungen zurück. Die Kundschaft ist eine Ihrer Bestandskundinnen und -kunden. Mit der Reseller API können Sie die Konto- und Aboeinstellungen dieses Kunden verwalten.

• Gibt die minimalen Kundenkontoinformationen zurück. Wenn in der Antwort nur customerId, customerDomain und customerType zurückgegeben werden, verwaltet entweder Google oder ein anderer Reseller den Kunden. Sie können keinen weiteren Kunden mit E-Mail-Bestätigung für diesen Kunden erstellen. So verwalten Sie diesen Kunden:

  1. Rufen Sie alle übertragbaren Abos für den Kunden ab, um zu prüfen, ob das Abo übertragen werden kann und wie viele Nutzerlizenzen für die Übertragung mindestens erforderlich sind.
  2. Übertragen Sie das Abo.

• Gibt Multiple teams exist on this domain zurück. Dieser Domain ist ein oder mehrere Teamkunden zugeordnet. So fügen Sie dieser Domain ein weiteres Team hinzu:

  1. Bestellen Sie ein Kundenkonto.
  2. Bitten Sie den Kunden, ein direktes Abo über Google zu kaufen, seine Domain zu bestätigen, vorhandene Teams zu übernehmen und das Abo auf Ihr Konto zu übertragen, um einen Kunden mit Domainbestätigung für die Domain zu erstellen.

• Gibt den HTTP-Fehler 404 zurück. Der Kunde ist neu bei Google und hat kein Konto. So verwalten Sie diesen Kunden:

  1. Achten Sie darauf, dass Ihre Kundendaten keine alten Kundendaten mit einer potenziellen Abweichung des primären Domainnamens eines Kunden und der eindeutigen Google-Kunden-ID enthalten. Wenn ein zuvor gelöschtes Google-Konto wiederhergestellt wird, wird es als neues Konto behandelt und erhält einen neuen customerId-Wert, auch wenn das Konto möglicherweise denselben customerDomain-Wert behält.
  2. Bestellen Sie ein neues Kundenkonto.
  3. Erstellen Sie ein Abo für dieses neue Kundenkonto.

Einstellungen eines Kunden aktualisieren

Mit der Reseller API können Sie die customerType nicht aktualisieren, aber Sie können die Domain eines team-Kunden bestätigen und ein domain-Kunde werden.

Verwenden Sie die folgende PUT-Anfrage und geben Sie die eindeutige Kennung für den Kunden an, um die Einstellungen eines Kunden zu aktualisieren:

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

Im JSON-Anfragetext werden die folgenden benutzerdefinierten Einstellungen aktualisiert:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Ersetzen Sie Folgendes:

• DOMAIN_NAME: die Domain Ihres Kunden, z. B. example.com
• NAME: der Name Ihres Kunden, z. B. Alex Cruz
• ORGANIZATION_NAME: der Organisationsname Ihres Kunden, z. B. Example Organization.
• POSTAL_CODE: die Postleitzahl des Kunden, z. B. 94043
• COUNTRY_CODE: Der zweistellige ISO-Ländercode Ihres Kunden.
• EMAIL_ADDRESS: die E-Mail-Adresse Ihres Kunden, z. B. [e-mail]

Bei einer erfolgreichen JSON-Antwort werden der HTTP-Statuscode 200 und die aktualisierten Kundeneinstellungen zurückgegeben:

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