Перейти к контенту

LinkedIn comments API: что приложение может делать с комментариями

4 мин чтения

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.

  1. Нажми Comment под постом или нажми на поле с надписью Add a comment.
  2. Напиши комментарий.
  3. По желанию нажми значок эмодзи, значок GIF или значок изображения.
  4. Нажми 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)

Частые вопросы

Да. socialActions/comments API позволяет приложению писать и читать комментарии к постам. В нём есть методы, чтобы получить, создать, отредактировать и удалить комментарий. Справочник лежит на Microsoft Learn.

Начни со следующего поста команды.

Подключи LinkedIn-профили команды и го на бесплатный триал.