Introducción a la Policy Service API
El Policy Service La API de le permite crear y administrar varios recursos relacionados con la gobernanza de datos de Adobe Experience Platform. Este documento proporciona una introducción a los conceptos principales que necesita conocer antes de intentar realizar llamadas a Policy Service API.
Requisitos previos
El uso de la guía para desarrolladores requiere una comprensión práctica de los distintos Experience Platform servicios implicados en el trabajo con capacidades de control de datos. Antes de comenzar a trabajar con Policy Service API, consulte la documentación de los siguientes servicios:
- Gobernanza de datos: el marco mediante el cual Experience Platform aplica el cumplimiento de uso de datos.
- Experience Data Model (XDM) System: El marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Real-Time Customer Profile: Proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
- Zonas protegidas: Experience Platform proporciona zonas protegidas virtuales que dividen una sola Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Lectura de llamadas de API de muestra
El Policy Service La documentación de la API proporciona ejemplos de llamadas a la API para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.
Encabezados obligatorios
La documentación de la API también requiere que haya completado la tutorial de autenticación para realizar llamadas correctamente a Platform puntos finales. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en Experience Platform Llamadas de API, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Todos los recursos de Experience Platform, incluidas las que pertenecen a la gobernanza de datos, están aisladas para zonas protegidas virtuales específicas. Todas las solicitudes a Platform Las API requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación:
x-sandbox-name: {SANDBOX_NAME}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:
Content-Type: application/json
Recursos principales y personalizados
Dentro de Policy Service API, todas las políticas y acciones de marketing se denominan core
o custom
recursos.
core
los recursos son los definidos y mantenidos por el Adobe, mientras que custom
los recursos son los que crea y mantiene su organización y, por lo tanto, son únicos y visibles únicamente para su organización. Como tal, las operaciones de listado y búsqueda (GET
) son las únicas operaciones permitidas en core
recursos, mientras que las operaciones de listado, búsqueda y actualización (POST
, PUT
, PATCH
, y DELETE
) están disponibles para custom
recursos.
Pasos siguientes
Para empezar a realizar llamadas mediante la API del servicio de directivas, seleccione una de las guías de extremos disponibles.