搜索Assets API search-assets-api

AVAILABILITY
Dynamic Media with OpenAPI功能指南现在以PDF格式提供。 下载整个指南,并使用Adobe Acrobat AI Assistant来回答您的疑问。
[具有OpenAPI功能的Dynamic Media指南PDF]{class="badge informative"}

可以使用投放URL搜索Experience Manager资源存储库中可用的所有批准的资源,然后将其传递到集成的下游应用程序。

从Experience Manager存储库中搜索正确的已批准资源是使用投放URL交付资源的第一步。 对搜索请求的响应包括对应于满足搜索条件的资产的JSON文档数组。 每个JSON文档都使用id字段进行标识,该字段用于构成资产投放请求。

直接二进制上传协议概述

您可以在Search Assets API请求中定义属性以启用以下功能:

  • 全文搜索:使用match查询定义要搜索的文本。 您还可以使用match查询中的运算符来筛选结果。

  • 应用筛选器:使用term查询通过定义key和一个或多个值进一步筛选结果。 key标识其值必须匹配的字段,value表示要匹配的对象。 同样,您可以使用range查询通过“大于(gt)”、“大于或等于(gte)”、“小于(lt)”和“小于或等于(lte)”属性来定义字段的范围。

  • 排序结果:使用OrderBy属性根据一个或多个字段对搜索结果排序。 您可以按升序或降序对结果进行排序。

  • 分页:使用limitcursor属性在搜索API请求中定义分页属性。 limit属性定义API响应中要检索的最大项数。 cursor属性有助于检索limit属性中定义的下一组资源的起点。 例如,如果您在API请求中将50定义为限制,则可以使用cursor属性启动并使用下一个API请求检索接下来的50个项目。

搜索资产API端点 search-assets-api-endpoint

Search Assets API请求中的端点必须采用以下格式:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search

投放域的结构与Experience Manager创作环境的域类似。 唯一的区别是将术语author替换为delivery

pXXXX引用项目ID

eYYYY引用环境ID

搜索资产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