DocumentazioneExperience PlatformGuida di Platform Identity Service

Elencare mappature identità

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

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 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 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 XID di un'identità, consulta la sezione di questo documento che descrive come ottenere 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à

Utilizzare il metodo POST come equivalente batch del metodo GET descritto in precedenza per recuperare mappature per più identità.

NOTE
La richiesta non deve indicare più di 1000 identità. Le richieste che superano le 1000 identità restituiranno il codice di stato 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: 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 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 sono state trovate identità correlate con l'input fornito, viene restituito un codice di risposta HTTP 204 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 regionId e lastAssociationTime per la posizione in cui è stata visualizzata l'identità.

Passaggi successivi

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

recommendation-more-help
64963e2a-9d60-4eec-9930-af5aa025f5ea