Parâmetros da API padrão

Os seguintes parâmetros de consulta podem ser usados com todos os métodos e todos os recursos na Cloud Spanner API.

OBSERVAÇÕES (sobre tokens de autenticação):

  1. Você precisa enviar um token de autorização com todas as solicitações que exigem um escopo do OAuth. OAuth 2.0 é o único protocolo de autorização compatível.
  2. É possível fornecer um token OAuth 2.0 com qualquer solicitação, de uma das duas maneiras:
    • Com o parâmetro de consulta access_token, como este: ?access_token=oauth2-token
    • Com o cabeçalho HTTP Authorization, como este: Authorization: Bearer oauth2-token

Todos os parâmetros são opcionais, exceto quando indicado.

Parâmetro Significado Observações
access_token Token OAuth 2.0 para o usuário atual.
callback Função de retorno de chamada.
  • Nome da função de retorno de chamada JavaScript que lida com a resposta.
  • Usado em solicitações JavaScript JSON-P.
fields Seletor com que é especificado um subconjunto de campos a ser incluído na resposta.
  • Para mais informações, consulte a documentação sobre resposta parcial.
  • Use para conseguir um desempenho melhor.
prettyPrint

Retorna uma resposta com recuos e quebras de linha.

  • Retorna a resposta em um formato legível se for true.
  • Valor padrão: true.
  • Se for false, o tamanho do payload da resposta poderá ser reduzido, o que talvez melhore o desempenho em alguns ambientes.

Dicas de desempenho

É altamente recomendável usar as bibliotecas de cliente para cargas de trabalho que envolvam consultas relativamente altas por segundo, solicitações ou respostas relativamente pequenas e em situações em que você esteja preocupado com a latência ou a capacidade. As bibliotecas têm uma sobrecarga substancialmente menor que REST ou JSON porque são construídas sobre as interfaces gRPC. Há casos em que é necessário usar a API REST e otimizar por menos bytes transferidos ou respostas JSON menores. Nesses casos, é possível usar muitas das dicas de desempenho do Cloud Storage.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Spanner