ドキュメント Experience Platform カタログおよびデータセットガイド

クエリパラメーターを使用した Catalog データのフィルタリング

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
カタログ

作成対象：

開発者

パフォーマンスを向上させ、関連する結果を取得するには、クエリパラメーターを使用して API 応答データ Catalog Service フィルタリングします。

API の Catalog オブジェクトに対する一般的なフィルタリングメソッドについて説明します。 API インタラクションについて詳しくは、このドキュメントをカタログ開発者ガイドと共に使用してください。一般的 Catalog Service 情報については、Catalog 概要を参照してください。

返されるオブジェクトの制限 limit-returned-objects

limit クエリパラメーターでは、応答で返されるオブジェクトの数を制限します。応答 Catalog 事前定義の制限に従います。

limit パラメーターを指定しない場合、1 回の応答あたりのオブジェクトの最大数は 20 です。
データセットクエリの場合、properties クエリパラメーターを使用して observableSchema がリクエストされた場合、返されるデータセットの最大数は 20 です。
ユーザートークンの場合、上限は 1 です。
サービストークンの場合、上限は 20 です。
他のカタログクエリのグローバル制限は 100 オブジェクトです。
無効な limit 値（limit=0 を含む）を指定すると、適切な範囲を指定した 400 レベルのエラー応答が返されます。
クエリパラメーターとして渡された制限またはオフセットは、ヘッダーの制限またはオフセットよりも優先されます。

API 形式

GET /{OBJECT_TYPE}?limit={LIMIT}

パラメーター

説明

{OBJECT_TYPE}

取得するオブジェ Catalog トのタイプ。有効なオブジェクト：

batches
dataSets
dataSetFiles

{LIMIT}

返されるオブジェクトの数を指定する整数（範囲：1 ～ 100）。

リクエスト

次のリクエストでは、データセットのリストを取得し、応答を 3 つのオブジェクトに制限します。

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?limit=3 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

正常な応答は、データセットのパラメーターを返します。この値は、limit クエリパラメーターで示される数に制限されます。

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset 1",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    },
    "5bb276b03a14440000971552": {
        "name": "Sample Dataset 2",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5bb276b03a14440000971552"
    },
    "5bceaa4c26c115000039b24b": {
        "name": "Sample Dataset 3"
    }
}

表示するプロパティの制限 limit-displayed-properties

limit パラメーターを使用して返されたオブジェクトの数をフィルタリングする場合でも、返されるオブジェクト自体には、実際に必要な情報よりも多くの情報が含まれることがあります。システムの負荷をさらに減らすには、ベストプラクティスは必要なプロパティのみを含めるように応答をフィルタリングすることです。

propertiesパラメーターフィルターは、指定されたプロパティのセットのみを返すようにオブジェクトに応答します。このパラメーターは、1 つ以上のプロパティを返すように設定できます。

properties パラメータは、任意のレベルオブジェクトプロパティを受け付けることができます。 sampleKey は ?properties=subItem.sampleKey を使用して抽出できます。

{
  "5ba9452f7de80400007fc52a": {
      "name": "Sample Dataset",
      "description": "Sample dataset containing important data",
      "subitem": {
          "sampleKey": "sampleValue"
      }
  }
}

API 形式

GET /{OBJECT_TYPE}?properties={PROPERTY}
GET /{OBJECT_TYPE}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}

パラメーター

説明

{OBJECT_TYPE}

取得 Catalog るオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets
dataSetFiles

{PROPERTY}

応答本文に含める属性の名前。

{OBJECT_ID}

取得する特定の Catalog オブジェクトの一意の識別子。

リクエスト

次のリクエストは、データセットのリストを取得します。properties パラメーターの下に指定されたプロパティ名のコンマ区切りリストは、応答で返されるプロパティを示します。また、返されるデータセットの数を制限する limit パラメーターも含まれます。リクエストに limit パラメーターが含まれていない場合、応答には最大 20 個のオブジェクトが含まれます。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?limit=4&properties=name,schemaRef' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答が成功すると、リクエストされたプロパティのみが表示された Catalog オブジェクトのリストが返されます。

{
    "Dataset1": {
        "name": "Dataset 1",
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/bc82c518380478b59a95c63e0f843121",
            "contentType": "application/vnd.adobe.xed+json;version=1"
        }
    },
    "Dataset2": {},
    "Dataset3": {
        "name": {},
    },
    "Dataset4": {
        "name": "Dataset 4",
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/142afb78d8b368a5ba97a6cc8fc7e033",
            "contentType": "application/vnd.adobe.xed+json;version=1"
        }
    }
}

上記の回答に基づいて、以下を推論できます。

リクエストされたプロパティがオブジェクトにない場合は、そのオブジェクトに含まれているリクエストされたプロパティのみが表示されます（Dataset1）。
リクエストされたプロパティが 1 つもオブジェクトに含まれていない場合は、空のオブジェクトとして表示されます（Dataset2）。
データセットは、リクエストされたプロパティがそのプロパティを含むが値がない場合、そのプロパティを空のオブジェクトとして返すことがあります（Dataset3）。
それ以外の場合は、リクエストされたすべてのプロパティの完全な値がデータセットに表示されます（Dataset4）。

NOTE

各データセットの schemaRef プロパティのバージョン番号は、スキーマの最新のマイナーバージョンを示します。詳しくは、XDM API ガイドのスキーマのバージョン管理の節を参照してください。

応答リストのオフセット開始インデックス offset-starting-index

start クエリパラメーターは、0 から始まる番号付けを使用して、応答リストを指定された数だけ前方にオフセットします。例えば、start=2 は、リストされた 3 番目のオブジェクトで開始するように応答をオフセットします。

start パラメーターと limit パラメーターがペアでない場合、返されるオブジェクトの最大数は 20 です。

API 形式

GET /{OBJECT_TYPE}?start={OFFSET}

パラメーター

説明

{OBJECT_TYPE}

取得するカタログオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets
dataSetFiles

{OFFSET}

応答をオフセットするオブジェクトの数を示す整数。

リクエスト

次のリクエストは、データセットのリストを取得し、5 番目のオブジェクト（start=4）にオフセットし、応答を 2 つの戻りデータセット（limit=2）に制限します。

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?start=4&limit=2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答には、各データセットに対して 1 つずつ、2 つの最上位項目（limit=2）とその詳細（この例で詳細をまとめたもの）を含む JSON オブジェクトが含まれます。応答が 4 ずつシフトされます（start=4）。つまり、表示されるデータセットは時系列で 5 と 6 です。

{
    "Dataset5": {},
    "Dataset6": {}
}

タグによるフィルター

一部のカタログオブジェクトは、tags 属性の使用をサポートしています。タグは、オブジェクトに情報を付加し、後でそのオブジェクトを取得するために使用できます。使用するタグと適用方法の選択は、組織のプロセスによって異なります。

タグを使用する場合は、いくつかの制限が考慮されます。

現在タグをサポートしているカタログオブジェクトは、データセット、バッチ、接続のみです。
タグ名は組織に固有の名前です。
アドビのプロセスは、特定の動作にタグを活用する場合があります。これらのタグの名前には、標準として「adobe」というプリフィックスが付けられます。したがって、タグ名を宣言する際は、このような規則を避ける必要があります。
次のタグ名は、Experience Platform 全体で使用するために予約されているので、組織のタグ名として宣言することはできません。
- unifiedProfile：このタグ名は、Real-Time Customer Profile が取り込むデータセット用に予約されています。
- unifiedIdentity：このタグ名は、Identity Service が取り込むデータセット用に予約されています。

次に、tags プロパティを含むデータセットの例を示します。このプロパティ内のタグは、キーと値のペアの形式をとり、各タグ値は 1 つの文字列を含む配列として表示されます。

{
    "5be1f2ecc73c1714ceba66e2": {
        "imsOrg": "{ORG_ID}",
        "tags": {
            "sampleTag": [
                "123456"
            ],
            "secondTag": [
                "sample_tag_value"
            ]
        },
        "name": "Sample Dataset",
        "description": "Same dataset containing sample data.",
        "createdUser": "{CREATED_USER}",
        "createdClient": "{CREATED_CLIENT}",
        "updatedUser": "{UPDATED_USER}",
        "version": "1.0.0",
        "created": 1541534444286,
        "updated": 1541534444286
    }
}

API 形式

tags パラメーターの値は、{TAG_NAME}:{TAG_VALUE} 形式を使用して、キーと値のペアの形式を取ります。複数のキーと値のペアは、コンマ区切りのリスト形式で提供できます。複数のタグを指定する場合、AND 関係が想定されます。

このパラメーターでは、タグ値にワイルドカード文字（*）を使用できます。例えば、test* の検索文字列は、タグ値が「test」で始まる任意のオブジェクトを返します。ワイルドカードのみで構成される検索文字列を使用すると、値に関係なく、特定のタグが含まれているかどうかに基づいてオブジェクトをフィルタリングできます。

GET /{OBJECT_TYPE}?tags={TAG_NAME}:{TAG_VALUE}
GET /{OBJECT_TYPE}?tags={TAG_NAME_1}:{TAG_VALUE_1},{TAG_NAME_2}:{TAG_VALUE_2}
GET /{OBJECT_TYPE}?tags={TAG_NAME}:{TAG_VALUE}*
GET /{OBJECT_TYPE}?tags={TAG_NAME}:*

パラメーター

説明

{OBJECT_TYPE}

取得 Catalog るオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets

{TAG_NAME}

フィルターに使用するタグの名前。

{TAG_VALUE}

フィルターに使用するタグの値。ワイルドカード文字（*）をサポートします。

リクエスト

次のリクエストは、データセットのリストを取得し、特定の値を持つ 1 つのタグと、2 番目のタグが存在することでフィルタリングします。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?tags=sampleTag:123456,secondTag:* \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

正常な応答は、値が「123456」である sampleTag、および、任意の値を持つ secondTag を含むデータセットのリストを返します。制限も指定しない限り、応答には最大 20 個のオブジェクトが含まれます。

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 1",
            "created": 1533539550237,
            "updated": 1533539552416,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
            "tags": {
                "sampleTag": [
                    "123456"
                ],
                "secondTag": [
                    "Example tag value"
                ]
            },
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.0",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 2",
            "created": 1533539550237,
            "updated": 1533539552416,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
            "tags": {
                "sampleTag": [
                    "123456"
                ],
                "secondTag": [
                    "A different tag value"
                ],
                "anotherTag": [
                    "2.0"
                ]
            },
    }
}

日付範囲によるフィルター

Catalog API の一部のエンドポイントには、遠隔クエリを可能にするクエリパラメーターがあります。ほとんどの場合、日付の場合です。

API 形式

GET /batches?createdAfter={TIMESTAMP_1}&createdBefore={TIMESTAMP_2}

パラメーター

説明

{TIMESTAMP }

UNIX エポック時間の datetime 整数。

リクエスト

次のリクエストは、2019 年 4 月に作成されたバッチのリストを取得します。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/batches?createdAfter=1554076800000&createdBefore=1556668799000' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答が成功すると、指定した日付範囲内の Catalog オブジェクトのリストが含まれます。制限も指定しない限り、応答には最大 20 個のオブジェクトが含まれます。

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 1",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.0",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 2",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

プロパティによる並べ替え

orderBy クエリパラメーターを使用すると、指定したプロパティ値に基づいて応答データを並べ替え（順序付け）できます。このパラメーターには、「方向」(昇順：asc、降順：desc)、コロン（:）、結果を並べ替えるプロパティの順に並べ替える必要があります。方向を指定しない場合、デフォルトの方向は昇順です。

複数の並べ替えプロパティは、コンマで区切ったリストで指定できます。最初の並べ替えプロパティで、そのプロパティが同じ値を含む複数のオブジェクトが生成される場合、2 番目の並べ替えプロパティを使用して、一致するオブジェクトをさらに並べ替えます。

例えば、クエリ「orderBy=name,desc:created」について考えます。結果は、最初の並べ替えプロパティ（name）に基づいて昇順で並べ替えられます。複数のレコードが同じ name プロパティを共有している場合、一致するレコードは 2 番目の並べ替えプロパティ（created）で並べ替えられます。返されたレコードが同じ name を共有しない場合、created プロパティは並べ替えで考慮されません。

API 形式

GET /{OBJECT_TYPE}?orderBy=asc:{PROPERTY_NAME}
GET /{OBJECT_TYPE}?orderBy=desc:{PROPERTY_NAME}
GET /{OBJECT_TYPE}?orderBy={PROPERTY_NAME_1},desc:{PROPERTY_NAME_2}

パラメーター

説明

{OBJECT_TYPE}

取得するカタログオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets
dataSetFiles

{PROPERTY_NAME}

結果の並べ替えに使用するプロパティの名前。

リクエスト

次のリクエストは、name プロパティで並べ替えられたリストセットのデータセットを取得します。同じ name を共有するデータセットがある場合、そのデータセットは updated プロパティによって降順で並べ替えられます。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?orderBy=name,desc:updated' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

正常な応答には、orderBy パラメーターに従って並べ替えられた Catalog オブジェクトのリストが含まれます。制限も指定しない限り、応答には最大 20 個のオブジェクトが含まれます。

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "0405",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.3",
            "imsOrg": "{ORG_ID}",
            "name": "AAM Dataset",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5cd3a129ec106214b722a939": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "AAM Dataset",
            "created": 1554028394852,
            "updated": 1554130582960,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

プロパティによるフィルター

Catalog には、プロパティでフィルタリングする 2 つの方法があります。これらの方法について、以降の節で詳しく説明します。

単純なフィルターの使用：特定のプロパティが特定の値と一致するかどうかでフィルタリングします。
プロパティパラメーターの使用：条件付き式を使用して、プロパティが存在するかどうか、またはプロパティの値が別の指定した値や正規式と一致、近似、比較するかどうかを基にフィルタリングします。

NOTE

Catalog オブジェクトの任意の属性を使用して、Catalog Service API で結果をフィルタリングできます。

単純なフィルターの使用 using-simple-filters

単純なフィルターを使用すると、特定のプロパティ値に基づいて応答をフィルタリングできます。単純なフィルターは、{PROPERTY_NAME}={VALUE} の形式をとります。

例えば、クエリ「name=exampleName」は、name プロパティに「exampleName」という値が含まれているオブジェクトのみを返します。これに対し、クエリ「name=!exampleName」は、name プロパティが「exampleName」でないオブジェクトのみを返します。

また、単純なフィルターは、単一のプロパティに対して複数の値をクエリする機能をサポートしています。複数の値が指定された場合、応答は指定されたリスト内の値の いずれかに プロパティが一致するオブジェクトを返します。複数値のクエリを反転するには、リストの冒頭に ! 文字を追加し、指定したリストにプロパティ値が含まれて いない（例えば、name=!exampleName,anotherName）オブジェクトのみを返します。

API 形式

GET /{OBJECT_TYPE}?{PROPERTY_NAME}={VALUE}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}=!{VALUE}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}={VALUE_1},{VALUE_2},{VALUE_3}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}=!{VALUE_1},{VALUE_2},{VALUE_3}

パラメーター

説明

{OBJECT_TYPE}

取得 Catalog るオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets
dataSetFiles

{PROPERTY_NAME}

値のフィルターに使用するプロパティの名前です。

{VALUE}

クエリに応じて含めるまたは除外する結果を決定するプロパティ値。

リクエスト

次のリクエストは、データセットのリストを取得し、name プロパティの値が「exampleName」または「anotherName」であるデータセットのみを含めるようにフィルタリングします。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?name=exampleName,anotherName' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

正常な応答は、name が「exampleName」または「anotherName」のデータセットを除く、データセットのリストを含みます。制限も指定しない限り、応答には最大 20 個のオブジェクトが含まれます。

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "exampleName",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.3",
            "imsOrg": "{ORG_ID}",
            "name": "anotherName",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

`property` パラメーターの使用 using-the-property-parameter

property クエリパラメーターは、単純なパラメーターよりも柔軟にプロパティベースのフィルタリングをおこなえます。プロパティに特定の値が含まれるかどうかに基づいてフィルタリングする以外に、property パラメーターは他の比較演算子（「より大きい」（>）や「より小さい」（<）など）を正規式としてプロパティ値によるフィルタリングに使用できます。また、値に関係なく、プロパティが存在するかどうかでフィルタリングすることもできます。

アンパサンド（&）を使用して複数のフィルターを組み合わせ、1 回のリクエストでクエリを絞り込みます。複数のフィールドでフィルタリングする場合、デフォルトでは AND 関係が適用されます。

NOTE

複数の property パラメーターを 1 つのクエリで組み合わせる場合は、少なくとも 1 つが id または created フィールドに適用される必要があります。次のクエリは、id が abc123 である ANDname が test でないオブジェクトを返します。

code language-http
`GET /datasets?property=id==abc123&property=name!=test`

同じフィールドで複数の property パラメーターを使用した場合は、最後に指定したパラメーターのみが有効になります。

IMPORTANT

1 つの property パラメーターを使用して複数のフィールドを一度にフィルタリングすることはできまん。各フィールドには、独自の property パラメーターが必要です。次の例（property=id>abc,name==myDataset）は、単一の property パラメーター 内の id および name に条件を適用しようとするので、許可されていません。

property パラメータは、任意のレベルオブジェクトプロパティを受け付けることができます。 sampleKey は、?properties=subItem.sampleKey を使用したフィルタリングに使用できます。

{
  "5ba9452f7de80400007fc52a": {
      "name": "Sample Dataset",
      "description": "Sample dataset containing important data",
      "subitem": {
          "sampleKey": "sampleValue"
      }
  }
}

API 形式

GET /{OBJECT_TYPE}?property={CONDITION}

パラメーター

説明

{OBJECT_TYPE}

取得 Catalog るオブジェクトのタイプ。有効なオブジェクトは次のとおりです。

batches
dataSets
dataSetFiles

{CONDITION}

クエリするプロパティ、およびその値の評価方法を示す条件式。以下に例を示します。

property パラメーターの値は、複数の異なる種類の条件付き式をサポートします。次の表に、サポートされる式の基本構文を示します。

シンボル

説明

例

なし

プロパティ名を演算子なしで指定すると、値に関係なく、プロパティが存在するオブジェクトのみが返されます。

property=name

property パラメーターの値に「!」を接頭辞として付けると、プロパティが存在 しない オブジェクトのみが返されます。

property=!name

チルダ（~）記号の後に指定された正規式に一致するプロパティ値（文字列）を持つオブジェクトのみを返します。

property=name~^example

プロパティ値が==記号の後に指定した文字列と完全に一致する重複のみを返します。

property=name==exampleName

! =

プロパティ値が不等号（!=）の後に指定された文字列と一致 しない オブジェクトのみを返します。

property=name!=exampleName

プロパティ値が指定した値未満のオブジェクトのみを返します。

property=version<1.0.0

プロパティ値が指定した値以下のオブジェクトのみを返します。

property=version<=1.0.0

プロパティ値が指定した値より大きい（ただし、等しくない）オブジェクトのみを返します。

property=version>1.0.0

プロパティ値が指定した値以上のオブジェクトのみを返します。

property=version>=1.0.0

ワイルドカードは任意の文字列プロパティに適用され、任意の文字列のシーケンスに一致します。リテラルのアスタリスクをエスケープするには、** を使用します。

property=name==te*st

複数の property パラメーターを、それらの間の AND の関係で組み合わせます。

property=id==abc&property=name!=test

NOTE

name プロパティでは、検索文字列全体または検索文字列の一部として、ワイルドカード * の使用がサポートされています。ワイルドカードは空の文字に一致するので、検索文字列 te*st は「test」に一致します。アスタリスクは繰り返す（**）ことでエスケープされます。検索文字列内のダブルアスタリスクは、リテラル文字列として 1 つのアスタリスクを表します。

リクエスト

次のリクエストは、1.0.3 より大きいバージョン番号を持つデータセットを返します。

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?property=version>1.0.3 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

正常な応答は、バージョン番号が 1.0.3 よりも大きいデータセットのリストを含みます。制限が指定されていない限り、応答には最大 20 個のオブジェクトが含まれます。

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.1.2",
            "imsOrg": "{ORG_ID}",
            "name": "sampleDataset",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.6",
            "imsOrg": "{ORG_ID}",
            "name": "exampleDataset",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5cd3a129ec106214b722a939": {
            "version": "1.0.4",
            "imsOrg": "{ORG_ID}",
            "name": "anotherDataset",
            "created": 1554028394852,
            "updated": 1554130582960,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

プロパティパラメーターを使用した配列のフィルタリング filter-arrays

配列プロパティに基づいて結果をフィルタリングする際に、等値演算子と不等値演算子を使用して、特定の値を含めたり除外したりします。

同等フィルター equality-filters

配列フィールドを複数の値でフィルタリングするには、値ごとに個別のプロパティパラメーターを使用します。等値フィルターを使用して、指定した値に一致する配列データ内のエントリのみを返します。

NOTE

複数のフィールドをフィルタリングする場合に id または created を含める要件は 配列フィールド内の複数の値をフィルタリングする場合には適用 されません）。

次のクエリ例では、val1 と val2 の両方を含む配列から結果のみを返します。

API 形式

GET /{OBJECT_TYPE}?property=arrayField=val1&property=arrayField=val2

不平等フィルター inequality-filters

配列フィールドに不等号演算子（!=）を使用して、配列に指定された値が含まれるデータ内のエントリを除外します。

API 形式

GET /{OBJECT_TYPE}?property=arrayField!=val1&property=arrayField!=val2

このクエリは、arrayField に val1 または val2 が含まれていないドキュメントを返します。

平等および不平等フィルターの制限 equality-inequality-limitations

1 つのクエリで同じフィールドに等しい（=）と等しくない（!=）の両方を適用することはできません。

recommendation-more-help

c5c02be6-79a3-4a2f-b766-136bffe8b676

クエリパラメーターを使用した Catalog データのフィルタリング

返されるオブジェクトの制限 limit-returned-objects

表示するプロパティの制限 limit-displayed-properties

応答リストのオフセット開始インデックス offset-starting-index

タグによるフィルター

日付範囲によるフィルター

プロパティによる並べ替え

プロパティによるフィルター

単純なフィルターの使用 using-simple-filters

property パラメーターの使用 using-the-property-parameter

プロパティパラメーターを使用した配列のフィルタリング filter-arrays

同等フィルター equality-filters

不平等フィルター inequality-filters

平等および不平等フィルターの制限 equality-inequality-limitations

`property` パラメーターの使用 using-the-property-parameter