En este instructivo, se muestra cómo trabajar con datos de la cuenta. API de My Business Account Management te permite hacer lo siguiente:
- Enumera todas las cuentas.
- Devolver una cuenta específica
- Actualiza una cuenta.
Antes de comenzar
Antes de usar la API de My Business Account Management, debes registrar tu solicitud y obtener credenciales de OAuth 2.0.
Para obtener información detallada sobre cómo comenzar a usar las APIs del Perfil de Negocio, consulta Configuración básica:
Enumerar todas las cuentas
Una buena forma de validar las cuentas asociadas con un usuario autenticado es
enumerar todas sus cuentas. Usa la accounts.list
.
para mostrar una lista de todas las cuentas asociadas con un usuario.
Para ver una lista de todas las cuentas de un usuario autenticado, usa lo siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Cómo devolver una cuenta específica
A veces, solo deseas ver información sobre una cuenta específica de un
usuario autenticado. Usa la accounts.get
.
para devolver una cuenta específica y revisar los detalles adicionales de la cuenta.
Para mostrar una cuenta específica por nombre, usa lo siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Actualizar una cuenta
Cambiar el nombre de una cuenta es una tarea administrativa fundamental. Usa el
accounts.update
API para modificar
el nombre de la cuenta.
Para actualizar una cuenta específica por nombre, usa lo siguiente:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
Restricciones
- El único campo editable de una cuenta es
accountName
. Cualquier otro campo se ignorarán. - Solo las cuentas de tipo
BUSINESS
se pueden actualizar de esta manera.