Directory API: Kunden verwalten

Mit der Directory API können Sie Kunden programmatisch verwalten. Mit den Methoden in dieser API können Sie die Kontaktdaten in Ihrer G Suite-Domain aktualisieren und die primäre Domain für Ihre Instanz ändern.

Kunden abrufen

Verwenden Sie zum Abrufen eines vorhandenen Kunden die folgende GET-HTTP-Anfrage und fügen Sie das unter Anfragen autorisieren beschriebene Autorisierungstoken ein. customerKey kann die eindeutige Kunden-ID oder my_customer sein, um den aktuellen Kunden anzugeben.

GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Eine erfolgreiche Antwort gibt den Statuscode HTTP 200 zurück. Zusammen mit dem Statuscode enthält die JSON-Antwort die Informationen des Kunden:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Bestehenden Kunden aktualisieren

Verwenden Sie zum Aktualisieren eines vorhandenen Kunden die folgende PUT-HTTP-Anfrage und fügen Sie das unter Anfragen autorisieren beschriebene Autorisierungstoken hinzu. Die customerKey kann die eindeutige Kunden-ID des Kunden oder my_customer sein, um den aktuellen Kunden anzugeben.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Eine erfolgreiche Antwort gibt den Statuscode HTTP 200 zurück. Zusammen mit dem Statuscode enthält die JSON-Antwort die neu aktualisierten Kundendaten:

{
  "alternateEmail": "[e-mail]",
  "customerDomain": "amatchmadeinspace.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  }
}

Eine erfolgreiche Antwort gibt den Statuscode HTTP 200 zurück. Zusammen mit dem Statuscode enthält die JSON-Antwort die Informationen des Kunden:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Primären Domainnamen eines Kunden ändern

Hinweis: Sie müssen den eindeutigen customerId-Wert des Kunden mithilfe der HTTP-Anfrage abrufen, die unter Kunden abrufen beschrieben ist. Dieser Wert bleibt auch nach der Änderung des primären Domainnamens konsistent.

Wenn Sie die primäre Domain eines Kunden ändern möchten, verwenden Sie die folgende PUT-HTTP-Anfrage und fügen Sie das unter Anfragen autorisieren beschriebene Autorisierungstoken hinzu. Die customerKey muss die eindeutige Kunden-ID oder my_customer sein.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Der JSON-Anfragetext muss den neuen Wert customerDomain enthalten:

{
  "alternateEmail": "[e-mail]",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  }
}

Eine erfolgreiche Antwort gibt den Statuscode HTTP 200 zurück. Zusammen mit dem Statuscode enthält die JSON-Antwort die Informationen des Kunden:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "fluxcapacitor.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}