Show Menu
TEMAS×

Query Service guía para desarrolladores

Esta guía para desarrolladores proporciona pasos para realizar varias operaciones en la API de Adobe Experience Platform Query Service .

Primeros pasos

Esta guía requiere un conocimiento práctico de los distintos servicios de Adobe Experience Platform que se utilizan Query Service.
  • Servicio de Consulta : Proporciona la capacidad de consulta de conjuntos de datos y capturar las consultas resultantes como nuevos conjuntos de datos en Experience Platform.
  • Sistema de modelo de datos de experiencia (XDM) : El marco normalizado por el cual Experience Platform organiza los datos de experiencia del cliente.
  • Sandboxes : Experience Platform proporciona entornos limitados virtuales que dividen una sola Platform instancia en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.
Las siguientes secciones proporcionan información adicional que deberá conocer para poder utilizar Query Service con éxito la API.

Leer llamadas de API de muestra

Esta guía proporciona ejemplos de llamadas a API para mostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados requeridos y cargas de solicitud con el formato adecuado. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en esta documentación para ver ejemplos de llamadas a API, consulte la sección sobre cómo leer llamadas a API de ejemplo en la guía de solución de problemas Experience Platform .

Recopilar valores para encabezados necesarios

Para realizar llamadas a Experience Platform API, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación se proporcionan los valores para cada uno de los encabezados necesarios en todas las llamadas Platform de API, como se muestra a continuación:
  • Autorización: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
Todos los recursos de Experience Platform están aislados en entornos limitados virtuales específicos. Todas las solicitudes a Platform las API requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:
  • x-sandbox-name: {SANDBOX_NAME}
Para obtener más información sobre cómo trabajar con entornos limitados en Experience Platform, consulte la documentación general de los entornos limitados.

Ejemplos de llamadas a API

Ahora que comprende qué encabezados usar, está listo para empezar a realizar llamadas a la Query Service API. Los siguientes documentos atraviesan las distintas llamadas de API que puede realizar mediante la Query Service API. Cada llamada de ejemplo incluye el formato de API general, una solicitud de ejemplo que muestra los encabezados necesarios y una respuesta de ejemplo.

Pasos siguientes

Ahora que ha aprendido a realizar llamadas mediante la Query Service API, puede crear sus propias consultas no interactivas. Para obtener más información sobre cómo crear consultas, lea la guía de referencia SQL .