API Tutorial
Comment planifier des publications Google Business par API
Pour planifier des publications Google Business par API, connecte Google Business via Modiva puis appelle `posts_schedule` avec ton contenu et un horodatage `publish_at` — Modiva le met en file d'attente et le publie automatiquement à ce moment-là sur Google Business.
Planifier, c'est enregistrer une publication et la diffuser plus tard de façon fiable — quelque chose que l'API de Google Business te laisse entièrement gérer. Modiva exploite la file d'attente, réessaie en cas d'erreurs temporaires de Google Business et expose un unique outil `posts_schedule` qui fonctionne à l'identique sur chaque plateforme.
Étape par étape
Créer un compte Modiva et une clé MCP
Inscris-toi gratuitement et génère une clé MCP (`mk_live_…`) dans le tableau de bord. La même clé authentifie à la fois le serveur MCP hébergé (pour les agents IA) et l'API REST (pour ton backend), si bien que tu ne gères qu'un seul identifiant d'accès.
Connecter ton compte Google Business
Dans le tableau de bord, clique sur Connecter et choisis Google Business. Modiva exécute le flux OAuth et demande les scopes appropriés à ta place, puis stocke les tokens d'accès et de rafraîchissement dans un coffre chiffré et les maintient à jour — tu ne manipules jamais les identifiants d'API bruts de Google Business. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Appeler posts_schedule avec une heure publish_at
Appelle `posts_schedule` avec l'ID de connexion, ton contenu et un horodatage `publish_at` au format ISO. Modiva enregistre la tâche et publie à ce moment-là sur Google Business, en prenant en charge le rafraîchissement des tokens et les réessais sans ton propre cron.
Trouver le meilleur moment et regrouper un calendrier
Appelle `analytics_best_time_to_post` pour choisir un créneau, puis planifie toute une semaine en boucle. Via MCP, un agent IA peut planifier et mettre en file d'attente un calendrier de contenu Google Business complet à partir d'un seul prompt.
Exemple de requête
Appelez l'outil posts_schedule via l'API REST de Modiva. Le même outil est disponible pour les agents IA sur le serveur MCP à l'adresse https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Essayez-le avec Google Business
Commencer gratuitementFAQ
Est-ce Modiva ou moi qui exploite le planificateur ?
Modiva. Dès que tu appelles `posts_schedule`, Modiva enregistre la tâche et publie à l'heure voulue sur Google Business — tu n'as besoin ni de ta propre file d'attente ni d'un cron.
Puis-je planifier la même publication pour plusieurs plateformes ?
Oui — transmets plusieurs ID de connexion (ou utilise `posts_cross_post`) et Modiva planifie la publication pour Google Business et chaque autre plateforme, adaptée au format de chacune.