이 사용 사례는 지난 30일 동안의 계정 실적을 캠페인별로, 기기별로 분류하여 요약합니다. 이 보고서의 쿼리는 다음과 같습니다.
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
이 요청을 실행하려면 이 Google Ads 쿼리 언어 문을
GoogleAdsService.SearchStream
인터페이스에 전달하세요.
HTTP 요청 URL
요청은 다음 URL에서 Google Ads API 서버에 대한 HTTP POST로 구성됩니다.
https://googleads.googleapis.com/v24/customers/{customer_id}/googleAds:searchStream
{customer_id}를 쿼리하려는 특정 Google Ads 계정의 ID로 바꿉니다. ID에 하이픈을 포함하지 마세요. 하위 계정의 데이터를 가져오려면 해당 하위 계정의 ID를 사용해야 합니다. 관리자 계정 ID로 쿼리하면 해당 관리자 계정이 직접 소유한 데이터만 반환되며 하위 계정의 데이터는 포함되지 않습니다.
전체 HTTP 요청 샘플
다음은 HTTP POST 요청에 포함된 이 보고서 정의의 전체 예시입니다.
POST /v24/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]
Parameters:
{
"query" : "SELECT campaign.name, campaign.status, segments.device,
metrics.impressions, metrics.clicks, metrics.ctr,
metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS"
}
코드 샘플
지난 7일 동안 측정항목이 있는 캠페인을 검색하는 코드 샘플의 동영상 안내를 시청하세요. 이 코드 샘플은 Java로 작성되었지만 모든 언어에서 프로세스가 비슷합니다.