Skip to main content
POST
get configuração de uso

Visão geral

Recupere o limite de crédito adicional efetivo por usuário da sua organização. Os limites são sempre por usuário. A resposta retorna o limite aplicado ao sujeito solicitado após a mesclagem das configurações de escopos mais amplos, e não apenas um limite configurado diretamente no escopo solicitado.

Requisição

string
obrigatório
Sua chave de serviço com a permissão “Billing Read”

Configuração de escopo (escolha uma opção)

boolean
Defina como true para recuperar o limite por usuário no nível da equipe
string
Recupere o limite por usuário efetivo de um grupo específico informando o ID do grupo. O resultado combina o limite no nível da equipe com o override desse grupo, se houver, e não leva em conta outros grupos aos quais o usuário possa pertencer nem overrides no nível do usuário.
string
Recupere o limite por usuário efetivo de um usuário específico informando o endereço de e-mail dele. O resultado combina o limite no nível da equipe, os overrides de todos os grupos aos quais o usuário pertence e eventuais overrides no nível do usuário.
Você deve informar um dos parâmetros team_level, group_id ou user_email para definir o escopo.

Exemplo de requisição - get o limite por usuário no nível da equipe

Exemplo de requisição - get o limite efetivo por usuário para um grupo

Exemplo de requisição - get do limite efetivo por usuário para um usuário

Resposta

integer
O limite de crédito adicional efetivo para o sujeito da requisição. Para os escopos de grupo e de usuário, esse valor pode ser herdado de um escopo mais amplo. Se esse campo não estiver presente na resposta, nenhum limite se aplica ao escopo solicitado nem a qualquer escopo do qual ele herda.
Este endpoint não indica qual escopo definiu o limite retornado. Uma consulta de grupo ou de usuário pode retornar um limite herdado da equipe (ou, no caso de um usuário, de um dos seus grupos) mesmo quando não houver nenhum override configurado no escopo solicitado.

Exemplo de resposta - com limite em vigor

Exemplo de resposta - Sem limite em vigor

Respostas de erro

Cenários comuns de erro:
  • Chave de serviço inválida ou permissões insuficientes
  • Vários parâmetros de escopo informados
  • Nenhum parâmetro de escopo informado
  • ID do grupo ou e-mail do usuário inválido
  • Limite de requisições excedido