Kontoinformationen eines Kunden abrufen und aktualisieren

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

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

Kontoinformationen eines Kunden abrufen

Wenn du die Kontoinformationen eines Kunden abrufen möchtest, verwende die folgende GET-Anfrage und füge das Autorisierungstoken ein:

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

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

Antwortrückgaben

Wenn du die Kontoinformationen eines Kunden abrufen möchtest, erhältst du möglicherweise eine der folgenden Antworten:

• Gibt die vollständigen Kundeneinstellungen zurück. Der Kunde ist einer Ihrer Bestandskunden. Mit der Reseller API kannst du das Konto und die Aboeinstellungen dieses Kunden verwalten.

• Gibt die minimalen Informationen zum Kundenkonto 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 E-Mail-Bestätigung für den Kunden erstellen. So verwalten Sie diesen Kunden:

  1. Hole alle übertragbaren Abos für den Kunden ab, um herauszufinden, ob das Abo übertragen werden kann und wie viele Nutzerplätze für die Übertragung erforderlich sind.
  2. Übertragen Sie das Abo.

• Gibt Multiple teams exist on this domain zurück. Diese Domain ist mit mindestens einem Teamkunden verknüpft. So fügen Sie dieser Domain ein weiteres Team hinzu:

  1. Bestellen Sie ein Kundenkonto.
  2. Wenn Sie einen domainbestätigten Kunden für die Domain erstellen möchten, bitten Sie den Kunden, ein direktes Abo über Google zu erwerben und seine Domain zu bestätigen sowie bestehende Teams zu übernehmen und dann das Abo auf Ihr Konto zu übertragen.

• 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 Kundendatensätze keine alten Kundendaten enthalten, bei denen der primäre Domainname eines Kunden nicht mit der eindeutigen Google-Kundennummer übereinstimmt. Wenn ein zuvor gelöschtes Google-Konto reaktiviert wird, wird es als neues Konto behandelt und hat einen neuen customerId-Wert, auch wenn das Konto möglicherweise denselben customerDomain-Wert beibehält.
  2. Bestellen Sie ein neues Kundenkonto.
  3. Erstelle ein Abo für dieses neue Kundenkonto.

Einstellungen eines Kunden aktualisieren

Mit der Reseller API kannst du die customerType nicht aktualisieren, aber die Domain eines team-Kunden bestätigen und domain-Kunde werden.

Wenn du die Einstellungen eines Kunden aktualisieren möchtest, verwende die folgende PUT-Anfrage und gib die eindeutige Kennung für deinen Kunden an:

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 Ihres Kunden, z. B. example.com
• NAME: Der Name deines 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 des Kunden.
• EMAIL_ADDRESS: die E-Mail-Adresse deines 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"
}