Parámetros estándar de API

Los siguientes parámetros de consulta se pueden usar con todos los métodos y todos los recursos de la API de Cloud Spanner.

NOTAS (sobre tokens de autenticación):

  1. Es obligatorio enviar un token de autorización con cada solicitud que requiera un alcance de OAuth. OAuth 2.0 es el único protocolo de autorización compatible.
  2. Puedes proporcionar un token de OAuth 2.0 con cualquier solicitud de una de estas dos formas:
    • Mediante el parámetro de consulta access_token de esta manera: ?access_token= oauth2-token
    • Mediante el encabezado Authorization HTTP de esta forma Authorization: Bearer oauth2-token

Todos los parámetros son opcionales, excepto donde se indique.

Parámetro Significado Notas
access_token Token de OAuth 2.0 para el usuario actual
callback Función de devolución de llamada
  • Nombre de la función de devolución de llamada de JavaScript que maneja la respuesta
  • Se usa en las solicitudes JSON-P de JavaScript.
fields Selector que especifica un subconjunto de campos para incluir en la respuesta.
  • Para obtener más información, consulta la documentación de respuesta parcial.
  • Se usa para mejorar el rendimiento.
prettyPrint

Muestra una respuesta con sangrías y saltos de línea.

  • Muestra la respuesta en un formato legible si es true.
  • Valor predeterminado: true.
  • Cuando el valor es false, puede reducirse el tamaño de la carga útil de la respuesta, lo que podría mejorar el rendimiento en algunos entornos.

Sugerencias de rendimiento

Recomendamos encarecidamente usar las bibliotecas cliente para las cargas de trabajo que involucren consultas relativamente altas por segundo, solicitudes o respuestas relativamente pequeñas y cuando te preocupes por la latencia o la capacidad de procesamiento. Las bibliotecas tienen una sobrecarga considerablemente menor que REST o JSON, ya que se compilan sobre las interfaces gRPC. Hay casos en los que usar la API de REST tiene sentido y deseas optimizar la cantidad de bytes transferidos o respuestas JSON más pequeñas. En esos casos, puedes usar muchas de las sugerencias de rendimiento para Cloud Storage.