文档Dynamic Media Classic指南

上传栅格图像资产 uploading-an-image-asset-or-a-vector-asset

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 中级
  • 用户

在上载图像资源之前，必须先请求一个共享密钥。可以使用该共享密钥检索上载令牌。然后，使用上传令牌上传光栅图像资产。

IMPORTANT
从2023年5月1日开始，Dynamic Media中的UGC资源最多可在上传日期起60天内使用。 60天后，将删除资源。
NOTE
对Adobe Dynamic Media Classic中新增或现有UGC矢量资源的支持已于2021年9月30日终止。

请求共享密钥 requesting-a-shared-secret-key

使用Admin Console创建支持案例，由请求​ 共享密钥。在技术支持案例中，请求共享密钥。

在电子邮件中，请提供要用于上载图像资源的公司名称。从Adobe Dynamic Media Classic收到密钥后，请将其本地保存以供将来使用。

检索上传令牌 retrieving-the-upload-token

上载令牌 ​可确保他人不能使用相同的共享密钥来上载资源。它可确保上载合法且来自信任的来源。

上载令牌是字母数字字符串，只能在特定时间段内使用。使用以下URL替换您的共享密钥，以便您可以检索上载令牌。

  • 栅格图像
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602在此示例中，共享密钥为fece4b21-87ee-47fc-9b99-2e29b78b602

默认情况下，上载令牌在您检索到它之后 5 分钟（300 秒）便到期。若要请求更多时间，请在URL中包含expires，并指定您需要的时间（以秒为单位）。 例如，以下示例图像 URL 检索有效期为 1800 秒的上载令牌：

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

图像的成功响应类似于以下内容：

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
        <serviceName>User Generated Content: Images</serviceName>
        <version>1.0.0</version>
        <operationName>get_uploadtoken</operationName>
        <serviceStatus>SUCCESS</serviceStatus>
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
        <message>
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
            <expiration_in_seconds>1800</expiration_in_seconds>
        </message>
        </response>
    </user_generated_content>
</scene7>

将上载令牌保存到本地，以备以后请求时使用。

您可以在查询 URL 字符串中使用以下字段来检索上载令牌：

URL 参数
必需或可选
值
操作
必需
get_uploadtoken
共享密钥
必需
正在进行上载的公司的共享密钥。
过期
可选
上载令牌有效的秒数。如果未指定，则默认为300秒。

光栅图像URL示例：

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

允许的HTTP方法：
GET和POST

您现在可以上载图像资源。

请参阅上传图像资产。

上传栅格图像资产 uploading-an-image-asset

您检索到在特定时间内有效的上载令牌后，即可上载图像资源。以 multipart/form post 形式上载资源，而值的其余部分以 URL 查询字符串形式发送，如以下示例中所示：

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

upload_token和company_name字段为必填项。

请参阅检索上载令牌。

请参阅检索共享密钥。

您还能以 URL 查询字符串的形式发送其他可选值，如以下示例所示：

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif

file_limit参数以字节为单位指定文件大小限制。 file_exts参数指定允许上传的文件扩展名。 这两个值都是可选的。

对于允许的文件大小限制和文件扩展名，在应用程序中设置全局限制。如果您在请求中发送的内容是全局限制的子集，则表示同意。 全局限制如下所示：

全局限制
值
所有客户端的文件大小
20 MB
用于上载的支持的图像文件格式
BMP，GIF，JPG， PNG，PSD，TIFF

用户可通过下面的 HTML 表单上载资源。表单要求用户输入以下信息：

  • 公司名称。
  • 上载令牌。
  • 文件大小限制。
  • 文件扩展名的列表。
  • 是否保留与资源关联的颜色配置文件和文件名。
  • 是否使用挖空背景。 如果启用“挖空背景”，请设置“拐角”、“公差”和“填充方法”。
    在上传🔗处查看图像微调选项中的“挖空背景”。
  • 要上传的文件的名称。

您可以通过选择https://s7ugc1.scene7.com/ugc/upload.html来查看与上述表单相关联的HTML源代码

在Firefox中，右键单击浏览器窗口，然后选择​ 查看页面Source。 代码显示相应的URL查询字符串以及用户选择​ 提交 ​时运行的POST方法。

若要在Internet Explorer中查看XML响应，请转到​ 查看 > Source。 若要在Firefox中查看XML响应，请转到​ 工具 > 浏览器工具 > Web开发人员工具。 建议使用 Firefox 查看 XML 响应。

下面是成功上载的示例响应：

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content: Images</serviceName>
            <version>1.0.0</version>
            <operationName>upload</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>Your file has been uploaded Successfully.</title>
            <message>
            <url>https://s7w2p1.scene7.com/is/image/ </url>
            <path>000Company/ugc/1442564.tif</path>
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
            </message>
        </response>
    </user_generated_content>
</scene7>
NOTE
上载的资源（JPG、GIF 等）转换为 PTIFF 格式，响应向该 PTIFF 资源发送直接链接。

该资源类似于任何其他的图像服务资源；您可以对其应用处理查询。例如，以下URL请求已拉伸到指定宽度和高度的资产。

https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

以 multipart/form post 形式发送要上载的资源，而值的其余部分以 URL 查询字符串形式发送。您可以在 URL 查询字符串中使用以下字段来上载资源：

URL 参数
必需或可选
值
op
必需
上载
upload_token
必需
上载与公司关联的共享密钥的令牌。
company_name
必需
执行上载的公司的名称。
file_limit
可选
资源的文件大小限制（以字节为单位）。
file_exts
可选
图像资源文件容许扩展名的列表。
preserve_colorprofile
可选
用于在将上载文件转换成 PTIFF 格式时保留任何嵌入的颜色配置文件。可能的值为 true 或 false。默认值为 false。
preserve_filename
可选
保留所上载资源的文件名。可能的值为 true 或 false。默认值为 false。
NOTE
须将待上载资源作为 multipart POST 请求中的唯一字段发送。

示例 URL：

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

允许的 HTTP 方法：

POST

获取图像的资源元数据 getting-asset-metadata-for-images

您可以使用image_info检索您上传的资源的元数据，如以下示例所示：

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

成功响应的示例如下所示：

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content: Images</serviceName>
            <version>1.0.0</version>
            <operationName>image_info</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>More information on 1442564.tif</title>
            <message>
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
            <imageFormat>Tiff</imageFormat>
            <colorSpace>Rgb</colorSpace>
            <width>686</width>
            <height>457</height>
            </message>
        </response>
    </user_generated_content>
</scene7>

您可以在 URL 查询字符串中使用以下字段请求有关资源的信息：

URL 参数
必需或可选
值
op
必需
image_info
shared_secret
必需
公司的共享密钥。
image_name
必需
图像的名称。

示例 URL：

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

允许的 HTTP 方法：

GET 和 POST

recommendation-more-help
ba789e76-bace-4e0e-bd26-52691fb2cb26