Documentatie Experience Platform Handleiding voor Privacy Service

Inhoudseindpunt

Laatst bijgewerkt: 27 januari 2025

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Gebruik het /content eindpunt om toegangsinformatie veilig terug te winnen (de informatie die een privacyonderwerp kan met recht verzoeken om toegang) voor uw klanten. De download-URL in het antwoord op een /jobs/{JOB_ID} GET-aanvraag verwijst naar een Adobe-servicedetail. U kunt vervolgens een GET-aanvraag indienen bij /jobs/:JOB_ID/content om uw klantgegevens in JSON-indeling te retourneren. Deze toegangsmethode voert veelvoudige lagen van authentificatie en toegangsbeheer uit om veiligheid te verbeteren.

Alvorens deze gids te gebruiken, gelieve te verwijzen naar begonnen gidsvoor informatie over de vereiste authentificatiekopballen die in de voorbeeld API hieronder vraag worden voorgesteld.

TIP

Als u momenteel niet baanidentiteitskaart voor de toegangsinformatie kent u vereist, maak een vraag aan het /jobs eindpunt en gebruik extra vraagparameters om de resultaten te filtreren. Een volledige lijst van de beschikbare vraagparameters kan in de gids van het de baaneindpunt van de privacyworden gevonden.

Taakgegevens over privacy ophalen

Als u informatie wilt ophalen over een specifieke taak, zoals de huidige verwerkingsstatus, neemt u de taak jobId op in het pad van een GET-aanvraag naar het /jobs -eindpunt.

API formaat

GET /jobs/{JOB_ID}

Verzoek

Met het volgende verzoek worden de details opgehaald van de taak waarvan jobId is opgegeven in het aanvraagpad.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'

Reactie

Een geslaagde reactie retourneert de details van de opgegeven taak.

NOTE

Privacy-taken moeten de complete -status hebben om de downloadUrl te bevatten.

{
    "jobId":"dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5",
    "requestId":"17129380910360540RX-753",
    "userKey":"1234",
    "action":"access",
    "status":"complete",
    "submittedBy":"jsnow@adobe.com",
    "createdDate":"04/12/2024 04:08 PM GMT",
    "lastModifiedDate":"04/12/2024 04:08 PM GMT",
    "userIds":[{
        "namespace":"ECID",
        "value":"1234",
        "type":"standard",
        "namespaceId":4,
        "isDeletedClientSide":false
        }],
    "productResponses":[{
        "product":"Identity",
        "retryCount":0,
        "processedDate":"04/12/2024 04:08 PM GMT",
        "productStatusResponse":{"status":"submitted"
        }}],
    "downloadUrl":"https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5/content",
    "regulation":"gdpr"
}

Eigenschap

Beschrijving

jobId

Een unieke id voor de privacytaak.

requestId

Een unieke identificatiecode voor het specifieke verzoek dat aan de Privacy Service wordt gedaan.

userKey

userKey is de key -waarde die u hebt opgegeven toen u de privacyaanvraag indiende. De waarde key is uw gelegenheid om een id voor de betrokkene te verstrekken die voor u zinvol is. Het is doorgaans een unieke id die uw systeem heeft gemaakt voor het bijhouden van die gegevens. TIP: U kunt alle actieve privacytaken weergeven en de key met elke taak vergelijken.

action

Het gevraagde type actie. De toegestane waarden zijn access en delete .

status

De huidige status van de privacytaak.

submittedBy

Het e-mailadres van de persoon die de privacytaak heeft ingediend.

createdDate

De datum en tijd waarop de privacytaak is gemaakt.

lastModifiedDate

De datum en tijd waarop de privacytaak voor het laatst is gewijzigd.

userIds

Een array met gebruikers-id's en verwante informatie.

userIds.namespace

De naamruimte die voor de gebruikersnaam wordt gebruikt.

userIds.value

De werkelijke waarde van de gebruikersidentificatie.

userIds.type

Het type id (bijvoorbeeld standard of custom).

userIds.namespaceId

Een id voor de naamruimte die wordt gebruikt om gebruikersidentiteiten te categoriseren en te beheren.

userIds.isDeletedClientSide

Een Booleaanse waarde die aangeeft of de id aan de clientzijde is verwijderd.

productResponses

Een array met reacties van verschillende producten of services met betrekking tot de privacytaak.

productResponses.product

De naam van het product of de dienst die is gebruikt om informatie over de betrokkene te verkrijgen.

productResponses.retryCount

Het aantal keren dat de aanvraag opnieuw is geprobeerd.

productResponses.processedDate

De datum en het tijdstip waarop de reactie van het product is verwerkt.

productResponses.productStatusResponse

Een object dat de status van de reactie van het product bevat.

productResponses.productStatusResponse.status

De status van de respons van het product.

downloadURL

Deze eigenschap verstrekt een eindpunt, dat beschikbaar is om 60 dagen te roepen nadat de baan voltooit. De status van de taak moet complete zijn en action moet access zijn. Anders is dit veld niet aanwezig.

regulation

Het regelgevingskader waaronder de privacyaanvraag wordt verwerkt, zoals gdpr , ccpa , lgpd_bra , pdpa_tha , enzovoort.

De informatie van de klantentoegang terugwinnen

Om de "toegangsinformatie"te krijgen die in antwoord op de vraag van uw gegevenssubject wordt geproduceerd, doe een verzoek van de GET aan het /jobs/{JOB_ID}/content eindpunt. De reactie is een ZIP-bestand (*.zip) dat een map bevat met submappen voor elk product dat gegevens over de betrokkene bevat.

TIP

U hebt een specifieke taak-id nodig om deze aanvraag in te dienen. Als u de specifieke baan ID moet terugwinnen, doe eerst een verzoek van de GET aan het /jobs eindpunt en gebruik extra vraagparameters om de resultaten te filtreren. De gedetailleerde informatie met inbegrip van de toegestane vraagparameters kan in de gids van het de baaneindpunt van de privacyworden gevonden.

API formaat

GET /jobs/{JOB_ID}/content

Verzoek

Het volgende verzoek retourneert 'toegangsinformatie' voor de taak-id die in het verzoek wordt opgegeven.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/32d429b1-f7f4-11ee-a365-574bcf5a525d/content \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Accept: application/json`

Reactie

De reactie is een ZIP-bestand (*.zip). De informatie wordt doorgaans geretourneerd in JSON-indeling, maar dat kan niet worden gegarandeerd. Geëxtraheerde gegevens kunnen in elke indeling worden geretourneerd.

recommendation-more-help