표준 쿼리 매개변수

모든 Resource Manager API 작업에 적용되는 쿼리 매개변수가 아래 표에 나와 있습니다.

API 키 및 인증 토큰 관련 참고사항:

  1. key 매개변수는 모든 요청에 필요합니다. 단, 요청과 함께 OAuth 2.0 토큰을 제공하는 경우는 예외입니다.
  2. OAuth 범위가 필요한 모든 요청에는 승인 토큰을 전송해야 합니다. OAuth 2.0은 지원되는 유일한 승인 프로토콜입니다.
  3. 다음 두 가지 방법 중 하나로 모든 요청과 함께 OAuth 2.0 토큰을 제공할 수 있습니다.
    • access_token 쿼리 매개변수 사용: ?access_token=oauth2-token
    • HTTP Authorization 헤더 사용: Authorization: Bearer oauth2-token

별도로 명시되어 있는 경우를 제외한 모든 매개변수는 선택사항입니다.

매개변수 의미 참고사항
access_token 현재 사용자의 OAuth 2.0 토큰입니다.
callback 콜백 함수입니다.
  • 응답을 처리하는 자바스크립트 콜백 함수의 이름입니다.
  • 자바스크립트 JSON-P 요청에서 사용됩니다.
fields 응답에 포함할 필드의 하위 집합을 지정하는 선택기입니다.
  • 자세한 내용은 부분 응답 문서를 참조하세요.
  • 성능 개선을 위해 사용합니다.
key API 키입니다. (필수*)
  • *OAuth 2.0 토큰을 제공하지 않는 한 필수 항목입니다.
  • API 키는 프로젝트를 식별하고 사용자에게 API 액세스 권한, 할당량, 보고서를 제공합니다.
  • 프로젝트의 API 키는 Google Cloud Console에서 확인할 수 있습니다.
prettyPrint

들여쓰기와 줄바꿈이 적용된 응답을 반환합니다.
  • true인 경우 사람이 읽을 수 있는 형식으로 응답을 반환합니다.
  • 기본값은 true입니다.
  • false인 경우 응답의 페이로드 크기가 줄어 일부 환경에서 성능이 개선될 수 있습니다.
quotaUser userIp의 대체 매개변수입니다.
  • 사용자의 IP 주소를 모르더라도 서버 측 애플리케이션에서 사용자별 할당량을 적용할 수 있습니다. 예를 들어 사용자를 대신하여 App Engine에서 크론 작업을 실행하는 애플리케이션이 여기에 해당합니다.
  • 사용자를 고유하게 식별하는 임의의 문자열을 선택할 수 있지만 길이는 40자로 제한됩니다.
  • 두 매개변수가 모두 제공되면 userIp는 무시됩니다.
  • API 사용량 상한 설정에 대해 자세히 알아보세요.
userIp API 호출을 실행하는 최종 사용자의 IP 주소입니다.
  • 서버 측 애플리케이션에서 API를 호출하는 경우 사용자별 할당량을 적용할 수 있습니다.
  • API 사용량 상한 설정에 대해 자세히 알아보세요.