Kontoinformationen eines Kunden abrufen und aktualisieren

Wenn Sie die Informationen eines Kunden mit der Reseller API abrufen und aktualisieren möchten, haben Sie zwei Möglichkeiten, den Kunden zu suchen:

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

Kontoinformationen eines Kunden abrufen

Wenn Sie die Kontoinformationen eines Kunden abrufen möchten, verwenden Sie die folgende GET-Anfrage und fügen Sie das Autorisierungstoken ein:

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

Ersetzen Sie CUSTOMER_ID durch die eindeutige Kennung oder den Domainnamen des Kunden.

Rückgabe von Antworten

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

• Gibt die vollständigen Kundeneinstellungen zurück. Der Kunde ist einer Ihrer Bestandskunden. Mit der Reseller API können Sie die Konto- und Abonnementeinstellungen dieses Kunden verwalten.

• Gibt die minimalen Kundenkontoinformationen zurück. Wenn in der Antwort nur customerId, customerDomain und customerType zurückgegeben werden, wird der Kunde entweder von Google oder einem anderen Reseller verwaltet. Sie können keinen weiteren Kunden mit bestätigter E-Mail-Adresse für den Kunden erstellen. So verwaltest du diesen Kunden:

  1. Alle übertragbaren Abos für den Kunden abrufen, um festzustellen, ob das Abo übertragen werden kann und wie viele Nutzerlizenzen für die Übertragung mindestens erforderlich sind.
  2. Abo übertragen

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

  1. Kundenkonto bestellen
  2. Wenn Sie einen Kunden mit bestätigter Domain für die Domain erstellen möchten, bitten Sie den Kunden, ein Direktabo über Google zu kaufen und seine Domain zu bestätigen und vorhandene Teams zu übernehmen und dann das Abo auf Ihr Konto zu übertragen.

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

  1. Prüfen Sie, ob Ihre Kundendatensätze alte Kundendaten enthalten, bei denen es zu einer potenziellen Diskrepanz zwischen dem primären Domainnamen eines Kunden und der eindeutigen Google-Kundenkennung kommen kann. Wenn ein zuvor gelöschtes Google-Konto reaktiviert wird, wird es als neues Konto behandelt und hat einen neuen customerId-Wert, auch wenn der customerDomain-Wert des Kontos gleich bleibt.
  2. Ein neues Kundenkonto bestellen
  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, um die Einstellungen eines Kunden zu aktualisieren, und geben Sie die eindeutige Kennung für Ihren Kunden an:

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

Mit dem JSON-Anfragetext werden die folgenden Kundeneinstellungen 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 des Kunden, z. B. Alex Cruz.
• ORGANIZATION_NAME: Der Name der Organisation 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 des Kunden, z. B. [e-mail].

Bei einer erfolgreichen JSON-Antwort wird 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"
}