Örnekler

Bu kılavuzda, istemci kitaplığı kullanılmadan REST uç noktalarının doğrudan çağrılmasıyla ilgili örnekler yer almaktadır.

Ön koşullar

Aşağıdaki tüm örnekler, curl komutu kullanılarak bash kabuğuna kolayca kopyalanıp yapıştırılacak şekilde tasarlanmış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, 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 müşteri hesabına (CUSTOMER_ID) eriştiğiniz varsayılır. Bunun yerine doğrudan tek bir müşteri hesabına erişiyorsanız login-customer-id üstbilgisini atlayın veya CUSTOMER_ID ile aynı değere ayarlayın.

Ortam değişkenleri

Aşağıya hesap kimlik bilgilerini ve kimlikleri girin, ardından sonraki örneklerde kullanılan ortam değişkenlerini yapılandırmak için 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 kullanmak üzere mevcut bir kampanyanın kimlikleri varsa bunları aşağıya girin.

CAMPAIGN_ID=CAMPAIGN_ID

Sayfalandırılmış arama

search yöntemi, query ile birlikte belirtilen ayarlanabilir bir pageSize parametresiyle birlikte sayfalara ayırma özelliğini 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ı tek bir yanıtta yayınladığı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'