Trabajar con datos de la cuenta

En este tutorial se explica cómo utilizar datos de cuentas. La API My Business Account Management te permite hacer lo siguiente:

  • Obtener una lista con todas las cuentas
  • Hacer una consulta que devuelva una cuenta específica
  • Actualizar una cuenta

Antes de empezar

Para usar la API My Business Account Management, necesitas registrar tu aplicación y obtener credenciales de OAuth 2.0.

Para saber cómo empezar a usar las APIs de Perfil de Empresa, consulta el artículo Configuración básica.

Obtener una lista con todas las cuentas

Una forma eficaz de validar las cuentas asociadas a un usuario autenticado es obtener una lista con todas sus cuentas. Obtenla mediante la API accounts.list.

Para obtener una lista con todas las cuentas de un usuario autenticado, utiliza el código siguiente:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Devolver una cuenta específica

Hay situaciones en las que solo quieres ver información sobre una cuenta específica de un usuario autenticado. Utiliza la API accounts.get para que devuelva una cuenta específica y puedas consultar detalles adicionales de dicha cuenta.

Para consultar una cuenta específica por nombre, utiliza el código siguiente:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Actualizar una cuenta

Cambiar nombres de cuentas es una tarea básica de gestión. Para hacerlo, usa la API accounts.update.

Para actualizar una cuenta específica por nombre, utiliza el código siguiente:

HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

Restricciones

  • El único campo cuyo valor se puede editar en una cuenta es accountName. Si se envían valores de otros campos, se ignorarán.
  • Las únicas cuentas que se pueden actualizar de esta manera son las de tipo BUSINESS.