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.

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 per E-Mail bestätigten Kunden 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: Diese Domain ist mit einem oder mehreren Teamkunden verknüpft. So fügen Sie dieser Domain ein weiteres Team hinzu:

  1. Bestellen Sie ein Kundenkonto.
  2. Wenn Sie einen per Domain bestätigten Kunden 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, damit er zu einem domain-Kunden wird.

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

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