일반적인 사용 사례

이제 일반적인 사용 사례를 살펴보겠습니다. 지난 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/v16/customers/{customer_id}/googleAds:searchStream

전체 HTTP 요청 샘플

다음은 HTTP POST 요청에 포함된 위 보고서 정의의 전체 예입니다.

POST /v16/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일 동안의 측정항목으로 캠페인을 검색하는 코드 샘플 둘러보기를 시청하세요. 이 동영상의 코드 샘플은 자바로 작성되었지만 프로세스는 모든 언어에서 유사합니다.