Aktualisieren einer Ziel-Server-Konfiguration

Auf dieser Seite werden die API-Anfrage und die Payload erläutert, die Sie verwenden können, um eine vorhandene Ziel-Server-Konfiguration mithilfe des API-Endpunkts /authoring/destination-servers aktualisieren können.

TIPP

Jeder Aktualisierungsvorgang für produktbezogene/öffentliche Ziele ist erst sichtbar, nachdem Sie die Publishing-API verwendet und die Aktualisierung zur Überprüfung durch Adobe eingereicht haben.

Eine ausführliche Beschreibung der Funktionen, die Sie über diesen Endpunkt konfigurieren können, finden Sie in den folgenden Artikeln:

WICHTIG

Bei allen von Destination SDK unterstützten Parameternamen und Werten wird nach Groß-/Kleinschreibung unterschieden. Um Fehler bei der Groß-/Kleinschreibung zu vermeiden, verwenden Sie bitte die Parameternamen und -werte genau wie in der Dokumentation dargestellt.

Erste Schritte mit API-Vorgängen für Ziel-Server

Bevor Sie fortfahren, lesen Sie Erste Schritte für wichtige Informationen, die Sie benötigen, um die API erfolgreich aufrufen zu können, einschließlich Informationen zum Abrufen der erforderlichen Authoring-Berechtigung für Ziele und der erforderlichen Kopfzeilen.

Aktualisieren einer Ziel-Server-Konfiguration

Sie können eine vorhandene Ziel-Server-Konfiguration aktualisieren, indem Sie eine PUT-Anfrage an den Endpunkt /authoring/destination-servers mit der aktualisierten Payload stellen.

TIPP

API-Endpunkt: platform.adobe.io/data/core/activation/authoring/destination-servers

Um eine vorhandene Ziel-Server-Konfiguration und die zugehörige {INSTANCE_ID} abzurufen, lesen Sie den Artikel über das Abrufen einer Ziel-Server-Konfiguration.

API-Format

PUT /authoring/destination-servers/{INSTANCE_ID}

Parameter	Beschreibung
`{INSTANCE_ID}`	Die ID des Ziel-Servers, den Sie aktualisieren möchten. Um eine vorhandene Ziel-Server-Konfiguration und die zugehörige `{INSTANCE_ID}` abzurufen, lesen Sie den Artikel über das Abrufen einer Ziel-Server-Konfiguration.

Die folgenden Anfragen aktualisieren eine vorhandene Ziel-Server-Konfiguration, die durch die in der Payload bereitgestellten Parameter konfiguriert wird.

Wählen Sie die einzelnen Registerkarten unten aus, um die entsprechende Payload anzuzeigen.

Anfrage

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destination-servers\{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "httpTemplate":{
      "httpMethod":"PUT",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}

Parameter	Typ	Beschreibung
`name`	Zeichenfolge	Erforderlich. Stellt einen Anzeigenamen Ihres Servers dar, der nur für Adobe sichtbar ist. Dieser Name ist weder für Partner noch für Kundinnen und Kunden sichtbar. Beispiel `Moviestar destination server`.
`destinationServerType`	Zeichenfolge	Erforderlich. Legen Sie dies für Echtzeit-Ziele (Streaming) auf `URL_BASED` fest.
`urlBasedDestination.url.templatingStrategy`	Zeichenfolge	Erforderlich. Verwenden Sie `PEBBLE_V1`, wenn Adobe die URL im nachstehenden Feld `value` umwandeln muss. Verwenden Sie diese Option, wenn Sie folgenden Endpunkt haben: `https://api.moviestar.com/data/{{customerData.region}}/items`. Verwenden Sie `NONE`, wenn von Adobe keine Umwandlung erforderlich ist, z. B. wenn Sie folgenden Endpunkt haben: `https://api.moviestar.com/data/items`.
`urlBasedDestination.url.value`	Zeichenfolge	Erforderlich. Geben Sie die Adresse des API-Endpunkts ein, mit dem sich Experience Platform verbinden soll.
`httpTemplate.httpMethod`	Zeichenfolge	Erforderlich. Die Methode, die Adobe bei Aufrufen an Ihren Server verwendet. Es gibt die Optionen `GET`, `PUT`, `PUT`, `DELETE`, `PATCH`.
`httpTemplate.requestBody.templatingStrategy`	Zeichenfolge	Erforderlich. Verwenden Sie `PEBBLE_V1`.
`httpTemplate.requestBody.value`	Zeichenfolge	Erforderlich. Diese Zeichenfolge ist die Version mit Escape-Zeichen, die die Daten von Platform-Kundinnen und -Kunden in das Format umwandelt, das Ihr Service erwartet. Informationen zum Schreiben der Vorlage finden Sie im Abschnitt Verwenden von Vorlagen. Weitere Informationen zu Escape-Zeichen finden Sie unter RFC JSON-Standard, Abschnitt 7. Ein Beispiel für eine einfache Umwandlung finden Sie im unter Umwandlung von Profilattributen.
`httpTemplate.contentType`	Zeichenfolge	Erforderlich. Der Content-Typ, den Ihr Server akzeptiert. Dieser Wert ist höchstwahrscheinlich `application/json`.

Antwort