この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Personalization Audiences

ユーザコンテキストに一致する割り当て済み利用者のリストを取得します。利用者を作成します。

リソース

1/connect/communities/communityId/personalization/audiences

使用可能なバージョン

47.0

Chatter が必要かどうか

いいえ

HTTP のメソッド

GET、POST

GET の要求パラメータ

パラメータ名	型	説明	必須か省��可能	使用可能なバージョン
`domain`	String	ユーザの Salesforce カスタムドメインの名前。指定しない場合、ドメイン条件がある利用者は返されません。	省略可能	47.0
`includeAudienceCriteria`	Boolean	利用者の条件を含めるか (`true`)、否か (`false`) を指定します。指定しない場合は、デフォルトの `false` になります。	省略可能	47.0
`ipAddress`	String	ユーザの IP アドレス。指定しない場合、場所条件がある利用者は返されません。	省略可能	47.0
`publishStatus`	String	利用者の状況を公開します。値は次のとおりです。 `Draft` `Live` 指定しない場合、デフォルトは `Live` です。	省略可能	47.0
`recordId`	String	項目ベースの条件のレコードの ID。指定しない場合、項目ベースの条件がある該当するすべての利用者が返されます。	省略可能	51.0
`targetTypes`	String[]	結果を絞り込むための対象種別のカンマ区切りリスト。サポートされる値は次のとおりです。 `ExperienceVariation` (バージョン 47.0 以降) `CustomObjectName__c` などのカスタムオブジェクトの API 参照名 (バージョン 47.0 以降) `NavigationLinkSet` (バージョン 49.0 以降) `Topic` (バージョン 49.0 以降) `CollaborationGroup` (バージョン 49.0 以降) `KnowledgeArticle` (バージョン 49.0 以降) `ContentDocument` (バージョン 49.0 以降) `ManagedContent` (バージョン 49.0 以降) `Report` (バージョン 49.0 以降) `Dashboard` (バージョン 49.0 以降) 指定しない場合、すべての対象種別が返されます。	省略可能	47.0
`userId`	String	ユーザの ID。指定しない場合、デフォルトは、コンテキストユーザの ID です。	省略可能	47.0

GET のレスポンスボディ

Audience Collection

POST のリクエストボディ

ルート XML タグ

<audience>

JSON の例

1{
2   "criteria": [
3      {
4      "criterion": [
5         {
6         "entityType": "User",
7         "fieldValue": "60005500",
8         "entityField": "Contact.Account.AnnualRevenue"
9         },
10         {
11         "entityType": "User",
12         "fieldValue": "6000557700",
13         "entityField": "Contact.Account.AnnualRevenue"
14         }
15      ],
16      "criterionNumber": 1,
17      "criterionOperator": "Equal",
18      "criterionType": "FieldBased"
19      },
20      {
21      "criterion": [
22         {
23         "permission": "AssignTopics", // give permission id in case of custom permission
24         "isEnabled": "true"
25         }
26      ],
27      "criterionNumber": 2,
28      "criterionOperator": "Equal",
29      "criterionType": "Permission"
30      },
31      {
32      "criterion": [
33         {
34         "domainId": "0I4...", // give domain id 
35         },
36         {
37         "domainId": "0I4...", // give domain id 
38         }
39      ],
40      "criterionNumber": 3,
41      "criterionOperator": "Equal",
42      "criterionType": "Domain"
43      },
44      {
45      "criterion": [
46         {
47         "profileId": "00e...", // give profile id 
48         },
49         {
50         "profileId": "00e...", // give profile id 
51         }
52      ],
53      "criterionNumber": 4,
54      "criterionOperator": "Equal",
55      "criterionType": "Profile"
56      },
57      {
58      "criterion": [
59         {
60         "country": "US",
61         "subdivision" : "California",
62         "city" : "LA"
63         },
64         {
65         "country": "US",
66         "subdivision" : "California",
67         "city" : "SF"
68         },
69      ],
70      "criterionNumber": 5,
71      "criterionOperator": "Equal",
72      "criterionType": "GeoLocation"
73      },
74      {
75      "criterion": [
76         {
77         "audienceId": "6Au...": // give audience id 
78         }
79      ]
80      "criterionNumber": 6,
81      "criterionOperator": "Equal",
82      "criterionType": "Audience"
83      }
84    ],
85   "customFormula": "(1 OR (2 AND 3)) AND 4 AND 5 AND 6",
86   "formulaFilterType": "CustomLogicMatches",
87   "name": "CreateAudienceExample"
88}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
`criteria`	Audience Criterion Input[]	更新または追加する利用者の条件のリスト。利用者には最大 100 個の条件を含めることができます。	利用者を作成する場合は必須利用者を更新する場合は省略可能	47.0
`customFormula`	String	利用者の条件のカスタム数式。たとえば、(1 AND 2) OR 3 などです。	`formulaFilterType` を `CustomLogicMatches` に設定して利用者を作成する場合は必須それ以外の場合は、省略可能	47.0
`formulaFilterType`	String	パーソナライズ利用者の数式の条件種別。値は次のとおりです。 `AllCriteriaMatch` — すべての利用者の条件が true (AND 操作)。 `AnyCriterionMatches` — いずれかの利用者の条件が true (OR 操作)。 `CustomLogicMatches` — 利用者の条件はカスタム数式に一致します (たとえば (1 AND 2) OR 3 など)。	利用者を作成する場合は必須利用者を更新する場合は省略可能	47.0
`name`	String	利用者の名前。	利用者を作成する場合は必須利用者を更新する場合は省略可能	47.0

POST のレスポンスボディ

利用者

Connect REST API 開発者ガイド

Personalization Audiences