검색 및 SearchStream

Search Ads 360 Reporting API에는 속성 검색 및 측정항목 보고 기능이 통합되어 있습니다. 메커니즘 Search Ads 360 검색어 도구를 사용하여 검색어를 생성할 수 있는 언어. 이를 통해 특정 데이터에 대한 대량의 데이터를 반환할 수 있는 복잡한 쿼리를 개별 Search Ads 360 계정에 적용됩니다.

Search 또는 SearchStream 메서드 중 하나를 사용하여 쿼리를 만들 수 있습니다. 두 메서드 모두 동일한 쿼리를 지원하고 동일한 결과를 반환합니다. 이 Search 메서드는 맞춤설정 가능한 페이지 크기로 데이터를 반환하여 반복할 수 있도록 합니다. 결과를 필터링할 수 있습니다. 이는 낮은 대역폭에서 유리할 수 있음 예를 들어 대규모 결과 집합을 분류하기 위해 불안정한 네트워크 조건 연결이 끊어진 경우 다시 가져올 수 있는 더 작은 응답으로 보냅니다. 이 반면 SearchStream 메서드는 전체 결과 세트를 다시 스트리밍합니다. 단일 응답을 생성할 수 있으며, 이는 대량 데이터 검색에 보다 효율적일 수 있습니다.

Search와 SearchStream는 모두 동일한 기본 URL을 사용합니다.

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

페이지 기반 검색 메서드는 pageSize 매개변수(선택사항)를 사용하며, 이 매개변수는 단일 API 응답으로 반환되는 결과 수

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"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'"
}

결과에 pageSize보다 더 많은 행이 있으면 nextPageToken은 다음과 같습니다.

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

위의 값을 사용해 동일한 쿼리를 반복하는 pageToken을 추가합니다. 다음 결과 페이지:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"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 /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_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'"
}
 드림