Aktualisieren von Kampagnen mithilfe der API

Sie können eine Kampagne mit den gewünschten Änderungen aktualisieren. Bearbeiten können Sie nur die Bezeichnung oder die Teilnehmer.

In diesem Beispiel wird Talend API Tester zum Senden von Requests verwendet.

Weitere Informationen zu Talend API Tester finden Sie im Nutzungshandbuch für Talend Cloud API Tester.

Prozedur

Sofern Sie noch nicht über ein persönliches Zugriffstoken verfügen, erzeugen Sie eines. Weitere Informationen finden Sie unter „Generieren persönlicher Zugriffstoken“.
Öffnen Sie Talend API Tester in Ihrem Browser.
Wählen Sie auf der Registerkarte Repository die Methode Put in der Dropdown-Liste Method (Methode) aus.
Geben Sie folgende URL ein: https://tds.{region}.cloud.talend.com/data-stewardship/api/v1/campaigns/owned

Eine Liste der für die verschiedenen Rechenzentren zu verwendenden URLs finden Sie unter Talend Cloud-Regionen und -URLs.
Klicken Sie auf die Schaltfläche Add header (Header hinzufügen) und geben Sie Authorization (Autorisierung) in das Feld name (Name) und Bearer, gefolgt von einem Leerzeichen und Ihrem Token in das Feld value (Wert) ein.
Klicken Sie auf die Schaltfläche Add header (Header hinzufügen), geben Sie Cookie in das Feld name (Name) ein und lassen Sie das Feld value (Wert) leer.

Nehmen Sie in das Feld Body den Inhalt der zur Erstellung der Kampagne verwendeten Operation POST https://tds.{region}.cloud.talend.com/data-stewardship/api/v1/campaigns/owned mit den gewünschten Änderungen auf.

Example

Um den Data Steward steward2@account.com für den neuen Workflow-Schritt New (Neu) hinzuzufügen, fügen Sie ihn zum Wert Supervisor im Objekt participants (Teilnehmer) hinzu:

{
    "campaign": {
        "name": "my-campaign-resolution-created-via-api",
        "label": "Improve product catalog data quality (created via API)",
        "description": "Increase the level of data quality for each product catalog.",
        "owners": ["owner@account.com"],
        "taskType": "RESOLUTION",
        "schemaRef": {
            "namespace": "org.talend.schema",
            "name": "my_products_created_via_API",
            "version": 1,
            "displayName": "Product (created via API)"
        },
        "taskResolutionDelay": {
            "value": 10,
            "unit": "DAYS"
        },
        "workflow": {
            "name": "default workflow",
            "states": [{
                "name": "New",
                "label": "New",
                "transitions": [{
                    "name": "To validate",
                    "label": "To validate",
                    "targetStateName": "To validate",
                    "allowedRoles": ["Supervisor"]
                }],
                "allowedRoles": [],
                "translations": {}
            }, {
                "name": "To validate",
                "label": "To validate",
                "transitions": [{
                    "name": "Accept",
                    "label": "Accept",
                    "targetStateName": "Resolved",
                    "allowedRoles": ["Validator"]
                }, {
                    "name": "Reject",
                    "label": "Reject",
                    "targetStateName": "New",
                    "allowedRoles": ["Validator"]
                }],
                "allowedRoles": [],
                "translations": {}
            }, {
                "name": "Resolved",
                "label": "Resolved",
                "transitions": [],
                "allowedRoles": ["Validator"],
                "translations": {}
            }]
        }
    },
    "participants": {
        "Supervisor": ["steward1@account.com", "steward2@account.com"],
        "Validator": ["steward1@account.com"]
    }
}

Klicken Sie auf Send (Senden).

Ergebnisse

Die API gibt den HTTP-Code 200 zurück, um Sie darüber zu informieren, dass der Request erfolgreich war. Die Antwort enthält eine aktualisierte JSON-Beschreibung der Kampagne.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab