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:
$ 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:
$ 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:
$ 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.