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

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

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 參數
必要或選擇性
op
必要
get_uploadtoken
sharedsecret
必要
正在進行上載的公司共用密鑰。
過期
選擇性
上載標記有效的秒數。若未指定,預設值為300秒。

點陣化影像URL範例:

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

允許的HTTP方法:
GETPOST

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

請參閱上傳影像資產

上傳點陣化影像資產 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_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 表單上載資產。表單要求使用者輸入以下資訊:

  • 公司名稱。
  • 上傳權杖。
  • 檔案大小限制。
  • 副檔名清單。
  • 是否要保留與資產關聯的色彩設定檔和檔案名稱。
  • 是否使用「去底色背景」。 如果您啟用「去底色背景」,請設定「轉角」、「公差」和「填色方法」。
    在上傳🔗檢視影像微調選項中的「去底色背景」。
  • 要上傳的檔案名稱。

您可以選取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