Exemples

Ce guide contient des exemples d'appels directs aux points de terminaison REST, sans utiliser de bibliothèque cliente.

Prérequis

Tous les exemples ci-dessous sont conçus pour être facilement copiés et collés dans une interface système bash à l'aide de la commande curl. Vous aurez besoin d'un compte administrateur Search Ads 360 contenant au moins un compte client.

Important : Dans ces exemples, nous partons du principe que vous accédez à un compte client (CUSTOMER_ID) par le biais d'un utilisateur disposant d'un accès administrateur à un compte administrateur (MANAGER_CUSTOMER_ID) qui gère directement le compte client. Si vous accédez directement à un compte client individuel, omettez l'en-tête login-customer-id ou définissez-le sur la même valeur que CUSTOMER_ID.

Variables d'environnement

Saisissez les identifiants et les ID de compte ci-dessous, puis copiez-les et collez-les dans votre terminal pour configurer les variables d'environnement utilisées dans les exemples suivants.

Remarque : Le guide Autorisation fournit des instructions pour générer un jeton d'accès OAuth 2.0.

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 d'ID de campagne existants à 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é à côté de 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'

Streaming

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'