コンテンツへスキップ

LinkedInコメントAPI: アプリでできること

5分で読めます

PostCat AIはLinkedInとは提携していません。

LinkedInのコメントAPIは、socialActions/commentsのAPIです。アプリがシェア(投稿)に対してコメントを書き込んだり読み取ったりできます。コメントの取得、シェアやコメントへのコメント一覧の取得、コメントの作成・編集・削除のメソッドが用意されています。アプリがデータを取得したりメンバーのデータにアクセスしたりするには、事前に認可と認証が必要です。

Artem Luko

PostCat AI創業者

0+

LinkedInのフォロワー

LinkedInを投稿ひとつずつ伸ばしてきました。PostCat AIは、そこで学んだことを全部まとめたアプリです。

やり方を見る

LinkedInコメント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

1件のコメントは、https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}へのGETリクエストで読み取ります。.../comments/ids=List({commentId})を使えば、複数のコメントを1回の呼び出しで読み取れます。シェアへのコメント一覧は、https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/commentsへのGETリクエストで取得します。

ドキュメントの場所

APIのリファレンスは、LinkedInが開発者向けドキュメントを公開しているMicrosoft Learnにあります。まずはMicrosoft Learn: Comments APIを見てください。LinkedInヘルプセンターで扱っているのは、メンバーがサイトやアプリで行う操作であり、APIについては扱っていません。

必要な権限

権限によって、アプリにできることが決まります。次の表は、LinkedInのドキュメントの表記をそのまま残しています。

権限アプリにできることアクセス
w_member_social認証済みメンバーの代わりに、投稿、コメント、投稿へのいいねをアプリから行えるようにします公開されている権限の表で、Share on LinkedInの下に掲載されています
w_member_social_feedメンバーの代わりに、投稿へのコメントやリアクションを作成、変更、削除できるようにしますCommunity Management API向けのメンバー権限(3-legged)
r_member_social_feed認証済みメンバーの代わりに、投稿、リアクション、いいねを取得できるようにします制限付きで、一部の開発者にのみ付与されます
w_organization_social_feed組織の代わりに、投稿、コメント、リアクションを行えるようにしますメンバーが企業ページのいずれかのロールを持つ組織に限定されます

権限の表はAPIのバージョンごとに同じではありません。使う予定のバージョンを確認してから、行の内容を頼りにしてください。

コメントの項目: actor、message、返信

すべてのコメントにはactorがあり、これはコメントしている人のURNです。actorの項目は必須です。urn:li:personのactorは、メンバーを発信者とする個人のコメントになります。urn:li:organizationやurn:li:organizationBrandのactorは、メンバーがエンティティの代わりに書いた組織のコメントになります。

messageの項目は必須のテキストで、人や組織へのリンクを含められます。画像などのコンテンツは任意です。

返信は、ネストされたコメントです。そのparentCommentの項目には、親コメントのURNが入ります。この項目は、第1階層のコメントでは使えません。

コメントを編集するには、X-RestLi-Method: PARTIAL_UPDATEのヘッダーと、メッセージのテキストを設定するパッチを使います。Delete a Commentも、掲載されているメソッドの一つです。

コメントのオン・オフ

投稿へのコメントのオン・オフは、Social Metadata APIという別のAPIで切り替えます。コメントを無効にするにはcommentsStateをCLOSEDに、有効にするにはOPENに設定します。コメントを無効にすると、そのスレッドの既存コメントはすべて削除されます。リアクションはそのまま残ります。コメントを再び有効にすると、そのスレッドに再びコメントできるようになります。

Social Metadata APIが受け付けるのはスレッドのURNだけです。コメントのURNを使った書き込みは拒否されます。コメントの作成と取得には、Comments APIを使ってください。集計の件数は、返信を含むcommentSummary.countと、返信を除くcommentSummary.topLevelCountです。

LinkedInで手作業でコメントする

APIを呼び出す前にコメントの感触を確かめたいなら、まず手作業で試してください。手順はLinkedInヘルプ: 投稿にコメントする・コメントに返信するに従っています。

  1. 投稿の下にあるコメントをクリックするか、Add a commentと書かれたテキストボックスをクリックします。
  2. コメントを入力します。
  3. 必要に応じて、絵文字アイコン、GIFアイコン、画像アイコンのいずれかをクリックします。
  4. コメントをクリックします。

返信するには、コメントの下にあるReplyをクリックするか、Add a replyと書かれたテキストボックスをクリックして、返信を入力してからReplyをクリックします。メンバーはコメントできる相手を自分の1次つながりに限定することもでき、1次つながりでない人のコメントを防げます。

自分のコメントを編集するには、コメントの右にあるMoreアイコンをクリックし、Editアイコンをクリックして内容を変更してから、Save Changesをクリックします。すると、そのコメントの上に(編集済み)と表示されます。手順はLinkedInヘルプ: コメントを編集するに従っています。

始め方

使う予定のAPIバージョンのリファレンスを読んでください。権限の行はバージョンごとに変わるためです。自分が所有する投稿に対して、1回の読み取り呼び出しから始めてください。書き込みは、読み取りで期待どおりの結果が返ってきてから追加してください。

参照したヘルプページに書かれていないこと

参照したヘルプページには、次の内容は書かれていません。

  • APIのレート制限とクォータ。
  • APIアクセスの料金や価格。
  • アプリの作成方法、Marketing Developer PlatformやCommunity Managementへのアクセスの取得方法、承認にかかる期間、個人の開発者が対象になるかどうか。
  • 管理者権限のないアプリが、他のメンバーの投稿へのコメントを読み取れるかどうか。
  • Delete a Commentのリクエスト形式、ページングと件数の上限、現在のAPIバージョン。

PostCat AIとコメント

PostCat AIは独立した製品で、LinkedInが運営しているものでも、LinkedInが承認しているものでもありません。公開した投稿へのコメントに、承認を経て、または自動で返信します。LinkedInの公式APIを通じてのみ動作します。料金は料金ページにあります。

出典
  • 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プロフィールをつないで、無料トライアルを始めましょう。