Google Ads API에서는 속성 검색 및 측정항목 보고가 통합되어 메커니즘 Google Ads 쿼리를 이용해 검색어를 생성할 수 있는 언어. 이를 통해 특정 데이터에 대한 대량의 데이터를 반환할 수 있는 복잡한 쿼리를 개별 Google Ads 계정에 적용됩니다.
Search 또는 SearchStream 메서드 중 하나를 사용하여 쿼리를 만들 수 있습니다.
두 메서드 모두 동일한 쿼리를 지원하고 동일한 결과를 반환합니다. 이
Search 메서드는 10,000행으로 구성된 고정된 크기 페이지로 데이터를 반환하므로
페이지로 나누기를 사용하여 결과 집합을 반복합니다. 이렇게 하면
불안정한 네트워크 상태, 예를 들어 대규모 데이터를
더 작은 응답으로 결과를 반환.
패배했지. 반면 SearchStream 메서드는 전체 결과를 스트리밍합니다.
단일 응답으로 다시 설정할 수 있어 일괄 데이터에 대한 보다 효율적일 수 있습니다.
가져올 수 있습니다.
Search와 SearchStream는 모두 동일한 기본 URL을 사용합니다.
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/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 /v17/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로 변경합니다.
(pageSize 및 pageToken는 SearchStream에 필요하지 않음):
POST /v17/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'"
}