Google Ads 쿼리 빌더는 Google Ads 쿼리 언어(GAQL)를 사용하여 쿼리를 대화형으로 구성하고 검증할 수 있도록 설계된 대화형 도구입니다. GAQL을 처음 사용하는 사용자든 숙련된 사용자든 쿼리 빌더를 사용하면 Google Ads API에서 필요한 정확한 데이터를 가져오는 프로세스를 간소화할 수 있습니다.
이점
- 사용 편의성: 특정 구문과 사용 가능한 필드를 숙지하지 않아도 GAQL 쿼리 작성 프로세스를 간소화합니다.
- 검색 가능성: Google Ads API 데이터 모델 내에서 사용 가능한 리소스, 필드, 세그먼트, 측정항목을 탐색하고 찾는 데 도움이 됩니다.
- 오류 감소: 구조화된 인터페이스와 유효한 옵션의 드롭다운 메뉴를 제공하여 구문 오류와 오타를 방지하고 생성된 쿼리가 유효하도록 지원합니다.
- 더 빠른 쿼리 빌드: 쿼리 문자열 생성을 자동화하여 개발 프로세스 속도를 높입니다.
- 유효성 검사: 이 도구는 API 탐색기 및 쿼리 유효성 검사기와 연결되어 실행 전에 API 규칙에 대해 쿼리를 확인합니다.
작동 방식
Google Ads 쿼리 빌더는 GAQL 쿼리를 시각적으로 조립할 수 있는 사용자 친화적인 인터페이스를 제공합니다. 기본 워크플로는 다음과 같습니다.
- 리소스 선택: 쿼리할 버전의 참조 탭에서 기본 리소스를 선택하는 것으로 시작합니다. 이 리소스는
FROM조항에 포함됩니다. 리소스는 Google Ads 내의 항목(예:campaign,ad_group,keyword_view)을 나타냅니다. 빌더에 사용 가능한 모든 리소스가 나열됩니다. - 필드 선택: 리소스를 선택하면 해당 리소스 및 해당 리소스의 속성 (암시적으로 조인 가능) 리소스와 관련된 속성, 세그먼트, 측정항목을 비롯한 선택 가능한 모든 필드가 표시됩니다. 체크박스를 선택하여
SELECT절에 필드를 포함할 수 있습니다. 선택하면 도구에서 해당 GAQL 쿼리 문자열을 동적으로 생성하고, 오류를 표시하고, 호환되지 않는 필드 조합을 필터링합니다. - 필터 적용:
WHERE절 조건을 추가하여 결과를 필터링할 수 있습니다. 빌더를 사용하면 필드, 연산자, 값을 선택하여 올바른 문법을 보장할 수 있습니다. - 결과 정렬:
ORDER BY절을 사용하여 정렬 순서를 지정합니다. - 한도 설정:
LIMIT절을 추가하여 반환되는 결과 수를 제어합니다. - 유효성 검사: 이 도구는 유효한 필드 조합을 안내할 뿐만 아니라 API 탐색기로 연결되므로 계정 데이터를 기준으로 쿼리를 테스트할 수 있습니다. 직접 작성한 GAQL 쿼리를 붙여넣고 확인할 수 있는 별도의 [쿼리 유효성 검사기](페이지 링크)도 있습니다.
- 내보내기: 쿼리가 마음에 들면 테스트를 거치고 구문이 올바른 GAQL 문자열을
GoogleAdsService.Search또는SearchStream클라이언트 요청에 복사하여 붙여넣습니다.
빌더는 선택한 필드, 세그먼트, 측정항목이 호환되고 Google Ads API의 기본 메타데이터를 참조하여 단일 쿼리에서 함께 사용할 수 있는지 확인합니다.
시작하기
쿼리 빌더로 이동하는 방법에는 두 가지가 있습니다. 한 가지 방법은 보고 참조 문서의 특정 페이지를 살펴보는 것이고, 다른 방법은 쿼리 빌더 개요 페이지에서 탐색하는 것입니다.
보고 참조 문서
- 보고 참조 문서로 시작하여 모든 리소스 목록에서 시작할 특정 리소스를 선택합니다. 또는 왼쪽 탐색 창에서 리소스로 직접 이동합니다.
- 쿼리 작성 도우미를 클릭하면 해당 리소스의 쿼리 빌더로 이동합니다.
쿼리 빌더 개요 페이지에서
보고 참조 문서의 쿼리 빌더 섹션으로 이동하여 살펴볼 리소스를 선택합니다.
다른 도구와 통합
쿼리 빌더는 Google Ads API 개발자 툴킷의 다른 도구와 통합되어 있습니다. 쿼리 빌더에서 빌드된 쿼리를 가져와 API 탐색기에서 테스트하거나 쿼리 유효성 검사기로 검증할 수 있습니다.
API 탐색기
쿼리를 빌드한 후 API 탐색기에서 사용해 보기를 클릭하여 API 탐색기에서 쿼리를 엽니다. 쿼리가 요청 본문에 자동으로 채워지며, 계정 데이터를 대상으로 쿼리를 실행하여 쿼리를 테스트할 수 있습니다. 이 도구에 대한 자세한 내용은 API 탐색기를 참고하세요.
쿼리 검사기
쿼리 입력 또는 수정을 클릭하면 쿼리 유효성 검사기가 열립니다. 쿼리 검사기를 사용하여 쿼리의 구문 유효성을 검사합니다. 쿼리 빌더를 통해 완전히 빌드된 쿼리는 이미 올바른 구문이 포함되어 있지만, 쿼리하는 리소스에 익숙한 경우 쿼리 유효성 검사기를 사용하면 쿼리를 빠르게 입력하고 유효성을 확인할 수 있습니다. 이 도구에 관한 자세한 내용은 쿼리 유효성 검사기를 참고하세요.