Kontoinformationen eines Kunden abrufen und aktualisieren

Wenn Sie die Informationen eines Kunden mit der Reseller API abrufen und aktualisieren möchten, können Sie einen Kunden auf zwei Arten 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 nur minimale Kundenkontoinformationen zurück: Wenn in der Antwort nur customerId, customerDomain und customerType zurückgegeben werden, wird der Kunde von Google oder einem anderen Reseller verwaltet. Sie können keinen weiteren Kunden mit bestätigter E-Mail-Adresse für ihn erstellen. So verwalten Sie diesen Kunden:

  1. Alle übertragbaren Abos für den Kunden abrufen, um die Übertragbarkeit und die Mindestanzahl an Nutzerlizenzen zu ermitteln.
  2. Abo übertragen.

• Rückgabe Multiple teams exist on this domain: 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 erstellen möchten, bitten Sie ihn, ein Direktabo zu erwerben und seine Domain zu bestätigen und dann das Abo 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 Datensätze alte Kundendaten mit einer Abweichung zwischen dem primären Domainnamen und der eindeutigen Google-Kunden-ID enthalten. Wenn ein gelöschtes Konto reaktiviert wird, wird es als neues Konto mit einer neuen customerId behandelt.
  2. Ein neues Kundenkonto bestellen
  3. Erstellen Sie ein Abo für das neue Kundenkonto.

Einstellungen eines Kunden aktualisieren

Mit der Reseller API können Sie customerType nicht aktualisieren, aber Sie können die Domain eines team-Kunden bestätigen, um ein domain-Kunde zu 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 des Kunden, z. B. example.com.
• NAME: Der Name des Kunden, z. B. Alex Cruz.
• ORGANIZATION_NAME: Der Name der Organisation des Kunden, z. B. Example Organization.
• POSTAL_CODE: Die Postleitzahl des Kunden, z. B. 94043.
• COUNTRY_CODE: Der zweistellige ISO-Ländercode des 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"
}