文件 Audience Manager Audience Manager 使用手冊

網域管理API方法

最後更新： 2024年7月20日

主題：
API

網域管理方法可讓您建立和管理要傳送資料的網域（僅適用於Cookie目的地）。

建立新網域

POST方法可讓您為（僅限Cookie目的地）建立新網域。

請求

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

範例要求

{
   "url":"example1.com"
}

回應

成功的回應傳回201 created和合作夥伴網站，包括其唯一識別碼。

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

刪除網域

可讓您移除網域的DELETE方法（僅適用於Cookie目的地）。

請求

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

回應

成功的回應傳回204 no content。如果找不到夥伴網站，則傳回404 not found。

傳回網域的屬性

傳回指定網域相關詳細資料的GET方法（僅適用於Cookie目的地）。

請求

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

回應

成功的回應會傳回200 OK和資料，如下列範例所示。如果找不到網站ID或夥伴，則傳回404 Not found。

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

傳回所有網域的屬性

傳回您所有網域相關資訊的GET方法（僅適用於Cookie目的地）。

請求

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

選擇性查詢引數

您可以使用這些選擇性引數搭配API方法，傳回物件的所有屬性。將該查詢傳入API時，在要求字串中設定這些選項。請參閱選用引數。

參數

說明

page

依頁碼傳回結果。編號從0開始。

pageSize

設定要求傳回的回應結果數目（預設為10）。

sortBy

根據指定的JSON屬性排序並傳回結果。

descending

以遞減順序排序並傳回結果。預設值為升序。

search

根據您要用作搜尋引數的指定字串傳回結果。例如，假設您想要尋找在該專案的任何值欄位中有「Test」字詞的所有模型的結果。您的範例請求可能如下所示：

`GET` `https://api.demdex.com/v1/models/?search=Test`實施流量分類。

您可以搜尋"get all"方法傳回的任何值。

回應

成功的回應傳回200 OK和陣列中的資料，如下列範例所示。如果找不到網站ID或夥伴，則傳回404 Not found。

[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]

recommendation-more-help