Listar as conexões de uma marca

Lista as contas sociais vinculadas a uma marca. O id de cada linha é o ID da conexão: o valor que você passa em connectedChannelIds quando quer direcionar uma publicação a canais específicos, o valor que desconectar aceita e o socialConnectedChannelId que estatísticas exige.

Caso de uso: exibir o seletor de canais. Antes de mostrar um editor de publicações, consulte esta lista e ofereça uma opção de seleção por linha, identificada por displayName e platform. Uma marca com um array socialConnected vazio não tem onde publicar; nesse caso, direcione o usuário para um link de conexão.

Caso de uso: confirmar que uma conexão foi estabelecida. Depois que o usuário retornar do fluxo de conexão hospedado com status=success, consulte este endpoint periodicamente até aparecer a linha cujo id corresponda ao connectedAccountId na URL de retorno. As conexões são criadas de forma assíncrona, portanto, aguarde alguns segundos e faça duas novas tentativas antes de exibir um erro.

Observações.

• platform é um destes valores: FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id é o UUID da conexão e o valor esperado por todo endpoint de Social que aceita uma conexão. referenceId é o identificador da conta na própria plataforma — um ID de Página do Facebook, um ID de conta comercial do Instagram — útil para fazer a correspondência com registros que você mantém fora do ListingsAPI, mas nunca aceito como entrada aqui.
• archived: true com um carimbo de data e hora em archivedAt significa que a conexão deixou de existir, seja porque alguém a desconectou, porque a marca foi arquivada ou porque a plataforma revogou o token. Uma publicação direcionada a um canal arquivado falha com SY95045.
• listingConnectedAccountId só é definido quando a mesma conta também está vinculada no lado de Listings; seu valor é null para uma conexão exclusiva de Social.
• Apenas uma conexão por plataforma por marca é usada para publicação. Conectar a mesma plataforma novamente à mesma marca substitui o canal anterior em vez de adicionar um segundo.
• Para ver o uso de conexões em toda a sua conta em relação ao seu limite, em vez dos canais de uma marca, chame GET /social/limits.