Partilhar via


Obter dados de conhecimentos aprofundados utilizando a ação msdyn_RetrieveKPIValuesForGDPR

O Regulamento Geral sobre a Proteção de Dados (RGPD) da União Europeia (UE) concede direitos importantes às pessoas singulares relativamente aos respetivos dados. Consulte o Resumo do Regulamentos Geral sobre a Proteção de Dados do Microsoft Learn para obter uma descrição geral do RGPD, incluindo terminologia, um plano de ação e listas de verificação de prontidão para o ajudar a cumprir as suas obrigações com o RGPD quando utiliza produtos e serviços da Microsoft.

Pode obter mais informações sobre o RGPD e a forma como a Microsoft o ajuda a suportá-lo e aos nossos clientes que são afetados por ele.

  • O Centro de Confiança da Microsoft fornece informações gerais, melhores práticas de conformidade e documentação útil para a responsabilidade do RGPD, tais como Avaliações do Impacto da Proteção de Dados, Pedidos de Titulares de Dados e notificação de falha de segurança de dados.
  • O Portal de Confiança do Serviço fornece informações sobre como os serviços da Microsoft ajudam a suportar a conformidade com o RGPD.

Utilize a ação msdyn_RetrieveKPIValuesForGDPR para obter perfis, interações e KPIs de forma programática, armazenados no serviço do Azure utilizado para calcular e armazenar dados, para um contacto, oportunidade potencial, oportunidade ou systemuser. Esta ação é útil para responder a pedidos de dados para satisfazer as suas obrigações de conformidade com os dados de privacidade no Dynamics 365 Sales Insights.

Nota

Parâmetro da ação

A ação msdyn_RetrieveKPIValuesForGDPR espera os seguintes parâmetros de entrada:

Nome Tipo Descrição
CRMRecord mscrm.crmbaseentity Tipo de entidade para a qual pretende recolher os dados. Obrigatório.

Pode especificar um dos seguintes valores:

  • Microsoft.Dynamics.CRM.contact
  • Microsoft.Dynamics.CRM.lead
  • Microsoft.Dynamics.CRM.opportunity
  • Microsoft.Dynamics.CRM.systemuser

Consoante o tipo de entidade, tem de especificar contactid, leadid, opportunityid ou systemuserid como segunda chave para identificar o registo de entidade para o qual pretende obter dados. Consulte Exemplo mais para a frente neste tópico.

Tipo de devolução de ação

A ação msdyn_RetrieveKPIValuesForGDPR devolve o seguinte valor:

Nome Tipo Descrição
msdyn_RetrieveKPIValuesForGDPRResponse ComplexType Contém a resposta da ação msdyn_RetrieveKPIValuesForGDPR action. Contém a propriedade seguinte que contém os dados estruturados do tipo:
  • Nome:Response
  • Tipo: Edm.String
  • Descrição: Lista de dados como uma matriz JSON com caráter de escape.

Exemplo

Pedir

POST [Organization URI]/api/data/v9.0/msdyn_RetrieveKPIValuesForGDPR HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
  
{
  "CRMRecord": {
    "@odata.type": "Microsoft.Dynamics.CRM.contact",
    "contactid": "bf1b1e9a-6e28-e811-a94e-000d3a365e68"
  }
}  

Response

A resposta contém um objeto JSON com uma propriedade Response que contém a lista de dados armazenados no serviço do Azure é utilizado para calcular e armazenar dados.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
  "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyn_RetrieveKPIValuesForGDPRResponse",
   "Response": {\"EntityId\": \"bf1b1e9a-6e28-e811-a94e-000d3a365e68\",\"Daily UI KPIs\": \"Some Values\",\"Lifetime UI KPIs\": \"Some Values\",\"Most Contacted KPIs\": \"Some Values\",\"Health KPIs\": \"Some Values\"}]"
}

Consulte também

Utilizar as ações Web API

Sales Insights e privacidade