Method: accounts.list

Lista todas as contas do usuário autenticado. Isso inclui todas as contas do usuário e todas as contas em que o usuário tem direitos de gerenciamento.

Solicitação HTTP

GET https://mybusiness.googleapis.com/v4/accounts

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
pageSize

integer

Quantas contas precisam ser buscadas por página. O padrão é 20, o mínimo é 2, e o tamanho máximo da página é 20.

pageToken

string

Se especificado, a próxima página de contas é recuperada. O pageToken é retornado quando uma chamada para accounts.list retorna mais resultados do que o tamanho de página solicitado.

name

string

O nome do recurso da conta para que a lista de contas acessíveis diretamente será recuperada. Isso é válido apenas para organizações e grupos de usuários. Se estiver vazio, retornará accounts.list para o usuário autenticado.

filter

string

Um filtro que restringe as contas a retornar. A resposta inclui apenas entradas que correspondem ao filtro. Se filter estiver vazio, nenhuma restrição será aplicada e todas as contas (paginadas) serão recuperadas para a conta solicitada.

Por exemplo, uma solicitação com o filtro type=USER_GROUP retornará somente grupos de usuários.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta para accounts.ListAccounts.

Representação JSON
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Campos
accounts[]

object (Account)

Um conjunto de contas às quais o usuário tem acesso. A conta pessoal do usuário que fez a consulta será sempre o primeiro item do resultado, a menos que seja filtrado.

nextPageToken

string

Se o número de contas exceder o tamanho de página solicitado, esse campo será preenchido com um token para buscar a próxima página de contas em uma chamada subsequente para accounts.list. Se não houver mais contas, este campo não estará presente na resposta.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Para mais informações, consulte a Visão geral do OAuth 2.0.