Verbindungen einer Marke auflisten

Listet die mit einer Marke verknüpften Social-Media-Konten auf. Der Wert id jeder Zeile ist die Verbindungs-ID: der Wert, den Sie in connectedChannelIds übergeben, wenn ein Beitrag auf bestimmten Kanälen veröffentlicht werden soll, den disconnect entgegennimmt und den insights als socialConnectedChannelId benötigt.

Anwendungsfall: Kanalauswahl anzeigen. Rufen Sie diese Liste ab, bevor Sie einen Beitragseditor anzeigen, und bieten Sie für jede Zeile einen Schalter an, der mit displayName und platform beschriftet ist. Eine Marke mit einem leeren socialConnected-Array hat keinen Kanal zum Veröffentlichen; leiten Sie den Benutzer stattdessen zu einem Verbindungslink weiter.

Anwendungsfall: Bestätigen, dass eine Verbindung hergestellt wurde. Nachdem der Benutzer mit status=success aus dem gehosteten Verbindungsablauf zurückkehrt, fragen Sie diesen Endpunkt wiederholt ab, bis die Zeile erscheint, deren id mit dem connectedAccountId in der Rückkehr-URL übereinstimmt. Verbindungen werden asynchron angelegt. Warten Sie daher einige Sekunden und versuchen Sie es ein paar Mal erneut, bevor Sie einen Fehler anzeigen.

Hinweise.

• platform hat einen der folgenden Werte: FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id ist die UUID der Verbindung und der Wert, den jeder Social-Endpunkt erwartet, der eine Verbindung entgegennimmt. referenceId ist die eigene Kontokennung der Plattform — eine Facebook-Seiten-ID oder eine Instagram-Business-Konto-ID — und eignet sich zum Abgleich mit Datensätzen, die Sie außerhalb von ListingsAPI verwalten, wird hier jedoch niemals als Eingabe akzeptiert.
• archived: true mit einem archivedAt-Zeitstempel bedeutet, dass die Verbindung nicht mehr besteht, entweder weil jemand sie getrennt hat, weil die Marke archiviert wurde oder weil die Plattform das Token widerrufen hat. Ein Beitrag, der auf einen archivierten Kanal abzielt, schlägt mit SY95045 fehl.
• listingConnectedAccountId wird nur gesetzt, wenn dasselbe Konto auch auf der Listings-Seite verknüpft ist; bei einer reinen Social-Verbindung ist der Wert null.
• Pro Plattform und Marke wird nur eine Verbindung zum Veröffentlichen verwendet. Wenn Sie dieselbe Plattform erneut mit derselben Marke verbinden, wird der bisherige Kanal ersetzt, statt ein zweiter hinzugefügt.
• Um die kontoweite Nutzung Ihrer Verbindungen im Verhältnis zu Ihrem Limit statt der Kanäle einer einzelnen Marke anzuzeigen, rufen Sie GET /social/limits auf.