LinkedIn comments API: что приложение может делать с комментариями
PostCat AI никак не связан с LinkedIn.
LinkedIn comments API это socialActions/comments API. Он позволяет приложению писать и читать комментарии к постам (shares). В нём есть методы, чтобы получить комментарий, получить комментарии к посту или к другому комментарию, а также создать, отредактировать и удалить комментарий. Прежде чем приложение сможет получать данные или работать с данными участника, его нужно авторизовать и аутентифицировать.
Artem Luko
Фаундер PostCat AI
0+
подписчиков в LinkedIn
Он вырастил свой LinkedIn пост за постом. PostCat AI: всё, что он на этом понял, в одном месте.
Как это работаетЧто приложение может делать через LinkedIn comments API
В документации LinkedIn перечислены такие методы:
- 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
Один комментарий читается GET-запросом на https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Несколько комментариев можно получить одним вызовом через .../comments/ids=List({commentId}). Комментарии к посту приходят GET-запросом на https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.
Где искать документацию
Справочник по API лежит на Microsoft Learn, там LinkedIn публикует документацию для разработчиков. Начни с Microsoft Learn: Comments API. Центр помощи LinkedIn описывает только то, что участники делают на сайте и в приложении, а не сам API.
Какие права нужны
Каждое право определяет, что приложение может делать. В таблице ниже сохранена формулировка документации LinkedIn.
| Право | Что позволяет приложению | Доступ |
|---|---|---|
| w_member_social | Позволяет приложению публиковать посты, комментировать и ставить лайки от имени авторизованного участника | Указано в разделе Share on LinkedIn в таблице открытых прав |
| w_member_social_feed | Позволяет приложению создавать, изменять и удалять комментарии и реакции к постам от имени участника | Право участника (3-legged) для Community Management API |
| r_member_social_feed | Позволяет приложению получать посты, реакции и лайки от имени авторизованного участника | Ограниченное, выдаётся только избранным разработчикам |
| w_organization_social_feed | Позволяет приложению публиковать посты, комментировать и ставить реакции от имени организации | Ограничено организациями, где у участника есть одна из ролей на странице компании |
Таблицы прав не одинаковы во всех версиях API. Перед тем как опираться на строку, проверь версию, которую собираешься использовать.
Поля комментария: actor, message и ответы
У каждого комментария есть actor, то есть URN того, кто комментирует. Поле actor обязательное. Actor вида urn:li:person делает личный комментарий, где публикатором выступает участник. Actor вида urn:li:organization или urn:li:organizationBrand делает комментарий от организации, который участник написал от имени сущности.
Поле message обязательное, это текст, и в нём могут быть ссылки на людей и организации. Содержимое вроде изображения необязательно.
Ответ это вложенный комментарий. Его поле parentComment содержит URN родительского комментария. Это поле недоступно для комментариев первого уровня.
Чтобы отредактировать комментарий, запрос использует заголовок X-RestLi-Method: PARTIAL_UPDATE и patch, который задаёт текст message. Delete a Comment входит в список перечисленных методов.
Как включать и выключать комментарии
Комментарии к посту включаются и выключаются через другой API, Social Metadata API. Чтобы отключить комментарии, поставь commentsState в значение CLOSED, чтобы включить, поставь OPEN. Отключение комментариев удаляет все существующие комментарии в треде. Реакции остаются. Повторное включение позволяет снова писать комментарии в треде.
Social Metadata API принимает только URN тредов. Он отклоняет любую запись с URN комментария. Для создания и получения комментариев используй Comments API. Сводные счётчики: commentSummary.count, который включает ответы, и commentSummary.topLevelCount, который ответы не учитывает.
Комментирование вручную в LinkedIn
Если хочешь сначала почувствовать, как работает комментарий, сделай это вручную, до вызова API. Шаги по LinkedIn Help: Comment on posts and reply to a comment.
- Нажми Comment под постом или нажми на поле с надписью Add a comment.
- Напиши комментарий.
- По желанию нажми значок эмодзи, значок GIF или значок изображения.
- Нажми Comment.
Чтобы ответить, нажми Reply под комментарием или нажми на поле с надписью Add a reply, напиши ответ и нажми Reply. Участники также могут ограничить комментирование только контактами первого уровня, тогда те, кто не является контактами 1-го уровня, комментировать не смогут.
Чтобы отредактировать свой комментарий, нажми значок More справа от комментария, нажми значок Edit, внеси изменения и нажми Save Changes. После этого над комментарием появится пометка (edited). Шаги по LinkedIn Help: Edit a comment.
С чего начать
Прочитай справочник для той версии API, которую собираешься использовать, потому что строки с правами меняются между версиями. Начни с одного запроса на чтение к посту, который ты сам опубликовал. Запросы на запись добавляй только тогда, когда чтения возвращают то, что ты ожидаешь.
Чего не говорят прочитанные справочные страницы
Прочитанные справочные страницы не указывают:
- Лимиты запросов и квоты API.
- Комиссии или цены за доступ к API.
- Как создать приложение, как получить доступ к Marketing Developer Platform или Community Management, сколько длится одобрение и подходят ли отдельные разработчики.
- Может ли приложение без админских прав читать комментарии к постам других участников.
- Формат запроса для Delete a Comment, пагинацию и лимиты на количество, а также какая версия API актуальна.
PostCat AI и комментарии
PostCat AI это независимый продукт, его не ведёт и не одобряет LinkedIn. Он отвечает на комментарии под постами, которые публикует, после одобрения или самостоятельно, и работает только через официальный API LinkedIn. Цены указаны на странице тарифов.
Источники
- 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)


