SharePoint で他のユーザーをフォローする
SharePoint で他のユーザーをフォローするための一般的なプログラミング タスクについて説明します。
SharePoint で他のユーザーをフォローするための API
SharePoint でユーザーをフォローすると、ユーザーが発行したマイクロブログの投稿とアクティビティについての通知がニュースフィードに表示されます。 ユーザーのフォローに関連する機能は、[ニュースフィード] および [フォロー相手] のページに表示されます。
SharePoint では、プログラムによって他のユーザーをフォローするために使用できる、次の API が提供されています。
マネージ コード用のクライアント オブジェクト モデル
.NET クライアント オブジェクト モデル
Silverlight クライアント オブジェクト モデル
モバイル クライアント オブジェクト モデル
JavaScript オブジェクト モデル
REST (Representational State Transfer) サービス
サーバー オブジェクト モデル
SharePoint 開発のベスト プラクティスとして、可能な場合はクライアント API を使用します。 クライアント API には、クライアント オブジェクト モデル、JavaScript オブジェクト モデル、および REST サービスが含まれます。 SharePoint の API と使用するタイミングの詳細については、「 SharePoint で適切な API セットを選択する」を参照してください。
各 API には、フォローする他のユーザーのコアタスクの実行に使用するマネージャー オブジェクトが含まれています。
注:
コンテンツのフォローにも同じ API を使用します。 コンテンツのフォロー タスクの概要については、「 SharePoint でコンテンツ をフォローする」を参照してください。
表 1 に、API のマネージャー オブジェクトとその他のキー オブジェクト (または REST リソース)、および、それらがあるクラス ライブラリ (またはアクセス ポイント) を示します。
注:
Silverlight およびモバイル クライアント オブジェクト モデルは、.NET クライアント オブジェクト モデルと中核的な機能が同じであり、同じ署名を使用するので、表 1 や表 2 には明示されていません。 Silverlight クライアント オブジェクト モデルは、Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll で定義され、モバイル クライアント オブジェクト モデルは、Microsoft.SharePoint.Client.UserProfiles.Phone.dll で定義されています。
表 1. プログラムでユーザーをフォローするために使用される SharePoint API
API | キー オブジェクト |
---|---|
.NET クライアント オブジェクト モデル 参照先: 方法: SharePoint で .NET クライアント オブジェクト モデルを使用してユーザーをフォローする |
Manager オブジェクト: SocialFollowingManager プライマリ名前空間: Microsoft.SharePoint.Client.Social その他の重要なオブジェクト: SocialActor 、 SocialActorInfo 、 SocialActorType 、 SocialActorTypes クラス ライブラリ: Microsoft.SharePoint.Client.UserProfiles.dll |
JavaScript オブジェクト モデル 参照先: 方法: SharePoint で JavaScript オブジェクト モデルを使用してユーザーをフォローする |
Manager オブジェクト: SocialFollowingManager プライマリ名前空間: SP。社会的 その他の重要なオブジェクト: SocialActor、 SocialActorInfo、 SocialActorType、 SocialActorTypes クラス ライブラリ: SP.UserProfiles.js |
REST サービス 参照先: SharePoint のユーザーとコンテンツ REST API リファレンスのフォロー |
マネージャー リソース: social.following エンドポイント URI: <siteUri>/_api/social.following プライマリ名前空間 (OData.md): sp.social.SocialRestFollowingManager その他の重要なリソース: SocialActor、 SocialActorInfo、 SocialActorType、 SocialActorTypes |
サーバー オブジェクト モデル | Manager オブジェクト: SPSocialFollowingManager プライマリ名前空間: Microsoft.Office.Server.Social その他のキー オブジェクト: SPSocialActor 、 SPSocialActorInfo 、 SPSocialActorType 、 SPSocialActorTypes クラス ライブラリ: Microsoft.Office.Server.UserProfiles.dll |
SharePoint で他のユーザーをフォローするための一般的なプログラミング タスク
表 2 は、人々をフォローするための一般的なプログラミング タスクとそれらを実行するのに使用するメンバーを示します。 メンバーは .NET クライアント オブジェクト モデル (CSOM)、JavaScript オブジェクト モデル (JSOM)、REST サービス、サーバー オブジェクト モデル (SSOM) です。
注:
コンテンツのフォローにも同じ API を使用します。 コンテンツのフォロー タスクの概要については、「 SharePoint でコンテンツ をフォローする」を参照してください。
SocialFollowingManager オブジェクトは、現在のユーザーのコアフォローユーザー機能とフォローコンテンツ機能を統合します。 ただし、 PeopleManager オブジェクト (表 3 を参照) には、 SocialFollowingManager で提供されていない機能がいくつか用意されています。これには、他のユーザーの [次のユーザー] 状態を取得するためのメソッドも含まれます。
表 2. SocialFollowingManager オブジェクトを使用して人々をフォローするための一般的なタスクの API
タスク | メンバー |
---|---|
現在のユーザーのコンテキストでマネージャー オブジェクトのインスタンスを作成する | CSOM: SocialFollowingManager JSOM: SocialFollowingManager 休む: <siteUri>/_api/social.following SSOM: SPSocialFollowingManager |
特定のユーザーのコンテキストでマネージャー オブジェクトのインスタンスを作成する | CSOM: 実装されていません JSOM: 実装されていません REST: 実装されていません SSOM: SPSocialFollowingManager (オーバーロード) |
現在のユーザーが誰かのフォローを開始 (停止) するようにする | CSOM: フォロー ( StopFollowing ) JSOM: フォロー ( stopFollowing) REST: POST <siteUri>/_api/social.following/Follow (<siteUri>/_api/social.following/StopFollowing ) を実行し、要求本文で actor パラメーターを渡しますSSOM: Follow ( StopFollowing ) |
現在のユーザーが特定のユーザーをフォローしているかどうかを特定する | CSOM: IsFollowed JSOM: isFollowed REST: POST <siteUri>/_api/social.following/my/IsFollowed および要求本文で actor パラメーターを渡すSSOM: IsFollowed |
現在のユーザーをフォローしている人々を取得する | CSOM: GetFollowers JSOM: getFollowers REST: GET <siteUri>/_api/social.following/my/Followers SSOM: GetFollowers |
現在のユーザーがフォローしている人々を取得する | CSOM: GetFollowed JSOM: getFollowed REST: GET <siteUri>/_api/social.following/my/Followed(types=1) SSOM: GetFollowed |
現在のユーザーがフォローしている人々の数を取得する | CSOM: GetFollowedCount JSOM: getFollowedCount REST: GET <siteUri>/_api/social.following/my/FollowedCount(types=1) SSOM: GetFollowedCount |
現在のユーザーがフォローする可能性のある人々を取得する | CSOM: GetSuggestions JSOM: getSuggestions REST: GET <siteUri>/_api/social.following/my/Suggestions SSOM: GetSuggestions |
表 3 は、ユーザーをフォローするために使用できる PeopleManager メンバーの機能を示します。
表 3. PeopleManager オブジェクトを使用してユーザーをフォローするための一般的なタスク用 API
タスク | メンバー |
---|---|
フォローしている人々のリストが公開されているかどうかを確認する | CSOM: IsMyPeopleListPublic JSOM: isMyPeopleListPublic REST: IsMyPeopleListPublic 例: GET <siteUri>/_api/SP.UserProfiles.PeopleManager/IsMyPeopleListPublic SSOM: IsMyPeopleListPublic |
誰かが現在のユーザーをフォローしているかどうかを確認する | CSOM: AmIFollowedBy JSOM: amIFollowedBy REST: AmIFollowedBy 例: GET <siteUri>/_api/SP.UserProfiles.PeopleManager/AmIFollowedBy(accountName=@v)?@v='domain\\user' SSOM: AmIFollowedBy |
特定のユーザーがフォローしている人々を取得する | CSOM: GetPeopleFollowedBy JSOM: getPeopleFollowedBy REST: GetPeopleFollowedBy 例: GET <siteUri>/_api/SP.UserProfiles.PeopleManager/GetPeopleFollowedBy(accountName=@v)?@v='domain\\user' SSOM: GetPeopleFollowedBy |
特定のユーザーをフォローしている人々を取得する | CSOM: GetFollowersFor JSOM: getFollowersFor REST: GetFollowersFor 例: GET <siteUri>/_api/SP.UserProfiles.PeopleManager/GetFollowersFor(accountName=@v)?@v='domain\\user' SSOM: GetFollowersFor |
特定のユーザーが別のユーザーをフォローしているかどうかを確認する | CSOM: IsFollowing JSOM: isFollowing REST: IsFollowing (静的) 例: GET <siteUri>/_api/SP_UserProfiles_PeopleManager_IsFollowing(possibleFollowerAccountName=@v,possibleFolloweeAccountName=@y)?@v='domain\\user'&@y='domain\\user' SSOM: IsFollowing |
SharePoint Online での、おすすめのユーザー機能の仕組み
おすすめのユーザー機能の結果は、確立されたユーザー フォローのアクティビティに基づいています。 ユーザーがまだフォローしていないユーザーと相互にフォローしている別のユーザーをフォローする場合に提案されます。
検索クロールの間、フォローに関連する情報にインデックスが設定されます。 クロールの終了後、検索分析によりクロールされたフォロー情報を分析し、ユーザーへの提案を出力する必要があります。 既定により、検索分析は 1 日に 1 回実行されます。
ユーザーが [ フォロー相手] ページを開くと、 PeopleManager.GetMySuggestions() メソッドが呼び出されます。 GetMySuggestions 現在のユーザーに対する新しい提案を検索し、データベース中でユーザーの提案を更新し、ページに提案を表示します。