すべての推奨のリスト
get
/content/management/api/v1.1/personalization/recommendations
このリソースは、推奨名、apiNameおよびupdatedAtでフィルタできる使用可能な推奨のリストを返します。 フェッチ、ページ付け、並べ替えるアイテムの数を制御することができます。 制限を参照するには、問合せ構文の説明を参照してください。
リクエスト
問合せパラメータ
- default(optional): string
デフォルトの検索問合せ式。
- fields(optional): string
このパラメータは、推奨事項に対して返されるフィールドを制御するために使用されます。 このパラメータは、フィールド名または「すべて」のカンマ区切りリストを受け入れます。 これらのフィールドは、リストの各推奨に対して返されます。 すべてのフィールド名で大文字と小文字が区別されるため、問合せには正しいフィールド名を指定する必要があります。 各推奨事項には、標準フィールド(id、name、apiName、description、type、createdBy、createdAt、updatedBy、updatedAt、mainおよびdefaults)の両方があります。 fieldsを「すべて」 (大/小文字を区別しない)として指定すると、すべての標準フィールドおよび追加フィールドが返されます。 標準フィールドは常にレスポンスで返され、除外することはできません。 ユーザーがフィルタ処理できるのは、追加フィールドのみです。 このパラメータは問合せではオプションで、デフォルトではレスポンスの標準フィールドのみが表示されます。 問合せで指定されたフィールド名が正しくないか無効な場合は、エラーが発生します。
例: ?fields=all
このメソッドは、すべての標準フィールドと、各推奨のすべての追加フィールドを返します。
- limit(optional): integer(int32)
このパラメータは、負でない整数を受け入れ、結果のサイズの制御に使用します。デフォルト値:
100 - links(optional): string
このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby, first, 最後, prev, next
- offset(optional): integer(int32)
このパラメータは、負でない整数を受け入れ、結果の開始インデックスを制御するために使用します。デフォルト値:
0 - orderBy(optional): string
結果順。 現在、推奨を順序付けることはできません。デフォルト値:
name:asc - q(optional): string
このパラメータは、フィールド値に一致する問合せ式条件を受け入れます。 問合せ条件は、AND演算子を使用して結合し、カッコでグループ化できます。 問合せ条件の値は、{fieldName} {operator} "{fieldValue}"の形式に従います。 許可されるフィールド名は、repositoryIdのみです。 演算子の使用できる値は、eq (等しい)のみです。
例:
https://{cecsdomain}/content/management/api/v1.1/personalization/recommendations?q=(apiName eq "TestRecommendation")
例 :
https://{cecsdomain}/content/management/api/v1.1/personalization/recommendations?q=(repositoryId eq "EAQWER42DGKJ10PCNMGAE") - totalResults(optional): boolean
このパラメータは、ブール・フラグを受け入れます。 trueとして指定した場合、返される結果には合計結果数が含まれる必要があります。デフォルト値:
false
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
OK。
ルート・スキーマ : 推奨
型:
objectRecommendations
ソースを表示
- aggregationResults(optional): array aggregationResults
集計結果。
- count(optional): integer(int32)
現在のレスポンス内のレコードの合計数
- hasMore(optional): boolean
フェッチするページがまだあるかどうかを確認します。
- items(optional): array items
コレクションに含まれる特異なリソース。
- limit(optional): integer(int32)
サーバーによって使用される実際のページ・サイズ。 これは、クライアントがリクエストするものと同じではない可能性があります。
- links(optional): array links
リソースのリンク。
- offset(optional): integer(int32)
特異リソースが返される実際のインデックス。
- pinned(optional): array pinned
固定品目。 検索リストの上部に固定されたアイテムを表示
- scrollId(optional): string
scrollId:検索がスクロール検索に解決された場合。
- totalResults(optional): integer(int32)
クライアント・リクエストを満たすローの総数(ページング・パラメータを除く)
ネストされたスキーマ : 推奨
型:
object推奨事項
ソースを表示
- apiName(optional): string
推奨の参照名。 拒否名が指定されていない場合は、サーバーによって生成されます。 参照名はすべての推奨事項で一意である必要があります。 これは、推奨を起動するAPIコールで使用される名前です。
- channels(optional): array channels
- contentTypes(optional): array contentTypes
推奨されるコンテンツ・タイプが返されます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- createdBy(optional): string
推奨を作成したユーザー。
- createdDate(optional): object date
date
- defaults(optional): array defaults
デフォルト・ルール・セクション。
- description(optional): string
推奨の説明。
- id: string
推奨のid。 これは、レスポンス取得の必須プロパティであり、ポスト/putリクエストで無視されました。
- isPublished(optional): boolean
推奨が公開される前かどうか。
- links(optional): array links
リンク
- main(optional): array main
メイン・ルール・セクション。
- name: string
推奨の名前。 これはレスポンス取得の必須プロパティであり、投稿/書込みリクエストで空にはできません。
- publishedChannels(optional): array publishedChannels
- publishInfo(optional): object ItemSubResourceListPublishInfo
アイテムSubResource。
- repositoryId: string
推奨のリポジトリ。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- status(optional): string
推奨の現在のステータス。
- type(optional): string
ルール構造によって決定される推奨のタイプ。
- updatedBy(optional): string
推奨を最後に更新したユーザー。
- updatedDate(optional): object date
date
- version(optional): string
このアイテムの現在のリビジョン・バージョン。
ネストされたスキーマ : contentTypes
型:
array推奨されるコンテンツ・タイプが返されます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
ソースを表示
ネストされたスキーマ : ChannelId
型:
objectChannelId
ソースを表示
- id(optional): string
- isPrimaryChannel(optional): boolean
チャネルがアセットのプライマリかどうかを示します。
- links(optional): array links
リンク
- name(optional): string
ネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : ContentTypeId
型:
ソースを表示
object- name(optional): string
- typeCategory(optional): string
アセット・タイプのtypeCategory。
ネストされたスキーマ : DefaultSection
型:
objectデフォルト・セクション
ソースを表示
- items(optional): array items
アイテムのリストです。 これはオプションであり、空にできます。
- sort(optional): array sort
これは、標準的なクイズ構文に基づいた非常に単純なソートです。
例: [systemField | userDefinedfield]<:> これには、:ascまたは:descを追加することによって、上位プロパティと降順プロパティを付与できます。
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ネストされたスキーマ: sort
型:
arrayこれは、標準的なクイズ構文に基づいた非常に単純なソートです。
例: [systemField | userDefinedfield]<:>
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。 これには、:ascまたは:descを追加することによって、上位プロパティと降順プロパティを付与できます。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ソースを表示
例: [systemField | userDefinedfield]<:
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ネストされたスキーマ : ItemId
型:
ソースを表示
object- id(optional): string
アイテムのId。
- links(optional): array links
アイテム・リソースのリンク
- name(optional): string
アイテムの名前。
ネストされたスキーマ : MainRulesSection
型:
objectメイン・ルール・セクション
ソースを表示
- properties(optional): object RulesProperties
RulesProperties
- rules(optional): array rules
ルールのメイン・リスト。 これはオプションであり、空にできます。
- sort(optional): array sort
これは、標準的なクイズ構文に基づいた非常に単純なソートです。
例: [systemField | userDefinedfield]<:> これには、:ascまたは:descを追加することによって、上位プロパティと降順プロパティを付与できます。
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ネストされたスキーマ : RulesProperties
型:
objectRulesProperties
ソースを表示
- operator(optional): string
許容値:
[ "ALL", "ANY" ]このグループ内のルールを結合するために使用される演算子。 これはオプションで、省略した場合はALLにデフォルト設定されます。
ネストされたスキーマ: sort
型:
arrayこれは、標準的なクイズ構文に基づいた非常に単純なソートです。
例: [systemField | userDefinedfield]<:>
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。 これには、:ascまたは:descを追加することによって、上位プロパティと降順プロパティを付与できます。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ソースを表示
例: [systemField | userDefinedfield]<:
ここで:
standardAssetField - ユーザーがソート対象として選択できるフィールドの事前定義済リストです。
例:
publishedDate:asc - 公開された日付昇順でソート
userAssetField - ユーザーが作成したコンテンツ・タイプに定義されているフィールドを示します。
field.myTextまたはfield.someThing:desc
systemFieldまたはuserDefinedFieldが提供されない場合は、ランダムかつ関連性の可能性があります。
:relevance - Default. 関連性で順序付けられたアセットが返されます。
:ランダム - これによって、ルールやフィールドに関係なく、ランダムな順序でアセットが返されます。
ネストされたスキーマ : PublishInfo
型:
objectPublishInfo
ソースを表示
- channel (オプション): string
ターゲット名
- links(optional): array links
リンク
- publishedBy(optional): string
パブリッシュしたユーザー
- publishedDate(optional): object date
date
- slug(optional): string
公開スラグ
- version(optional): string
公開済のバージョン
400レスポンス
不正リクエスト
403レスポンス
禁止。
500レスポンス
内部サーバー・エラー