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 de nome em quaisquer outros campos serão ignoradas.
• Apenas contas do tipo BUSINESS podem ser atualizadas dessa forma.