Show Menu
ARGOMENTI×

Elenca 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à

Data un'identità, recuperate tutte le identità correlate dallo stesso spazio nomi rappresentato dall'identità nella richiesta.
Formato API
GET https://platform-{REGION}.adobe.io/data/core/identity/mapping

Richiesta
Opzione 1: Specificate l'identità come spazio dei nomi ( nsId , per ID) e come 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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Opzione 2: Specificate l'identità come spazio dei nomi ( ns , per nome) e come 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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Opzione 3: Specificate l'identità come XID ( xid ). Per ulteriori informazioni su come ottenere l'XID di un'identità, consulta la sezione di questo documento relativa al recupero dell'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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Ottenere le mappature di identità per più identità

Utilizzate il POST metodo come equivalente batch del GET metodo descritto sopra per recuperare mappature per più identità.
La richiesta non deve contenere più di 1000 identità. Le richieste che superano 1000 identità genereranno un codice di stato di 400.
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: Fornite un elenco di identità come ID compositi, in cui ogni nome indica il valore ID e lo spazio nomi per ID namespace. Questo esempio illustra come utilizzare questo metodo per sovrascrivere il valore predefinito graph-type di "Grafico privato".
{
    "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 di 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 viene trovata alcuna identità correlata con l'input fornito, viene restituito un codice di HTTP 204 risposta 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 : Il timestamp dell'ultima associazione dell'identità di input a questa identità.
  • regions : Fornisce il regionId e lastAssociationTime la posizione in cui è stata visualizzata l'identità.

Passaggi successivi

Passate all'esercitazione successiva per elencare gli spazi dei nomi disponibili.