Directory API: Kunden verwalten

Mit 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

Wenn Sie einen vorhandenen Kunden abrufen möchten, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, das unter Anfragen autorisieren beschrieben ist. 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. Neben dem Statuscode enthält die JSON-Antwort die Informationen zum 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"
}

Vorhandenen Kunden aktualisieren

Wenn du einen vorhandenen Kunden aktualisieren möchtest, verwende die folgende PUT-HTTP-Anfrage und füge das Autorisierungstoken ein, das unter Anfragen autorisieren beschrieben wird. 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

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. Neben dem Statuscode enthält die JSON-Antwort die neu aktualisierten Kundeninformationen:

{
  "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. Neben dem Statuscode enthält die JSON-Antwort die Informationen zum 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: Du musst den eindeutigen customerId-Wert des Kunden mit der unter Kunden abrufen beschriebenen HTTP-Anfrage abrufen. Dieser Wert bleibt auch nach der Änderung des primären Domainnamens unverändert.

Wenn Sie die primäre Domain eines Kunden ändern möchten, verwenden Sie die folgende PUT-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, das unter Anfragen autorisieren beschrieben ist. 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 customerDomain-Wert 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. Neben dem Statuscode enthält die JSON-Antwort die Informationen zum 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"
}