Ce guide contient des exemples d'appel direct des points de terminaison REST, sans l'utilisation d'une bibliothèque cliente.
Prérequis
Tous les exemples ci-dessous sont destinés à être facilement copiés et collés dans un shell bash à l'aide de la commande curl. Vous devez disposer d'un compte administrateur Search Ads 360 contenant au moins un compte client.
Variables d'environnement
Saisissez les identifiants et les ID de compte ci-dessous, puis copiez-collez ces éléments dans votre terminal pour configurer les variables d'environnement utilisées dans les exemples suivants.
API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"
ID d'objets facultatifs supplémentaires
Les exemples suivants fonctionnent sur des campagnes préexistantes. Si vous disposez des ID d'une campagne existante à utiliser avec ces exemples, saisissez-les ci-dessous.
CAMPAIGN_ID=CAMPAIGN_ID
Recherche paginée
La méthode search
utilise la pagination, avec un paramètre pageSize
ajustable spécifié avec le 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]
Langage de requête 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'
Flux
La méthode searchStream
diffuse tous les résultats dans une seule réponse. Le champ pageSize
n'est donc pas accepté.
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]
Langage de requête 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'