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

Personalization Targets

ユーザーを含む割り当て済み利用者に基づいて、そのユーザーのコンテキストに一致する対象のリストを取得します。対象を作成、更新します。

リソース

1/connect/communities/communityId/personalization/targets

使用可能なバージョン

47.0

HTTP のメソッド

GET、POST、PATCH

GET の要求パラメーター

パラメーター名	型	説明	必須か省略可能	使用可能なバージョン
`domain`	String	ユーザーの Salesforce カスタムドメインの名前。指定しない場合、ドメイン条件がある利用者対象は返されません。	省略可能	47.0
`groupNames`	String[]	グループ名のカンマ区切りのリスト。グループによって、関連する対象と利用者のペアがまとめられます。グループ名を指定する場合は、単一の `targetTypes` 値も指定する必要があります。	省略可能	48.0
`includeAllMatchingTargetsWithinGroup`	Boolean	対象グループ内にすべての一致対象を含めるか (`true`)、否か (`false`) を指定します。指定しない場合、デフォルトは `false` です。`false` の場合は、グループ内の優先度に基づいて、各グループ内で最初に一致した対象が返されます。	省略可能	47.0
`includeAudience`	Boolean	一致する利用者を含めるか (`true`)、否か (`false`) を指定します。指定しない場合、デフォルトは `false` です。	省略可能	47.0
`ipAddress`	String	ユーザーの IP アドレス。指定しない場合、場所条件がある利用者対象は返されません。	省略可能	47.0
`publishStatus`	String	対象の公開状況。値は次のとおりです。 `Draft` `Live` 指定しない場合、デフォルトは `Live` です。	省略可能	47.0
`recordId`	String	利用者の項目ベースの条件を指定する場合のレコードの ID。	省略可能	47.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 以降) 指定しない場合、すべての対象種別が返されます。	`groupNames` を指定する場合は必須。それ以外は省略可能	47.0
`userId`	String	ユーザーの ID。指定しない場合、デフォルトは、コンテキストユーザーの ID です。	省略可能	47.0

POST のリクエストボディ

Target Collection Input で POST を使用して対象を作成します。

ルート XML タグ

<targetCollection>

JSON の例

1{
2   "targets": [{
3      "audienceId":"6AuRM0000004D5w0AE",
4      "groupName":"2b8bc305-d415-49f9-8e24-814455427324",
5      "priority":1,
6      "publishStatus":"Draft",
7      "targetType":"ExperienceVariation",
8      "targetValue":"ContactSupport_ContactSupportForCalifornia_Page"
9      }
10   ]
11}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
`targets`	Target Input[]	作成する対象のリスト。	必須	47.0

PATCH のリクエストボディ

Target Collection Update Input で PATCH を使用して、利用者を対象に割り当てるなどして対象を更新します。

ルート XML タグ

<targetCollection>

JSON の例

1{
2   "targets": [{
3      "audienceId":"6AuRM0000004D5w0AE",
4      "priority":1,
5      "targetId":"6AtRM0000000II30AM"
6      }
7   ]
8}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
`targets`	Target Update Input[]	更新する対象のリスト。	必須	47.0

GET、POST、PATCH のレスポンスボディ

Target Collection

Connect REST API 開発者ガイド

Personalization Targets