DokumentationExperience PlatformAnleitung zu Katalog und Datensätzen

Suchen nach mehreren Katalogobjekten

Last update: Wed Dec 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Wenn Sie mehrere spezifische Objekte anzeigen möchten, anstatt eine Anfrage pro Objekt zu stellen, Catalog bietet eine einfache Verknüpfung zum Anfordern mehrerer Objekte desselben Typs. Sie können eine GET-Anfrage verwenden, um mehrere bestimmte Objekte zurückzugeben, indem Sie eine durch Komma getrennte Liste von IDs einschließen.

NOTE
Auch wenn bestimmte Catalog -Objekte, empfiehlt es sich weiterhin, properties -Abfrageparameter, um nur die benötigten Eigenschaften zurückzugeben.

API-Format

GET /{OBJECT_TYPE}/{ID_1},{ID_2},{ID_3},{ID_4}
GET /{OBJECT_TYPE}/{ID_1},{ID_2},{ID_3},{ID_4}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
Parameter
Beschreibung
{OBJECT_TYPE}

Der Typ von Catalog -Objekt abgerufen werden. Gültige Objekte sind:

  • batches
  • dataSets
  • dataSetFiles
{ID}
Eine Kennung für eines der spezifischen Objekte, die Sie abrufen möchten.

Anfrage

Die folgende Anfrage enthält eine durch Kommas getrennte Liste von Datensatz-IDs sowie eine durch Kommas getrennte Liste von Eigenschaften, die für jeden Datensatz zurückgegeben werden sollen.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets/5bde21511dd27b0000d24e95,5bda3a4228babc0000126377,5bceaa4c26c115000039b24b,5bb276b03a14440000971552,5ba9452f7de80400007fc52a?properties=name,description,files' \
  -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}'

Antwort

Eine erfolgreiche Antwort gibt eine Liste der angegebenen Datensätze zurück, die nur die angeforderten Eigenschaften (name, description und files) enthält.

NOTE
Wenn ein zurückgegebenes Objekt nicht eine oder mehrere der angeforderten Eigenschaften enthält, die durch die Variable properties -Abfrage, gibt die Antwort nur die angeforderten Eigenschaften zurück, die sie enthält, wie in Sample Dataset 3 und Sample Dataset 4 unten.
{
    "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"
    },
    "5bda3a4228babc0000126377": {
        "name": "Sample Dataset 4",
        "files": "@/dataSetFiles?dataSetId=5bda3a4228babc0000126377"
    },
    "5bde21511dd27b0000d24e95": {
        "name": "Sample Dataset 5",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5bde21511dd27b0000d24e95"
    }
}
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676