Meccanismo metadati metadata-mechanism

È possibile recuperare i metadati delle risorse utilizzando resourceType in una richiesta GET:

GET /profileAndServices/resourceType/<resourceName>

La risposta restituisce i metadati principali dalla risorsa (tutti gli altri campi sono descrittivi o interni):

  • Il nodo Content restituisce i campi della risorsa. Per ogni campo del nodo content, sono disponibili i campi seguenti:

    • "apiName": nome dell’attributo utilizzato nelle API.

    • "type": definizione di tipo di alto livello (stringa, numero, collegamento, raccolta, enumerazione…).

    • "dataPolicy": il valore del campo deve seguire le regole dei criteri specificate. Ad esempio, se la regola dataPolicy è impostata su "email", il valore deve essere un messaggio e-mail valido. Durante un PATCH o un POST, DataPolicy può controllare il valore o modificarlo per la trasformazione (ad esempio SmartCase).

    • "category": fornisce la categoria del campo nell’editor delle query.

    • "resType": il tipo tecnico.

      Se "type" viene completato con il valore "link" o "collection", il valore resTarget corrisponde al nome della risorsa di destinazione del collegamento.
      Se "type" viene completato con il valore "enumeration", viene aggiunto un campo "values" e ogni valore di enumerazione è descritto nel nodo values.

  • Il nodo Filters restituisce l'URL per recuperare i filtri associati. Per ulteriori informazioni sui filtri, consulta questa sezione.

Richiesta di esempio

Esegui una richiesta di GET per la risorsa.

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/resourceType/profile \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

Restituisce la descrizione completa della risorsa profilo.

{
...
"content": {
  "email": {...},
    ...
    },
"data": "/profileAndServices/profile/",
"filters": {
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/resourceType/<PKEY>"
    },
"help": "Identified profiles",
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile/metadata",
"label": "Profiles",
"mandatory": false,
"name": "profile",
"pkgStatus": "never",
"readOnly": false,
"schema": "nms:recipient",
"type": "item"
}
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff