Aller au contenu
Quiet Social

Ciblage

Le paramètre to: de publications()->create() dit où publier : des noms de réseau, des identifiants de destination, ou les deux. Le SDK les résout dans la marque avant tout envoi, et refuse une cible qui ne mène à rien.

Noms de réseau et identifiants

use QuietSocial\Sdk\Network;

$client->publications()->create($post, to: [
    'facebook',                           // toutes les destinations Facebook de la marque qui peuvent publier
    Network::LinkedIn,                    // la même chose, avec l'énumération
    'dst_01k4b8x2q9r7f3m5t6v8w0y2z4',     // cette destination, si elle peut publier
]);
  • Un nom de réseau (facebook, instagram, linkedin, threads, pinterest, ou un cas de Network) vise toutes les destinations de ce réseau dans la marque qui peuvent publier. La casse ne compte pas ; un nom inconnu lève InvalidPost.
  • Un identifiant de destination (dst_…) ne vise que cette destination, à condition qu'elle appartienne à la marque et puisse publier.
  • L'ordre des cibles ne compte pas : les mêmes cibles dans un autre ordre donnent la même publication, et la même clé d'idempotence.

Une destination par son nom

Quand un réseau a plusieurs destinations dans la marque, plusieurs tableaux Pinterest par exemple, destination() restreint le nom de réseau à celle qui porte ce nom :

use QuietSocial\Sdk\Network;
use QuietSocial\Sdk\NetworkPost;

$post = $post->for(Network::Pinterest, fn (NetworkPost $epingle) => $epingle->destination('Recettes'));

$client->publications()->create($post, to: ['pinterest']);

Le nom se compare sans tenir compte de la casse (lettres accentuées comprises) ni des espaces autour. Il ne part pas dans la requête : il ne sert qu'à choisir la destination.

Quand une cible ne mène à rien

Les destinations de la marque sont lues une fois, toutes pages comprises, avant tout envoi d'image et toute création. Le SDK lève alors ValidationFailed, sans rien envoyer à POST /publications :

Code Cause
destination_unavailable Aucune destination de ce réseau ne peut publier dans la marque, aucune ne porte le nom demandé, ou l'identifiant dst_… n'existe pas dans la marque ou ne peut pas publier.
destination_ambiguous Plusieurs destinations du réseau portent le nom demandé : visez l'une d'elles par son identifiant.

Le statut de ces exceptions vaut 0, puisque l'API n'a rien répondu, et errors porte le message sous la clé to. Une destination qui ne peut plus publier (connexion à rétablir, destination désactivée) se rétablit dans le panel.

to: ['x'] lève aussi destination_unavailable : Network::X se déclare dans un post, mais l'API ne publie encore rien sur X.

Lire les destinations

Pour voir où une marque peut publier, et ce qu'accepte chaque destination :

foreach ($client->destinations()->all() as $destination) {
    $destination->id;                              // dst_…
    $destination->network;                         // pinterest
    $destination->name;                            // Recettes
    $destination->canPublish;
    $destination->capabilities->maximumTextLength;
    $destination->capabilities->requiresMedia;
}

destinations()->all() lit toutes les pages ; destinations()->list() en lit une seule (page, perPage jusqu'à 100) et rend une Page ; destinations()->find() lit une destination. Les capacités sont décrites dans Marques et destinations.

Les marques

Le ciblage se fait toujours dans une marque : celle de la clé, ou, pour une clé qui couvre tout l'espace, celle du post (brand()) ou du client (argument brand). Sans marque, une clé d'espace lit les destinations de toutes ses marques et l'API refuse la publication. brands()->list() rend les marques que la clé voit.