Trabalhar com dados da conta

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.