Google Ads API 탐색기는 브라우저에서 직접 실시간 API 요청을 구성하고 보낼 수 있는 대화형 실행 환경입니다. 참조 문서에 내장되어 있으며 OAuth 2.0 인증 및 JSON 페이로드 형식의 복잡성을 처리하므로 단 한 줄의 코드를 작성하지 않고도 특정 서비스와 메서드를 테스트할 수 있습니다.
이점
- 노코드 테스트: 로컬 개발 환경을 설정하지 않고 문서에서 직접 실시간 API 호출 (읽기 및 쓰기 모두)을 실행합니다.
- 프로토콜 검색: HTTP 요청 및 응답의 정확한 구조를 확인하여 API의 작동 방식을 파악합니다.
- 원활한 프로토타이핑: 애플리케이션에 로직을 구현하기 전에 엔드포인트 동작을 확인하고 원시 API 응답을 즉시 검사합니다.
- 간소화된 인증: 이 도구는 OAuth 2.0 흐름을 자동으로 관리하므로 사용자 인증 정보 관리 대신 API 요청에 집중할 수 있습니다.
시작하기
- 문서로 이동: 참조 문서로 이동하여 테스트할 서비스와 메서드를 선택합니다(예:
GoogleAdsService/Search). - 탐색기 열기: 페이지 오른쪽에 있는 '사용해 보기' 패널을 찾습니다.
- 요청 구성:
developer-token및login-customer-id과 같은 필수 요청 매개변수를 입력합니다.`mutate`작업과 같이 메서드에 페이로드가 필요한 경우 대화형 JSON 편집기를 사용하여 요청 본문을 정의합니다.
- 실행: 실행을 클릭하여 요청을 보냅니다. 이 도구는 전체 HTTP 요청과 API의 실시간 JSON 응답을 표시합니다.
주요 특징
- 실시간 실행: 프로덕션 또는 테스트 계정에 대해 실시간
search및mutate작업을 실행합니다. - JSON 페이로드 형식 지정: 도구에서 필수 필드와 유효한 스키마 구조를 강조 표시하여 요청에 대한 복잡한 JSON 객체를 대화형으로 빌드합니다.
- 필드 마스크:
update_mask로직을 테스트하여 실제 부분 리소스 업데이트가 어떻게 작동하는지 확인합니다. - 오류 검사: 원시 응답에서 자세한 오류 메시지와 코드 (예:
QUERY_ERROR또는AUTHENTICATION_ERROR)를 확인하여 더 빠르게 디버깅할 수 있습니다. - 코드 내보내기: API 탐색기의 확장된 보기에서
curl명령어, 원시 HTTP 요청 또는 샘플 JavaScript 코드를 내보냅니다.
사용 사례
- 계정 설정 감사:
get또는search요청을 실행하여 계정 수준 구성 또는 메타데이터를 빠르게 가져옵니다. - 테스트 변이: 코드를 프로덕션에 배포하기 전에 캠페인 생성 또는 예산 업데이트가 성공했는지 확인합니다.
- GAQL 디버그: 탐색기를 사용하여 Google Ads 쿼리 언어(GAQL) 문자열을 실행하고 반환된 JSON 구조가 애플리케이션의 예상과 일치하는지 확인합니다.
- 프로토콜 확인: 특정 API 버전에 필요한 정확한 HTTP 헤더와 JSON 중첩을 검사합니다.