LinkedInコメントAPI: アプリでできること
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ヘルプ: 投稿にコメントする・コメントに返信するに従っています。
- 投稿の下にあるコメントをクリックするか、Add a commentと書かれたテキストボックスをクリックします。
- コメントを入力します。
- 必要に応じて、絵文字アイコン、GIFアイコン、画像アイコンのいずれかをクリックします。
- コメントをクリックします。
返信するには、コメントの下にある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)


