機械翻訳について

類似アイテムの問合せ

get

/content/management/api/v1.1/items/{id}/similarItems

このリソースは、特定のアイテムに類似したアイテムの検索を可能にします。 同期と非同期の両方の起動をサポートします。

視覚的類似度は、イメージに対してのみサポートされています。
問合せ式にデフォルト値が指定されていない場合は、q=repositoryId eq "{repoId}" AND (fileGroup eq "Images")に設定されます。

ビジュアル検索に固有のフィルタ・ルールは次のとおりです:
repositoryIdを指定する場合は、アセットが属するリポジトリのidと一致する必要があります。
typeが指定されている場合、DigitalAssetTypeカテゴリである必要があります。
fileGroupを指定する場合は、イメージにする必要があります。
前述のフィールドに他の値を指定すると、エラー・レスポンスになります。

リクエスト

パス・パラメータ
問合せパラメータ
  • このパラメータは、チャネルのchannelTokenを受け入れ、返される結果を制御するために使用します。 結果には、指定されたchannelTokenが属するチャネルをターゲットとするアイテムのみが含まれます。 これは、チャネル(アイテムの標準フィールド)に問合せ条件(channels co "{channelId}")をq問合せパラメータの問合せ条件の1つとして指定することによって実現することもできます。 これはオプションのパラメータであり、デフォルトではすべての結果が戻されます。
  • すべてのフィールドのアイテムの値を照合するデフォルトの検索問合せ式です。
  • このパラメータは、結果内の各アイテムの返されるフィールドを制御するために使用します。 このパラメータは、フィールド名または「すべて」のカンマ区切りリストを受け入れます。 これらのフィールドは、結果内の各アイテムに対して返されます。 フィールド名はすべて大文字小文字が区別され、ユーザーは問合せで正しいフィールド名を指定する必要があります。 すべてのユーザー定義フィールド名には、プレフィクス・フィールドを指定し、その後にピリオド(.)を付加する必要があります。 fields「すべて」 (大/小文字を区別しない)として指定されている場合、タイプ間および特定の問合せのタイプの場合、すべての標準フィールドが返され、すべての標準フィールドとユーザー・フィールドが返されます。 このパラメータは問合せではオプションで、結果には標準フィールド名と説明のみが表示されます。 標準フィールドid (type)は、尋ねられたフィールドに関係なく常に返されます。 問合せに指定されたフィールド名が間違っているか無効な場合は、error.Inがブレス・スタイル・クロス・タイプ問合せのコンテキストをスローします。タイプ固有のフィールドは、構文name,{typename1:fields.userdefinedfieldname1, fields.userdefinedfieldname2},{typename2:fields.userdefinedfieldname1}を使用して指定できます。 前述の例では、typename1タイプのすべてのアイテムにフィールドがあります - 名前、userdefinedfieldname1およびuserdefinedfieldname2。typename2タイプのすべてのアイテムにはフィールドが含まれます - 名前、userdefinedfieldname1。 型付きフィールド句で参照されているタイプにクロス・タイプの問合せが解決されない場合、エラーがスローされます。
    fields「メタデータ」またはmetadata.exifとして指定するアセットの既存のメタデータを返すこともできます。
    現在、新しくアップロードしたイメージに使用できるのはEXIFメタデータのみです。

    : これにより、検索結果のアドレスタイプの標準フィールドname、ユーザー・フィールドstateおよびcountryが返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?q=type eq "Address"&fields= fields.state, fields.country

    : これにより、検索結果で使用される特定のタイプのすべての属性が返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?q=type eq "Address"&fields=all

    : これにより、すべてのタイプのすべてのアイテムの検索結果で標準フィールドnamecreatedByが返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?fields=name,createdBy

    : これにより、検索結果のすべての標準フィールドがすべてのタイプのすべてのアイテムに対して返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?fields=all

    : これにより、すべてのタイプのすべてのアイテムについて検索結果で使用可能なメタデータが返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?fields=metadata

    : これにより、すべてのタイプのすべてのアイテムの検索結果に使用可能なEXIFメタデータが返されます。
    https://{cecsdomain}/content/management/api/v 1.1 /items?fields=metadata.exif
    デフォルト値: name,description
  • このパラメータは、負でない整数を受け入れ、結果のサイズの制御に使用します。
    デフォルト値: 100
  • このパラメータは、負でない整数を受け入れ、結果の開始インデックスを制御するために使用します。
    デフォルト値: 0
  • このパラメータは、フィールド値に一致する問合せ式条件を受け入れます。 このような問合せ条件の多くは、AND/OR演算子を使用して結合でき、カッコで囲まれています。 問合せ条件の値は、{fieldName} {operator} "{fieldValue}"の形式に従います。 タイプ固有の問合せの場合、フィールド名は標準フィールドとユーザー定義フィールド(largeTextデータ型のフィールドを除く)に制限されます。 演算子で使用できる値は、eq (等しい)、co (含む)、sw (で開始)、ge (以上)、le (以下)、gt (より大きい)、lt (より小さい)、mt (一致)およびsm (類似)のみです。
    :
    https://{cecsdomain}/content/management/api/v1.1/items?q=(name eq "John")
    :
    https://{cecsdomain}/content/management/api/v1.1/items?q=(type eq "Employee" AND name eq "John")
    :
    https://{cecsdomain}/content/management/api/v1.1/items?q=(type eq "Employee" AND ((name eq "John" AND field.age ge "40") OR fields.weight gt "70"))
    :
    https://{cecsdomain}/content/management/api/v1.1/items?q=( taxonomies.categories.id eq "9E1A79EE600C4C4BB727FE3E39E95489" OR ( taxonomies.categories.name co "cat" AND taxonomies.categories.name co "red"))
    :
    https://{cecsdomain}/content/management/api/v1.1/items?q=( taxonomies.categories.nodes.id eq "9E1A79EE600C4C4BB727FE3E39E95489" OR taxonomies.categories.nodes.name co "cars")
  • returnMaster
    デフォルト値: false
  • このパラメータは、ブール・フラグを受け入れます。 trueとして指定した場合、返される結果には合計結果数が含まれる必要があります。
    デフォルト値: false
ヘッダー・パラメータ
  • このパラメータは、リクエストの相互作用のタイプ(同期/非同期)を制御するために使用されます。 ヘッダーの値がレスポンス/同期で指定されている場合は、非同期相互作用が優先されることを示します。 それ以外の場合は、同期相互作用が優先されます。 非同期リクエストは、ロケーション・ヘッダーにステータス・リンクがある202ステータスで応答します。 同期リクエストは、レスポンス本文とともに200で応答します。
    許容値: [ "respond-async" ]
トップに戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

OK。
本文()
ルート・スキーマ : SearchItems
型: object
アイテムの検索
ソースを表示
ネストされたスキーマ : aggregationResults
型: array
集計結果。
ソースを表示
ネストされたスキーマ: items
型: array
コレクションに含まれる特異なリソース。
ソースを表示
ネストされたスキーマ : 殺害
型: array
固定品目。 検索リストの上部に固定されたアイテムを表示
ソースを表示
ネストされたスキーマ : AggregationResult
型: object
ソースを表示
ネストされたスキーマ : アイテム
型: object
識別子: typeCategory
項目
ソースを表示
ネストされたスキーマ : ItemSubResourceListChangesInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListChannelId
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListCollectionId
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceConnectorFileInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: User
型: object
ユーザー・オブジェクト
ソースを表示
ネストされたスキーマ : date
型: object
date
ソースを表示
ネストされたスキーマ: fields
型: object
読取り専用: true
使用可能なその他のプロパティ
ソースを表示
ユーザー定義フィールドのデータ。 Map タイプ定義に必要なすべてのユーザー定義フィールドは、このプロパティのPUTとPOSTリクエストで指定する必要があります。
ネストされたスキーマ : ItemSubResourceLockInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemMetadataInfo
型: object
ItemMetadataInfo
ソースを表示
ネストされたスキーマ : ItemSubResourceListAction
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListPublishInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemReferenceInfo
型: object
ItemReferenceInfo
ソースを表示
ネストされたスキーマ : ItemSubResourceRelationships
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListSuggestedTaxonomyInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListTag
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListTaxonomyInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListVariationsInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListVersionInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : VideoBean
型: object
VideoBean
ソースを表示
ネストされたスキーマ : WorkflowField
型: object
すべてのマップ済ワークフロー・フィールド
ソースを表示
ネストされたスキーマ : ItemSubResourceListWorkflowInfo
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : ChangesInfo
型: object
ChangesInfo
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : ChannelId
型: object
ChannelId
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : CollectionId
型: object
CollectionId
ソースを表示
ネストされたスキーマ : ConnectorFileInfo
型: object
ConnectorFileInfo
ソースを表示
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ : LockInfo
型: object
LockInfo
ソースを表示
ネストされたスキーマ : EXIFMetadata
型: object
EXIFメタデータ
ソースを表示
ネストされたスキーマ : VideoTranscriptMetadata
型: object
ビデオ記録Metadata
ソースを表示
ネストされたスキーマ : aggregationResults
型: array
集計結果。
ソースを表示
ネストされたスキーマ: items
型: array
コレクションに含まれる特異なリソース。
ソースを表示
ネストされたスキーマ : 殺害
型: array
固定品目。 検索リストの上部に固定されたアイテムを表示
ソースを表示
ネストされたスキーマ : ItemExtractedExifBean
型: object
ItemExtractedExifBean
ソースを表示
ネストされたスキーマ : aggregationResults
型: array
集計結果。
ソースを表示
ネストされたスキーマ: items
型: array
コレクションに含まれる特異なリソース。
ソースを表示
ネストされたスキーマ : 殺害
型: array
固定品目。 検索リストの上部に固定されたアイテムを表示
ソースを表示
ネストされたスキーマ : Videotranscript
型: object
ビデオ・トランスクリプト
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ: Action
型: object
アクション
ソースを表示
  • 許容値: [ "view", "update", "create", "delete" ]
    リソースでアクションが許可されています
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : PublishInfo
型: object
PublishInfo
ソースを表示
ネストされたスキーマ : 関係
型: object
関係
ソースを表示
ネストされたスキーマ : referencedBy
型: array
Idによる参照
ソースを表示
ネストされたスキーマ : サイト・プラン参照
型: object
サイト・プラン参照
ソースを表示
ネストされたスキーマ : referencedBySites
型: array
サイトで参照
ソースを表示
ネストされたスキーマ : references
型: array
参照Id
ソースを表示
ネストされたスキーマ : 参照
型: object
参照
ソースを表示
ネストされたスキーマ : ReferencedBySites
型: object
ReferencedBySites
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : SuggestedTaxonomyInfo
型: object
SuggestedTaxonomyInfo
ソースを表示
ネストされたスキーマ : categories
型: array
アイテムが属する推奨タクソノミのカテゴリ。
ソースを表示
ネストされたスキーマ : ItemSuggestedCategoryInfo
型: object
ソースを表示
ネストされたスキーマ : nodes
型: array
品目に割り当てられたカテゴリ内のノード。
ソースを表示
ネストされたスキーマ : CategoryNodeBean
型: object
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ: Tag
型: object
Tag.
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : TaxonomyInfo
型: object
TaxonomyInfo
ソースを表示
ネストされたスキーマ : categories
型: array
アイテムが属するタクソノミのカテゴリ。
ソースを表示
ネストされたスキーマ : ItemCategoryInfo
型: object
ソースを表示
ネストされたスキーマ : nodes
型: array
品目に割り当てられたカテゴリ内のノード。
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : VariationsInfo
型: object
バリエーション情報。
ソースを表示
ネストされたスキーマ: items
型: array
コンテンツ・アイテムのバリエーション。
ソースを表示
ネストされたスキーマ : 言語
型: object
LanguageItem
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : VersionInfo
型: object
VersionInfo
ソースを表示
ネストされたスキーマ : PlaybackBean
型: object
PlaybackBean
ソースを表示
ネストされたスキーマ : ProcessingBean
型: object
ProcessingBean
ソースを表示
  • 読取り専用: true
    バックグラウンド・プロセスの進捗。 このフィールドの値は、保留中、成功または失敗のいずれかになります。
ネストされたスキーマ : StripBean
型: object
StripBean
ソースを表示
ネストされたスキーマ : AdaptiveStreamsBean
型: object
AdaptiveStreamsBean
ソースを表示
ネストされたスキーマ : StripFrameBean
型: object
StripFrameBean
ソースを表示
ネストされたスキーマ : aggregationResults
型: array
集計結果。
ソースを表示
ネストされたスキーマ: items
型: array
コレクションに含まれる特異なリソース。
ソースを表示
ネストされたスキーマ : 殺害
型: array
固定品目。 検索リストの上部に固定されたアイテムを表示
ソースを表示
ネストされたスキーマ : WorkflowInfo
型: object
WorkflowInfo.
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示

202レスポンス

Accepted.

304 レスポンス

変更されていません。

400レスポンス

不正リクエスト

403レスポンス

禁止。

404レスポンス

見つかりません。

429 レスポンス

リクエストが多すぎます。

500レスポンス

内部サーバー・エラー
先頭に戻る