Cómo trabajar con datos de la cuenta

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:

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

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

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. Cualquier otro campo se ignorarán.
  • Solo las cuentas de tipo BUSINESS se pueden actualizar de esta manera.