표준 쿼리 매개변수

아래 표에서는 모든 Ad Exchange 구매자 REST API 작업에 적용되는 검색 매개변수를 보여 줍니다.

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

1. key 매개변수는 모든 요청에서 반드시 필요합니다. 단, 요청과 함께 OAuth 2.0 토큰을 제공하는 경우는 예외입니다.
2. (AUTHENTICATED)로 표시된 모든 요청은 승인 토큰을 반드시 전송해야 합니다. 승인 프로토콜로 OAuth 2.0을 사용할 것을 권장합니다.
3. 다음 두 가지 방법으로 요청과 함께 OAuth 2.0 토큰을 제공할 수 있습니다.
   • 다음과 같이 access_token 쿼리 매개변수 사용: ?access_token= oauth2-token
   • HTTP Authorization 헤더 사용(예: Authorization: Bearer oauth2-token)

별도로 명시되지 않으면 모든 매개변수는 선택사항입니다.

매개변수	의미	참고
access_token	현재 사용자의 OAuth 2.0 토큰입니다.	OAuth 2.0 토큰을 제공하는 한 가지 방법입니다.
callback	콜백 함수입니다.	응답을 처리하는 JavaScript 콜백 함수의 이름입니다. 자바스크립트 JSON-P 요청에서 사용됩니다.
fields	응답에 포함할 필드의 부분 집합을 지정하는 선택 도구입니다.	자세한 내용은 부분 응답에 대한 설명을 참조하세요. 성능을 높이는 데 사용됩니다.
key	API 키입니다.(필수*)	*OAuth 2.0 토큰을 제공하지 않은 경우 필수 항목입니다. API 키는 프로젝트를 식별하고 API 액세스, 할당량 및 보고서를 제공합니다. 프로젝트의 API 키는 Google Developers Console에서 확인할 수 있습니다.
prettyPrint	들여쓰기와 줄바꿈을 포함하여 응답을 반환합니다.	true이면 사람이 읽을 수 있는 형식으로 응답을 반환합니다. 기본값: true. false로 설정하면 응답의 페이로드 크기가 감소하여 일부 환경에서 성능이 개선될 수 있습니다.
quotaUser	userIp를 대체합니다.	사용자의 IP 주소를 모르더라도 서버측 애플리케이션에서 사용자별 할당량을 적용할 수 있습니다.예를 들어 사용자를 대신하여 App Engine에서 cron 작업을 실행하는 애플리케이션이 여기에 해당합니다. 사용자를 고유하게 식별하는 임의의 문자열을 선택할 수 있지만 길이는 40자로 제한됩니다. 두 매개변수가 모두 제공되면 userIp는 무시됩니다. 사용 한도 지정에 대해 자세히 알아보세요.
userIp	API 호출을 실행하는 최종 사용자의 IP 주소입니다.	서버측 애플리케이션에서 API 호출 시 사용자별 할당량을 적용할 수 있습니다. 사용 한도 지정에 대해 자세히 알아보세요.