Esta guía contiene ejemplos de cómo llamar a los extremos REST directamente, sin usar una biblioteca cliente.
Requisitos previos
Todos los ejemplos que se muestran a continuación se pueden copiar y pegar fácilmente en una shell de Bash con el comando curl. Necesitarás una cuenta de administrador de Search Ads 360 que contenga, al menos, una cuenta de cliente.
Variables de entorno
Ingresa las credenciales y los IDs de la cuenta a continuación y, luego, cópialos y pégalos en la terminal para configurar las variables de entorno que se usan en los ejemplos posteriores.
API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"
IDs de objetos opcionales adicionales
Los siguientes ejemplos funcionan en campañas preexistentes. Si tienes los IDs de una campaña existente para usar con estos ejemplos, ingrésalos a continuación.
CAMPAIGN_ID=CAMPAIGN_ID
Búsqueda paginada
El método search usa paginación, con un parámetro pageSize ajustable especificado junto con 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]
Lenguaje de consulta de 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'
Transmisión
El método searchStream transmite todos los resultados en una sola respuesta y, por lo tanto, no se admite el campo 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]
Lenguaje de consulta de 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'