sObject Suggested Articles for Case

構文

URI

作成中のケース (つまり、ケースタイトル、説明、他の情報は入力されていても、ケースの保存と ID の割り当てがまだ行われていないケース) の推奨記事を返すには、vXX.X/sobjects/Case/suggestedArticles?language=記事の言語&subject=ケースの件名&description=ケースの説明 を使用します。

ID が存在する既存のケースの推奨記事を返すには、vXX.X/sobjects/Case/ID/suggestedArticles?language=記事の言語 を使用します。

適用開始バージョン

30.0

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

リクエストボディ

不要

要求パラメータ

パラメー���	説明
articleTypes	省略可能。目的の記事タイプを示す 3 文字の ID プレフィックス。値ごとにパラメータ名を繰り返すことで、1 回の REST コールでこのパラメータに複数の値を指定できます。たとえば、articleTypes=ka0&articleTypes=ka1 です。
categoryIds	省略可能。目的のデータカテゴリの ID。値ごとにパラメータ名を繰り返すことで、1 回の REST コールでこのパラメータに複数の値を指定できます。たとえば、categoryIds=02nx0000000GpZ8&categoryIds=02oRR0000004MNj です。
description	ケースの説明のテキスト。vXX.X/sobjects/Case/suggestedArticles?language=記事の言語&subject=ケースの件名&description=ケースの説明 にのみ有効で、subject が null の場合は必須です。記事の推奨は、ケースの件名、説明、またはその両方に基づいて行われます。
language	必須。記事が作成されている言語。
limit	省略可能。返される推奨記事の最大数を指定します。
publishStatus	省略可能。記事の公開状況。有効な値は次のとおりです。 Draft – 非公開 Online – Salesforce ナレッジに公開 Archived
subject	ケースの件名のテキスト。vXX.X/sobjects/Case/suggestedArticles?language=記事の言語&subject=ケースの件名&description=ケースの説明 にのみ有効で、description が null の場合は必須です。記事の推奨は、ケースの件名、説明、またはその両方に基づいて行われます。
validationStatus	省略可能。返される記事の検証状況。

作成中のケースの推奨記事を取得する場合の例

1curl https://na1.salesforce.com/services/data/v30.0/sobjects/Case/suggestedArticles?
2language=en_US&subject=orange+banana&articleTypes=ka0&articleTypes=ka1
3 -H "Authorization: Bearer token"

JSON レスポンスボディの例

1[ {
2  "attributes" : {
3    "type" : "KnowledgeArticleVersion",
4    "url" : "/services/data/v30.0/sobjects/KnowledgeArticleVersion/ka0D00000004CcQ"
5  "Id" : "ka0D00000004CcQ"
6}, {
7  "attributes" : {
8    "type" : "KnowledgeArticleVersion",
9    "url" : "/services/data/v30.0/sobjects/KnowledgeArticleVersion/ka0D00000004CXo"
10  },
11  "Id" : "ka0D00000004CXo"
12} ]

使用方法

Salesforce ナレッジが組織で有効になっている必要があります。ユーザの「記事の参照」権限が有効化されている必要があります。ユーザが参照する権限を持つデータカテゴリおよび記事タイプに基づいて、ユーザがアクセスできる記事のみが推奨記事に含まれます。

記事は、関連アルゴリズムに基づいて推奨されます。suggestedArticles リソースは、ケースに関係する記事の ID を取得するように設計されています。表示用の記事データを取得するために ID を使用する他のサービスと併用することを目的としています。