Google Ads API에는 통합된 속성 검색 및 측정항목 보고 메커니즘 이 있어 Google Ads 쿼리 언어를 사용하여 쿼리를 만들 수 있습니다. 이를 통해 개별 Google Ads 계정에 관한 대량의 데이터를 반환할 수 있는 복잡한 쿼리를 실행할 수 있습니다.
Search 또는 SearchStream 메서드 중 하나를 사용하여 쿼리를 만들 수 있습니다.
두 메서드 모두 동일한 쿼리를 지원하고 동일한 결과를 반환합니다. Search 메서드는 10,000개의 행으로 구성된 고정 크기 페이지로 데이터를 반환하므로 페이지 나누기를 사용하여 결과 집합을 반복할 수 있습니다. 예를 들어 대역폭이 낮거나 네트워크 연결이 불안정한 경우 연결이 끊어지면 다시 가져올 수 있는 더 작은 응답으로 큰 결과 집합을 분할하는 데 유용할 수 있습니다. 반면 SearchStream 메서드는 전체 결과 집합을 단일 응답으로 스트리밍하므로 대량 데이터 검색에 더 효율적일 수 있습니다.
Search와 SearchStream 모두 동일한 기본 URL을 사용합니다.
https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds
POST /v25/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
결과에 10,000개가 넘는 행이 있는 경우 응답에 nextPageToken이 반환됩니다.
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
이전 요청의 값으로 추가된 pageToken을 사용하여 동일한 쿼리를 반복하면 결과의 다음 페이지가 가져옵니다.
POST /v25/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
단일 스트리밍 응답으로 모든 결과를 반환하는 SearchStream 메서드를 사용하려면 URL의 서비스 메서드를 searchStream으로 변경합니다(pageToken은 SearchStream에 필요하지 않음).
POST /v25/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }