例

このガイドでは、クライアント ライブラリを使用せずに REST エンドポイントを直接呼び出す例を示します。

前提条件

以下のサンプルはすべて、curl コマンドを使用して bash シェルに簡単にコピーして貼り付けることができるようにしています。少なくとも 1 つのクライアント アカウントを含む検索広告 360 マネージャー アカウントが必要です。

重要: 以下の例では、クライアント アカウント（CUSTOMER_ID）を直接管理する MCC アカウント（MANAGER_CUSTOMER_ID）の管理者権限を持つユーザーが、クライアント アカウント（CUSTOMER_ID）にアクセスしていることを前提としています。個々のクライアント アカウントに直接アクセスする場合は、login-customer-id ヘッダーを省略するか、CUSTOMER_ID と同じ値に設定します。

環境変数

アカウントの認証情報と ID を以下に入力し、コピーしてターミナルに貼り付け、後続の例で使用する環境変数を構成します。

注: 認可ガイドでは、OAuth 2.0 アクセス トークンの生成手順について説明しています。

API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"

追加のオプションのオブジェクト ID

次の例は、既存のキャンペーンで使用できます。これらの例で使用する既存のキャンペーンの ID がある場合は、以下に入力してください。

CAMPAIGN_ID=CAMPAIGN_ID

ページ分け検索

search メソッドは、query とともに指定された調整可能な pageSize パラメータを使用してページネーションを使用します。

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:search" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"pageSize": 10,
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 クエリ言語

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'

ストリーミング

searchStream メソッドはすべての結果を 1 つのレスポンスでストリーミングするため、pageSize フィールドはサポートされていません。

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:searchStream" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 クエリ言語

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'