API de Directory: Administra clientes

Puedes usar la API de Directory para administrar a tus clientes de manera programática. Los métodos de esta API te permiten actualizar la información de contacto de tu dominio de Google Workspace, así como cambiar el dominio principal de tu instancia.

Recupera un cliente

Para recuperar un cliente existente, utiliza la siguiente solicitud HTTP GET e incluye el token de autorización que se describe en Autorizar solicitudes. El customerKey puede ser el customerId único o my_customer para indicar el cliente actual.

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

Una respuesta correcta devuelve un código de estado HTTP 200. Junto con el código de estado, la respuesta JSON incluye la información del cliente:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Actualiza un cliente existente

Para actualizar un cliente existente, usa la siguiente solicitud PUT e incluye el token de autorización que se describe en Autorizar solicitudes. El customerKey puede ser el customerId único del cliente o my_customer para indicar el cliente actual.

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

Una respuesta correcta devuelve un código de estado HTTP 200. Junto con el código de estado, la respuesta JSON incluye la información del cliente recién actualizada:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Cambia el nombre de dominio principal de un cliente

Para cambiar el dominio principal de un cliente, usa la siguiente solicitud PUT e incluye el token de autorización que se describe en Autorizar solicitudes. El customerKey debe ser el customerId o my_customer único.

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

El cuerpo de la solicitud en formato JSON debe incluir el nuevo valor de customerDomain:

{
  "alternateEmail": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}