Neste tutorial, mostramos como trabalhar com os dados da conta. Com a API My Business Account Management, você pode fazer o seguinte:
- Listar todas as contas.
- Retorne 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.
Se quiser saber como começar a usar as APIs do Perfil da Empresa, consulte Configuração básica.
Listar todas as contas
Uma ótima maneira de validar as contas associadas a um usuário autenticado é
listar todas as contas dele. Use a API accounts.list
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 apenas as informações sobre uma conta específica de um
usuário autenticado. Use a API accounts.get
para retornar uma conta específica e analisar outros detalhes.
Para retornar uma conta específica pelo nome, 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 a API accounts.update
para alterar 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
. Todos os outros campos transmitidos são ignorados. - Somente contas do tipo
BUSINESS
podem ser atualizadas dessa forma.