Zum Inhalt springen

Die LinkedIn-Comments-API: Was eine App damit tun kann

5 min Lesezeit

PostCat AI ist nicht mit LinkedIn verbunden.

Die LinkedIn-Comments-API ist die socialActions/comments-API. Sie lässt eine App Kommentare zu Shares schreiben und lesen. Dafür gibt es Methoden, um einen Kommentar abzurufen, Kommentare zu einem Share oder zu einem Kommentar zu holen sowie einen Kommentar anzulegen, zu bearbeiten und zu löschen. Bevor eine App Daten abrufen oder auf Mitgliedsdaten zugreifen kann, muss sie autorisiert und authentifiziert sein.

Artem Luko

Founder von PostCat AI

0+

Follower auf LinkedIn

Er hat sein LinkedIn Post für Post groß gemacht. PostCat AI ist alles, was er dabei gelernt hat, an einem Ort.

So geht's

Was die LinkedIn-Comments-API einer App erlaubt

Die Dokumentation von LinkedIn listet diese Methoden:

  • Get a Comment
  • Batch Get a Collection of Comments
  • Get Comments on Shares
  • Get Comments on Comments
  • Create a Comment
  • Edit a Comment
  • Delete a Comment

Einen einzelnen Kommentar liest du mit einer GET-Anfrage an https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Mehrere Kommentare lassen sich mit .../comments/ids=List({commentId}) in einem Aufruf lesen. Die Kommentare zu einem Share kommen über eine GET-Anfrage an https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.

Wo du die Dokumentation findest

Die Referenz zur API liegt auf Microsoft Learn, dort veröffentlicht LinkedIn seine Entwicklerdokumentation. Starte mit Microsoft Learn: Comments API. Das LinkedIn-Hilfecenter behandelt nur, was Mitglieder auf der Seite und in der App tun, nicht die API.

Berechtigungen, die du brauchst

Jede Berechtigung legt fest, was eine App darf. Die Tabelle unten behält den Wortlaut der LinkedIn-Dokumentation.

BerechtigungWas sie einer App erlaubtZugriff
w_member_socialErlaubt einer App, im Namen eines authentifizierten Mitglieds Posts zu veröffentlichen, zu kommentieren und Posts zu likenAufgeführt unter Share on LinkedIn in der Tabelle der offenen Berechtigungen
w_member_social_feedErlaubt einer App, Kommentare und Reaktionen auf Posts im Namen des Mitglieds anzulegen, zu ändern und zu löschenMitgliedsberechtigung (3-legged) für die Community Management API
r_member_social_feedErlaubt einer App, Posts, Reaktionen und Likes im Namen eines authentifizierten Mitglieds abzurufenEingeschränkt, nur für ausgewählte Entwickler freigegeben
w_organization_social_feedErlaubt einer App, im Namen einer Organisation zu posten, zu kommentieren und zu reagierenEingeschränkt auf Organisationen, in denen das Mitglied eine der Rollen auf der Unternehmensseite hat

Die Berechtigungstabellen sind nicht in jeder API-Version gleich. Prüfe die Version, die du nutzen willst, bevor du dich auf eine Zeile verlässt.

Kommentarfelder: Actor, Message und Antworten

Jeder Kommentar hat einen Actor, also die URN dessen, der kommentiert. Das Actor-Feld ist Pflicht. Ein urn:li:person-Actor erzeugt einen persönlichen Kommentar, bei dem das Mitglied als Veröffentlichender auftritt. Ein urn:li:organization- oder urn:li:organizationBrand-Actor erzeugt einen Organisationskommentar, den ein Mitglied im Namen der Entität schreibt.

Das Message-Feld ist Pflichttext und darf Links zu Personen und Organisationen enthalten. Inhalte wie ein Bild sind optional.

Eine Antwort ist ein verschachtelter Kommentar. Ihr Feld parentComment enthält die URN des übergeordneten Kommentars. Dieses Feld gibt es bei Kommentaren der ersten Ebene nicht.

Um einen Kommentar zu bearbeiten, nutzt die Anfrage den Header X-RestLi-Method: PARTIAL_UPDATE und einen Patch, der den Nachrichtentext setzt. Delete a Comment ist eine der aufgelisteten Methoden.

Kommentare ein- und ausschalten

Kommentare unter einem Post schaltest du über eine andere API ein und aus, die Social Metadata API. Setze commentsState auf CLOSED, um Kommentare zu deaktivieren, und auf OPEN, um sie zu aktivieren. Das Deaktivieren löscht alle bestehenden Kommentare im Thread. Reaktionen bleiben erhalten. Wenn du Kommentare wieder aktivierst, können Leute erneut im Thread kommentieren.

Die Social Metadata API akzeptiert nur Thread-URNs. Jeder Schreibvorgang mit einer Kommentar-URN wird abgelehnt. Zum Anlegen und Abrufen eines Kommentars nutzt du die Comments API. Die Zählwerte heißen commentSummary.count, das die Antworten einschließt, und commentSummary.topLevelCount, das die Antworten ausklammert.

Von Hand auf LinkedIn kommentieren

Wenn du das Gefühl eines Kommentars testen willst, bevor du die API aufrufst, probier es zuerst von Hand aus. Die Schritte folgen LinkedIn Hilfe: Auf Posts kommentieren und auf einen Kommentar antworten.

  1. Klicke unter dem Post auf Comment oder auf das Textfeld mit dem Text Add a comment.
  2. Schreibe deinen Kommentar.
  3. Optional klickst du auf das Emoji-Symbol, das GIF-Symbol oder das Bild-Symbol.
  4. Klicke auf Comment.

Zum Antworten klickst du unter einem Kommentar auf Reply oder auf das Textfeld mit dem Text Add a reply, schreibst deine Antwort und klickst dann auf Reply. Mitglieder können das Kommentieren außerdem auf Kontakte beschränken, dann können Leute, die keine Kontakte ersten Grades sind, nicht kommentieren.

Um deinen eigenen Kommentar zu bearbeiten, klickst du auf das More-Symbol rechts neben dem Kommentar, dann auf das Edit-Symbol, nimmst die Änderungen vor und klickst auf Save Changes. Danach steht (edited) über dem Kommentar. Die Schritte folgen LinkedIn Hilfe: Einen Kommentar bearbeiten.

So fängst du an

Lies die Referenz zur API-Version, die du nutzen willst, denn die Zeilen der Berechtigungen ändern sich zwischen den Versionen. Beginne mit einem einzelnen Lesezugriff auf einen Post, den du besitzt. Füge Schreibzugriffe erst hinzu, wenn die Lesezugriffe das liefern, was du erwartest.

Was die gelesenen Hilfeseiten nicht sagen

Die Hilfeseiten, die wir gelesen haben, nennen diese Punkte nicht:

  • API-Ratenlimits und Kontingente.
  • Gebühren oder Preise für den API-Zugang.
  • Wie du eine App anlegst, wie du Zugang zur Marketing Developer Platform oder zur Community Management API bekommst, wie lange die Freigabe dauert und ob einzelne Entwickler dafür infrage kommen.
  • Ob eine App ohne Admin-Rechte Kommentare unter Posts anderer Mitglieder lesen kann.
  • Das Anfrageformat für Delete a Comment, Paginierung und Anzahlgrenzen sowie welche API-Version aktuell ist.

PostCat AI und Kommentare

PostCat AI ist ein unabhängiges Produkt, LinkedIn betreibt es nicht und empfiehlt es nicht. PostCat AI beantwortet Kommentare unter den Posts, die es veröffentlicht, nach Freigabe oder selbstständig, und arbeitet nur über die offizielle API von LinkedIn. Die Preise findest du auf der Preisseite.

Quellen
  • Comments API - LinkedIn (learn.microsoft.com)
  • LinkedIn Help: Comment on posts and reply to a comment
  • LinkedIn Help: Edit comments in your LinkedIn feed
  • Getting Access to LinkedIn APIs - LinkedIn (learn.microsoft.com)
  • Increasing Access - LinkedIn (learn.microsoft.com)
  • Community Management - Overview - LinkedIn (learn.microsoft.com)
  • Migration Guide for Community Management API - LinkedIn (learn.microsoft.com)
  • Integration Requirements for Community Management - LinkedIn (learn.microsoft.com)
  • Social Metadata API - LinkedIn (learn.microsoft.com)
  • Posts API - LinkedIn (learn.microsoft.com)

Häufige Fragen

Ja. Die socialActions/comments-API lässt eine App Kommentare zu Shares schreiben und lesen. Sie hat Methoden zum Abrufen, Anlegen, Bearbeiten und Löschen von Kommentaren. Die Referenz steht auf Microsoft Learn.

Starte mit dem nächsten Post deines Teams.

Verbinde die LinkedIn-Profile deines Teams und starte mit dem kostenlosen Test.