Cómo trabajar con datos de la cuenta

En este instructivo, se muestra cómo trabajar con datos de la cuenta. La API de My Business Account Management te permite hacer lo siguiente:

• Genera una lista de todas las cuentas.
• Devuelve una cuenta específica.
• Actualiza una cuenta.

Antes de comenzar

Antes de utilizar la API de My Business Account Management, debes registrar tu aplicación y obtener las credenciales de OAuth 2.0.

Si deseas obtener detalles para comenzar a usar las APIs del Perfil de Negocio, consulta Configuración básica.

Enumerar todas las cuentas

Una excelente manera de validar las cuentas asociadas con un usuario autenticado es hacer una lista de todas sus cuentas. Usa la API de accounts.list para enumerar todas las cuentas asociadas con un usuario.

Para ver una lista de todas las cuentas de un usuario autenticado, usa lo siguiente:

HTTP

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

Cómo devolver una cuenta específica

A veces, solo quieres ver información sobre una cuenta específica de un usuario autenticado. Usa la API de accounts.get para mostrar una cuenta específica y revisar los detalles adicionales de la cuenta.

Para devolver una cuenta específica por nombre, usa lo siguiente:

HTTP

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

Actualizar una cuenta

Cambiar el nombre de una cuenta es una tarea administrativa fundamental. Usa la API de accounts.update para modificar el nombre de la cuenta.

Para actualizar una cuenta específica por nombre, usa lo siguiente:

HTTP

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

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

Restricciones

• El único campo que se puede modificar de una cuenta es accountName. Se ignorará cualquier otro campo que se pase.
• Solo se pueden actualizar las cuentas de tipo BUSINESS de esta manera.