有關一般需求、驗證、可選查詢參數、請求的資訊 URLs和其他參考。
使用時,您必須且應該執行的事項 Audience Manager APIs.
使用時請注意下列事項 Audience ManagerAPI 代碼:
x-api-key
頁首。 你可以 API 鍵 服務帳戶整合 頁面。content-type: application/json
和 accept: application/json
在程式碼中。此 Audience Manager REST APIs 支援兩種驗證方法。
您需要根據驗證方法調整請求 URLs 因此。 請參閱 環境 一節,以取得您應使用之主機名稱的詳細資訊。
Adobe Developer 是Adobe的開發人員生態系統和社群。 包括 所有Adobe產品的API.
這是設定和使用的建議方式 Adobe APIs.
設定之前 JWT 驗證,確定您擁有 Adobe Developer Console in Adobe Developer. 如需存取請求,請聯絡貴組織的管理員。
請依照下列步驟來設定 JWT (Service Account) 驗證使用 Adobe Developer:
若要設定及使用 Audience Manager REST APIs 您可以自動產生 JWT 程式設計。 請參閱 JWT(服務帳戶)驗證 以取得詳細指示。
如果您的Audience Manager帳戶使用 角色型存取控制,您必須建立Audience Manager技術使用者帳戶,並將其新增至將進行API呼叫的Audience ManagerRBAC群組。
請依照下列步驟建立技術使用者帳戶,並將其新增至RBAC群組:
建立 GET
呼叫 https://aam.adobe.io/v1/users/self
. 此呼叫將建立技術使用者帳戶,您可在 Admin Console,在 Users 頁面。
登入您的Audience Manager帳戶,並 新增技術使用者帳戶 至將進行API呼叫的使用者群組。
Audience Manager REST API 代號驗證和續約,透過 OAuth 2.0 現已過時。
請使用 JWT(服務帳戶)驗證 。
此 Audience Manager REST API 如下 OAuth 2.0 代號驗證和續約的標準。 以下各節說明如何驗證及開始使用 APIs.
建議您建立個別的技術使用者帳戶,以搭配 Audience Manager APIs.這是一般帳戶,不會系結至組織中的特定使用者,或與其建立關聯。 此類 API 使用者帳戶可協助您完成下列兩件事:
作為此類帳戶的範例或使用案例,假設您想要使用 大量管理工具. 為此,您的使用者帳戶需要 API 存取權。 建立非特定的、 API 具有可建立的適當憑證、金鑰和機密的使用者帳戶 API 呼叫。 如果您開發的應用程式使用 Audience Manager APIs.
與您的 Audience Manager 顧問來設定通用, API — 僅限用戶帳戶。
密碼驗證安全訪問我們的 REST API. 下列步驟將概述密碼驗證的工作流程,來自 JSON 用戶端。
如果您將權杖儲存在資料庫中,請加密存取和重新整理權杖。
請連絡您的合作夥伴解決方案經理。 他們會提供 API 用戶端ID和密碼。 ID和機密會驗證您 API.
注意:如果您想要接收重新整理Token,請在您提出要求時指定 API 存取權。
使用您偏好的傳遞Token要求 JSON 用戶端。 建置請求時:
POST
呼叫方法 https://api.demdex.com/oauth/token
.testId : testSecret
轉換為 dGVzdElkOnRlc3RTZWNyZXQ=
.Authorization:Basic <base-64 clientID:clientSecret>
和 Content-Type: application/x-www-form-urlencoded
. 例如,標題可能如下所示: Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
grant_type=password&username=<your-AudienceManager-user-name>&password=<your-AudienceManager-password>
此 JSON 回應包含您的存取權杖。 回應應如下所示:
{
"access_token": "28fed402-eafd-456c-9341-ac753f25bbbc",
"token_type": "bearer",
"refresh_token": "b27122c0-b0c7-4b39-a71b-1547a3b3b88e",
"expires_in": 21922,
"scope": "read write"
}
此 expires_in
key代表存取權杖過期的秒數。 最佳作法是,如果代號曾公開,請使用短的到期時間來限制曝光。
重新整理代號續約 API 原始代號過期後的存取。 如有要求,則回應 JSON 在密碼工作流程中包含重新整理Token。 如果您未收到重新整理Token,請透過密碼驗證程式建立新Token。
您也可以使用重新整理Token,在現有存取Token過期之前產生新Token。
如果您的存取權杖已過期,您會收到 401 Status Code
和回應中的下列標題:
WWW-Authenticate: Bearer realm="oauth", error="invalid_token", error_description="Access token expired: <token>"
下列步驟將概述使用重新整理Token,以從 JSON 用戶端。
使用您偏好的傳遞重新整理Token請求 JSON 用戶端。 建置請求時:
POST
呼叫方法 https://api.demdex.com/oauth/token
.testId : testSecret
轉換為 dGVzdElkOnRlc3RTZWNyZXQ=
.Authorization:Basic <base-64 clientID:clientSecret>
和 Content-Type: application/x-www-form-urlencoded
. 例如,標題可能如下所示: Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
grant_type:refresh_token
並傳入您先前存取請求中收到的重新整理Token。 請求應如下所示: grant_type=refresh_token&refresh_token=b27122c0-b0c7-4b39-a71b-1547a3b3b88e
此 JSON 回應包含您的新存取權杖。 回應應如下所示:
{
"access_token": "4fdfc261-2ffc-4fb7-8dbd-64221714c45f",
"token_type": "bearer",
"refresh_token": "295fa487-1825-4caa-a715-80b81ac17dae",
"expires_in": 21922,
"scope": "read write"
}
此 Audience Manager REST API 支援授權碼和隱式驗證。 若要使用這些存取方法,您的使用者必須登入 https://api.demdex.com/oauth/authorize
以取得存取權並重新整理權杖。
呼叫需求 API 方法。
對可用進行呼叫的方式 API 方法:
HTTP
標題,設定 Authorization: Bearer <token>
.x-api-key
標題,其與 client_id
. 你可以 client_id
從 Adobe Developer整合 頁面。設定可用於方法的可選參數,這些方法將返回對象的所有屬性。
您可以搭配使用這些選用參數 API 傳回的方法 all 對象的屬性。 將查詢傳入至 API.
參數 | 說明 |
---|---|
page |
按頁碼返回結果。 編號從0開始。 |
pageSize |
設定請求傳回的回應結果數(預設為10)。 |
sortBy |
根據指定的 JSON 屬性。 |
descending |
按降序排序和返回結果。 ascending 為預設值。 |
search |
根據您要用作搜索參數的指定字串返回結果。 例如,假設您想在該項目的任何值欄位中,找到所有具有「Test」字詞之模型的結果。 您的範例要求可能如下所示: GET https://aam.adobe.io/v1/models/?search=Test . 您可以搜尋「get all」方法。 |
folderId |
傳回 traits 在指定的資料夾內。 不適用於所有方法。 |
permissions |
根據指定的權限傳回區段清單。 READ 為預設值。 權限包括:
使用個別的索引鍵值配對指定多個權限。 例如,若要傳回具有 READ 和 WRITE 僅限權限,傳入 "permissions":"READ" , "permissions":"WRITE" . |
includePermissions |
(Boolean)設為 true 以傳回區段的權限。 預設為 false . |
頁面資訊時 不是 指定,則請求會傳回純 JSON 產生陣列。 如果頁面資訊 is 指定,則傳回的清單會包裝在 JSON 包含總結果和當前頁資訊的對象。 使用頁面選項的範例請求看起來可能類似這樣:
GET https://aam.adobe.io/v1/models/?page=1&pageSize=2&search=Test
URLs 適用於請求、測試和生產環境及版本。
下表列出請求 URLs 過去傳入 API 請求,依方法。
您需要根據您使用的驗證方法調整請求 URLs 根據下表。
API 方法 | 請求 URL |
---|---|
Algorithmic Modeling | https://aam.adobe.io/v1/models/ |
Data Source | https://aam.adobe.io/v1/datasources/ |
Derived Signals | https://aam.adobe.io/v1/signals/derived/ |
Destinations | https://aam.adobe.io/v1/destinations/ |
Domains | https://aam.adobe.io/v1/partner-sites/ |
Folders | 特徵: https://aam.adobe.io/v1/folders/traits / 區段: https://aam.adobe.io/v1/folders/segments / |
Schema | https://aam.adobe.io/v1/schemas/ |
Segments | https://aam.adobe.io/v1/segments/ |
Traits | https://aam.adobe.io/v1/traits/ |
Trait Types | https://aam.adobe.io/v1/customer-trait-types |
Taxonomy | https://aam.adobe.io/v1/taxonomies/0/ |
API 方法 | 請求 URL |
---|---|
Algorithmic Modeling | https://api.demdex.com/v1/models/ |
Data Source | https://api.demdex.com/v1/datasources/ |
Derived Signals | https://api.demdex.com/v1/signals/derived/ |
Destinations | https://api.demdex.com/v1/destinations/ |
Domains | https://api.demdex.com/v1/partner-sites/ |
Folders | 特徵: https://api.demdex.com/v1/folders/traits / 區段: https://api.demdex.com/v1/folders/segments / |
Schema | https://api.demdex.com/v1/schemas/ |
Segments | https://api.demdex.com/v1/segments/ |
Traits | https://api.demdex.com/v1/traits/ |
Trait Types | https://api.demdex.com/v1/customer-trait-types |
Taxonomy | https://api.demdex.com/v1/taxonomies/0/ |
此 Audience Manager API提供對不同工作環境的存取。 這些環境可協助您針對個別資料庫測試程式碼,而不會影響即時的生產資料。 下表列出可用 API 環境和對應的資源主機名。
您需要根據您使用的驗證方法調整環境 URLs 根據下表。
環境 | 的主機名 JWT 驗證 | 的主機名 OAuth 驗證 |
---|---|---|
生產 | https://aam.adobe.io/... |
https://api.demdex.com/... |
Beta | https://aam-beta.adobe.io/... |
https://api-beta.demdex.com/... |
此 Audience Manager 測試版環境是生產環境的較小規模的獨立版本。 必須在此環境中輸入並收集您要測試的所有資料。
新版本 API會定期發行。 新發行將 API 版本號。 請求中參考的版本編號 URL as v<version number>
如下列範例所示:
https://<host>/v1/...
HTTP
狀態代碼和由返回的響應文本 Audience Manager REST API.
回應代碼ID | 回應文字 | 定義 |
---|---|---|
200 |
OK |
已成功處理請求。 會視需要傳回預期的內容或資料。 |
201 |
Created |
已建立資源。 傳回 PUT 和 POST 要求。 |
204 |
No Content |
已刪除資源。 回應內文將為空白。 |
400 |
Bad Request |
伺服器不理解該請求。 通常是因為語法格式不正確。 請檢查您的請求,然後重試。 |
403 |
Forbidden |
您沒有資源的存取權。 |
404 |
Not Found |
找不到指定路徑的資源。 |
409 |
Conflict |
由於與資源狀態衝突,無法完成請求。 |
500 |
Server Error |
伺服器遇到錯誤,使其無法完成請求。 |