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 Kunden-ID, 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 Kunden-ID oder den Domainnamen des Kunden.

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 bestehenden Kunden. Mit der Reseller API können Sie die Konto- und Aboeinstellungen dieses Kunden verwalten.

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

  1. Rufen Sie alle übertragbaren Abos für den Kunden ab , um die Übertragbarkeit und die Mindestanzahl an Nutzerlizenzen zu ermitteln.
  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. Wenn Sie einen Kunden mit bestätigter Domain erstellen möchten, bitten Sie den Kunden, ein Direktabo zu erwerben und seine Domain zu bestätigen, übertragen Sie dann das Abo.

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

  1. Prüfen Sie, ob Ihre Aufzeichnungen alte Kundendaten mit einer Diskrepanz zwischen dem primären Domainnamen und der eindeutigen Google-Kunden-ID enthalten. Wenn ein gelöschtes Konto wiederhergestellt wird, wird es als neues Konto mit einer neuen customerId behandelt.
  2. Bestellen Sie ein neues Kundenkonto.
  3. Erstellen Sie ein Abo für das neue Kundenkonto.

Einstellungen eines Kunden aktualisieren

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

Verwenden Sie die folgende PUT-Anfrage und fügen Sie die eindeutige ID für Ihren Kunden ein, um die Einstellungen eines Kunden zu aktualisieren:

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

Im 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 aus zwei Buchstaben bestehende ISO-Ländercode des Kunden.
• EMAIL_ADDRESS: Die E-Mail-Adresse des Kunden, z. B. [e-mail].

Eine erfolgreiche JSON-Antwort gibt den HTTP-Statuscode 200 und die aktualisierten Kundeneinstellungen zurück:

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