Outils Google Ads
Campagnes Search et Performance Max, mots-clés, textes d'annonces, conversions, stratégies d'enchères et recommandations.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture45 outils
list_google_ads_accounts
Lecture1 créditsComptes Google Ads accessibles à l'utilisateur Google connecté, y compris les comptes clients sous des comptes MCC/administrateur (id, nom, devise, fuseau horaire, administrateur, login_customer_id), et lequel est sélectionné. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
Cet outil ne prend aucun paramètre.
google_ads_report
Lecture2 créditsPerformances Google Ads (dépenses, clics, impressions, conversions, revenus, CTR, CPC, CPA, ROAS) par campagne, groupe d'annonces, mot-clé, appareil, zone géographique, heure, jour de la semaine ou compte (tous les comptes clients MCC classés). Plage de dates par nombre de jours ou début/fin ; compare_previous ajoute la période précédente. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
breakdownFacultatif | campaign | ad_group | ad | keyword | search_term | device | location | hour | day_of_week | account | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
compare_previousFacultatif | boolean | renvoie aussi la période précédente de même durée et la variation en % |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_device_report
Lecture2 créditsPerformances Google Ads réparties par appareil (mobile, ordinateur, tablette, TV connectée) avec CPA et ROAS par appareil. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
compare_previousFacultatif | boolean | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_change_history
Lecture1 créditsQui a modifié quoi et quand dans le compte Google Ads (30 derniers jours maximum) : utilisateur, outil (UI/API), ressource, opération et valeurs ancienne → nouvelle. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–30) | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
limitFacultatif | integer (1–1000) | — |
resource_typeFacultatif | AD | AD_GROUP | AD_GROUP_CRITERION | CAMPAIGN | CAMPAIGN_BUDGET | AD_GROUP_BID_MODIFIER | CAMPAIGN_CRITERION | AD_GROUP_AD | ASSET | CUSTOMER_ASSET | CAMPAIGN_ASSET | AD_GROUP_ASSET | ASSET_SET | ASSET_SET_ASSET | CAMPAIGN_ASSET_SET | — |
operationFacultatif | CREATE | UPDATE | REMOVE | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads_recommendations
Lecture1 créditsRecommandations d'optimisation de Google (type, campagne, impact estimé). Appliquez celles retenues avec apply_google_ads_recommendation. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
typesFacultatif | array<string> | types de recommandation, p. ex. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
include_dismissedFacultatif | boolean | — |
limitFacultatif | integer (1–10000) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_quality_score_report
Lecture2 créditsNiveau de qualité des mots-clés (1-10) avec ses composantes (CTR attendu, pertinence de l'annonce, expérience sur la page de destination) et dépenses ; résume les mots-clés à faible score et la composante qui les pénalise. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_keyword_planner
Lecture2 créditsIdées de l'outil de planification des mots-clés Google Ads : recherches mensuelles moyennes réelles, concurrence et fourchette d'enchères haut de page pour des mots-clés de départ ou une URL. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
seed_keywordsFacultatif | array<string> | — |
urlFacultatif | string | — |
locationFacultatif | string | noms de villes/régions, séparés par des virgules |
countryFacultatif | string | code ISO, TR par défaut |
languageFacultatif | string | tr, en, de, fr, es, ar, ru |
limitFacultatif | integer (10–500) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ip_exclusions
Lecture1 créditsExclusions d'IP sur les campagnes Google Ads. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ad_groups
Lecture1 créditsGroupes d'annonces (id, nom, statut, CPC par défaut) du compte Google Ads ou d'une campagne. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_shared_negative_lists
Lecture1 créditsListes partagées de mots-clés à exclure du compte Google Ads avec le nombre de mots-clés et les campagnes associées. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
list_idFacultatif | string | renvoie aussi les mots-clés de cette liste |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads
Lecture1 créditsAnnonces responsives sur le Réseau de Recherche avec tous les titres/descriptions, le libellé de performance Google (LOW/GOOD/BEST), l'efficacité de l'annonce et l'URL finale. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_conversion_actions
Lecture1 créditsActions de conversion du compte Google Ads : type, catégorie, statut, principale/secondaire, comptabilisation, paramètres de valeur, fenêtre de conversion après clic. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | also return conversions recorded per action in this window |
statusFacultatif | string | only this status, e.g. ENABLED or REMOVED |
searchFacultatif | string | name contains |
include_removedFacultatif | boolean | also list removed actions (to verify a removal) |
limitFacultatif | integer (1–200) | default 50 |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_asset_groups
Lecture1 créditsGroupes d'assets Performance Max avec efficacité de l'annonce, URL finales et leurs assets texte/image par type de champ. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
asset_group_idFacultatif | string | — |
signalsFacultatif | boolean | also return audience signals and search themes |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_demand_gen_campaigns
Lecture1 créditsCampagnes Demand Gen du compte Google Ads avec statut, enchères, budget quotidien et performances de la période (dépenses, clics, impressions, conversions, revenus, CTR, CPC, CPA, ROAS). Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_app_campaigns
Lecture1 créditsCampagnes pour applications du compte Google Ads avec id de l'application, store, objectif d'enchères, statut, budget quotidien et performances de la période. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_invalid_clicks_report
Lecture2 créditsRapport des clics incorrects (fraude au clic) par campagne et par jour à partir des métriques de Google (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) sur les N derniers jours (14 par défaut) ; signale les campagnes dont le taux de clics incorrects dépasse le seuil (10 % par défaut) ou dont le dernier jour a bondi (3x la moyenne précédente), plus les villes à nombreux clics sans conversion pour les campagnes suspectes. Limites honnêtes : Google ne signale que les clics incorrects déjà filtrés et n'expose jamais les IP des cliqueurs — un signal d'alerte, pas une preuve au niveau IP. Les clics incorrects ne sont pas facturés. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
threshold_rateFacultatif | number | taux de clics incorrects suspect, en fraction, 0.10 par défaut |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_merchant_accounts
Lecture1 créditsComptes Google Merchant Center accessibles avec le jeton Google connecté (Merchant API accounts v1beta) : id, nom, langue, fuseau horaire, indicateur de test. Utilise le consentement Google connecté ; renvoie error=scope_missing s'il manque la portée Merchant Center (auth/content) — l'utilisateur doit réautoriser Google.
Cet outil ne prend aucun paramètre.
list_merchant_products
Lecture1 créditsProduits Merchant Center (Merchant API products v1beta) avec titre, id d'offre, prix, disponibilité, statut d'approbation par destination et problèmes au niveau de l'article ; filtre sur les produits refusés / en attente / avec problèmes. Utilise le consentement Google connecté ; renvoie error=scope_missing s'il manque la portée Merchant Center (auth/content) — l'utilisateur doit réautoriser Google.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte Merchant Center ; facultatif lorsque l'utilisateur n'a qu'un compte ou qu'un compte est sélectionné |
statusFacultatif | all | disapproved | pending | approved | issues | issues = tout problème au niveau de l'article ou pays refusé |
queryFacultatif | string | fragment du titre ou de l'id d'offre |
limitFacultatif | integer (1–1000) | — |
get_merchant_product_issues
Lecture1 créditsProblèmes au niveau de l'article d'un produit Merchant Center (code, gravité, résolution, description, pays concernés) plus ses statuts par destination ; indique les problèmes que le marchand peut corriger via les données produit. Utilise le consentement Google connecté ; renvoie error=scope_missing s'il manque la portée Merchant Center (auth/content) — l'utilisateur doit réautoriser Google.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte Merchant Center ; facultatif lorsque l'utilisateur n'a qu'un compte ou qu'un compte est sélectionné |
product_idFacultatif | string | p. ex. online~tr~TR~SKU123 (depuis list_merchant_products) |
offer_idFacultatif | string | — |
merchant_feed_status
Lecture1 créditsSources de données Merchant Center (flux) : type, méthode de saisie (API/FILE/UI/AUTOFEED), libellé de flux, langue et, pour les flux de fichiers, l'état de traitement du dernier envoi, le nombre d'articles et les problèmes. Utilise le consentement Google connecté ; renvoie error=scope_missing s'il manque la portée Merchant Center (auth/content) — l'utilisateur doit réautoriser Google.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte Merchant Center ; facultatif lorsque l'utilisateur n'a qu'un compte ou qu'un compte est sélectionné |
google_ads_query
Lecture2 créditsExécute une seule requête SELECT en lecture seule en Google Ads Query Language et renvoie les lignes brutes — pour les données qu'aucun outil dédié ne fournit. Un seul SELECT est accepté (pas de ';', de commentaires ni de mots-clés d'écriture) ; LIMIT est imposé (≤1000). Les montants sont en micros. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | une instruction GAQL SELECT, p. ex. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS |
limitFacultatif | integer (1–1000) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_details
Lecture1 créditsContenu complet des annonces Google Ads (type, chaque titre/description de RSA avec épinglage, URL, modèle de suivi, statut), plus l'efficacité de l'annonce, les actions d'amélioration de Google et l'approbation au regard des règles. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
ad_idFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_campaign_targeting
Lecture1 créditsCiblage actuel d'une campagne (ou d'un groupe d'annonces) Google Ads : lieux avec leur nom, lieux exclus, ciblage par rayon (lat/lng, rayon, unités), langues, ajustements d'enchères par appareil, audiences et l'option de ciblage géographique présence/intérêt. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_assets
Lecture2 créditsToute la bibliothèque d'assets Google Ads du compte (texte, images avec taille, vidéos YouTube, liens annexes, accroches, extraits, appels, promotions, prix, formulaires pour prospects, WhatsApp), éventuellement avec l'endroit où chacun est utilisé et son approbation. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
asset_typeFacultatif | TEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED | — |
limitFacultatif | integer (1–1000) | — |
include_usageFacultatif | boolean | liste aussi les campagnes/groupes d'annonces qui utilisent chaque asset |
include_approvalFacultatif | boolean | ajoute le statut d'approbation/examen au regard des règles |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
rsa_asset_performance
Lecture2 créditsRésultats par titre et par description des annonces responsives sur le Réseau de Recherche (impressions, clics, coût, conversions, valeur, CPA, CTR, taux de conversion) avec le libellé LOW/GOOD/BEST de Google, l'épinglage et l'efficacité de l'annonce. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
daysFacultatif | integer (1–365) | — |
limitFacultatif | integer (1–1000) | — |
min_impressionsFacultatif | integer (0–…) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_historical_metrics
Lecture2 créditsStatistiques historiques du Planificateur de mots-clés pour des mots-clés que vous connaissez déjà : recherches moyennes et mois par mois, concurrence, fourchette d'enchères en haut de page et CPC moyen. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
keywordsObligatoire | array<string> | — |
language_idFacultatif | string | id de constante de langue Google, par défaut 1037 (turc) |
languageFacultatif | string | alternative par code langue (tr, en…) |
geo_idsFacultatif | array<string> | id de constantes de ciblage géographique (geo_target_search), par défaut 2792 (Turquie) |
start_monthFacultatif | string | YYYY-MM |
end_monthFacultatif | string | YYYY-MM |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_quality_report
Lecture2 créditsNiveau de qualité historique jour par jour pour chaque mot-clé avec ses trois composantes, en signalant les dates de baisse et la composante qui a changé. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
daysFacultatif | integer (1–90) | — |
limitFacultatif | integer (1–500) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_negative_keywords
Lecture1 créditsTous les mots-clés négatifs qui s'appliquent : au niveau campagne, au niveau groupe d'annonces et les listes partagées de mots-clés négatifs associées aux campagnes (avec leurs mots-clés). Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
smart_negative_keywords
Lecture2 créditsSuggestions de mots-clés négatifs : termes de recherche ayant dépensé sans aucune conversion et qui ne sont encore négatifs nulle part, classés par dépense (économie estimée). Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
min_wasteFacultatif | number | dépense minimale par terme |
limitFacultatif | integer (1–500) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
conversion_tracking_health
Lecture2 créditsBilan du suivi des conversions : actions masquées/supprimées, actions principales qui n'ont rien enregistré sur la période et action principale manquante. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
extension_asset_performance
Lecture2 créditsPerformances des extensions de campagne (liens annexes, accroches, appel, extraits, promotions, prix, WhatsApp, images, nom/logo de l'entreprise) : impressions, clics, coût, conversions par asset. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
field_typeFacultatif | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | — |
limitFacultatif | integer (1–1000) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_schedule
Lecture1 créditsCalendrier de diffusion actuel d'une campagne : jour, heure de début/fin, ajustement d'enchère et id de critère par créneau. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_conversion_tags
Lecture1 créditsDétails des balises des actions de conversion : ID de conversion (AW-…), libellé et valeur send_to pour Tag Manager / gtag, plus les extraits bruts. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
conversion_action_idsFacultatif | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_extension_assets
Lecture1 créditsAssets d'extension associés à une campagne ou à un groupe d'annonces (liens annexes, accroches, appel, extraits, promotions, prix, WhatsApp, formulaire pour prospects, application, nom/logo de l'entreprise) avec le nom de ressource du lien utilisé pour la suppression. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_conversion_goals
Lecture1 créditsObjectifs de conversion du compte (catégorie × origine) et si chacun est principal/utilisable pour les enchères ; avec campaign_id, aussi les remplacements d'objectifs de cette campagne. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_custom_conversion_goals
Lecture1 créditsObjectifs de conversion personnalisés : nom, actions de conversion incluses, statut et campagnes qui optimisent pour chacun. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
budget_pacing_alerts
Lecture2 créditsDépenses depuis le début du mois comparées au budget quotidien des campagnes actives, projetées à la fin du mois ; signale les campagnes en passe de dépasser ou de sous-consommer leur budget. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
threshold_pctFacultatif | number (1–100) | écart qui déclenche une alerte, par défaut 10 |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
impression_share_analysis
Lecture2 créditsTaux d'impressions sur le Réseau de Recherche, taux en haut / tout en haut de la page, taux en correspondance exacte et part perdue à cause du budget ou du classement, plus les annonces refusées par campagne. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
levelFacultatif | campaign | ad_group | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_audiences
Lecture1 créditsListes d'audiences (remarketing, site web basé sur des règles, Customer Match, similaires) : id, type, statut, durée d'appartenance, taille Recherche/Display et éligibilité. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
limitFacultatif | integer (1–1000) | — |
definitionFacultatif | boolean | inclut la définition de règle / source de la liste |
searchFacultatif | string | name contains, or exact list id |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_experiments
Lecture1 créditsListe les tests de campagne (tests A/B) avec id, statut et dates. Lecture seule ; pour en arrêter ou en appliquer un, utilisez manage_experiment. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | list | uniquement list ; pour arrêter ou appliquer, manage_experiment |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
geo_target_search
Lecture1 créditsRecherche par nom les id de ciblage géographique Google : id, type (ville, province, pays…), nom canonique et portée — utilisez les id dans le ciblage géographique. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | — |
countryFacultatif | string | indication de pays ISO |
levelFacultatif | string | filtre par type, p. ex. City, Province, Country, District, Postal Code |
limitFacultatif | integer (1–50) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_campaign_diagnosis
Lecture2 créditsDiagnostic d'état EN DIRECT d'une campagne Google Ads. À appeler en premier lorsque l'utilisateur signale un avertissement ou un état (mal configurée, limitée, non éligible, en apprentissage, refusée), puis pour vérifier une modification. Renvoie l'état principal avec chaque motif (code, signification, correction habituelle, outils), l'état de diffusion, la stratégie d'enchères avec son CPA / ROAS cible, le champ qui contient la cible, l'état système de la stratégie d'enchères (la cause réelle d'une mauvaise configuration des enchères), le type d'objectif des campagnes d'applications, le budget et le budget recommandé par Google, les dates de début et de fin, les actions de conversion optimisées avec leur état, les constats, les recommandations et les modifications récentes. Montants dans la devise du compte. Lecture seule. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads ; sans valeur, toutes les campagnes ayant un problème d'état sont listées |
relatedFacultatif | boolean | true par défaut : aussi les recommandations de la campagne et les modifications des 14 derniers jours |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_ad_policy_issues
Lecture2 créditsAnnonces refusées ou limitées par Google, avec les thèmes de règlement et le texte justificatif de chaque décision. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
only_problemsFacultatif | boolean | par défaut true : uniquement les annonces refusées / limitées |
limitFacultatif | integer (1–1000) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_lead_form_submissions
Lecture2 créditsProspects envoyés via les formulaires Google Ads (nom, e-mail, téléphone et réponses personnalisées, campagne, heure). Données personnelles — à traiter avec soin. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
asset_idFacultatif | string | id de l'asset formulaire pour prospects |
limitFacultatif | integer (1–1000) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_location_assets
Lecture1 créditsBusiness Profile location sync in Google Ads: location asset sets (LOCATION_SYNC, location groups), whether they are linked to the account, and the synced location assets. linked=false means ads cannot show the Business Profile address yet. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outils d'écriture74 outils
select_google_ads_account
Écriture1 créditsChange le compte client Google Ads utilisé par toutes les lectures et écritures suivantes (agence/MCC : le bon login-customer-id est défini automatiquement). Réglage local ; rien ne change chez Google.
| Paramètre | Type | Description |
|---|---|---|
customer_idObligatoire | string | id du compte client issu de list_google_ads_accounts |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
apply_google_ads_recommendation
Écriture2 créditsApplique les recommandations Google Ads sélectionnées (jusqu'à 100). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
recommendationsObligatoire | array<string> | noms de ressources issus de list_google_ads_recommendations |
actionFacultatif | apply | dismiss | default apply |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_search_campaign
Écriture2 créditsCrée une campagne Google Search en un seul flux : budget, campagne, ciblage géographique + linguistique, stratégie d'enchères, groupe d'annonces, mots-clés et annonce responsive sur le Réseau de Recherche (textes issus par défaut du profil de marque). Créée en PAUSED après validation. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | devise du compte |
locationsFacultatif | array<string> | noms de villes/régions/pays ; par défaut : la ville du profil de marque |
location_idsFacultatif | array<string> | ids de constantes de ciblage géographique Google |
countryFacultatif | string | — |
languagesFacultatif | array<string> | codes de langue (tr, en…) ou ids de langue Google ; turc par défaut |
bid_strategyFacultatif | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | — |
max_cpcFacultatif | number | — |
cpc_bidFacultatif | number | CPC par défaut du groupe d'annonces |
keywordsFacultatif | array<any> | — |
headlinesFacultatif | array<any> | — |
descriptionsFacultatif | array<any> | — |
final_urlFacultatif | string | — |
ad_group_nameFacultatif | string | — |
search_partnersFacultatif | boolean | — |
end_dateFacultatif | string | YYYY-MM-DD |
goalFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_pmax_campaign
Écriture2 créditsCrée une campagne Performance Max : budget + campagne + groupe d'assets + assets texte + images (téléchargées depuis les URL fournies puis importées) en une seule requête atomique, créée en PAUSED. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | — |
final_urlObligatoire | string | — |
business_nameObligatoire | string | ≤25 caractères |
headlinesObligatoire | array<string> | 3-15, ≤30 caractères |
long_headlinesObligatoire | array<string> | 1-5, ≤90 caractères |
descriptionsObligatoire | array<string> | 2-5, ≤90 caractères |
marketing_imagesObligatoire | array<string> | paysage 1.91:1, au moins 1 |
square_marketing_imagesObligatoire | array<string> | 1:1, au moins 1 |
logo_imagesObligatoire | array<string> | logo 1:1, au moins 1 |
portrait_marketing_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
landscape_logo_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
bid_strategyFacultatif | maximize_conversions | maximize_conversion_value | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | — |
locationsFacultatif | array<string> | — |
countryFacultatif | string | — |
languagesFacultatif | array<string> | — |
asset_group_nameFacultatif | string | — |
end_dateFacultatif | string | — |
goalFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_display_campaign
Écriture2 créditsCrée une campagne Display : budget + campagne + groupe d'annonces + annonce display responsive (les images sont téléchargées depuis les URL fournies, recadrées au format de chaque champ puis importées) en une seule requête atomique, en PAUSED. Le Réseau de Recherche est désactivé ; la campagne ne diffuse que sur le Réseau Display.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | — |
final_urlObligatoire | string | — |
business_nameObligatoire | string | ≤25 caractères |
headlinesObligatoire | array<string> | 1-5, ≤30 caractères |
long_headlineObligatoire | string | ≤90 caractères |
descriptionsObligatoire | array<string> | 1-5, ≤90 caractères |
marketing_imagesObligatoire | array<string> | paysage 1.91:1, au moins 1 |
square_marketing_imagesFacultatif | array<string> | 1:1, au moins 1 (sinon recadrée depuis l'image paysage) |
logo_imagesFacultatif | array<string> | image URLs (https) or Studio /medya files |
landscape_logo_imagesFacultatif | array<string> | image URLs (https) or Studio /medya files |
bid_strategyFacultatif | maximize_conversions | target_cpa | maximize_clicks | manual_cpc | — |
target_cpaFacultatif | number | — |
max_cpcFacultatif | number | — |
cpc_bidFacultatif | number | — |
locationsFacultatif | array<string> | — |
countryFacultatif | string | — |
languagesFacultatif | array<string> | — |
ad_group_nameFacultatif | string | — |
end_dateFacultatif | string | — |
goalFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_shopping_campaign
Écriture2 créditsCrée une campagne Shopping standard : budget + campagne + groupe d'annonces + annonce produit en une seule requête atomique, en PAUSED. Les produits viennent du compte Merchant Center associé ; la priorité 0-2 détermine quelle campagne l'emporte pour un même produit.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | — |
merchant_idObligatoire | string | — |
campaign_priorityFacultatif | 0 | 1 | 2 | — |
feed_labelFacultatif | string | — |
enable_localFacultatif | boolean | — |
bid_strategyFacultatif | manual_cpc | maximize_clicks | target_roas | maximize_conversion_value | — |
target_roasFacultatif | number | — |
max_cpcFacultatif | number | — |
cpc_bidFacultatif | number | — |
locationsFacultatif | array<string> | — |
countryFacultatif | string | — |
languagesFacultatif | array<string> | — |
ad_group_nameFacultatif | string | — |
end_dateFacultatif | string | — |
goalFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_google_conversion_value_rules
Écriture2 créditsAjuste la valeur de conversion au moment de l'enchère selon une condition : p. ex. une conversion mobile compte 1,2 fois, ou depuis une ville donnée vaut davantage. Une condition par règle (appareil, zone ou audience) ; la règle est rattachée à un ensemble de règles de valeur du compte ou d'une campagne.
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | create | remove | — |
operationFacultatif | ADD | MULTIPLY | SET | — |
valueFacultatif | number | pour MULTIPLY 0,5-10 ; pour ADD/SET supérieur à 0 (dans la devise du compte) |
device_typesFacultatif | array<string> | e.g. MOBILE, DESKTOP, TABLET |
geo_target_idsFacultatif | array<string> | — |
geo_match_typeFacultatif | string | — |
user_list_idsFacultatif | array<string> | — |
campaign_idFacultatif | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
resource_nameFacultatif | string | for action=remove |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_google_campaign
Écriture2 créditsRenomme, met en pause/active ou définit/supprime la date de fin d'une campagne Google Ads ; l'aperçu montre actuel → nouveau. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
nameFacultatif | string | — |
statusFacultatif | pause | enable | — |
end_dateFacultatif | string | null | YYYY-MM-DD, ou null pour une diffusion sans fin |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
rename_google_campaigns
Écriture2 créditsRenomme des campagnes Google Ads en masse (liste explicite, modèle de nommage ou rechercher/remplacer). L'aperçu est un tableau ancien → nouveau ; les noms doivent rester uniques. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
renamesFacultatif | array<object> | — |
campaign_idsFacultatif | array<string> | — |
patternFacultatif | string | modèle de nommage avec {name}, {channel}, {id}, p. ex. 'Brand | {channel} | {name}' |
findFacultatif | string | — |
replaceFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_google_campaign
ÉcritureIrréversible2 créditsSupprime DÉFINITIVEMENT une campagne Google Ads (ni annulable ni réactivable ; l'historique reste dans les rapports). Jamais appliqué automatiquement : attend toujours l'approbation explicite de l'utilisateur. En cas de doute, préférez update_google_campaign(status=pause). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_google_bid_strategy
Écriture2 créditsChange la stratégie d'enchères d'une campagne Google Ads : maximiser les conversions (CPA cible facultatif), maximiser la valeur de conversion (ROAS cible facultatif), CPA cible, ROAS cible, CPC manuel, maximiser les clics. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation). Pour une campagne d'applications, le type de stratégie ne peut pas être modifié ; seule sa cible est mise à jour (target_cpa = coût cible par installation / action dans l'application, ou target_roas). Lisez la cause avec google_campaign_diagnosis avant de modifier une cible pour supprimer un avertissement. La valeur précédente est conservée et la modification est annulable.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
strategyObligatoire | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share | — |
target_cpaFacultatif | number | devise du compte |
target_roasFacultatif | number | ratio, 4.0 = 400 % |
max_cpcFacultatif | number | plafond de CPC pour maximize_clicks |
impression_share_locationFacultatif | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentFacultatif | number (1–100) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_google_ad_schedule
Écriture2 créditsDéfinit le calendrier de diffusion d'une campagne Google Ads (créneaux jour/heure avec ajustement d'enchère facultatif) ; les annonces ne sont pas diffusées hors des créneaux. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
replaceFacultatif | boolean | supprime d'abord le calendrier existant |
scheduleObligatoire | array<object> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_google_location_targets
Écriture2 créditsCible ou exclut des zones géographiques dans une campagne Google Ads ; les noms sont résolus via les suggestions de ciblage géographique Google et affichés dans l'aperçu. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
locationsFacultatif | array<string> | noms, p. ex. İstanbul, Ankara |
location_idsFacultatif | array<string> | — |
countryFacultatif | string | code ISO indicatif, TR par défaut |
excludeFacultatif | boolean | — |
replaceFacultatif | boolean | supprime d'abord les zones ciblées existantes |
bid_adjustmentFacultatif | number | pourcentage |
languagesFacultatif | array<string> | language codes (tr, en…) or Google language ids to target |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
merge_google_campaigns
ÉcritureIrréversible2 créditsFusion sûre de campagnes : met en pause les campagnes sources et transfère leur budget quotidien vers la cible (Google ne permet pas de déplacer des groupes d'annonces entre campagnes). Soumis au garde-fou budgétaire (max. +50 % par modification) ; jamais appliqué automatiquement. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
target_campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
source_campaign_idsObligatoire | array<string> | — |
move_budgetFacultatif | boolean | ajouter les budgets quotidiens des sources à la cible (true par défaut) |
new_daily_budgetFacultatif | number | budget quotidien cible explicite au lieu de la somme |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
exclude_google_ips
Écriture2 créditsExclut des adresses IP (protection contre la fraude au clic) d'une campagne Google Ads (blocage d'IP négatif au niveau de la campagne, 500 max.). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ipsObligatoire | array<string> | adresses IPv4/IPv6 ou blocs CIDR |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
unblock_ip_addresses
Écriture2 créditsRetire des exclusions d'IP d'une campagne Google Ads (l'inverse de exclude_google_ips) ; seules les IP réellement exclues de la campagne sont retirées. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ipsObligatoire | array<string> | adresses IPv4/IPv6 ou blocs CIDR à ne plus exclure |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_ad_group
Écriture2 créditsAjoute un groupe d'annonces Search à une campagne Google Ads, avec éventuellement des mots-clés et une annonce responsive sur le Réseau de Recherche. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
nameObligatoire | string | — |
cpc_bidFacultatif | number | — |
keywordsFacultatif | array<any> | — |
headlinesFacultatif | array<any> | — |
descriptionsFacultatif | array<any> | — |
final_urlFacultatif | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_google_ad_group_status
Écriture2 créditsMet en pause ou active des groupes d'annonces Google Ads. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idsFacultatif | array<string> | — |
ad_group_idFacultatif | string | — |
statusObligatoire | pause | enable | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
pause_google_ad_groups
Écriture2 créditsMet en pause plusieurs groupes d'annonces Google Ads à la fois (p. ex. les groupes sans conversion issus de google_ads_report breakdown=ad_group). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idsObligatoire | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_google_keywords
Écriture2 créditsAjoute des mots-clés (texte, BROAD|PHRASE|EXACT, enchère CPC facultative) à un groupe d'annonces Google Ads. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
keywordsObligatoire | array<any> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_google_keyword
Écriture2 créditsMet en pause/active un mot-clé Google Ads, modifie son enchère CPC ou son type de correspondance (Google exige suppression + rajout ; fait en une seule requête atomique). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
keyword_idObligatoire | string | — |
statusFacultatif | pause | enable | — |
bidFacultatif | number | — |
match_typeFacultatif | BROAD | PHRASE | EXACT | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_google_negative_keywords
ÉcritureIrréversible2 créditsRetire des mots-clés à exclure (par texte, éventuellement par type de correspondance) d'une campagne Google Ads ou d'une liste d'exclusion partagée — l'annulation d'une exclusion erronée. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
shared_list_idFacultatif | string | — |
keywordsFacultatif | array<string> | — |
criterion_idsFacultatif | array<string> | negative criterion ids (list_negative_keywords) instead of / in addition to text |
match_typeFacultatif | BROAD | PHRASE | EXACT | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_to_google_shared_negative_list
Écriture2 créditsAjoute des exclusions (chacune avec son type de correspondance) à une liste d'exclusion partagée à l'échelle du compte — ou en crée une — et l'associe à des campagnes. Les termes existants sont ignorés. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
list_idFacultatif | string | — |
list_nameFacultatif | string | crée une nouvelle liste lorsque list_id n'est pas fourni |
keywordsObligatoire | array<any> | — |
attach_campaign_idsFacultatif | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_rsa
Écriture2 créditsCrée une annonce responsive sur le Réseau de Recherche (3-15 titres ≤30, 2-4 descriptions ≤90, épinglage facultatif) dans un groupe d'annonces Google Ads. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
headlinesObligatoire | array<any> | — |
descriptionsObligatoire | array<any> | — |
final_urlObligatoire | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
final_mobile_urlFacultatif | string | — |
tracking_url_templateFacultatif | string | — |
statusFacultatif | enable | pause | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_google_rsa_assets
Écriture2 créditsRenouvelle les titres/descriptions faibles d'une RSA : Google n'autorise pas la modification du texte d'une RSA, donc une nouvelle annonce est créée avec le nouveau jeu et l'ancienne mise en pause, en une seule requête. L'aperçu montre les textes ancien → nouveau. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
ad_idObligatoire | string | — |
replace_low_performingFacultatif | boolean | — |
remove_headlinesFacultatif | array<string> | — |
add_headlinesFacultatif | array<any> | — |
remove_descriptionsFacultatif | array<string> | — |
add_descriptionsFacultatif | array<any> | — |
headlinesFacultatif | array<any> | — |
descriptionsFacultatif | array<any> | — |
final_urlFacultatif | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
pause_oldFacultatif | boolean | true par défaut |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_google_sitelinks
Écriture2 créditsAjoute des assets liens annexes (texte ≤25, deux descriptions facultatives ≤35, URL finale) à une campagne Google Ads. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
sitelinksObligatoire | array<object> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_google_callouts
Écriture2 créditsAjoute des assets accroches (≤25 caractères) à une campagne Google Ads. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
calloutsObligatoire | array<string> | ≤25 caractères chacune |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_conversion_action
Écriture2 créditsCrée une action de conversion de site web ; le résultat contient l'extrait de balise à installer (p. ex. avec les outils Tag Manager). Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
categoryFacultatif | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeFacultatif | one | many | — |
primary_for_goalFacultatif | boolean | — |
default_valueFacultatif | number | — |
currencyFacultatif | string | — |
always_use_default_valueFacultatif | boolean | — |
click_through_window_daysFacultatif | integer (1–90) | — |
view_through_window_daysFacultatif | integer (1–30) | — |
phone_call_duration_secondsFacultatif | integer (0–10800) | — |
typeFacultatif | WEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALL | default WEBPAGE; UPLOAD_CLICKS for offline conversion upload |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_google_conversion_action
Écriture2 créditsModifie une action de conversion Google Ads : principale vs secondaire (primary_for_goal), statut, catégorie, comptabilisation, paramètres de valeur, fenêtre de conversion après clic. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
conversion_action_idObligatoire | string | — |
nameFacultatif | string | — |
statusFacultatif | enable | hide | remove | ENABLED | HIDDEN | REMOVED | — |
categoryFacultatif | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeFacultatif | one | many | — |
primary_for_goalFacultatif | boolean | — |
default_valueFacultatif | number | — |
currencyFacultatif | string | — |
always_use_default_valueFacultatif | boolean | — |
click_through_window_daysFacultatif | integer (1–90) | — |
view_through_window_daysFacultatif | integer (1–30) | — |
phone_call_duration_secondsFacultatif | integer (0–10800) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_google_asset_group_assets
Écriture2 créditsAjoute des titres, titres longs, descriptions et images (téléchargées depuis des URL puis importées) à un groupe d'assets Performance Max en une seule requête atomique. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
asset_group_idObligatoire | string | — |
headlinesFacultatif | array<string> | — |
long_headlinesFacultatif | array<string> | — |
descriptionsFacultatif | array<string> | — |
business_nameFacultatif | string | — |
marketing_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
square_marketing_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
logo_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
portrait_marketing_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
landscape_logo_imagesFacultatif | array<string> | URL d'images (https) ou fichiers Studio /medya |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_google_image_asset
Écriture2 créditsImporte des images dans la bibliothèque d'assets Google Ads (assets:mutate, imageAsset) ; le résultat renvoie des noms de ressources d'assets réutilisables dans create_google_demand_gen_campaign / create_google_app_campaign. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
imagesObligatoire | array<any> | URL https ou fichiers Studio /medya (JPEG/PNG/GIF, ≤5120 Ko), jusqu'à 20 |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_demand_gen_campaign
Écriture2 créditsCrée une campagne Google Demand Gen (YouTube, Discover, Gmail) : budget + campagne (advertising_channel_type DEMAND_GEN) + groupe d'annonces + annonce multi-assets (DemandGenMultiAssetAdInfo : titres, descriptions, nom de l'entreprise, logo, images paysage/carrées/portrait importées depuis des URL ou liées par id d'asset), ciblage facultatif par audience, zone géographique et langue, enchères maximiser les conversions / tCPA / tROAS. Créée en PAUSED après validation. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | devise du compte |
final_urlObligatoire | string | — |
business_nameObligatoire | string | ≤25 caractères |
headlinesObligatoire | array<string> | 1-5, ≤40 caractères |
descriptionsObligatoire | array<string> | 1-5, ≤90 caractères |
marketing_imagesFacultatif | array<string> | paysage 1.91:1 — URL à importer ou ids d'assets existants |
square_marketing_imagesFacultatif | array<string> | 1:1 — URL ou ids d'assets |
portrait_marketing_imagesFacultatif | array<string> | 4:5 — URL ou ids d'assets |
logo_imagesObligatoire | array<string> | logo 1:1, au moins 1 — URL ou ids d'assets |
call_to_actionFacultatif | string | p. ex. Learn more, Shop now (≤15 caractères) |
bid_strategyFacultatif | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | — |
max_cpcFacultatif | number | — |
audience_idsFacultatif | array<string> | ids d'audiences Google Ads (Gestionnaire d'audiences) à cibler sur le groupe d'annonces ; vide = large |
locationsFacultatif | array<string> | — |
location_idsFacultatif | array<string> | — |
countryFacultatif | string | — |
languagesFacultatif | array<string> | — |
ad_group_nameFacultatif | string | — |
end_dateFacultatif | string | YYYY-MM-DD |
goalFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_app_campaign
Écriture2 créditsCrée une campagne Google pour applications (advertising_channel_type MULTI_CHANNEL, sous-type APP_CAMPAIGN, app_campaign_setting avec id de l'application, store et objectif d'enchères) : budget + campagne + groupe d'annonces + annonce d'application (assets texte, images/vidéos facultatives), enchères CPI/CPA cible ou ROAS, ciblage géographique/linguistique. Créée en PAUSED après validation ; l'application doit être associée au compte. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | devise du compte |
app_idObligatoire | string | id numérique d'application Apple (p. ex. 284815942) ou nom de package Android (p. ex. com.example.app) |
app_storeObligatoire | apple | google | — |
goalFacultatif | installs | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registration | installs = coût cible par installation (par défaut) ; in_app_actions = installations susceptibles d'agir dans l'application (tCPI) ; in_app_actions_cpa = coût cible par action dans l'application ; value = ROAS cible ; installs_no_target / pre_registration = maximiser |
target_cpaFacultatif | number | coût cible par installation / action dans l'application |
target_roasFacultatif | number | — |
conversion_action_idsFacultatif | array<string> | actions de conversion dans l'application pour les objectifs in_app / value (list_google_conversion_actions) |
headlinesObligatoire | array<string> | 2-5, ≤30 caractères |
descriptionsObligatoire | array<string> | 1-5, ≤90 caractères |
imagesFacultatif | array<string> | URL d'images facultatives à importer ou ids d'assets existants |
video_asset_idsFacultatif | array<string> | ids d'assets vidéo YouTube existants |
locationsFacultatif | array<string> | — |
location_idsFacultatif | array<string> | — |
countryFacultatif | string | — |
languagesFacultatif | array<string> | — |
ad_group_nameFacultatif | string | — |
end_dateFacultatif | string | YYYY-MM-DD |
goal_noteFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_google_app_ad
Écriture2 créditsRemplace les titres et descriptions d'une annonce de campagne d'application Google (texte actuel via get_ad_details). Le résultat conserve l'ancien texte.
| Paramètre | Type | Description |
|---|---|---|
ad_idObligatoire | string | — |
headlinesFacultatif | array<string> | 2-5, up to 30 characters |
descriptionsFacultatif | array<string> | 1-5, up to 90 characters |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
google_click_fraud_guard
Écriture2 créditsProtection contre la fraude au clic : trouve les campagnes aux taux de clics incorrects suspects (ou prend campaign_ids) et exclut les adresses IP fournies sur chacune (blocage d'IP négatif au niveau de la campagne). Sans ips, ne fait que signaler les campagnes suspectes et les anomalies géographiques — l'API Google Ads ne révèle jamais les IP des cliqueurs, les exclusions nécessitent donc des adresses que vous avez obtenues vous-même. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
threshold_rateFacultatif | number | — |
campaign_idsFacultatif | array<string> | campagnes explicites ; par défaut : les campagnes signalées par le rapport des clics incorrects |
ipsFacultatif | array<string> | adresses IPv4/IPv6 ou blocs CIDR issus de vos propres journaux serveur/analytics |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upsert_merchant_product
Écriture2 créditsAjoute ou met à jour une saisie de produit Merchant Center (products v1beta productInputs:insert — remplace une saisie existante ayant les mêmes id d'offre, langue, libellé de flux et source de données). Crée un élément de validation avec aperçu ; envoyé à Google uniquement après validation et uniquement avec un compte Google connecté. Utilise le consentement Google connecté ; renvoie error=scope_missing s'il manque la portée Merchant Center (auth/content) — l'utilisateur doit réautoriser Google.
| Paramètre | Type | Description |
|---|---|---|
offer_idObligatoire | string | — |
content_languageFacultatif | string | tr par défaut |
feed_labelFacultatif | string | TR par défaut |
account_idFacultatif | string | id du compte Merchant Center ; facultatif lorsque l'utilisateur n'a qu'un compte ou qu'un compte est sélectionné |
data_sourceFacultatif | string | id de la source de données ; par défaut : la source de données produit API/principale du compte |
titleFacultatif | string | — |
descriptionFacultatif | string | — |
linkFacultatif | string | — |
image_linkFacultatif | string | — |
priceFacultatif | number | — |
sale_priceFacultatif | number | — |
currencyFacultatif | string | ISO, TRY par défaut |
availabilityFacultatif | in stock | out of stock | preorder | backorder | — |
conditionFacultatif | new | refurbished | used | — |
brandFacultatif | string | — |
gtinFacultatif | string | — |
googleProductCategoryFacultatif | string | — |
imageLinkFacultatif | string | Alias of image_link |
channelFacultatif | ONLINE | LOCAL | default ONLINE |
attributesFacultatif | object | autres attributs produit de la Merchant API (camelCase), p. ex. color, sizes, itemGroupId, customLabel0 |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_experiment
ÉcritureIrréversible2 créditsArrête un test de campagne (test A/B) ou applique ses modifications à la campagne de base. Irréversible ; attend toujours une validation explicite. Nécessite un compte Google Ads connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
experiment_idObligatoire | string | — |
actionObligatoire | end | promote | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_demand_gen_ad
Écriture2 créditsAjoute une annonce vidéo YouTube (DemandGenVideoResponsiveAd) à un groupe d'annonces Demand Gen — la création qui permet à une campagne vidéo Demand Gen d'être diffusée. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
youtube_videoObligatoire | string | URL YouTube ou id de 11 caractères, ou id d'un asset vidéo existant |
headlinesObligatoire | array<string> | 1 à 5, ≤40 |
long_headlinesObligatoire | array<string> | 1 à 5, ≤90 |
descriptionsObligatoire | array<string> | 1 à 5, ≤90 |
business_nameObligatoire | string | — |
final_urlObligatoire | string | — |
logo_asset_idObligatoire | string | id d'asset logo 1:1 ou URL d'image |
call_to_actionFacultatif | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW | — |
ad_nameFacultatif | string | — |
statusFacultatif | enable | pause | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
copy_ad_group
Écriture2 créditsDuplique des groupes d'annonces avec leurs mots-clés, mots-clés négatifs, annonces responsives sur le Réseau de Recherche, assets du groupe et audiences dans une autre campagne (ou la même) en une seule requête atomique ; les copies démarrent en pause par défaut. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idsObligatoire | array<string> | — |
target_campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
new_nameFacultatif | string | — |
name_suffixFacultatif | string | — |
statusFacultatif | pause | enable | par défaut pause |
cpc_bidFacultatif | number | — |
include_keywordsFacultatif | boolean | — |
include_negativesFacultatif | boolean | — |
include_adsFacultatif | boolean | — |
include_assetsFacultatif | boolean | — |
include_audiencesFacultatif | boolean | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_ad_group_targeting
Écriture2 créditsCiblage géographique et linguistique d'un groupe d'annonces (là où Demand Gen le conserve) : ajoute ou remplace les lieux et langues ciblés / exclus. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
locationsFacultatif | array<string> | — |
location_idsFacultatif | array<string> | — |
negative_locationsFacultatif | array<string> | — |
negative_location_idsFacultatif | array<string> | — |
languagesFacultatif | array<string> | — |
countryFacultatif | string | — |
modeFacultatif | add | replace | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_ad_group
Écriture2 créditsRenomme un groupe d'annonces Google Ads, modifie son CPC max par défaut et/ou le met en pause/l'active. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
nameFacultatif | string | — |
cpc_bidFacultatif | number | — |
statusFacultatif | pause | enable | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_ad_status
ÉcritureIrréversible2 créditsActive, met en pause ou supprime définitivement une annonce Google Ads. REMOVED est irréversible et attend toujours une approbation explicite. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
ad_idObligatoire | string | — |
statusObligatoire | ENABLED | PAUSED | REMOVED | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_pmax_assets
Écriture2 créditsAjoute et retire des assets texte d'un groupe d'assets Performance Max en une seule requête (images : add_google_asset_group_assets). Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
asset_group_idObligatoire | string | — |
headlinesFacultatif | array<string> | — |
long_headlinesFacultatif | array<string> | — |
descriptionsFacultatif | array<string> | — |
remove_resource_namesFacultatif | array<string> | liaisons d'assets de groupe d'assets issues de list_google_asset_groups |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_rsa
Écriture2 créditsModifie sur place une annonce responsive sur le Réseau de Recherche (même id, historique conservé) : remplacer l'ensemble complet ou ajouter/retirer des titres/descriptions, modifier les épinglages, l'URL finale et les chemins. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_idObligatoire | string | — |
headlinesFacultatif | array<any> | — |
descriptionsFacultatif | array<any> | — |
add_headlinesFacultatif | array<any> | — |
remove_headlinesFacultatif | array<string> | — |
add_descriptionsFacultatif | array<any> | — |
remove_descriptionsFacultatif | array<string> | — |
headline_pinsFacultatif | object | {texte : champ d'épinglage} — une chaîne vide supprime l'épinglage |
description_pinsFacultatif | object | {texte : champ d'épinglage} — une chaîne vide supprime l'épinglage |
final_urlFacultatif | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_negative_keyword
Écriture2 créditsAjoute un ou plusieurs mots-clés négatifs au niveau de la campagne ou du groupe d'annonces (chacun avec son propre type de correspondance) ; ceux qui existent déjà sont ignorés. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
textFacultatif | string | — |
keywordsFacultatif | array<any> | — |
match_typeFacultatif | BROAD | PHRASE | EXACT | — |
skip_existingFacultatif | boolean | par défaut true |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_keywords
ÉcritureIrréversible2 créditsMet en pause / active / supprime définitivement en masse des mots-clés existants, ou définit leur CPC max ou leurs URL finales au niveau du mot-clé. remove attend une approbation explicite. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
criterion_idsObligatoire | array<string> | — |
actionObligatoire | pause | enable | remove | set_bid | set_url | — |
cpc_bidFacultatif | number | — |
final_urlFacultatif | string | — |
final_mobile_urlFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_shared_negative_list
ÉcritureIrréversible2 créditsGère les listes partagées de mots-clés négatifs au niveau du compte : créer, ajouter/retirer des mots-clés, associer ou dissocier des campagnes, renommer, supprimer (la suppression attend une approbation explicite). Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
actionObligatoire | create | add_keywords | remove_keywords | attach | detach | rename | delete | — |
shared_set_idFacultatif | string | — |
nameFacultatif | string | — |
keywordsFacultatif | array<any> | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
campaign_idsFacultatif | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
dismiss_recommendations
Écriture2 créditsIgnore les recommandations Google Ads dont vous ne voulez pas. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
resource_namesObligatoire | array<string> | depuis list_google_ads_recommendations |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_extension_assets
Écriture2 créditsAjoute des assets d'extension à une campagne (ou à un groupe d'annonces) en une seule requête atomique : liens annexes, accroches, extrait structuré, appel, message WhatsApp, promotions et liste de prix. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
sitelinksFacultatif | array<object> | — |
calloutsFacultatif | array<string> | — |
snippet_headerFacultatif | string | p. ex. Services, Brands, Types, Destinations |
snippet_valuesFacultatif | array<string> | — |
phone_numberFacultatif | string | — |
phone_countryFacultatif | string | — |
whatsapp_numberFacultatif | string | — |
whatsapp_countryFacultatif | string | — |
whatsapp_greetingFacultatif | string | — |
whatsapp_ctaFacultatif | APPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE | — |
whatsapp_cta_textFacultatif | string | — |
promotionsFacultatif | array<object> | — |
pricesFacultatif | object | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_extension_assets
ÉcritureIrréversible2 créditsDissocie des assets d'extension d'une campagne ou d'un groupe d'annonces (les assets restent dans la bibliothèque et peuvent être réassociés). Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
resource_namesFacultatif | array<string> | noms de ressource des liaisons issus de list_extension_assets |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
field_typeFacultatif | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | avec campaign_id : retire toutes les liaisons de ce type |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_sitelink
Écriture2 créditsModifie sur place un lien annexe existant (texte du lien, les deux lignes de description, URL finale) sans le recréer. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
asset_idObligatoire | string | — |
link_textFacultatif | string | — |
description1Facultatif | string | — |
description2Facultatif | string | — |
final_urlFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_portfolio_bidding_strategy
Écriture2 créditsStratégies d'enchères de portefeuille (partagées) : les lister, en créer une, modifier ses objectifs ou y rattacher une campagne. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | list | create | update | assign | — |
nameFacultatif | string | — |
strategyFacultatif | target_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | — |
max_cpcFacultatif | number | — |
min_cpcFacultatif | number | — |
impression_share_locationFacultatif | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentFacultatif | number (1–100) | — |
bidding_strategy_idFacultatif | string | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_google_bidding_periods
Écriture2 créditsPrévient les enchères intelligentes d'une courte période : un ajustement de saisonnalité pour une promotion ou un lancement (multiplicateur attendu du taux de conversion), ou une exclusion de données pour les jours où la mesure était cassée (site hors ligne, balise absente), afin que ces jours n'entraînent pas l'enchérisseur. Lisez les existants avec google_ads_query. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | create | remove | — |
typeObligatoire | seasonality | data_exclusion | — |
nameFacultatif | string | — |
scopeFacultatif | CAMPAIGN | CHANNEL | — |
campaign_idsFacultatif | array<string> | — |
channel_typesFacultatif | array<string> | — |
devicesFacultatif | array<string> | — |
start_date_timeFacultatif | string | AAAA-MM-JJ ou AAAA-MM-JJ HH:MM:SS, dans le fuseau horaire du compte |
end_date_timeFacultatif | string | AAAA-MM-JJ ou AAAA-MM-JJ HH:MM:SS, dans le fuseau horaire du compte |
conversion_rate_modifierFacultatif | number (0.1–10) | ajustement de saisonnalité uniquement : 1,2 = 20 % de conversions attendues en plus |
resource_nameFacultatif | string | for action=remove |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_recommendation_auto_apply
Écriture2 créditsAffiche et bascule par type l'application automatique des recommandations Google. L'activation attend toujours une approbation explicite, car Google modifie ensuite le compte de lui-même. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | list | enable | disable | — |
typesFacultatif | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_conversion_goal
Écriture2 créditsRend un objectif de conversion (catégorie × origine) principal ou secondaire pour le compte ou une campagne — ce pour quoi Smart Bidding optimise. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
categoryObligatoire | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
originFacultatif | WEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS | — |
roleObligatoire | primary | secondary | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_custom_conversion_goal
ÉcritureIrréversible2 créditsCrée, modifie (actions incluses, nom) ou supprime un objectif de conversion personnalisé ; la suppression attend une approbation explicite. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
goal_idFacultatif | string | omettre pour créer un nouvel objectif |
conversion_actionsFacultatif | array<string> | — |
nameFacultatif | string | — |
removeFacultatif | boolean | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_offline_conversions
Écriture2 créditsImporte des conversions hors ligne (CRM) par id de clic (gclid/gbraid/wbraid) ou e-mail/téléphone haché (conversions avancées pour les prospects) ; les e-mails/téléphones sont hachés en SHA-256 avant tout stockage. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
conversion_actionObligatoire | string | id d'une action de conversion UPLOAD_CLICKS |
currency_codeFacultatif | string | — |
conversionsObligatoire | array<object> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_conversion_adjustments
Écriture2 créditsRétracte (remboursement/annulation) ou redéfinit la valeur de conversions déjà déclarées, par id de commande ou gclid + heure. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
conversion_actionObligatoire | string | — |
currency_codeFacultatif | string | — |
adjustmentsObligatoire | array<object> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_customer_match_audience
Écriture2 créditsCrée une liste Customer Match vide (données first party). Les membres sont ajoutés via les circuits d'import propres à Google ; cet outil n'importe jamais de données personnelles. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
membership_daysFacultatif | integer (1–540) | — |
upload_key_typeFacultatif | CONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
link_google_business_profile
Écriture2 créditsLink Google Business Profile locations to the Google Ads account as location assets (address, directions, call in ads; store visit conversions). Uses the connected Business Profile; filter by business name, label or listing id when the profile has several businesses. Only one sync per account; an existing one is reused. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
business_name_filterFacultatif | string | only listings with this business name |
label_filtersFacultatif | array<string> | only listings with one of these Business Profile labels |
listing_idsFacultatif | array<string> | only these Business Profile listing ids |
business_account_idFacultatif | string | — |
emailFacultatif | string | Business Profile account e-mail; default: the connected Google account |
nameFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_google_campaign_locations
Écriture2 créditsShow only some Business Profile locations in one campaign's ads (dynamic location group by label or listing id), so another business's address does not appear when the account syncs several businesses. Needs the account-level sync (link_google_business_profile). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
label_filtersFacultatif | array<string> | Business Profile labels (OR) |
listing_idsFacultatif | array<string> | Business Profile listing ids (OR) |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_google_audience
ÉcritureIrréversible2 créditsPermanently remove a Google Ads audience list (Customer Match, website, lookalike). A list still used by a campaign is rejected by Google; use only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
user_list_idObligatoire | string | audience (user list) id from list_audiences |
nameFacultatif | string | list name, shown in the approval |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_lookalike_audience
Écriture2 créditsCrée une audience similaire (Demand Gen) à partir de listes sources pour les pays et le niveau de portée indiqués. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
seed_user_list_idsObligatoire | array<string> | — |
country_codesObligatoire | array<string> | — |
expansion_levelFacultatif | NARROW | BALANCED | BROAD | — |
membership_daysFacultatif | integer (1–540) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_website_audience
Écriture2 créditsCrée une liste de remarketing basée sur des règles à partir des visiteurs du site dont l'URL de page correspond (nécessite la balise Google sur le site) ; les visiteurs passés sont préremplis. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
url_containsObligatoire | any | — |
string_operatorFacultatif | CONTAINS | EQUALS | STARTS_WITH | ENDS_WITH | — |
membership_daysFacultatif | integer (1–540) | — |
lookback_daysFacultatif | integer (1–540) | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_audience_targeting
Écriture2 créditsAssocie une liste d'audience à une campagne ou à un groupe d'annonces (ou la retire), en définissant éventuellement observation ou ciblage et un modificateur d'enchère. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
audienceObligatoire | string | id de liste d'utilisateurs (list_audiences) |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id de groupe d'annonces Google Ads (list_google_ad_groups) |
actionFacultatif | add | remove | — |
modeFacultatif | observation | targeting | — |
bid_modifierFacultatif | number | multiplicateur, 1.2 = +20 % |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_campaign_settings
Écriture2 créditsLit (sans autre argument) ou modifie les paramètres de campagne : option de zone présence ou intérêt, partenaires du Réseau de Recherche, extension au Display, modèle de suivi, déclaration UE sur les annonces politiques, AI Max for Search. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
geo_target_typeFacultatif | PRESENCE | PRESENCE_OR_INTEREST | — |
search_partnersFacultatif | boolean | — |
display_expansionFacultatif | boolean | — |
tracking_url_templateFacultatif | string | — |
eu_political_adsFacultatif | boolean | — |
ai_maxFacultatif | boolean | AI Max for Search |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_google_ads_account
ÉcritureIrréversible2 créditsOuvre un nouveau compte client sous un compte administrateur (MCC) géré par l'utilisateur connecté. Attend toujours une validation explicite ; la devise et le fuseau horaire sont définitifs. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
manager_customer_idObligatoire | string | — |
nameObligatoire | string | — |
currency_codeObligatoire | string | — |
time_zoneObligatoire | string | — |
tracking_url_templateFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_lead_form
Écriture2 créditsCrée un asset formulaire pour prospects (le formulaire dans l'annonce) avec champs standard, questions personnalisées, écran de remerciement et envoi facultatif par webhook, puis l'associe à une campagne ou à un groupe d'annonces. Crée un élément de validation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après validation de l'utilisateur (immédiatement seulement si la politique de validation du compte pour ce type est explicitement « faites-le vous-même ») et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
business_nameObligatoire | string | — |
headlineObligatoire | string | — |
descriptionObligatoire | string | — |
privacy_policy_urlObligatoire | string | — |
final_urlObligatoire | string | — |
ctaFacultatif | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED | — |
cta_descriptionFacultatif | string | — |
fieldsFacultatif | array<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE> | — |
questionsFacultatif | array<any> | — |
post_submit_headlineFacultatif | string | — |
post_submit_descriptionFacultatif | string | — |
post_submit_ctaFacultatif | VISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW | — |
webhook_urlFacultatif | string | — |
webhook_keyFacultatif | string | — |
campaign_idFacultatif | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
ad_group_idFacultatif | string | id du groupe d'annonces Google Ads (list_google_ad_groups) |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_business_logo
Écriture2 créditsRemplace le logo de l'entreprise affiché dans les annonces d'une campagne. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
asset_idObligatoire | string | id d'asset image 1:1 ou URL d'image |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_business_name
Écriture2 créditsDéfinit ou corrige le nom de l'entreprise affiché dans les annonces d'une campagne. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
textObligatoire | string | ≤25 caractères |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_campaign_proximity
Écriture2 créditsListe, ajoute ou supprime des ciblages par rayon (cercle lat/lng) sur une campagne. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
actionFacultatif | list | add | remove | — |
latFacultatif | number | — |
lngFacultatif | number | — |
radiusFacultatif | number | — |
unitsFacultatif | KILOMETERS | MILES | — |
pointsFacultatif | array<object> | — |
criterion_idFacultatif | string | — |
criterion_idsFacultatif | array<string> | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_device_targeting
Écriture2 créditsDéfinit l'ajustement d'enchère d'une campagne pour un appareil (ou -100 % pour ne plus y diffuser). Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Tecrübe (list_campaigns) ou id de campagne Google Ads |
deviceObligatoire | MOBILE | DESKTOP | TABLET | CONNECTED_TV | — |
bid_modifier_pctObligatoire | number | -90..900, ou -100 pour exclure |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_call_reporting
Écriture2 créditsActive/désactive les rapports d'appels et de conversions d'appel au niveau du compte et choisit l'action de conversion d'appel. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
call_reportingFacultatif | boolean | — |
call_conversionFacultatif | boolean | — |
call_conversion_action_idFacultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_pmax_asset_group
ÉcritureIrréversible2 créditsModifie l'URL finale, le nom, les chemins d'affichage ou le statut d'un groupe d'assets Performance Max ; REMOVED est définitif et attend une approbation explicite. Crée un élément d'approbation avec aperçu (actuel → nouveau) ; appliqué dans Google Ads après l'approbation de l'utilisateur (immédiatement uniquement si la politique d'approbation du compte pour ce type est explicitement 'faites-le vous-même') et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
asset_group_idObligatoire | string | — |
final_urlFacultatif | string | — |
nameFacultatif | string | — |
statusFacultatif | ENABLED | PAUSED | REMOVED | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
customer_idFacultatif | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.