DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

API-Methoden für die Domain-Verwaltung domain-management-api-methods

Last update: Fri Dec 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Methoden der Domain-Verwaltung, mit denen Sie die Domains erstellen und verwalten können, an die Sie Daten senden möchten (nur für Cookie-Ziele).

Erstellen einer neuen Domain create-new-domain

Eine POST Methode zum Erstellen einer neuen Domain (nur für Cookie-Ziele).

Anfrage

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

Beispielanforderung

{
   "url":"example1.com"
}

Antwort

Bei einer erfolgreichen Antwort werden 201 created und die Partner-Site zurückgegeben, einschließlich ihrer eindeutigen ID.

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

Löschen einer Domain delete-domain

Eine DELETE Methode zum Entfernen einer Domain (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 Partnerseite nicht gefunden werden kann.

Zurückgeben von Eigenschaften für eine Domain return-props-domain

Eine GET Methode, die Details zur angegebenen Domain 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"
}

Eigenschaften für alle Domains zurückgeben return-props-all-domains

Eine GET Methode, die Informationen zu all Ihren Domains 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 den API übergeben. Siehe Optionale Parameter.

Parameter
Beschreibung
page
Gibt Ergebnisse nach Seitenzahl zurück. Nummerierung beginnt bei 0.
pageSize
Legt die Anzahl der von der Anfrage zurückgegebenen Antwortergebnisse fest (10 ist der Standardwert).
sortBy
Sortiert Ergebnisse entsprechend der angegebenen JSON-Eigenschaft und gibt sie zurück.
descending
Sortiert die Ergebnisse in absteigender Reihenfolge und gibt sie zurück. Aufsteigend ist Standard.
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 finden, die das Wort „Test“ in einem der Wertefelder für dieses Element enthalten. 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