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:

• 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.