Trabalhar com dados da conta

Neste tutorial, mostramos como trabalhar com os dados da conta. Com a API My Business Account Management, você pode fazer o seguinte:

  • Exibir todas as contas
  • Retornar uma conta específica
  • Atualizar uma conta

Antes de começar

Antes de usar a API My Business Account Management, é necessário registrar seu app e receber as credenciais do OAuth 2.0.

Para saber como começar a usar as APIs do Perfil da Empresa, consulte Configuração básica.

Exibir todas as contas

Uma ótima maneira de validar as contas associadas a um usuário autenticado é exibindo todas as contas dele. Use a API accounts.list para ver todas as contas associadas a um usuário.

Para isso, você pode utilizar o código abaixo:

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

Retornar uma conta específica

Talvez você queira só ver informações sobre uma conta específica de um usuário autenticado. Nesse caso, use a API accounts.get para retornar uma determinada conta e revisar detalhes adicionais dela.

Para isso, você pode utilizar o código abaixo:

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

Atualizar uma conta

Alterar o nome de uma conta é uma tarefa administrativa fundamental. Use a API accounts.update para atribuir um novo nome.

Para isso, você pode utilizar o código abaixo:

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

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

Restrições

  • O único campo editável de uma conta é accountName. Alterações em quaisquer outros campos serão ignoradas.
  • Apenas contas do tipo BUSINESS podem ser atualizadas dessa forma.