Примеры

В этом руководстве содержатся примеры вызова конечных точек REST напрямую, без использования клиентской библиотеки.

Предпосылки

Все приведённые ниже примеры можно легко скопировать и вставить в оболочку Bash с помощью команды curl . Вам потребуется управляющий аккаунт Search Ads 360, содержащий как минимум один клиентский аккаунт.

Важно: В этих примерах предполагается, что вы обращаетесь к клиентской учётной записи ( CUSTOMER_ID ) через пользователя с правами администратора к учётной записи менеджера ( MANAGER_CUSTOMER_ID ), который непосредственно управляет клиентской учётной записью. Если вы обращаетесь напрямую к отдельной клиентской учётной записи, опустите заголовок login-customer-id или установите для него то же значение, что и для CUSTOMER_ID .

Переменные среды

Введите ниже учетные данные и идентификаторы, а затем скопируйте и вставьте их в терминал, чтобы настроить переменные среды, используемые в последующих примерах.

Примечание: Руководство по авторизации содержит инструкции по созданию токена доступа OAuth 2.0.

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

Дополнительные необязательные идентификаторы объектов

Следующие примеры работают с уже существующими кампаниями. Если у вас есть идентификаторы существующей кампании для использования с этими примерами, введите их ниже.

CAMPAIGN_ID=CAMPAIGN_ID

Постраничный поиск

Метод search использует пагинацию с настраиваемым параметром pageSize , указанным вместе с query .

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 выводит все результаты в одном ответе, поэтому поле 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'