Operaciones de API de extremo de destinos

IMPORTANTE

Punto final de API: platform.adobe.io/data/core/activation/authoring/destinations

Esta página enumera y describe todas las operaciones de API que puede realizar con el extremo de API /authoring/destinations . Para obtener una descripción de la funcionalidad admitida por este extremo, lea configuración de destino.

Introducción a las operaciones de API de destino

Antes de continuar, consulte la guía de introducción para obtener información importante que debe conocer para realizar llamadas correctamente a la API de , incluido cómo obtener el permiso de creación de destino necesario y los encabezados necesarios.

Crear configuración para un destino

Puede crear una nueva configuración de destino realizando una solicitud de POST al extremo /authoring/destinations .

Formato de API

POST /authoring/destinations

Solicitud

La siguiente solicitud crea una nueva configuración de destino, configurada por los parámetros proporcionados en la carga útil. La carga útil siguiente incluye todos los parámetros aceptados por el extremo /authoring/destinations . Tenga en cuenta que no es necesario agregar todos los parámetros en la llamada de y que la plantilla se puede personalizar, según los requisitos de la API.

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "schemaConfig":{
      "profileFields":[
         {
            "name":"a_custom_attribute",
            "title":"a_custom_attribute",
            "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
            "type":"string",
            "isRequired":false,
            "readOnly":false,
            "hidden":false
         }
      ],
      "profileRequired":true,
      "segmentRequired":true,
      "identityRequired":true
   },
   "aggregation":{
      "aggregationType":"BEST_EFFORT",
      "bestEffortAggregation":{
         "maxUsersPerRequest":10,
         "splitUserById":false
      }
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "backfillHistoricalProfileData":true
}
Parámetro Tipo Descripción
name Cadena Indica el título del destino en el catálogo de Experience Platform
description Cadena Proporcione una descripción que el Adobe utilizará en el catálogo de destinos del Experience Platform para su tarjeta de destino. Apunte a no más de 4-5 frases.
status Cadena Indica el estado del ciclo vital de la tarjeta de destino. Los valores aceptados son TEST, PUBLISHED y DELETED. Utilice TEST la primera vez que configure el destino.
customerAuthenticationConfigurations Cadena Indica la configuración utilizada para autenticar a los clientes Experience Platform en el servidor. Consulte authType a continuación para conocer los valores aceptados.
customerAuthenticationConfigurations.authType Cadena Los valores aceptados son OAUTH2, BEARER.
customerDataFields.name Cadena Proporcione un nombre para el campo personalizado que está introduciendo.
customerDataFields.type Cadena Indica qué tipo de campo personalizado está introduciendo. Los valores aceptados son string, object, integer
customerDataFields.title Cadena Indica el nombre del campo, tal como lo ven los clientes en la interfaz de usuario del Experience Platform
customerDataFields.description Cadena Proporcione una descripción para el campo personalizado.
customerDataFields.isRequired Booleano Indica si este campo es necesario en el flujo de trabajo de configuración de destino.
customerDataFields.enum Cadena Representa el campo personalizado como un menú desplegable y enumera las opciones disponibles para el usuario.
customerDataFields.pattern Cadena Aplica un patrón para el campo personalizado, si es necesario. Utilice expresiones regulares para aplicar un patrón. Por ejemplo, si los ID de cliente no incluyen números o guiones bajos, introduzca ^[A-Za-z]+$ en este campo.
uiAttributes.documentationLink Cadena Se refiere a la página de documentación de Destinations Catalog para su destino. Utilice https://www.adobe.com/go/destinations-YOURDESTINATION-en, donde YOURDESTINATION es el nombre de su destino. Para un destino llamado Moviestar, debe utilizar https://www.adobe.com/go/destinations-moviestar-en.
uiAttributes.category Cadena Se refiere a la categoría asignada a su destino en Adobe Experience Platform. Para obtener más información, lea Categorías de destino. Utilice uno de los siguientes valores: adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments.
uiAttributes.connectionType Cadena Server-to-server actualmente es la única opción disponible.
uiAttributes.frequency Cadena Streaming actualmente es la única opción disponible.
identityNamespaces.externalId.acceptsAttributes Booleano Indica si el destino acepta atributos de perfil estándar. Normalmente, estos atributos se resaltan en la documentación de nuestros socios.
identityNamespaces.externalId.acceptsCustomNamespaces Booleano Indica si los clientes pueden configurar áreas de nombres personalizadas en el destino.
identityNamespaces.externalId.allowedAttributesTransformation Cadena No se muestra en la configuración de ejemplo. Se utiliza, por ejemplo, cuando el cliente Platform tiene direcciones de correo electrónico simples como atributo y la plataforma solo acepta correos electrónicos con hash. Aquí es donde proporcionaría la transformación que debe aplicarse (por ejemplo, transformar el correo electrónico a minúsculas y luego a hash).
identityNamespaces.externalId.acceptedGlobalNamespaces - Se utiliza para casos en los que la plataforma acepta áreas de nombres de identidad estándar (por ejemplo, IDFA), por lo que puede restringir a los usuarios de Platform a que solo seleccionen estas áreas de nombres de identidad.
Cuando utilice acceptedGlobalNamespaces, puede utilizar "requiredTransformation":"sha256(lower($))" para escribir en minúsculas y hash las direcciones de correo electrónico o los números de teléfono.
destinationDelivery.authenticationRule Cadena Indica cómo se conectan los clientes Platform con el destino. Los valores aceptados son CUSTOMER_AUTHENTICATION, PLATFORM_AUTHENTICATION, NONE.
  • Utilice CUSTOMER_AUTHENTICATION si los clientes de Platform inician sesión en su sistema mediante un nombre de usuario y contraseña, un token al portador u otro método de autenticación. Por ejemplo, puede seleccionar esta opción si también selecciona authType: OAUTH2 o authType:BEARER en customerAuthenticationConfigurations.
  • Utilice PLATFORM_AUTHENTICATION si existe un sistema de autenticación global entre el Adobe y el destino y el cliente Platform no necesita proporcionar ninguna credencial de autenticación para conectarse al destino. En este caso, debe crear un objeto credentials utilizando la configuración Credentials.
  • Utilice NONE si no se requiere autenticación para enviar datos a la plataforma de destino.
destinationDelivery.destinationServerId Cadena El instanceId de la plantilla de servidor de destino utilizada para este destino.
backfillHistoricalProfileData Booleano Controla si los datos del perfil histórico se exportan cuando los segmentos se activan en el destino.
  • true: Platform envía los perfiles de usuario históricos que cumplen los requisitos para el segmento antes de que se active el segmento.
  • false: Platform solo incluye perfiles de usuario que cumplen los requisitos para el segmento una vez activado el segmento.
segmentMappingConfig.mapUserInput Booleano Controla si el usuario introduce el ID de asignación de segmentos en el flujo de trabajo de activación de destino.
segmentMappingConfig.mapExperiencePlatformSegmentId Booleano Controla si el ID de asignación de segmentos en el flujo de trabajo de activación de destino es el ID de segmento del Experience Platform.
segmentMappingConfig.mapExperiencePlatformSegmentName Booleano Controla si el id. de asignación de segmentos en el flujo de trabajo de activación de destino es el nombre del segmento del Experience Platform.
segmentMappingConfig.audienceTemplateId Booleano El instanceId de la plantilla de metadatos de audiencia utilizada para este destino.
schemaConfig.profileFields Matriz Al agregar profileFields predefinido como se muestra en la configuración anterior, los usuarios tendrán la opción de asignar atributos de Experience Platform a los atributos predefinidos en el lado del destino.
schemaConfig.profileRequired Booleano Utilice true si los usuarios deben poder asignar atributos de perfil de Experience Platform a atributos personalizados en el lado del destino, como se muestra en el ejemplo de configuración anterior.
schemaConfig.segmentRequired Booleano Utilice siempre segmentRequired:true.
schemaConfig.identityRequired Booleano Utilice true si los usuarios deben poder asignar áreas de nombres de identidad del Experience Platform al esquema deseado.
aggregation.aggregationType - Seleccione BEST_EFFORT o CONFIGURABLE_AGGREGATION. La configuración de ejemplo anterior incluye la agregación BEST_EFFORT. Para ver un ejemplo de CONFIGURABLE_AGGREGATION, consulte la configuración de ejemplo en el documento configuración de destino. Los parámetros relevantes para la agregación configurable se documentan a continuación en esta tabla.
aggregation.bestEffortAggregation.maxUsersPerRequest Número entero El Experience Platform puede acumular varios perfiles exportados en una sola llamada HTTP. Especifique el número máximo de perfiles que su extremo debe recibir en una sola llamada HTTP. Tenga en cuenta que esta es una agregación de mejor esfuerzo. Por ejemplo, si especifica el valor 100, Platform podría enviar cualquier número de perfiles menores que 100 en una llamada.
Si el servidor no acepta varios usuarios por solicitud, establezca este valor en 1.
aggregation.bestEffortAggregation.splitUserById Booleano Utilice este indicador si la llamada al destino debe dividirse por identidad. Establezca este indicador como true si el servidor solo acepta una identidad por llamada, para un área de nombres determinada.
aggregation.configurableAggregation.splitUserById Booleano Consulte el parámetro en la configuración de ejemplo aquí. Utilice este indicador si la llamada al destino debe dividirse por identidad. Establezca este indicador como true si el servidor solo acepta una identidad por llamada, para un área de nombres determinada.
aggregation.configurableAggregation.maxBatchAgeInSecs Número entero Valor máximo: 3600. Consulte el parámetro en la configuración de ejemplo aquí. Junto con maxNumEventsInBatch, esto determina cuánto tiempo debe esperar el Experience Platform hasta enviar una llamada de API al extremo.
Por ejemplo, si utiliza el valor máximo para ambos parámetros, el Experience Platform esperará 3600 segundos O hasta que haya 10 000 perfiles cualificados antes de realizar la llamada de API, lo que suceda primero.
aggregation.configurableAggregation.maxNumEventsInBatch Número entero Valor máximo: 1000. Consulte el parámetro en la configuración de ejemplo aquí. Consulte maxBatchAgeInSecs justo arriba.
aggregation.configurableAggregation.aggregationKey Booleano Consulte el parámetro en la configuración de ejemplo aquí. Permite acumular los perfiles exportados asignados al destino según los parámetros siguientes:
  • ID de segmento
  • estado del segmento
  • área de nombres de identidad
aggregation.configurableAggregation.aggregationKey.includeSegmentId Booleano Consulte el parámetro en la configuración de ejemplo aquí. Configúrelo en true si desea agrupar perfiles exportados al destino por ID de segmento.
aggregation.configurableAggregation.aggregationKey.includeSegmentStatus Booleano Consulte el parámetro en la configuración de ejemplo aquí. Debe configurar includeSegmentId:true y includeSegmentStatus:true si desea agrupar los perfiles exportados al destino por ID de segmento Y estado del segmento.
aggregation.configurableAggregation.aggregationKey.includeIdentity Booleano Consulte el parámetro en la configuración de ejemplo aquí. Configúrelo en true si desea agrupar perfiles exportados al destino por área de nombres de identidad.
aggregation.configurableAggregation.aggregationKey.oneIdentityPerGroup Booleano Consulte el parámetro en la configuración de ejemplo aquí. Utilice este parámetro para especificar si desea que los perfiles exportados se agreguen en grupos de una sola identidad (GAID, IDFA, números de teléfono, correo electrónico, etc.).
aggregation.configurableAggregation.aggregationKey.groups Cadena Consulte el parámetro en la configuración de ejemplo aquí. Cree listas de grupos de identidad si desea agrupar perfiles exportados a su destino por grupos de área de nombres de identidad. Por ejemplo, puede combinar perfiles que contengan los identificadores móviles IDFA y GAID en una llamada a su destino y correos electrónicos en otra utilizando la configuración del ejemplo.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con detalles de la configuración de destino recién creada.

Enumerar configuraciones de destino

Puede recuperar una lista de todas las configuraciones de destino para su organización IMS realizando una solicitud de GET al extremo /authoring/destinations .

Formato de API

GET /authoring/destinations

Solicitud

La siguiente solicitud recuperará la lista de configuraciones de destino a la que tiene acceso, según la configuración de la organización y el entorno limitado de IMS.

curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

La siguiente respuesta devuelve el estado HTTP 200 con una lista de configuraciones de destino a las que tiene acceso, según el ID de organización de IMS y el nombre del simulador de pruebas que ha utilizado. Un instanceId corresponde a la plantilla de un destino. La respuesta se trunca para su brevedad.

{
   "items":[
      {
         "instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
         "createdDate":"2020-10-28T06:14:09.784471Z",
         "lastModifiedDate":"2021-06-28T06:14:09.784471Z",
         "imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
         "sandboxName":"prod",
         "sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
         "name":"Moviestar",
         "description":"Moviestar is a fictional destination, used for this example.",
         "status":"TEST",
         "customerAuthenticationConfigurations":[
            {
               "authType":"BEARER"
            }
         ],
         "customerDataFields":[
            {
               "name":"endpointsInstance",
               "type":"string",
               "title":"Select Endpoint",
               "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
               "isRequired":true,
               "enum":[
                  "US",
                  "EU",
                  "APAC",
                  "NZ"
               ]
            },
            {
               "name":"customerID",
               "type":"string",
               "title":"Moviestar Customer ID",
               "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
               "isRequired":true,
               "pattern":"^[A-Za-z]+$"
            }
         ],
         "uiAttributes":{
            "documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
            "category":"mobile",
            "connectionType":"Server-to-server",
            "frequency":"Streaming"
         },
         "identityNamespaces":{
            "external_id":{
               "acceptsAttributes":true,
               "acceptsCustomNamespaces":true,
               "acceptedGlobalNamespaces":{
                  "Email":{
                     
                  }
               }
            },
            "another_id":{
               "acceptsAttributes":true,
               "acceptsCustomNamespaces":true
            }
         },
         "segmentMappingConfig":{
            "mapExperiencePlatformSegmentName":false,
            "mapExperiencePlatformSegmentId":false,
            "mapUserInput":false,
            "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
         },
         "schemaConfig":{
            "profileFields":[
               {
                  "name":"a_custom_attribute",
                  "title":"a_custom_attribute",
                  "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
                  "type":"string",
                  "isRequired":false,
                  "readOnly":false,
                  "hidden":false
               }
            ],
            "profileRequired":true,
            "segmentRequired":true,
            "identityRequired":true
         },
         "aggregation":{
            "aggregationType":"BEST_EFFORT",
            "bestEffortAggregation":{
               "maxUsersPerRequest":10,
               "splitUserById":false
            }
         },
         "destinationDelivery":[
            {
               "authenticationRule":"CUSTOMER_AUTHENTICATION",
               "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
            }
         ],
         "destConfigId":"410631b8-f6b3-4b7c-82da-7998aa3f327c",
         "backfillHistoricalProfileData":true
      }
   ]
}
    
Parámetro Tipo Descripción
name Cadena Indica el título del destino en el catálogo de Experience Platform.
description Cadena Proporcione una descripción que el Adobe utilizará en el catálogo de destinos del Experience Platform para su tarjeta de destino. Apunte a no más de 4-5 frases.
status Cadena Indica el estado del ciclo vital de la tarjeta de destino. Los valores aceptados son TEST, PUBLISHED y DELETED. Utilice TEST la primera vez que configure el destino.
customerAuthenticationConfigurations Cadena Indica la configuración utilizada para autenticar a los clientes Experience Platform en el servidor. Consulte authType a continuación para conocer los valores aceptados.
customerAuthenticationConfigurations.authType Cadena Los valores aceptados son OAUTH2, BEARER.
customerDataFields.name Cadena Proporcione un nombre para el campo personalizado que está introduciendo.
customerDataFields.type Cadena Indica qué tipo de campo personalizado está introduciendo. Los valores aceptados son string, object, integer
customerDataFields.title Cadena Indica el nombre del campo, tal como lo ven los clientes en la interfaz de usuario del Experience Platform
customerDataFields.description Cadena Proporcione una descripción para el campo personalizado.
customerDataFields.isRequired Booleano Indica si este campo es necesario en el flujo de trabajo de configuración de destino.
customerDataFields.enum Cadena Representa el campo personalizado como un menú desplegable y enumera las opciones disponibles para el usuario.
customerDataFields.pattern Cadena Aplica un patrón para el campo personalizado, si es necesario. Utilice expresiones regulares para aplicar un patrón. Por ejemplo, si los ID de cliente no incluyen números o guiones bajos, introduzca ^[A-Za-z]+$ en este campo.
uiAttributes.documentationLink Cadena Se refiere a la página de documentación de Destinations Catalog para su destino. Utilice https://www.adobe.com/go/destinations-YOURDESTINATION-en, donde YOURDESTINATION es el nombre de su destino. Para un destino llamado Moviestar, debe utilizar https://www.adobe.com/go/destinations-moviestar-en
uiAttributes.category Cadena Se refiere a la categoría asignada a su destino en Adobe Experience Platform. Para obtener más información, lea Categorías de destino. Utilice uno de los siguientes valores: adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments
uiAttributes.connectionType Cadena Server-to-server actualmente es la única opción disponible.
uiAttributes.frequency Cadena Streaming actualmente es la única opción disponible.
identityNamespaces.externalId.acceptsAttributes Booleano Indica si el destino acepta atributos de perfil estándar. Normalmente, estos atributos se resaltan en la documentación de nuestros socios.
identityNamespaces.externalId.acceptsCustomNamespaces Booleano Indica si los clientes pueden configurar áreas de nombres personalizadas en el destino. Obtenga más información sobre áreas de nombres personalizadas en Adobe Experience Platform.
identityNamespaces.externalId.allowedAttributesTransformation Cadena No se muestra en la configuración de ejemplo. Se utiliza, por ejemplo, cuando el cliente Platform tiene direcciones de correo electrónico simples como atributo y la plataforma solo acepta correos electrónicos con hash. Aquí es donde proporcionaría la transformación que debe aplicarse (por ejemplo, transformar el correo electrónico a minúsculas y luego a hash).
identityNamespaces.externalId.acceptedGlobalNamespaces - Se utiliza para casos en los que la plataforma acepta áreas de nombres de identidad estándar (por ejemplo, IDFA), por lo que puede restringir a los usuarios de Platform a que solo seleccionen estas áreas de nombres de identidad.
destinationDelivery.authenticationRule Cadena Indica cómo se conectan los clientes Platform con el destino. Los valores aceptados son CUSTOMER_AUTHENTICATION, PLATFORM_AUTHENTICATION, NONE.
  • Utilice CUSTOMER_AUTHENTICATION si los clientes de Platform inician sesión en su sistema mediante un nombre de usuario y contraseña, un token al portador u otro método de autenticación. Por ejemplo, puede seleccionar esta opción si también selecciona authType: OAUTH2 o authType:BEARER en customerAuthenticationConfigurations.
  • Utilice PLATFORM_AUTHENTICATION si existe un sistema de autenticación global entre el Adobe y el destino y el cliente Platform no necesita proporcionar ninguna credencial de autenticación para conectarse al destino. En este caso, debe crear un objeto credentials utilizando la configuración Credentials.
  • Utilice NONE si no se requiere autenticación para enviar datos a la plataforma de destino.
destinationDelivery.destinationServerId Cadena El instanceId de la plantilla de servidor de destino utilizada para este destino.
destConfigId Cadena Este campo se genera automáticamente y no requiere la introducción de datos.
backfillHistoricalProfileData Booleano Controla si los datos del perfil histórico se exportan cuando los segmentos se activan en el destino.
  • true: Platform envía los perfiles de usuario históricos que cumplen los requisitos para el segmento antes de que se active el segmento.
  • false: Platform solo incluye perfiles de usuario que cumplen los requisitos para el segmento una vez activado el segmento.
segmentMappingConfig.mapUserInput Booleano Controla si el usuario introduce el ID de asignación de segmentos en el flujo de trabajo de activación de destino.
segmentMappingConfig.mapExperiencePlatformSegmentId Booleano Controla si el ID de asignación de segmentos en el flujo de trabajo de activación de destino es el ID de segmento del Experience Platform.
segmentMappingConfig.mapExperiencePlatformSegmentName Booleano Controla si el id. de asignación de segmentos en el flujo de trabajo de activación de destino es el nombre del segmento del Experience Platform.
segmentMappingConfig.audienceTemplateId Booleano El instanceId de la plantilla de metadatos de audiencia utilizada para este destino. Para configurar una plantilla de metadatos de audiencia, lea la referencia API de metadatos de audiencia.

Actualizar una configuración de destino existente

Puede actualizar una configuración de destino existente realizando una solicitud de PUT al extremo /authoring/destinations y proporcionando el ID de instancia de la configuración de destino que desea actualizar. En el cuerpo de la llamada a , proporcione la configuración de destino actualizada.

Formato de API

PUT /authoring/destinations/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El ID de la configuración de destino que desea actualizar.

Solicitud

La siguiente solicitud actualiza una configuración de destino existente, configurada por los parámetros proporcionados en la carga útil. En la llamada de ejemplo siguiente, se está actualizando la configuración creada anteriormente para aceptar ahora los identificadores de correo electrónico con hash, IDFA y GAID como áreas de nombres de identidad.

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
   "createdDate":"2020-10-28T06:14:09.784471Z",
   "lastModifiedDate":"2021-04-28T06:14:09.784471Z",
   "imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
   "sandboxName":"prod",
   "sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      },
      "gaid":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "GAID":{
               
            }
         }
      },
      "idfa":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "IDFA":{
               
            }
         }
      },
      "email_lc_sha256":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation":"sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation":"sha256(lower($))"
            },
            "Email_LC_SHA256":{
               
            }
         }
      }
   },
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "schemaConfig":{
      "profileFields":[
         {
            "name":"a_custom_attribute",
            "title":"a_custom_attribute",
            "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
            "type":"string",
            "isRequired":false,
            "readOnly":false,
            "hidden":false
         }
      ],
      "profileRequired":true,
      "segmentRequired":true,
      "identityRequired":true
   },
   "aggregation":{
      "aggregationType":"BEST_EFFORT",
      "bestEffortAggregation":{
         "maxUsersPerRequest":10,
         "splitUserById":false
      }
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "backfillHistoricalProfileData":true
}

Recuperar una configuración de destino específica

Puede recuperar información detallada sobre una configuración de destino específica realizando una solicitud de GET al extremo /authoring/destinations y proporcionando el ID de instancia de la configuración de destino que desea recuperar.

Formato de API

GET /authoring/destinations/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El ID de la configuración de destino que desea recuperar.

Solicitud

curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre la configuración de destino especificada.

{
   "instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
   "createdDate":"2020-10-28T06:14:09.784471Z",
   "lastModifiedDate":"2021-06-04T06:14:09.784471Z",
   "imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
   "sandboxName":"prod",
   "sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
               
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      },
      "gaid":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "GAID":{
               
            }
         }
      },
      "idfa":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "IDFA":{
               
            }
         }
      },
      "email_lc_sha256":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation":"sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation":"sha256(lower($))"
            },
            "Email_LC_SHA256":{
               
            }
         }
      }
   },
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "schemaConfig":{
      "profileFields":[
         {
            "name":"a_custom_attribute",
            "title":"a_custom_attribute",
            "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
            "type":"string",
            "isRequired":false,
            "readOnly":false,
            "hidden":false
         }
      ],
      "profileRequired":true,
      "segmentRequired":true,
      "identityRequired":true
   },
   "aggregation":{
      "aggregationType":"BEST_EFFORT",
      "bestEffortAggregation":{
         "maxUsersPerRequest":10,
         "splitUserById":false
      }
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "backfillHistoricalProfileData":true
}

Eliminar una configuración de destino específica

Puede eliminar la configuración de destino especificada realizando una solicitud de DELETE al extremo /authoring/destinations y proporcionando el ID de la configuración de destino que desea eliminar en la ruta de solicitud.

Formato de API

DELETE /authoring/destinations/{INSTANCE_ID}
Parámetro Descripción
{INSTANCE_ID} El id de la configuración de destino que desea eliminar.

Solicitud

curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 junto con una respuesta HTTP vacía.

Gestión de errores de API

Los extremos de la API del SDK de destino siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte los códigos de estado de API y errores de encabezado de solicitud en la guía de solución de problemas de Platform.

Pasos siguientes

Después de leer este documento, ahora sabe cómo configurar su destino utilizando el extremo de API /authoring/destinations. Lea cómo utilizar el SDK de destino para configurar su destino para comprender dónde encaja este paso en el proceso de configuración de su destino.

En esta página