Örnekler

Bu kılavuz, REST uç noktalarını istemci kitaplığı kullanmadan doğrudan çağırmayla ilgili örnekler içerir.

Ön koşullar

Aşağıdaki tüm örneklerin, curl komutu kullanılarak bir bash kabuğuna kolayca kopyalanıp yapıştırılabilecek olması amaçlanmıştır. En az bir müşteri hesabı içeren bir Search Ads 360 yönetici hesabınızın olması gerekir.

Önemli: Bu örneklerde, bir müşteri hesabına (CUSTOMER_ID), müşteri hesabını doğrudan yöneten bir yönetici hesabına (MANAGER_CUSTOMER_ID) yönetim erişimi olan bir kullanıcı tarafından eriştiğiniz varsayılmıştır. Bunun yerine doğrudan tek bir müşteri hesabına erişiyorsanız login-customer-id başlığını çıkarın veya CUSTOMER_ID ile aynı değere ayarlayın.

Ortam değişkenleri

Hesap kimlik bilgilerini ve kimliklerini aşağıya girin. Ardından, gelecek örneklerde kullanılan ortam değişkenlerini yapılandırmak için bunları terminalinize kopyalayıp yapıştırın.

Not: Yetkilendirme kılavuzunda, OAuth 2.0 erişim jetonu oluşturmayla ilgili talimatlar yer almaktadır.

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

İsteğe bağlı ek nesne kimlikleri

Aşağıdaki örnekler mevcut kampanyalarda çalışır. Bu örneklerle kullanabileceğiniz mevcut bir kampanyanın kimlikleriniz varsa bunu aşağıya girin.

CAMPAIGN_ID=CAMPAIGN_ID

Sayfalandırılmış arama

search yöntemi, query ile birlikte belirtilen düzenlenebilir pageSize parametresiyle sayfalandırmayı kullanır.

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 Sorgu Dili

  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'

Canlı Yayın

searchStream yöntemi tüm sonuçların tek bir yanıtla akışını sağladığından pageSize alanı desteklenmez.

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 Sorgu Dili

  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'