上傳點陣化影像資產 uploading-an-image-asset-or-a-vector-asset

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

主題：
Dynamic Media Classic

建立對象：

中繼
使用者

您必須先要求一個共用密鑰，然後才能上載影像資產。使用此共用密鑰來擷取上載標記。您接著可使用上傳權杖來上傳點陣影像資產。

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

sharedsecret

必要

正在進行上載的公司共用密鑰。

過期

選擇性

上載標記有效的秒數。若未指定，預設值為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查詢字串以及使用者選取 Submit 時所執行的POST方法。

若要在Internet Explorer中檢視XML回應，請移至檢視 > Source。若要在Firefox中檢視XML回應，請移至工具 > 瀏覽器工具 > 網頁開發人員工具。建議使用 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