PluggzyDocs

Outils publicitaires

Trois outils pour chaque réseau publicitaire : trouver une opération, lire, changer. Ils marchent de la même façon sur Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads et ChatGPT Ads, sans limite propre à Pluggzy : seules les limites de débit de chaque réseau s’appliquent.

Outils

Exactement ce que votre app d’IA reçoit de tools/list. ads_write modifie votre compte publicitaire : tout ce qui peut dépenser ou donner un accès demande d’abord l’accord de l’utilisateur.

3 outils · 2 en lecture · 1 en écriture
Publicités3

Finds ads operations for Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads (campaigns, budgets, boosts, targeting, audiences, conversions, creatives, leads, insights…) by words or group; with operation, its parameters and body.

Autorisation View profiles
Entrée3 paramètres · 0 obligatoire
operationstring
querystring
words, e.g. "pause campaign"
groupstring
SortiestructuredContent
{
  "structuredContent": {
    "operations": [
      {
        "name": "update_ad_campaign_status",
        "summary": "Pause or resume a campaign",
        "kind": "write",
        "needs_user_confirmed": true
      },
      {
        "name": "bulk_update_ad_campaign_status",
        "summary": "Pause or resume many campaigns",
        "kind": "write",
        "needs_user_confirmed": true
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "2 operation(s)."
    }
  ]
}
Ce qu’a fait le garde-fouExemple09:41:02 → 09:41:02
  1. Reçue09:41:02
  2. TraitéeAucun appel au réseau
Le contenu texte commence par “2 operation(s).” · Peut refuser avecnot_foundinvalid_requestpermission

Runs a read-only ads operation (see ads_operations): campaigns with spend and results, daily metrics, insights, audiences, leads. Money is in the account's currency.

Autorisation View profilesLimite Aucune limite propre à Pluggzy · les limites de débit du réseau s’appliquent
Entrée4 paramètres · 1 obligatoire
accountstring
ad account_id (list_accounts), when several
operationstringobligatoire
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
SortiestructuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "get_ads_timeline",
    "result": {
      "rows": [
        {
          "date": "2026-11-16",
          "currency": "EUR",
          "spend": 112.4,
          "impressions": 18420,
          "clicks": 391,
          "ctr": 2.12,
          "conversions": 14
        },
        {
          "date": "2026-11-17",
          "currency": "EUR",
          "spend": 118.9,
          "impressions": 19105,
          "clicks": 402,
          "ctr": 2.1,
          "conversions": 16
        }
      ]
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: get_ads_timeline done."
    }
  ]
}
Ce qu’a fait le garde-fouExemple09:41:02 → 09:41:03
  1. Reçue09:41:02
  2. Aucune limite propre à PluggzyUniquement celles de la régie
  3. Envoyée09:41:03
Le contenu texte commence par “Meta Ads: get_ads_timeline done.” · Peut refuser avecnot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

Runs an ads operation that changes the account (see ads_operations): create, boost, pause, budgets, targeting, deletions. needs_user_confirmed ones spend money or grant access: tell the user what will run (budget, dates, audience) and set user_confirmed only once they agree. New ads can go live at once: send a paused status to review first.

Autorisation Send messages & postsLimite Aucune limite propre à Pluggzy · les limites de débit du réseau s’appliquentÀ confirmer d’abord avec l’utilisateur
Entrée5 paramètres · 1 obligatoire
accountstring
ad account_id (list_accounts), when several
operationstringobligatoire
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
user_confirmedboolean
the user approved this change
SortiestructuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "update_ad_campaign_status",
    "result": {
      "success": true,
      "campaignId": "120214455667788990",
      "status": "PAUSED"
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: update_ad_campaign_status done."
    }
  ]
}
Ce qu’a fait le garde-fouExemple09:41:02 → 09:41:03
  1. Reçue09:41:02
  2. Aucune limite propre à PluggzyUniquement celles de la régie
  3. Envoyée09:41:03
Le contenu texte commence par “Meta Ads: update_ad_campaign_status done.” · Peut refuser avecconfirmation_requirednot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

Erreurs

Chaque refus a un code que votre app d’IA sait traiter, et un message qui dit quoi faire.

Refus publicitaires

Rien n’est mis en file ni réessayé dans votre dos : votre app d’IA lit le code et le message, puis corrige l’appel ou vous demande.

confirmation_requiredads_write uniquement. L’opération peut dépenser de l’argent ou donner un accès et user_confirmed ne valait pas true. Dites à l’utilisateur ce qui va s’exécuter, puis rappelez.
unsupportedL’opération ne marche pas sur le réseau de ce compte publicitaire (pas de boost sur Microsoft Ads ni ChatGPT Ads). Le message dit à quels réseaux elle s’applique.
invalid_requestLe réseau a refusé l’appel : le message commence par son nom, et fields nomme les valeurs à corriger.
not_foundAucune opération de ce nom : le message liste les plus proches.
rate_limitedLe réseau lui-même a demandé de ralentir (sa propre limite de débit ; Pluggzy n’en a aucune sur les comptes publicitaires). retry_after_seconds est exactement l’attente demandée : rappelez ensuite.
Exemple de refus
isError
{
  "error": "Meta Ads refused: the daily budget is below this ad account’s minimum.",
  "req_id": "req_7f3a9c21e4b8",
  "code": "invalid_request",
  "fields": {
    "budgetAmount": "below the ad account’s minimum daily budget"
  }
}
Les codes de tous les canauxcooldown et permission fonctionnent comme partout ailleurs dans Pluggzy.
Erreurs
Généré depuis pluggzy.com/api/docs · 42 outilsQuelque chose n’est pas clair ? Écrire au support · État des services