Ir al contenido
Quiet Social

Destinos

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

El parámetro to: de publications()->create() dice dónde publicar: nombres de red, identificadores de destino, o ambos. El SDK los resuelve dentro de la marca antes de enviar nada, y rechaza un destino que no lleva a ninguna parte.

Nombres de red e identificadores

use QuietSocial\Sdk\Network;

$client->publications()->create($post, to: [
    'facebook',                           // todos los destinos de Facebook de la marca que pueden publicar
    Network::LinkedIn,                    // lo mismo, con la enumeración
    'dst_01k4b8x2q9r7f3m5t6v8w0y2z4',     // este destino, si puede publicar
]);
  • Un nombre de red (facebook, instagram, linkedin, threads, pinterest, o un caso de Network) apunta a todos los destinos de esa red en la marca que pueden publicar. Las mayúsculas no importan; un nombre desconocido lanza InvalidPost.
  • Un identificador de destino (dst_…) apunta solo a ese destino, siempre que pertenezca a la marca y pueda publicar.
  • El orden de los destinos no importa: los mismos destinos en otro orden dan la misma publicación, y la misma clave de idempotencia.

Un destino por su nombre

Cuando una red tiene varios destinos en la marca, varios tableros de Pinterest por ejemplo, destination() restringe el nombre de red al que lleva ese nombre:

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

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

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

El nombre se compara sin tener en cuenta las mayúsculas (letras acentuadas incluidas) ni los espacios de alrededor. No se envía en la petición: solo sirve para elegir el destino.

Cuando un destino no lleva a ninguna parte

Los destinos de la marca se leen una sola vez, todas las páginas, antes de enviar ninguna imagen y de crear nada. El SDK lanza entonces ValidationFailed, sin enviar nada a POST /publications:

Código Causa
destination_unavailable Ningún destino de esa red puede publicar en la marca, ninguno lleva el nombre pedido, o el identificador dst_… no existe en la marca o no puede publicar.
destination_ambiguous Varios destinos de la red llevan el nombre pedido: apunta a uno de ellos por su identificador.

El estado de estas excepciones vale 0, ya que la API no respondió nada, y errors lleva el mensaje bajo la clave to. Un destino que ya no puede publicar (una conexión que restablecer, un destino desactivado) se arregla en el panel.

to: ['x'] también lanza destination_unavailable: Network::X se puede declarar en un post, pero la API todavía no publica nada en X.

Leer los destinos

Para ver dónde puede publicar una marca, y qué acepta cada destino:

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

destinations()->all() lee todas las páginas; destinations()->list() lee una (page, perPage hasta 100) y devuelve una Page; destinations()->find() lee un destino. Las capacidades se describen en Marcas y destinos.

Las marcas

Los destinos se resuelven siempre dentro de una marca: la de la clave o, para una clave que cubre todo el espacio, la del post (brand()) o la del cliente (argumento brand). Sin marca, una clave de espacio lee los destinos de todas sus marcas y la API rechaza la publicación. brands()->list() devuelve las marcas que ve la clave.