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": "marty.mcfly@gmail.com",
"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": "marty.mcfly@gmail.com",
"customerDomain": "amatchmadeinspace.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
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": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "amatchmadeinspace.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}
Primären Domainnamen eines Kunden ändern
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": "marty.mcfly@gmail.com",
"customerDomain": "fluxcapacitor.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
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": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "fluxcapacitor.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}