Directory API: Kunden verwalten

Mithilfe der Directory API können Sie Ihre 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. Die customerKey kann die eindeutige customerId oder my_customer sein, um den aktuellen Kunden anzugeben.

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

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. 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"
}

Bestandskunden aktualisieren

Verwenden Sie die folgende PUT-HTTP-Anfrage und fügen Sie das unter Anfragen autorisieren beschriebene Autorisierungstoken ein, um einen vorhandenen Kunden zu aktualisieren. Bei customerKey kann es sich um die eindeutige Kunden-ID des Kunden handeln oder um my_customer, um den aktuellen Kunden anzugeben.

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

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. Zusammen mit dem Statuscode enthält die JSON-Antwort die aktualisierten Kundendaten:

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

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. 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 wird. Dieser Wert bleibt auch nach der Änderung des primären Domainnamens einheitlich.

Verwenden Sie zum Ändern der primären Domain eines Kunden die folgende PUT-HTTP-Anfrage und fügen Sie das unter Anfragen autorisieren beschriebene Autorisierungstoken ein. Die customerKey muss die eindeutige customerId 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]"
  }
}

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. 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"
}