Neste tutorial, mostramos como trabalhar com os dados da conta. API My Business Account Management oferece a capacidade de fazer o seguinte:
- Listar todas as contas.
- retornar uma conta específica;
- Atualizar uma conta.
Antes de começar
Antes de usar a API My Business Account Management, você precisa registrar seu aplicativo 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.
Mostrar todas as contas
Uma ótima maneira de validar as contas associadas a um usuário autenticado é
listar todas as contas dele. Usar o accounts.list
API para listar todas as contas associadas a um usuário.
Para listar todas as contas de um usuário autenticado, use o seguinte:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Retornar uma conta específica
Às vezes, você quer ver apenas informações sobre uma conta específica para um
usuário autenticado. Usar o accounts.get
API para retornar uma conta específica e analisar detalhes adicionais da conta.
Para isso, use o código abaixo:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Atualizar uma conta
Alterar o nome de uma conta é uma tarefa administrativa fundamental. Use o
API accounts.update
a ser alterada
o nome da conta.
Para atualizar uma conta específica pelo nome, use o seguinte:
$ 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
. Outros campos passados são ignorados. - Apenas contas do tipo
BUSINESS
podem ser atualizadas dessa forma.