DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

API-Methoden für die Domänenverwaltung domain-management-api-methods

Last update: Mon Jul 19 2021 00:00:00 GMT+0000 (Coordinated Universal Time)

Domain-Verwaltungsmethoden, mit denen Sie die Domänen erstellen und verwalten können, an die Sie Daten senden möchten (nur für Cookie-Ziele).

Neue Domäne erstellen create-new-domain

Eine POST -Methode, mit der Sie eine neue Domäne für erstellen können (nur Cookie-Ziele).

Anfrage

POST https://api.demdex.com/v1/partner-sites/

Beispielanforderung

{
   "url":"example1.com"
}

Antwort

Eine erfolgreiche Antwort gibt 201 created und die Partner-Site zurück, einschließlich der eindeutigen ID.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Löschen einer Domäne delete-domain

Eine DELETE -Methode, mit der Sie eine Domäne entfernen können (nur für Cookie-Ziele).

Anfrage

DELETE https://api.demdex.com/v1/partner-sites/<site-Id>

Antwort

Eine erfolgreiche Antwort gibt 204 no content zurück. Gibt 404 not found zurück, wenn die Partner-Site nicht gefunden werden kann.

Eigenschaften für eine Domäne zurückgeben return-props-domain

Eine GET -Methode, die Details zur angegebenen Domäne zurückgibt (nur für Cookie-Ziele).

Anfrage

GET https://api.demdex.com/v1/partner-sites/<siteId>

Antwort

Eine erfolgreiche Antwort gibt 200 OK und -Daten zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Rückgabeeigenschaften für alle Domänen return-props-all-domains

Eine GET -Methode, die Informationen über alle Ihre Domänen zurückgibt (nur für Cookie-Ziele).

Anfrage

GET https://api.demdex.com/v1/partner-sites/

Optionale Abfrageparameter

Sie können diese optionalen Parameter mit API-Methoden verwenden, die alle-Eigenschaften für ein Objekt zurückgeben. Legen Sie diese Optionen in der Anforderungszeichenfolge fest, wenn Sie diese Abfrage an API übergeben. Siehe Optionale Parameter.

Parameter
Beschreibung
page
Gibt Ergebnisse nach Seitenzahl zurück. Die Nummerierung beginnt bei 0.
pageSize
Legt die Anzahl der von der Anfrage zurückgegebenen Antwortergebnisse fest (standardmäßig 10).
sortBy
Sortiert Ergebnisse und gibt sie gemäß der angegebenen JSON-Eigenschaft zurück.
descending
Sortiert Ergebnisse und gibt sie in absteigender Reihenfolge zurück. Aufsteigend ist die Standardeinstellung.
search

Gibt Ergebnisse basierend auf der angegebenen Zeichenfolge zurück, die Sie als Suchparameter verwenden möchten. Angenommen, Sie möchten Ergebnisse für alle Modelle mit dem Wort "Test"in einem der Wertefelder für dieses Element finden. Ihre Beispielanfrage könnte wie folgt aussehen:

`GET` `https://api.demdex.com/v1/models/?search=Test`.

Sie können nach jedem Wert suchen, der von einer "get all"-Methode zurückgegeben wird.

Antwort

Eine erfolgreiche Antwort gibt 200 OK und Daten in einem Array zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695