Cómo trabajar con los datos de la cuenta

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

  • Muestra una lista de todas las cuentas.
  • Devuelve una cuenta específica.
  • Actualizar una cuenta

Antes de comenzar

Antes de usar la API de Mi Negocio Account Management, debes registrar tu aplicación y obtener credenciales de OAuth 2.0.

Para obtener detalles sobre cómo comenzar a usar las APIs de Perfil de Negocio, consulta Configuración básica.

Cómo mostrar todas las cuentas

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

Para enumerar todas las cuentas de un usuario autenticado, usa lo siguiente:

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

Cómo mostrar una cuenta específica

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

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

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

Cómo actualizar una cuenta

Cambiar el nombre de una cuenta es una tarea administrativa fundamental. Usa la API de accounts.update para alterar 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 editable de una cuenta es accountName. Se ignoran todos los demás campos que se pasen.
  • Solo se pueden actualizar de esta manera las cuentas de tipo BUSINESS.