Dokumentation Experience Platform Anleitung zu Katalog und Datensätzen

Suchen nach mehreren Catalog-Objekten

31. Dezember 2024

Themen:
Katalog

Erstellt für:

Entwickler

Wenn Sie mehrere spezifische Objekte anzeigen möchten, anstatt eine Anfrage pro Objekt zu stellen, bietet Catalog 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

Selbst beim Anfordern bestimmter Catalog ist es dennoch Best Practice, properties Abfrageparameter so zu konfigurieren, dass nur die benötigten Eigenschaften zurückgegeben werden.

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

Parameter	Beschreibung
`{OBJECT_TYPE}`	Der Typ Catalog abzurufenden Objekts. Gültige Objekte sind: `batches` `dataSets` `dataSetFiles`
`{ID}`	Eine Kennung für eines der spezifischen Objekte, die Sie abrufen möchten.

{OBJECT_TYPE}

Der Typ Catalog abzurufenden Objekts. 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 keine oder mehrere der angeforderten Eigenschaften enthält, die durch die properties Abfrage angegeben werden, gibt die Antwort nur die angeforderten Eigenschaften zurück, die es enthält, wie in Sample Dataset 3 und Sample Dataset 4 unten dargestellt.

{
    "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