Show Menu
TÓPICOS×

Tarefas de privacidade

Este documento aborda como trabalhar com trabalhos de privacidade usando chamadas de API. Especificamente, ela abrange o uso do /job endpoint na Privacy Service API. Antes de ler este guia, consulte a seção Introdução Introdução para obter informações importantes que você precisa saber para fazer chamadas à API com êxito, incluindo cabeçalhos necessários e como ler chamadas de exemplo de API.

Lista de todos os trabalhos

Você pode visualização uma lista de todos os trabalhos de privacidade disponíveis na sua organização, fazendo uma solicitação GET ao /jobs endpoint.
Formato da API
Esse formato de solicitação usa um parâmetro de regulation query no /jobs endpoint, portanto, começa com um ponto de interrogação ( ? ), conforme mostrado abaixo. A resposta é paginada, permitindo que você use outros parâmetros de query ( page e size ) para filtrar a resposta. É possível separar vários parâmetros usando os E-mails ( & ).
GET /jobs?regulation={REGULATION}
GET /jobs?regulation={REGULATION}&page={PAGE}
GET /jobs?regulation={REGULATION}&size={SIZE}
GET /jobs?regulation={REGULATION}&page={PAGE}&size={SIZE}

Parâmetro
Descrição
{REGULATION}
O tipo de regulamento a ser query. Os valores aceitos são gdpr , ccpa e pdpa_tha .
{PAGE}
A página de dados a ser exibida, usando a numeração com base em 0. O padrão é 0 .
{SIZE}
O número de resultados a serem exibidos em cada página. O padrão é 1 e o máximo é 100 . Exceder o máximo faz com que a API retorne um erro de código 400.
Solicitação
A solicitação a seguir recupera uma lista paginada de todos os trabalhos em uma Organização IMS, começando na terceira página com um tamanho de página de 50.
curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs?regulation=gdpr&page=2&size=50 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}'

Resposta
Uma resposta bem-sucedida retorna uma lista de jobs, com cada job contendo detalhes como seus jobId . Neste exemplo, a resposta conteria uma lista de 50 trabalhos, começando na terceira página de resultados.

Acessar páginas subsequentes

Para obter o próximo conjunto de resultados em uma resposta paginada, você deve fazer outra chamada de API para o mesmo terminal enquanto aumenta o parâmetro do page query em 1.

Criar um trabalho de privacidade

Antes de criar uma nova solicitação de cargo, é necessário coletar primeiro informações de identificação sobre as pessoas cujos dados você deseja acessar, excluir ou opt out de venda. Depois que você tiver os dados necessários, eles deverão ser fornecidos na carga de uma solicitação POST para o /jobs ponto de extremidade.
Os aplicativos compatíveis da Adobe Experience Cloud usam valores diferentes para identificar os indivíduos de dados. Consulte o guia nos aplicativos de Privacy Service e Experience Cloud para obter mais informações sobre os identificadores necessários para seus aplicativos. Para obter orientações mais gerais sobre como determinar para quais IDs enviar, consulte o documento sobre dados de Privacy Serviceidentidade em solicitações Dados de identidade para solicitações de privacidade de privacidade.
A Privacy Service API suporta dois tipos de solicitações de trabalho para dados pessoais:
Embora as solicitações de acesso e exclusão possam ser combinadas como uma única chamada de API, as solicitações de cancelamento devem ser feitas separadamente.

Criar um trabalho de acesso/exclusão

Esta seção demonstra como fazer uma solicitação de trabalho de acesso/exclusão usando a API.
Formato da API
POST /jobs

Solicitação
A solicitação a seguir cria uma nova solicitação de cargo, configurada pelos atributos fornecidos na carga, conforme descrito abaixo.
curl -X POST \
  https://platform.adobe.io/data/core/privacy/jobs \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -d '{
    "companyContexts": [
      {
        "namespace": "imsOrgID",
        "value": "{IMS_ORG}"
      }
    ],
    "users": [
      {
        "key": "DavidSmith",
        "action": ["access"],
        "userIDs": [
          {
            "namespace": "email",
            "value": "dsmith@acme.com",
            "type": "standard"
          },
          {
            "namespace": "ECID",
            "type": "standard",
            "value":  "443636576799758681021090721276",
            "isDeletedClientSide": false
          }
        ]
      },
      {
        "key": "user12345",
        "action": ["access","delete"],
        "userIDs": [
          {
            "namespace": "email",
            "value": "ajones@acme.com",
            "type": "standard"
          },
          {
            "namespace": "loyaltyAccount",
            "value": "12AD45FE30R29",
            "type": "integrationCode"
          }
        ]
      }
    ],
    "include": ["Analytics", "AudienceManager"],
    "expandIds": false,
    "priority": "normal",
    "analyticsDeleteMethod": "anonymize",
    "regulation": "ccpa"
}'

Propriedade
Descrição
companyContexts (Obrigatório)
Uma matriz que contém informações de autenticação para sua organização. Cada identificador listado inclui os seguintes atributos:
  • namespace : A namespace de um identificador.
  • value : O valor do identificador.
É necessário que um dos identificadores use imsOrgId como seu namespace , com value a ID exclusiva para sua Organização IMS.
Identificadores adicionais podem ser qualificadores de empresa específicos do produto (por exemplo, Campaign ), que identificam uma integração com um aplicativo da Adobe pertencente à sua organização. Os valores potenciais incluem nomes de conta, códigos de cliente, IDs de locatário ou outros identificadores de aplicativo.
users (Obrigatório)
Uma matriz que contém uma coleção de pelo menos um usuário cujas informações você gostaria de acessar ou excluir. É possível fornecer no máximo 1000 IDs de usuário em uma única solicitação. Cada objeto de usuário contém as seguintes informações:
  • key : Um identificador para um usuário que é usado para qualificar as IDs de trabalho separadas nos dados de resposta. É prática recomendada escolher uma string exclusiva e facilmente identificável para esse valor, para que possa ser facilmente referenciada ou pesquisada posteriormente.
  • action : Uma matriz que lista as ações desejadas para os dados do usuário. Dependendo das ações que você deseja realizar, essa matriz deve incluir access , delete ou ambos.
  • userIDs : Uma coleção de identidades para o usuário. O número de identidades que um único usuário pode ter está limitado a nove. Cada identidade consiste em um qualificador namespace , um value e um qualificador de namespace ( type ). Consulte o apêndice para obter mais detalhes sobre essas propriedades necessárias.
Para obter uma explicação mais detalhada sobre users e userIDs , consulte o guia de solução de problemas.
include (Obrigatório)
Uma matriz de produtos da Adobe a serem incluídos no seu processamento. Se esse valor estiver ausente ou vazio, a solicitação será rejeitada. Inclua somente os produtos com os quais sua organização tem uma integração. Para mais informações, consulte a seção sobre valores de produtos aceites no apêndice.
expandIDs
Uma propriedade opcional que, quando definida como true , representa uma otimização para o processamento das IDs nos aplicativos (atualmente apenas compatível com Analytics). If omitted, this value defaults to false .
priority
Uma propriedade opcional usada pelo Adobe Analytics que define a prioridade para o processamento de solicitações. Os valores aceitos são normal e low . Se priority for omitido, o comportamento padrão será normal .
analyticsDeleteMethod
Uma propriedade opcional que especifica como o Adobe Analytics deve lidar com os dados pessoais. Dois valores possíveis são aceitos para este atributo:
  • anonymize : Todos os dados referenciados pela coleção específica de IDs de usuário são tornados anônimos. Se analyticsDeleteMethod for omitido, esse é o comportamento padrão.
  • purge : Todos os dados são completamente removidos.
regulation (Obrigatório)
O regulamento do pedido. Deve ser um dos três valores a seguir:
  • gdpr
  • ccpa
  • pdpa_tha
Resposta
Uma resposta bem-sucedida retorna os detalhes dos trabalhos recém-criados.
{
    "jobs": [
        {
            "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076b0842b6",
            "customer": {
                "user": {
                    "key": "DavidSmith",
                    "action": [
                        "access"
                    ]
                }
            }
        },
        {
            "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076be029f3",
            "customer": {
                "user": {
                    "key": "user12345",
                    "action": [
                        "access"
                    ]
                }
            }
        },
        {
            "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076bd023j1",
            "customer": {
                "user": {
                    "key": "user12345",
                    "action": [
                        "delete"
                    ]
                }
            }
        }
    ],
    "requestStatus": 1,
    "totalRecords": 3
}

Propriedade
Descrição
jobId
Uma ID gerada pelo sistema exclusiva e somente leitura para um trabalho. Esse valor é usado na próxima etapa da pesquisa de um trabalho específico.
Depois de submeter a solicitação de emprego com êxito, você pode prosseguir para a próxima etapa de verificação do status da tarefa.

Criar um trabalho de não participação na venda

Esta seção demonstra como fazer uma solicitação de trabalho de não participação usando a API.
Formato da API
POST /jobs

Solicitação
A solicitação a seguir cria uma nova solicitação de cargo, configurada pelos atributos fornecidos na carga, conforme descrito abaixo.
curl -X POST \
  https://platform.adobe.io/data/privacy/gdpr/ \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -d '{
    "companyContexts": [
      {
        "namespace": "imsOrgID",
        "value": "{IMS_ORG}"
      }
    ],
    "users": [
      {
        "key": "DavidSmith",
        "action": ["opt-out-of-sale"],
        "userIDs": [
          {
            "namespace": "email",
            "value": "dsmith@acme.com",
            "type": "standard"
          },
          {
            "namespace": "ECID",
            "type": "standard",
            "value":  "443636576799758681021090721276",
            "isDeletedClientSide": false
          }
        ]
      },
      {
        "key": "user12345",
        "action": ["opt-out-of-sale"],
        "userIDs": [
          {
            "namespace": "email",
            "value": "ajones@acme.com",
            "type": "standard"
          },
          {
            "namespace": "loyaltyAccount",
            "value": "12AD45FE30R29",
            "type": "integrationCode"
          }
        ]
      }
    ],
    "include": ["Analytics", "AudienceManager"],
    "expandIds": false,
    "priority": "normal",
    "analyticsDeleteMethod": "anonymize",
    "regulation": "ccpa"
}'

Propriedade
Descrição
companyContexts (Obrigatório)
Uma matriz que contém informações de autenticação para sua organização. Cada identificador listado inclui os seguintes atributos:
  • namespace : A namespace de um identificador.
  • value : O valor do identificador.
É necessário que um dos identificadores use imsOrgId como seu namespace , com value a ID exclusiva para sua Organização IMS.
Identificadores adicionais podem ser qualificadores de empresa específicos do produto (por exemplo, Campaign ), que identificam uma integração com um aplicativo da Adobe pertencente à sua organização. Os valores potenciais incluem nomes de conta, códigos de cliente, IDs de locatário ou outros identificadores de aplicativo.
users (Obrigatório)
Uma matriz que contém uma coleção de pelo menos um usuário cujas informações você gostaria de acessar ou excluir. É possível fornecer no máximo 1000 IDs de usuário em uma única solicitação. Cada objeto de usuário contém as seguintes informações:
  • key : Um identificador para um usuário que é usado para qualificar as IDs de trabalho separadas nos dados de resposta. É prática recomendada escolher uma string exclusiva e facilmente identificável para esse valor, para que possa ser facilmente referenciada ou pesquisada posteriormente.
  • action : Um storage que lista as ações desejadas para executar os dados. Para solicitações de não participação na venda, a matriz deve conter apenas o valor opt-out-of-sale .
  • userIDs : Uma coleção de identidades para o usuário. O número de identidades que um único usuário pode ter está limitado a nove. Cada identidade consiste em um qualificador namespace , um value e um qualificador de namespace ( type ). Consulte o apêndice para obter mais detalhes sobre essas propriedades necessárias.
Para obter uma explicação mais detalhada sobre users e userIDs , consulte o guia de solução de problemas.
include (Obrigatório)
Uma matriz de produtos da Adobe a serem incluídos no seu processamento. Se esse valor estiver ausente ou vazio, a solicitação será rejeitada. Inclua somente os produtos com os quais sua organização tem uma integração. Para mais informações, consulte a seção sobre valores de produtos aceites no apêndice.
expandIDs
Uma propriedade opcional que, quando definida como true , representa uma otimização para o processamento das IDs nos aplicativos (atualmente apenas compatível com Analytics). If omitted, this value defaults to false .
priority
Uma propriedade opcional usada pelo Adobe Analytics que define a prioridade para o processamento de solicitações. Os valores aceitos são normal e low . Se priority for omitido, o comportamento padrão será normal .
analyticsDeleteMethod
Uma propriedade opcional que especifica como o Adobe Analytics deve lidar com os dados pessoais. Dois valores possíveis são aceitos para este atributo:
  • anonymize : Todos os dados referenciados pela coleção específica de IDs de usuário são tornados anônimos. Se analyticsDeleteMethod for omitido, esse é o comportamento padrão.
  • purge : Todos os dados são completamente removidos.
regulation (Obrigatório)
O regulamento do pedido. Deve ser um dos três valores a seguir:
  • gdpr
  • ccpa
  • pdpa_tha
Resposta
Uma resposta bem-sucedida retorna os detalhes dos trabalhos recém-criados.
{
    "jobs": [
        {
            "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076bd9vjs0",
            "customer": {
                "user": {
                    "key": "DavidSmith",
                    "action": [
                        "opt-out-of-sale"
                    ]
                }
            }
        },
        {
            "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076bes0ewj2",
            "customer": {
                "user": {
                    "key": "user12345",
                    "action": [
                        "opt-out-of-sale"
                    ]
                }
            }
        }
    ],
    "requestStatus": 1,
    "totalRecords": 2
}

Propriedade
Descrição
jobId
Uma ID gerada pelo sistema exclusiva e somente leitura para um trabalho. Esse valor é usado para procurar um trabalho específico na próxima etapa.
Depois de submeter a solicitação de emprego com êxito, você pode prosseguir para a próxima etapa de verificação do status da tarefa.

Verificar o status de uma tarefa

Você pode recuperar informações sobre um trabalho específico, como seu status de processamento atual, incluindo esse trabalho no caminho de uma solicitação GET jobId para o /jobs terminal.
Os dados para trabalhos criados anteriormente só estão disponíveis para recuperação dentro de 30 dias da data de conclusão do trabalho.
Formato da API
GET /jobs/{JOB_ID}

Parâmetro
Descrição
{JOB_ID}
A ID do trabalho que você deseja pesquisar. Essa ID é retornada jobId em respostas de API bem-sucedidas para criar um trabalho e listar todos os trabalhos .
Solicitação
A solicitação a seguir recupera os detalhes da tarefa jobId fornecida no caminho da solicitação.
curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/6fc09b53-c24f-4a6c-9ca2-c6076b0842b6 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}'

Resposta
Uma resposta bem-sucedida retorna os detalhes da tarefa especificada.
{
    "jobId": "6fc09b53-c24f-4a6c-9ca2-c6076b0842b6",
    "requestId": "15700479082313109RX-899",
    "userKey": "David Smith",
    "action": "access",
    "status": "complete",
    "submittedBy": "{ACCOUNT_ID}",
    "createdDate": "10/02/2019 08:25 PM GMT",
    "lastModifiedDate": "10/02/2019 08:25 PM GMT",
    "userIds": [
        {
            "namespace": "email",
            "value": "dsmith@acme.com",
            "type": "standard",
            "namespaceId": 6,
            "isDeletedClientSide": false
        },
        {
            "namespace": "ECID",
            "value": "1123A4D5690B32A",
            "type": "standard",
            "namespaceId": 4,
            "isDeletedClientSide": false
        }
    ],
    "productResponses": [
        {
            "product": "Analytics",
            "retryCount": 0,
            "processedDate": "10/02/2019 08:25 PM GMT",
            "productStatusResponse": {
                "status": "complete",
                "message": "Success",
                "responseMsgCode": "PRVCY-6000-200",
                "responseMsgDetail": "Finished successfully."
            }
        },
        {
            "product": "Profile",
            "retryCount": 0,
            "processedDate": "10/02/2019 08:25 PM GMT",
            "productStatusResponse": {
                "status": "complete",
                "message": "Success",
                "responseMsgCode": "PRVCY-6000-200",
                "responseMsgDetail": "Success dataSetIds = [5dbb87aad37beb18a96feb61], Failed dataSetIds = []"
            }
        },
        {
            "product": "AudienceManager",
            "retryCount": 0,
            "processedDate": "10/02/2019 08:25 PM GMT",
            "productStatusResponse": {
                "status": "complete",
                "message": "Success",
                "responseMsgCode": "PRVCY-6054-200",
                "responseMsgDetail": "PARTIALLY COMPLETED- Data not found for some requests, check results for more info.",
                "results": {
                  "processed": ["1123A4D5690B32A"],
                  "ignored": ["dsmith@acme.com"]
                }
            }
        }
    ],
    "downloadURL": "http://...",
    "regulation": "ccpa"
}

Propriedade
Descrição
productStatusResponse
Cada objeto dentro da productResponses matriz contém informações sobre o status atual da tarefa em relação a um Experience Cloud aplicativo específico.
productStatusResponse.status
A categoria de status atual do trabalho. Consulte a tabela abaixo para obter uma lista de categorias de status disponíveis e seus significados correspondentes.
productStatusResponse.message
O status específico da tarefa, correspondente à categoria de status.
productStatusResponse.responseMsgCode
Um código padrão para mensagens de resposta do produto recebidas por Privacy Service. Os detalhes da mensagem são fornecidos em responseMsgDetail .
productStatusResponse.responseMsgDetail
Uma explicação mais detalhada do status do trabalho. As mensagens para status semelhantes podem variar entre os produtos.
productStatusResponse.results
Para determinados status, alguns produtos podem retornar um results objeto que fornece informações adicionais não cobertas por responseMsgDetail .
downloadURL
Se o status do trabalho for complete , este atributo fornecerá um URL para baixar os resultados do trabalho como um arquivo ZIP. Este arquivo está disponível para download por 60 dias após a conclusão do trabalho.

categorias de status do trabalho

A tabela a seguir lista as diferentes categorias de status possíveis da tarefa e seu significado correspondente:
categoria de status
Significado
Concluído
O trabalho está concluído e (se necessário) os arquivos são carregados de cada aplicativo.
Processamento
Os aplicativos reconheceram o trabalho e estão sendo processados no momento.
Enviada
O trabalho é submetido a cada solicitação aplicável.
Erro
Ocorreu uma falha no processamento da tarefa - informações mais específicas podem ser obtidas através da recuperação de detalhes da tarefa individual.
Um trabalho enviado pode permanecer em um estado de processamento se ele tiver um trabalho filho dependente que ainda esteja em processamento.

Próximas etapas

Agora você sabe como criar e monitorar trabalhos de privacidade usando a Privacy Service API. Para obter informações sobre como executar as mesmas tarefas usando a interface do usuário, consulte a visão geral da interface do usuário do Privacy Service.