Ten przewodnik zawiera przykłady bezpośredniego wywoływania punktów końcowych REST bez użycia biblioteki klienta.
Wymagania wstępne
Wszystkie poniższe przykłady powinny być łatwe do skopiowania i wklejenia w powłoce powłoki bash za pomocą polecenia curl. Potrzebujesz konta menedżera Search Ads 360 zawierającego co najmniej jedno konto klienta.
Zmienne środowiskowe
Wpisz poniżej dane logowania i identyfikatory do konta, a następnie skopiuj je i wklej w terminalu, aby skonfigurować zmienne środowiskowe używane w kolejnych przykładach.
API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"
Dodatkowe opcjonalne identyfikatory obiektów
Podane niżej przykłady dotyczą już istniejących kampanii. Jeśli masz identyfikatory istniejącej kampanii, których chcesz użyć w tych przykładach, wpisz je poniżej.
CAMPAIGN_ID=CAMPAIGN_ID
Wyszukiwanie z podziałem na strony
Metoda search używa podziału na strony z regulowanym parametrem pageSize określonym obok elementu 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]
Język zapytań 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'
transmisje
Metoda searchStream przesyła strumieniowo wszystkie wyniki w jedną odpowiedź, więc pole pageSize nie jest obsługiwane.
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]
Język zapytań 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'