Carica una risorsa immagine raster

Ultimo aggiornamento: 2023-11-06
  • Creato per:
  • Intermediate
    User

Prima di poter caricare una risorsa immagine o vettoriale, richiedete una chiave segreta condivisa. Usate questa chiave segreta condivisa per ottenere un token di caricamento Quindi utilizzi il token di caricamento per caricare le risorse di immagini raster.

IMPORTANTE

A partire dal 1° maggio 2023, le risorse UGC in Dynamic Medie saranno disponibili per l’uso fino a 60 giorni dalla data di caricamento. Dopo 60 giorni, le risorse verranno rimosse.

NOTA

Il supporto per risorse vettoriali UGC nuove o esistenti in Adobe Dynamic Media Classic è terminato il 30 settembre 2021.

Richiedi una chiave con segreto condiviso

Richiedi chiave shared-secret da utilizzo dell’Admin Console per creare un caso di supporto. Nel tuo caso di supporto, richiedi una chiave con segreto condiviso.

Nel messaggio e-mail, fornite il nome della società che desiderate usare per caricare le risorse immagine. Dopo aver ricevuto la chiave da Adobe Dynamic Media Classic, salvarla localmente per utilizzarla in futuro.

Recuperare il token di caricamento

L’utilizzo di un token di caricamento fa sì che nessuno debba usare la chiave segreta condivisa per caricare le risorse. Garantisce inoltre la legittimità del caricamento e la provenienza da una fonte affidabile.

Il token di caricamento è una stringa alfanumerica disponibile solo per un periodo di tempo limitato. Utilizza i seguenti URL, sostituendo la chiave con segreto condiviso, in modo da poter recuperare il token di caricamento.

  • Immagine raster
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602In questo esempio, la chiave shared-secret è fece4b21-87ee-47fc-9b99-2e29b78b602

Per impostazione predefinita, il token di caricamento scade cinque minuti (300 secondi) dopo averlo ottenuto. Per richiedere più tempo, includete nell’URL il parametro expires e il tempo desiderato, in secondi. Ad esempio, con il seguente URL immagine di esempio si ottiene un token di caricamento che sarà valido per 1800 secondi:

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

La risposta corretta per le immagini è simile alla seguente:

<?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>

Salvate localmente il token di caricamento per poterlo usare per richieste future.

Per ottenere un token di caricamento, potete usare i seguenti campi nella stringa URL di richiesta:

Parametro URL Richiesto o facoltativo Valore
op Obbligatorio get_uploadtoken
shared_secret Obbligatorio Chiave segreta condivisa della società che esegue il caricamento.
expires Facoltativo Validità del token di caricamento, in secondi. Se non viene specificato, viene applicato il valore predefinito di 300 secondi.

URL immagine raster di esempio:

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

Metodi HTTP consentiti:
GET e POST

Ora potete caricare una risorsa immagine.

Consulta Caricare una risorsa immagine.

Carica una risorsa immagine raster

Dopo aver recuperato un token di caricamento valido per un periodo di tempo specificato, potete caricare una risorsa immagine. Potete caricare la risorsa come POST multiparte o modulo e inviare gli altri valori come una stringa di richiesta URL, come nell’esempio di seguito:

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

Il upload_token e company_name sono obbligatori.

Consulta Recuperare il token di caricamento.

Consulta Recuperare una chiave con segreto condiviso.

Potete anche inviare altri valori facoltativi come stringhe di richiesta URL, come nell’esempio di seguito:

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

Il file_limit parametro specifica il limite di dimensione file in byte. Il parametro file_exts specifica le estensioni del nome file consentite per il caricamento. Entrambi questi valori sono facoltativi.

Nell’applicazione è possibile impostare un limite globale per la dimensione dei nomi file e le estensioni di file consentite. Se l’elemento inviato nella richiesta è un sottoinsieme dei limiti globali, viene rispettato. I limiti globali sono indicati di seguito:

Limite globale Valore
Dimensione file per tutti i client 20 MB
Formati file immagine supportati per il caricamento BMP, GIF, JPG, PNG, PSD, TIFF

Il seguente modulo HTML consente a un utente di caricare una risorsa. Il modulo richiede l’inserimento delle informazioni di seguito:

  • Nome società.
  • Token di caricamento.
  • Limite dimensione file.
  • Elenco di estensione di nomi file.
  • Specifica se mantenere il profilo colore e il nome file associati alla risorsa.
  • Se utilizzare Knockout Background. Se attivate Sfondo foratura (Knockout Background), impostate i metodi Angolo (Corner), Tolleranza (Tolerance) e Riempimento (Fill).
    Consulta Foratura sfondo in Opzioni di ottimizzazione immagine al caricamento.
  • Nome del file da caricare.

Puoi visualizzare il codice sorgente HTML associato al modulo precedente selezionando https://s7ugc1.scene7.com/ugc/upload.html

In Firefox, fai clic con il pulsante destro del mouse nella finestra del browser, quindi seleziona Visualizza origine pagina. Il codice mostra la stringa di query URL corrispondente e il metodo POST eseguito quando l’utente seleziona Invia.

Per visualizzare la risposta XML in Internet Explorer, vai a Visualizza > Sorgente. Per visualizzare la risposta XML in Firefox, vai a Strumenti > Strumenti browser > Strumenti per sviluppatori Web. Per la visualizzazione delle risposte XML si consiglia Firefox.

Segue un esempio di risposta a seguito di un caricamento riuscito:

<?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>
NOTA

la risorsa caricata (JPG, GIF è così via) viene convertita in formato PTIFF e la risposta invia un collegamento diretto a tale risorsa PTIFF.

La risorsa è come qualsiasi altra risorsa Image Server ed è possibile applicarvi delle query di elaborazione. Ad esempio, con l’URL seguente viene richiesto di ingrandire la risorsa in base alla larghezza e all’altezza specificate.

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

Inviate la risorsa come POST multiparte o modulo mentre inviate gli altri valori come una stringa query URL. Nella stringa query URL potete usare i seguenti campi per caricare una risorsa:

Parametro URL Obbligatorio o facoltativo Valore
op Obbligatorio upload
upload_token Obbligatorio Token di caricamento per la chiave segreta condivisa associata alla società.
company_name Obbligatorio Nome della società che esegue il caricamento.
file_limit Facoltativo Limite dimensione file in byte per la risorsa.
file_exts Facoltativo Elenco di estensioni consentite per il file della risorsa immagine.
preserve_colorprofile Facoltativo Mantiene eventuale profilo colore incorporato durante la conversione in formato PTIFF del file caricato. I valori consentiti sono true o false. Il valore predefinito è false…
preserve_filename Facoltativo Mantiene il nome file della risorsa caricata. I valori consentiti sono true o false. Il valore predefinito è false…
NOTA

dovete inviare la risorsa da caricare come unico campo in una richiesta POST multiparte.

URL campione:

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

Metodo HTTP consentito:

POST

Ottieni metadati risorsa per immagini

Per ottenere i metadati di una risorsa caricata, potete usare image_info, come illustrato nell’esempio di seguito:

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

Un esempio di risposta corretta è simile al seguente:

<?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>

Nella stringa query URL potete usare i seguenti campi per richiedere informazioni su una risorsa:

Parametro URL Richiesto o facoltativo Valore
op Obbligatorio image_info
shared_secret Obbligatorio Chiave segreta condivisa della società.
image_name Obbligatorio Nome dell’immagine.

URL campione:

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

Metodo HTTP consentito:

GET e POST

In questa pagina