搜尋Assets API search-assets-api

AVAILABILITY
Dynamic Media搭配OpenAPI功能指南現在提供PDF格式。 下載整份指南,並使用Adobe Acrobat AI Assistant回答您的疑問。
[具有OpenAPI功能的Dynamic Media指南PDF]{class="badge informative"}

可以搜尋Experience Manager資產存放庫中可用的所有已核准資產,然後使用傳送URL傳送給整合的下游應用程式。

從Experience Manager存放庫搜尋正確的已核准資產,是使用傳送URL傳送資產的第一步。 對搜尋請求的回應包括對應於符合搜尋條件的資產的一系列JSON檔案。 每個JSON檔案都使用id欄位識別,該欄位用於構成資產傳遞請求。

直接二進位上傳通訊協定概觀

您可以在Search Assets API請求中定義屬性,以啟用下列功能:

  • 全文檢索搜尋:使用match查詢定義要搜尋的文字。 您也可以使用match查詢中的運運算元來篩選結果。

  • 套用篩選器:使用term查詢,定義一個key和一個或多個值,以進一步篩選結果。 key會識別其值必須相符的欄位,value代表要相符的欄位。 同樣地,您可以使用range查詢來定義欄位的範圍,其使用大於(gt)、大於或等於(gte)、小於(lt)以及小於或等於(lte)屬性。

  • 排序結果:使用OrderBy屬性,根據一或多個欄位來排序搜尋結果。 您可以依遞增或遞減順序來排序結果。

  • 分頁:使用limitcursor屬性,在Search API要求中定義分頁屬性。 limit屬性會定義API回應中要擷取的最大專案數。 cursor屬性有助於擷取limit屬性中定義之下一組資產的起點。 例如,如果您在API要求中將50定義為限制,您可以使用cursor屬性來開始,並使用下一個API要求擷取接下來的50個專案。

搜尋資產API端點 search-assets-api-endpoint

搜尋資產API請求中的端點必須採用以下格式:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search

傳遞網域的結構類似於Experience Manager作者環境的網域。 唯一的差異是以delivery取代字詞author

pXXXX參考方案識別碼

eYYYY參考環境識別碼

搜尋資產API要求方法 search-assets-api-request-method

POST

搜尋Assets API標頭 search-assets-api-header

在「搜尋資產API」中定義標題時,您必須提供下列詳細資料:

headers: {
      'Content-Type': 'application/json',
      'X-Adobe-Accept-Experimental': '1',
      Authorization: 'Bearer <YOUR_JWT_HERE>',
      'X-Api-Key': 'YOUR_API_KEY_HERE'
    },

若要叫用搜尋API,必須在Authorization詳細資料中定義IMS權杖。 IMS權杖是從技術帳戶中擷取。 請參閱擷取AEM as a Cloud Service認證以建立新的技術帳戶。 請參閱產生存取權杖以產生IMS權杖,並在搜尋資產API要求標頭中正確使用它。

若要檢視要求範例、回應範例和回應代碼,請參閱搜尋Assets API

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab