カスタムのおすすめを作成し、利用者を使用してスケジュールする | Chatter REST API 開発者ガイド

コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。

これらのおすすめは、デフォルトで Napili コミュニティのホームページと質問の詳細ページ、および Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに表示されます。また、Summer '15 以降のバージョンの Napili テンプレートを使用するコミュニティに、コミュニティマネージャがコミュニティビルダーを使用しておすすめを追加した場所にも表示されます。

ステップ 1: カスタムのおすすめを定義する

リソース

/connect/communities/communityId/recommendation-definitions

HTTP メソッド

POST

リクエストボディ

Recommendation Definition Input

リクエストボディの例

1{
2   "name":"Corporate Training Project",
3   "title":"Want to learn more about the Corporate Training Project?",
4   "explanation":"Click this link to learn more!",
5   "actionUrl":"https://www.example.com",
6   "actionUrlName":"Launch"
7}

レスポンスボディ

Recommendation Definition

ステップ 2: 画像をカスタムのおすすめに追加する

この例では、Salesforce にアップロードされている画像ファイルを追加します。新しい画像ファイルをアップロードするには、「バイナリファイルのアップロード」を参照してください。

リソース

/connect/recommendation-definitions/recommendationDefinitionId/photo

ステップ 1 の Recommendation Definition レスポンスボディで返された recommendationDefinitionId を使用します。

HTTP メソッド

PUT

リクエストボディ

Photo Input

リクエストボディの例

1{
2   "cropSize" : "120",
3   "cropX" : "0",
4   "cropY" : "0",
5   "fileId" : "069D00000001IOh"
6}

レスポンスボディ

Photo

ステップ 3: おすすめ利用者を作成する

リソース

/connect/communities/communityId/recommendation-audiences

HTTP メソッド

POST

リクエストボディ

Recommendation Audience Input

リクエストボディの例

1{
2   "name" : "Custom App Users"
3}

レスポンスボディ

Recommendation Audience

ステップ 4: メンバーをおすすめ利用者に追加する

リソース

/connect/communities/communityId/recommendation-audiences/recommendationAudienceId

ステップ 3 の Recommendation Audience レスポンスボディで返された recommendationAudienceId を使用します。

HTTP メソッド

PATCH

リクエストボディ

Recommendation Audience Input

リクエストボディの例

1{ 
2   "criteria" : {
3      "memberOperationType" : "Add",
4      "members" : {
5         "userIds" : [
6            "005B0000000Ge16",
7            "005D0000001GpHp"
8            ]
9         },
10      "type" : "CustomList"
11   }
12}

レスポンスボディ

Recommendation Audience

ステップ 5: 利用者を使用して、カスタムのおすすめをスケジュールする

リソース

/connect/communities/communityId/scheduled-recommendations

HTTP メソッド

POST

リクエストボディ

Scheduled Recommendation Input

リクエストボディの例

1{
2   "recommendationDefinitionId" : "0RDD00000004CEhOAM",
3   "recommendationAudienceId":"02JD00000008SfdMAE"
4}

レスポンスボディ

Scheduled Recommendation