上傳點陣影像資產

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

重要

Adobe Dynamic Media Classic中對新或現有UGC向量資產的支援已於2021年9月30日終止。

請求共用機密金鑰

使用Admin Console建立支援案例,透過請求​共用機密金鑰 在您的支援案例中,請求共用機密金鑰。

在電子郵件中,請提供想要用於上載影像資產的公司名稱。從AdobeDynamic Media Classic收到金鑰後,請將金鑰儲存在本機,以供日後使用。

擷取上傳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 參數 必要或選擇性
op 必要 get_uploadtoken
shared_secret 必要 正在進行上載的公司共用密鑰。
expires 選擇性 上載標記有效的秒數。如果不指定,則預設為 300 秒鐘。

點陣影像URL範例:

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

允許的HTTP方法:
GETPOST

您現在可以上載影像資產。

請參閱上傳影像資產

上傳點陣影像資產

您擷取在指定時間內有效的上載標記後,即可上載影像資產。以 multipart/form post 形式上載資產,以 URL 查詢字串形式傳送值的其餘部分,如以下範例中所示:

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

upload_tokencompany_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 表單上載資產。表單要求使用者輸入以下資訊:

  • 公司名稱.
  • 上載標記.
  • 檔案大小限制.
  • 檔案副檔名的清單.
  • 是否保留與資產相關聯的顏色設定檔和檔案名稱。
  • 是否使用挖空背景。 如果啟用「挖空背景」,請設定「拐角」(Corner)、「公差」(Tolerance)和「填充」(Fill)方法。
    請參閱上傳🔗時的影像微調選項中的挖空背景。
  • 待上載檔案的名稱.

您可以選取https://s7ugc1.scene7.com/ugc/upload.html來檢視與上述表單相關聯的HTML原始碼

在Firefox中,在瀏覽器視窗中按一下滑鼠右鍵,然後選取​檢視頁面來源。 代碼顯示當使用者按一下「送出」時執行的對應 URL 查詢字串和 POST 方式。

要在Internet Explorer中查看XML響應,請轉至​View > 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>
注意

上載的資產 (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。
注意

須將待上載資產作為 multipart POST 要求中的唯一欄位傳送。

範例 URL:

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

允許的 HTTP 方式:

POST

取得影像的資產中繼資料

您可以使用 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

本頁內容