Elencare mappature identità
Una mappatura è una raccolta di tutte le identità in un cluster, per uno spazio dei nomi specificato.
Ottenere una mappatura identità per una singola identità
Considerata un’identità, recupera tutte le identità correlate dallo stesso spazio dei nomi rappresentato dall’identità nella richiesta.
Formato API
GET https://platform-{REGION}.adobe.io/data/core/identity/mapping
Richiesta
Opzione 1: specificare l'identità come spazio dei nomi (nsId
, per ID) e il valore ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?nsId=411&id=WTCpVgAAAFq14FMF' \
-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}'
Opzione 2: specificare l'identità come spazio dei nomi (ns
, per nome) e il valore ID (id
).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?ns=AMO&id=WTCpVgAAAFq14FMF' \
-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}'
Opzione 3: specificare l'identità come XID (xid
). Per ulteriori informazioni su come ottenere l’XID di un’identità, consulta la sezione di questo documento relativa a recupero dello XID per un’identità.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?xid=CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8' \
-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}'
Ottenere mappature di identità per più identità
Utilizza il POST
metodo come equivalente batch del GET
per recuperare mappature per più identità.
Formato API
POST https://platform.adobe.io/data/core/identity/mappings
Corpo della richiesta
Opzione 1: fornire un elenco di XID per i quali recuperare le mappature.
{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}
Opzione 2: fornisci un elenco di identità come ID compositi, in cui ciascuna di esse nomina il valore ID e lo spazio dei nomi in base all’ID dello spazio dei nomi. In questo esempio viene illustrato l'utilizzo di questo metodo durante la sovrascrittura del valore predefinito graph-type
di "Private Graph".
{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"graph-type": "None"
}
Richiesta
Utilizzo di XID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"xids": ["GesCQXX0CAESEE8wHpswUoLXXmrYy8KBTVgA"],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Utilizzo degli UID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Se non sono state trovate identità correlate con l’input fornito, viene HTTP 204
il codice di risposta viene restituito senza contenuto.
Risposta
{
"version": 1,
"mappings": [{
"xid": "CAESEPl1uYyma1kMDWxx7dhbwGo",
"mapping": [{
"xid": "81218968060697815473313992060878182012",
"lastAssociationTime": "1493310475047"
}],
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"mapping": [{
"compositeXid": {
"nsid": 411,
"id": "WY-RNchvdsTSJS"
},
"lastAssociationTime": "1493310475047"
}],
"regions": [{
"regionId": "10",
"lastAssociationTime": "1493310475047"
}]
}],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
lastAssociationTime
: marca temporale dell’ultima associazione dell’identità di input a questa identità.regions
: fornisceregionId
elastAssociationTime
per il punto in cui è stata visualizzata l’identità.
Passaggi successivi
Procedi all’esercitazione successiva per elenca gli spazi dei nomi disponibili.