Recommendation Audience

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

リソース

1/connect/recommendation-audiences/recommendationAudienceId

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

使用可能なバージョン

35.0

Chatter が必要かどうか

いいえ

HTTP メソッド

GET、HEAD、DELETE、PATCH

GET のレスポンスボディ

Recommendation Audience

PATCH のリクエストボディ

ルート XML タグ

<recommendationAudience>

カスタムリストのおすすめ利用者を更新する JSON の例

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

新規メンバーのおすすめ利用者を更新する JSON の例

1{ 
2   "criteria" : {
3      "value" : "30",
4      "type" : "MaxDaysInCommunity"
5   },
6   "name" : "New Hires"
7}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
criteria	Custom List Audience Criteria Input または New User Audience Criteria Input	おすすめ利用者種別の条件。	省略可能 おすすめ利用者の作成時に指定されていない場合、おすすめ利用者種別はデフォルトでカスタムリストに設定されます。	36.0
member​OperationType	String	このプロパティはバージョン 35.0 でのみ使用できます。バージョン 36.0 以降では、Custom List Audience Criteria Input を使用してください。 重要 利用者メンバーに対して実行する操作。値は次のとおりです。 Add — 指定されたメンバーを利用者に追加します。 Remove — 指定されたメンバーを利用者から削除します。	おすすめ利用者を更新する場合は必須 おすすめ利用者の作成では null を使用または指定しないでください	35.0 のみ
members	User ID Collection Input	このプロパティはバージョン 35.0 でのみ使用できます。バージョン 36.0 以降では、Custom List Audience Criteria Input を使用してください。 重要 ユーザ ID のコレクション。 利用者を更新する場合、最大 100 人のメンバーを含めることができます。利用者には最大 100,000 人のメンバーを含めることができ、各コミュニティには最大 100 人の利用者を含めることができます。	おすすめ利用者を更新する場合は必須 おすすめ利用者の作成では null を使用または指定しないでください	35.0 のみ
name	String	おすすめ利用者の一意の名前。	おすすめ利用者を更新する場合は省略可能 おすすめ利用者を作成する場合は必須	35.0

PATCH の要求パラメータ

パラメータ名	型	説明	必須項目/省略可能	使用可能なバージョン
name	String	おすすめ利用者の一意の名前。	必須項目	35.0

PATCH のレスポンスボディ

Recommendation Audience

DELETE のレスポンスボディ

204: Successful Delete