Recherche de plusieurs objets Catalogue

Si vous souhaitez vue plusieurs objets spécifiques, plutôt que d'effectuer une requête par objet, Catalog fournit un raccourci simple pour demander plusieurs objets du même type. Vous pouvez utiliser une requête GET unique pour renvoyer plusieurs objets spécifiques en incluant une liste d’identifiants séparés par des virgules.

REMARQUE

Même lorsque vous demandez des objets Catalog spécifiques, il est recommandé au paramètre de requête properties de renvoyer uniquement les propriétés dont vous avez besoin.

Format d’API

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}
Paramètre Description
{OBJECT_TYPE} Type d'objet Catalog à récupérer. Les objets valides sont :
  • accounts
  • batches
  • connections
  • connectors
  • dataSets
  • dataSetFiles
  • dataSetViews
{ID} Un identifiant de l’un des objets spécifiques que vous souhaitez récupérer.

Requête

La requête suivante inclut une liste d’identifiants de jeux de données séparés par des virgules, ainsi qu’une liste de propriétés séparées par des virgules à renvoyer pour chaque jeu de données.

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Réponse

Une réponse réussie renvoie une liste des jeux de données spécifiés contenant uniquement les propriétés demandées (name, description et files) pour chacun d’eux.

REMARQUE

Si un objet renvoyé ne contient pas un ou plusieurs des propriétés demandées indiquées par la requête properties, la réponse renvoie uniquement les propriétés demandées qu'elle inclut, comme indiqué dans Sample Dataset 3 et Sample Dataset 4 ci-dessous.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset 1",
        "description": "Description of dataset.",
        "files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
    },
    "5bb276b03a14440000971552": {
        "name": "Sample Dataset 2",
        "description": "Description of dataset.",
        "files": "@/dataSets/5bb276b03a14440000971552/views/5bb276b01250b012f9acc75b/files"
    },
    "5bceaa4c26c115000039b24b": {
        "name": "Sample Dataset 3"
    },
    "5bda3a4228babc0000126377": {
        "name": "Sample Dataset 4",
        "files": "@/dataSets/5bda3a4228babc0000126377/views/5bda3a4228babc0000126378/files"
    },
    "5bde21511dd27b0000d24e95": {
        "name": "Sample Dataset 5",
        "description": "Description of dataset.",
        "files": "@/dataSets/5bde21511dd27b0000d24e95/views/5bde21511dd27b0000d24e96/files"
    }
}

Sur cette page