Créer une publication en masse

Crée une seule campagne de publication et la diffuse à chaque établissement de locationIds, en publiant sur les postSites sélectionnés. Contrairement à la création par établissement, un seul appel cible l'ensemble de vos établissements, ce qui permet de diffuser efficacement une annonce, une offre ou un événement à l'échelle de l'entreprise.

Structure de la requête. Le corps entier doit être encapsulé dans un objet input ; chaque champ (postName, locationIds, postType, …) est une propriété de input. Un corps à plat, non encapsulé, est rejeté avec un statut HTTP 400 (Variable "$input" of required type ... was not provided). Le contrat est identique à celui de POST /posts, et une réponse de succès utilise la clé createSocialPost plutôt qu'une clé propre à la publication en masse.

Cas d'utilisation : annonce à l'échelle de l'entreprise (illustré ci-dessus). Définissez postType: "ANNOUNCEMENT", indiquez les identifiants des établissements et fournissez un postMessage par établissement. Ajoutez postScheduledDates pour diffuser la publication sur une période définie (la publication est alors créée avec le statut SCHEDULED) ; omettez-le pour publier immédiatement.

Cas d'utilisation : offre à durée limitée dans tous les magasins. Remplacez la valeur de postType par OFFER et fournissez le coupon dans postContextInfo (toujours encapsulé dans input) :

{  "input": {    "postName": "Summer 20% Off",    "locationIds": ["TG9jYXRpb246MTgwMDI4OQ=="],    "postType": "OFFER",    "postSites": ["GOOGLE"],    "postMessage": [{ "site": "GOOGLE", "message": "20% off through July!" }],    "postContextInfo": {      "title": "Summer Sale",      "couponCode": "SUMMER20",      "redeemUrl": "https://example.com/offer",      "termsConditions": "Valid through July 31",      "startDay": "2026-07-10",      "startTime": "09:00",      "endDay": "2026-07-31",      "endTime": "23:59"    }  }}

Points de vigilance.

• Le corps doit être encapsulé dans input ; si vous envoyez les champs au premier niveau, le point de terminaison renvoie un statut HTTP 400.
• postType, postSites, postName et locationIds sont obligatoires ; les types EVENT, OFFER et PRODUCT nécessitent également les champs postContextInfo (ou products) correspondants.
• postSites accepte uniquement GOOGLE et FACEBOOK ; le canal correspondant doit être connecté pour chaque établissement ciblé, sinon cet établissement est ignoré.
• En cas d'échec partiel ou total de la validation, la réponse contient un statut HTTP 200 avec success: false et un tableau errors renseigné ; vérifiez success, puis suivez la diffusion en temps réel par établissement à l'aide du point de terminaison de récupération d'une publication en masse.