Dokumentation Experience Platform Zielhandbuch

Abrufen einer Zielveröffentlichungsanfrage

Last update: Wed Mar 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Ziele

Erstellt für:

Admin
Benutzende

IMPORTANT

Sie müssen diesen API-Endpunkt nur verwenden, wenn Sie ein produktbezogenes (öffentliches) Ziel einreichen, das von anderen Experience Platform-Kundinnen und -Kunden verwendet werden soll. Wenn Sie ein privates Ziel für Ihre eigene Verwendung erstellen, müssen Sie das Ziel nicht formell mit der Veröffentlichungs-API übermitteln.

IMPORTANT

API-Endpunkt: platform.adobe.io/data/core/activation/authoring/destinations/publish

Nachdem Sie Ihr Ziel konfiguriert und getestet haben, können Sie es zur Überprüfung und Veröffentlichung an Adobe senden. Lesen Sie Einreichen eines in Destination SDK erstellten Ziels zur Überprüfung, um alle weiteren Schritte zu erfahren, die Sie im Rahmen des Einreichungsprozesses für ein Ziel durchführen müssen.

Verwenden Sie den API-Endpunkt für Veröffentlichungsziele, um eine Veröffentlichungsanfrage zu senden, wenn Sie:

als Destination SDK-Partner Ihr produktbezogenes Ziel über alle Experience Platform-Organisationen für alle Experience Platform-Kundinnen und -Kunden verfügbar machen möchten.
Aktualisierungen jeglicher Art an Ihren Konfigurationen vornehmen. Konfigurationsaktualisierungen werden erst dann im Ziel angezeigt, wenn Sie eine neue Veröffentlichungsanfrage senden, die vom Experience Platform-Team genehmigt wurde.

IMPORTANT

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 zur Zielveröffentlichung get-started

Bevor Sie fortfahren, lesen Sie den Abschnitt Erste Schritte. Dort erhalten Sie wichtige Informationen darüber, wie Sie die API aufrufen und die erforderliche Authoring-Berechtigung für Ziele und die Kopfzeilen abrufen können.

Auflisten der Zielveröffentlichungsanfragen retrieve-list

Sie können eine Liste aller für Ihre IMS-Organisation zur Veröffentlichung übermittelten Ziele abrufen, indem Sie eine GET-Anfrage an den Endpunkt /authoring/destinations/publish stellen.

API-Format

Verwenden Sie das folgende API-Format, um alle Veröffentlichungsanfragen für Ihr Konto abzurufen.

GET /authoring/destinations/publish

Verwenden Sie das folgende API-Format, um eine bestimmte Veröffentlichungsanfrage abzurufen, die durch den Parameter {DESTINATION_ID} bestimmt wird.

GET /authoring/destinations/publish/{DESTINATION_ID}

Anfrage

Die folgenden beiden Anfragen rufen alle Veröffentlichungsanfragen für Ihre IMS-Organisation ab oder eine bestimmte Veröffentlichungsanfrage, je nachdem, ob Sie den Parameter DESTINATION_ID in der Anfrage übergeben.

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

Alle Veröffentlichungsanfragen abrufen

accordion

Anfrage

Die folgende Anfrage ruft auf der Grundlage der IMS Org ID und der Sandbox-Konfiguration die Liste der Veröffentlichungsanfragen ab, die Sie übermittelt haben.

code language-shell

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

accordion

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit einer Liste von Zielen zurückgegeben, die zur Veröffentlichung übermittelt wurden und auf die Sie Zugriff haben. Diese Liste basiert auf der von Ihnen verwendeten IMS-Organisations-ID und dem Sandbox-Namen der IMS-Organisation. Eine configId entspricht der Veröffentlichungsanfrage für jeweils ein Ziel.

code language-json

{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"ab41387c0-4772-4709-a3ce-6d5fee654520",
         "allowedOrgs":[
            "716543205DB85F7F0A495E5B@AdobeOrg"
         ],
         "status":"TEST",
         "destinationType":"DEV"
      },
      {
         "configId":"cd568c67-f25e-47e4-b9a2-d79297a20b27",
         "allowedOrgs":[
            "*"
         ],
         "status":"DEPRECATED",
         "destinationType":"PUBLIC",
         "publishedDate":1630525501009
      },
      {
         "configId":"ef6f07154-09bc-4bee-8baf-828ea9c92fba",
         "allowedOrgs":[
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType":"PUBLIC",
         "publishedDate":1630531586002
      }
   ]
}

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parameter	Typ	Beschreibung
`destinationId`	Zeichenfolge	Die Ziel-ID der Zielkonfiguration, die Sie zur Veröffentlichung übermittelt haben.
`publishDetailsList.configId`	Zeichenfolge	Die eindeutige ID der Zielveröffentlichungsanfrage für Ihr übermitteltes Ziel.
`publishDetailsList.allowedOrgs`	Zeichenfolge	Gibt die Experience Platform-Organisationen zurück, für die das Ziel verfügbar ist. Für `"destinationType": "PUBLIC"` gibt dieser Parameter `"*"` zurück, was bedeutet, dass das Ziel für alle Experience Platform-Organisationen verfügbar ist. Für `"destinationType": "DEV"` gibt dieser Parameter die Organisations-ID der Organisation zurück, die Sie zum Erstellen und Testen des Ziels verwendet haben.
`publishDetailsList.status`	Zeichenfolge	Der Status Ihrer Anfrage zum Ziel der Veröffentlichung. Mögliche Werte sind `TEST`, `REVIEW`, `APPROVED`, `PUBLISHED`, `DENIED`, `REVOKED`, `DEPRECATED`. Ziele mit dem Wert `PUBLISHED` sind live und können von Experience Platform-Kundinnen und -Kunden verwendet werden.
`publishDetailsList.destinationType`	Zeichenfolge	Der Typ des Ziels. Werte können `DEV` und `PUBLIC` sein. `DEV` entspricht dem Ziel in Ihrer Experience Platform-Organisation. `PUBLIC` entspricht dem Ziel, das Sie zur Veröffentlichung übermittelt haben. Stellen Sie sich diese beiden Optionen in Git-Begriffen vor, wobei die Version `DEV` für Ihre lokale Authoring-Verzweigung steht und die Version `PUBLIC` für den Remote-Hauptzweig.
`publishDetailsList.publishedDate`	Zeichenfolge	Das Datum, an dem das Ziel zur Veröffentlichung gesendet wurde, angegeben in Epochenzeit.

Bestimmte Veröffentlichungsanfrage abrufen

accordion

Anfrage

code language-shell

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

table 0-row-2 1-row-2
Parameter	Beschreibung
`{DESTINATION_ID}`	Die ID des Ziels, für das Sie den Veröffentlichungsstatus abrufen möchten.

accordion

Antwort

Wenn Sie eine DESTINATION_ID im API-Aufruf übergeben haben, gibt die Antwort den HTTP-Status 200 mit detaillierten Informationen zur angegebenen Ziel-Veröffentlichungsanfrage zurück.

code language-json

{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"123cs780-ce29-434f-921e-4ed6ec2a6c35",
         "allowedOrgs": [
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType": "PUBLIC",
         "publishedDate":"1630617746"
      }
   ]
}

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parameter	Typ	Beschreibung
`destinationId`	Zeichenfolge	Die Ziel-ID der Zielkonfiguration, die Sie zur Veröffentlichung übermittelt haben.
`publishDetailsList.configId`	Zeichenfolge	Die eindeutige ID der Zielveröffentlichungsanfrage für Ihr übermitteltes Ziel.
`publishDetailsList.allowedOrgs`	Zeichenfolge	Gibt die Experience Platform-Organisationen zurück, für die das Ziel verfügbar ist. Für `"destinationType": "PUBLIC"` gibt dieser Parameter `"*"` zurück, was bedeutet, dass das Ziel für alle Experience Platform-Organisationen verfügbar ist. Für `"destinationType": "DEV"` gibt dieser Parameter die Organisations-ID der Organisation zurück, die Sie zum Erstellen und Testen des Ziels verwendet haben.
`publishDetailsList.status`	Zeichenfolge	Der Status Ihrer Anfrage zum Ziel der Veröffentlichung. Mögliche Werte sind `TEST`, `REVIEW`, `APPROVED`, `PUBLISHED`, `DENIED`, `REVOKED`, `DEPRECATED`. Ziele mit dem Wert `PUBLISHED` sind live und können von Experience Platform-Kundinnen und -Kunden verwendet werden.
`publishDetailsList.destinationType`	Zeichenfolge	Der Typ des Ziels. Werte können `DEV` und `PUBLIC` sein. `DEV` entspricht dem Ziel in Ihrer Experience Platform-Organisation. `PUBLIC` entspricht dem Ziel, das Sie zur Veröffentlichung übermittelt haben. Stellen Sie sich diese beiden Optionen in Git-Begriffen vor, wobei die Version `DEV` für Ihre lokale Authoring-Verzweigung steht und die Version `PUBLIC` für den Remote-Hauptzweig.
`publishDetailsList.publishedDate`	Zeichenfolge	Das Datum, an dem das Ziel zur Veröffentlichung gesendet wurde, angegeben in Epochenzeit.

Umgang mit API-Fehlern error-handling

Destination SDK-API-Endpunkte folgen den allgemeinen Grundsätzen von Experience Platform API-Fehlermeldungen. Siehe API-StatusCodes und Fehler in der Anfragekopfzeile im Handbuch zur Fehlerbehebung bei Experience Platform.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6