Aller au contenu
Envoyer des données/Envoyer la dépense d'une régie, jour par jour

Envoyer la dépense d'une régie, jour par jour

Dépose la dépense d'une régie publicitaire jour par jour, pour une entité, sous la forme du tableau de son rapport.

Trois colonnes au moins : un jour, une campagne et un coût hors taxes, nommées comme le rapport de la régie les nomme. Ajoutez une colonne de devise quand le compte n'est pas en euros. Une ligne par campagne et par jour. Un chiffre plus récent pour un jour révise celui qui est connu.

Le tableau est lu à l'envoi par le lecteur du fichier : ce qu'il refuse revient tout de suite, avec ses lignes, numérotées à partir de 1 dans rows. Il attend ensuite qui importe les fichiers, qui voit son aperçu sur la page Données et le valide ou le refuse. Rien n'est compté avant.

Un relevé de carte et un export Spendesk ne s'envoient pas par l'API : ils restent des fichiers.

Appel

RepèreValeur
AdressePOST /api/v1/spend/daily/proposals
Par son nomPOST /api/v1/tools/propose_ad_spend, la réponse sous data
Nom de l'outilpropose_ad_spend
Droit demandéImporter un fichier (source.import)
Rôles qui ont ce droit par défautPropriétaire, CMO, Marketing Ops, DAF
Par MCPOui : l'envoi attend une personne.

Paramètres

Les paramètres sont dans le corps de la requête, en JSON.

ParamètreRequisType et limitesÀ quoi il sert
entityIdouitexte, non videL'entité. list_entities donne les identifiants.
sourceouivaleur au choix, google_ads, linkedin_ads, meta_ads, microsoft_adsLa régie : google_ads, linkedin_ads, meta_ads ou microsoft_ads.
nameouitexte, 1 à 80 caractèresLe nom de la proposition. Un envoi plus récent sous le même nom remplace celui qui attend.
columnsouiliste de textes, 1 à 120 éléments, chaque élément : 1 à 200 caractèresL'en-tête : les noms des colonnes, comme l'export les nomme, en français ou en anglais.
rowsouiliste de listes, 1 à 5 000 élémentsLes lignes, dans l'ordre des colonnes.
rows[]ouiliste de valeurs (texte, nombre ou null), 120 éléments au plusUne ligne : pour chaque colonne, un texte, un nombre, ou null pour une cellule vide. Les dates au format AAAA-MM-JJ.

Exemple

curl -X POST "$MARVESTO_URL/api/v1/spend/daily/proposals" \
  -H "x-api-key: $MARVESTO_API_KEY" \
  -H "content-type: application/json" \
  -d @corps.json

Le fichier corps.json :

{
  "entityId": "ENTITY_ID",
  "source": "google_ads",
  "name": "Google Ads, octobre",
  "columns": ["Day", "Campaign", "Cost"],
  "rows": [
    ["2026-10-01", "Search - Marque", 182.4],
    ["2026-10-01", "Search - Générique", 431.15]
  ]
}

Réponse

proposalId, rowCount (les lignes lues), firstMonth et lastMonth (les mois couverts), superseded (les propositions en attente remplacées).

{
  "proposalId": "PROPOSAL_ID",
  "rowCount": 2,
  "firstMonth": "2026-10",
  "lastMonth": "2026-10",
  "superseded": 0
}

Refus

Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.