L'API commenti di LinkedIn: cosa permette a un'app
PostCat AI non è affiliata a LinkedIn.
L'API commenti di LinkedIn è l'API socialActions/comments. Permette a un'app di scrivere e leggere commenti sui post condivisi. Offre metodi per ottenere un commento, ottenere i commenti su un post o su un commento, e creare, modificare ed eliminare un commento. Prima che un'app possa recuperare dati o accedere ai dati dei membri, deve essere autorizzata e autenticata.
Artem Luko
Founder di PostCat AI
0+
follower su LinkedIn
Ha fatto crescere il suo LinkedIn post dopo post. PostCat AI è tutto quello che ha imparato, in un posto solo.
Scopri comeCosa permette a un'app l'API commenti di LinkedIn
La documentazione di LinkedIn elenca questi metodi:
- 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
Un singolo commento si legge con una richiesta GET a https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Più commenti si possono leggere in una sola chiamata con .../comments/ids=List({commentId}). I commenti su un post arrivano da una richiesta GET a https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.
Dove trovare la documentazione
Il riferimento dell'API è su Microsoft Learn, dove LinkedIn pubblica la sua documentazione per sviluppatori. Inizia da Microsoft Learn: Comments API. Il Centro assistenza di LinkedIn copre solo quello che i membri fanno sul sito e nell'app, non l'API.
I permessi che ti servono
Ogni permesso decide cosa può fare un'app. La tabella qui sotto mantiene la formulazione della documentazione di LinkedIn.
| Permesso | Cosa permette a un'app di fare | Accesso |
|---|---|---|
| w_member_social | Permette a un'app di pubblicare, commentare e mettere mi piace ai post per conto di un membro autenticato | Elencato sotto Share on LinkedIn nella tabella dei permessi aperti |
| w_member_social_feed | Permette a un'app di creare, modificare ed eliminare commenti e reazioni sui post per conto del membro | Permesso del membro (3-legged) per la Community Management API |
| r_member_social_feed | Permette a un'app di recuperare post, reazioni e mi piace per conto di un membro autenticato | Limitato, concesso solo a sviluppatori selezionati |
| w_organization_social_feed | Permette a un'app di pubblicare, commentare e reagire per conto di un'organizzazione | Limitato alle organizzazioni in cui il membro ha uno dei ruoli della pagina aziendale |
Le tabelle dei permessi non sono uguali in ogni versione dell'API. Controlla la versione che vuoi usare prima di fidarti di una riga.
Campi del commento: actor, message e risposte
Ogni commento ha un actor, cioè l'URN di chi commenta. Il campo actor è obbligatorio. Un actor urn:li:person crea un commento personale, con il membro come autore. Un actor urn:li:organization o urn:li:organizationBrand crea un commento dell'organizzazione scritto da un membro per conto dell'entità.
Il campo message è un testo obbligatorio e può includere link a persone e organizzazioni. Contenuti come un'immagine sono facoltativi.
Una risposta è un commento annidato. Il suo campo parentComment contiene l'URN del commento padre. Quel campo non è disponibile per i commenti di primo livello.
Per modificare un commento, la richiesta usa l'intestazione X-RestLi-Method: PARTIAL_UPDATE e una patch che imposta il testo del message. Delete a Comment è uno dei metodi elencati.
Attivare o disattivare i commenti
I commenti su un post si attivano e disattivano tramite un'altra API, la Social Metadata API. Imposta commentsState su CLOSED per disattivare i commenti, e su OPEN per riattivarli. Disattivare i commenti elimina tutti i commenti esistenti nel thread. Le reazioni restano come sono. Riattivare i commenti permette di nuovo alle persone di scrivere commenti nel thread.
La Social Metadata API accetta solo URN di thread. Rifiuta qualsiasi scrittura che usi un URN di commento. Per creare e recuperare un commento, usa la Comments API. I conteggi riassuntivi sono commentSummary.count, che include le risposte, e commentSummary.topLevelCount, che le esclude.
Commentare a mano su LinkedIn
Se vuoi provare com'è un commento prima di chiamare l'API, fallo prima a mano. I passaggi seguono LinkedIn Help: Comment on posts and reply to a comment.
- Clicca Comment sotto il post, oppure clicca la casella di testo che dice Add a comment.
- Scrivi il tuo commento.
- Facoltativamente, clicca l'icona Emoji, l'icona GIF o l'icona Image.
- Clicca Comment.
Per rispondere, clicca Reply sotto un commento, oppure clicca la casella di testo che dice Add a reply, scrivi la tua risposta, poi clicca Reply. I membri possono anche limitare i commenti alle sole connessioni, il che impedisce di commentare a chi non è una connessione di 1º grado.
Per modificare il tuo commento, clicca l'icona More a destra del commento, clicca l'icona Edit, apporta le modifiche, poi clicca Save Changes. Il commento mostrerà poi (edited) sopra di sé. I passaggi seguono LinkedIn Help: Edit a comment.
Come iniziare
Leggi il riferimento della versione dell'API che vuoi usare, perché le righe dei permessi cambiano tra una versione e l'altra. Inizia con una sola chiamata di lettura su un post di tua proprietà. Aggiungi le scritture solo quando le letture restituiscono quello che ti aspetti.
Cosa non dicono le pagine di aiuto che abbiamo letto
Le pagine di aiuto che abbiamo letto non dichiarano questi punti:
- Limiti di frequenza e quote delle API.
- Costi o prezzi per l'accesso all'API.
- Come creare un'app, come ottenere l'accesso a Marketing Developer Platform o Community Management, quanto dura l'approvazione e se gli sviluppatori individuali possono ottenerlo.
- Se un'app senza diritti di amministratore può leggere i commenti sui post di altri membri.
- Il formato della richiesta per Delete a Comment, la paginazione e i limiti di conteggio, e quale versione dell'API è attuale.
PostCat AI e i commenti
PostCat AI è un prodotto indipendente, non gestito né approvato da LinkedIn. Risponde ai commenti sotto i post che pubblica, dopo approvazione o in autonomia, e funziona solo tramite l'API ufficiale di LinkedIn. I suoi prezzi sono nella pagina dei prezzi.
Fonti
- 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)


