DocumentaciónExperience PlatformGuía de catálogos y conjuntos de datos

Búsqueda de un objeto Catalog

Última actualización: 16 de julio de 2024
  • Temas:
  • Catálogo

Creado para:

  • Desarrollador

Si conoce el identificador único de un objeto Catalog específico, puede realizar una solicitud de GET para ver los detalles de ese objeto.

NOTE
Al ver objetos específicos, se recomienda filtrar por propiedades y devolver solamente las propiedades que le interesen.

Formato de API

GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
ParámetroDescripción
{OBJECT_TYPE}

Tipo de objeto Catalog que se va a recuperar. Los objetos válidos son:

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}El identificador del objeto específico que desea recuperar.

Solicitud

La siguiente solicitud recupera un conjunto de datos por su ID, devolviendo sus propiedades name, description, tags y files.

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

Respuesta

Una respuesta correcta devuelve el conjunto de datos especificado con solo el properties solicitado en el cuerpo.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    }
}
NOTE
Las propiedades cuyos valores tienen el prefijo @ representan objetos interrelacionados. Consulte la sección del apéndice sobre visualización de objetos interrelacionados para ver los pasos sobre cómo ver los detalles de estos objetos.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676