Caricamento in blocco e migrazione di cataloghi estesi

Aggiornato a luglio 2026.

Per migrare o caricare un catalogo esteso, usa gli strumenti di caricamento in blocco di LabelGrid: l’integrazione API per flussi di lavoro automatizzati e personalizzati, oppure l’import DDEX per feed standard del settore e migrazioni su scala di distributore. Entrambi sono disponibili sui piani con accesso API attivo. Riutilizza gli stessi ISRC e UPC con metadati corrispondenti per conservare ascolti e playlist. Questa guida illustra entrambi i metodi e come spostare in sicurezza un catalogo su scala di distributore.

Per la migrazione passo passo da un altro distributore, a qualsiasi scala, vedi Trasferire il tuo catalogo.

Metodi di caricamento in blocco

Opzioni disponibili

Metodo	Ideale per	Piano richiesto
Integrazione API	Flussi automatizzati, integrazioni personalizzate	Piani con accesso API attivo
Import DDEX	Feed standard del settore, flussi delle major	Piani Enterprise / API (contatta l’assistenza)

Nota

I metodi di caricamento in blocco sono disponibili sui piani con accesso API attivo. Se il tuo piano non include l’accesso API, puoi creare le release una alla volta dalla dashboard di LabelGrid oppure contattare l’assistenza per valutare l’attivazione dell’accesso API.

---

Integrazione API

Panoramica

L’API di LabelGrid ti permette di creare e gestire le release in modo programmatico, così puoi automatizzare completamente i flussi di lavoro per i cataloghi estesi.

Cosa puoi fare

• Creare release in modo programmatico
• Caricare file audio tramite API
• Gestire i metadati in blocco
• Automatizzare i flussi di distribuzione
• Integrarti con i tuoi sistemi esistenti

Come iniziare

1. Attiva l’accesso API sul tuo piano — contatta l’assistenza se non è già attivo
2. Genera le credenziali API nelle impostazioni del tuo account
3. Consulta la documentazione API per i dettagli sugli endpoint
4. Realizza la tua integrazione oppure usa i nostri SDK
5. Fai le prove nell’ambiente di staging prima della produzione

Esempio di richiesta

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

Registrare il tuo distributore precedente

Quando migri release già live altrove, l’API pubblica Releases accetta un campo opzionale transfer_from_distributor (testo libero, fino a 255 caratteri) per registrare il distributore da cui ti stai spostando. Diventa di sola lettura una volta distribuita la release, quindi impostalo prima dell’invio o al momento dell’invio.

Vantaggi dell’API

• Automazione completa - Nessun intervento manuale necessario
• Integrazione con i sistemi - Collega il tuo DAM, CRM o altri strumenti
• Release programmate - Metti in coda le release per una distribuzione futura
• Convalida personalizzata - Verifica i contenuti prima dell’invio
• Notifiche webhook - Ricevi aggiornamenti in tempo reale sullo stato della consegna
• Gestione degli errori - Rilevamento e nuovo tentativo degli errori in modo programmatico

Limiti di frequenza

L’API prevede limiti di frequenza per garantire la stabilità del sistema. Vedi la Panoramica dell’API per i dettagli aggiornati sui limiti di frequenza.

Vedi la Panoramica dell’API per la documentazione completa.

---

Import DDEX

Panoramica

DDEX (Digital Data Exchange) è il formato standard del settore usato dalle major per consegnare i contenuti ai distributori. LabelGrid supporta l’import DDEX per i clienti enterprise che dispongono già di un’infrastruttura di consegna DDEX.

Cos’è DDEX?

DDEX è uno standard basato su XML che raccoglie in un unico pacchetto:

• Metadati della release
• Informazioni sulle tracce
• Riferimenti ai file audio
• Copertine e asset
• Condizioni contrattuali e territori

Formati supportati

Versione	Stato
ERN 4.3.2	Supportato (consigliato)
ERN 4.3.1	Supportato
ERN 4.3.0	Supportato
ERN 3.8.2	Supportato (legacy)

Procedura di configurazione DDEX

1. Contatta l’assistenza per richiedere l’attivazione di DDEX
2. Completa l’onboarding con il nostro team tecnico
3. Configura le impostazioni di consegna e i percorsi dei file
4. Imposta le credenziali SFTP per il trasferimento sicuro dei file
5. Invia una consegna di prova per la convalida
6. Avvia le consegne di produzione una volta approvato

Flusso di consegna

Il tuo sistema → XML DDEX + asset → Upload SFTP → Elaborazione LabelGrid → Distribuzione

Requisiti DDEX

Requisito	Dettagli
Piano	Accesso API attivo (contatta l’assistenza)
Formato	ERN 4.3.2 preferito (supportati anche 4.3.1, 4.3.0 e 3.8.2)
Consegna	Solo SFTP
Asset	File audio inclusi o referenziati
Convalida	Consigliata la convalida preliminare

Quando usare DDEX

L’import DDEX è la scelta ideale se:

• Disponi già di un’infrastruttura di consegna DDEX
• Stai migrando da un altro distributore che usa DDEX
• Il tuo sistema di gestione dei contenuti esporta DDEX in modo nativo
• Sei una major o un grande indipendente con flussi di lavoro consolidati

Quando usare invece l’API

L’API REST/JSON è più adatta se:

• Stai realizzando una nuova integrazione da zero
• Preferisci le moderne API web all’XML
• Ti serve una comunicazione bidirezionale in tempo reale
• Vuoi le notifiche tramite webhook

---

Come scegliere il metodo

Fattore	Integrazione API	Import DDEX
Complessità di configurazione	Minore	Maggiore
Infrastruttura esistente	Da costruire	Usa il DDEX esistente
Formato	JSON	XML
Metodo di consegna	HTTPS	SFTP
Aggiornamenti in tempo reale	Sì (webhook)	Richiede polling
Ideale per	Nuove integrazioni	Migrazione enterprise

---

Tempi di elaborazione

Una volta caricati i contenuti via API o DDEX, il tempo di elaborazione dipende da:

• Numero di release e tracce
• Dimensioni dei file audio
• Complessità dei metadati
• Carico di lavoro del sistema al momento

I cataloghi più estesi richiedono naturalmente più tempo per l’elaborazione. Contatta l’assistenza se ti servono indicazioni sui tempi previsti per la dimensione del tuo catalogo.

---

Limiti di invio per le grandi migrazioni

Le grandi migrazioni possono raggiungere un limite di invio a scorrimento che conta anche gli import via API e DDEX — vedi Limiti di catalogo e release per capire come funziona. Prima di una grande migrazione una tantum, contatta l’assistenza così predisponiamo una finestra di deroga temporanea invece di farti raggiungere il limite a metà migrazione.

Verifica che tutte le tracce siano state importate

Dopo un import in blocco o via DDEX, conferma che ogni traccia sia stata importata correttamente prima di distribuire.

---

FAQ

”Come faccio a migrare un catalogo esteso su LabelGrid?”

Usa il caricamento in blocco: l’integrazione API (per flussi di lavoro automatizzati e personalizzati) o l’import DDEX (per feed standard del settore e migrazioni su scala di distributore). Entrambi richiedono l’accesso API attivo sul tuo piano. Riutilizza gli stessi ISRC e UPC con metadati perfettamente corrispondenti, così le DSP conservano i tuoi ascolti, i salvataggi e le playlist, e carica su LabelGrid prima di rimuovere il catalogo dal vecchio distributore.

”LabelGrid può importare il mio catalogo via DDEX?”

Sì. LabelGrid supporta l’import DDEX (ERN 4.3.2 consigliato; supportati anche 4.3.1, 4.3.0 e 3.8.2) tramite SFTP per i clienti che dispongono già di un’infrastruttura di consegna DDEX. Contatta l’assistenza per attivarlo. LabelGrid supporta lo standard DDEX ma non è membro del consorzio DDEX.

”Quali versioni ERN di DDEX supporta LabelGrid?”

LabelGrid supporta DDEX ERN 3.8.2, 4.3.0, 4.3.1 e 4.3.2, con la versione 4.3.2 consigliata per le nuove consegne. LabelGrid supporta questi standard e non è membro del consorzio DDEX.

”I miei ascolti e le playlist si conservano quando migro un catalogo esteso?”

Sì, se riutilizzi gli stessi ISRC e UPC con metadati perfettamente corrispondenti. Le DSP abbinano i contenuti tramite ISRC e UPC, quindi codici e metadati identici permettono di unire il tuo catalogo alle release esistenti e di conservare la cronologia degli ascolti, i salvataggi e i posizionamenti in playlist.

”Quali sono i limiti di invio per una grande migrazione una tantum?”

Le grandi migrazioni rientrano in un limite di invio a scorrimento che include anche gli import via API e DDEX. Prima di una grande migrazione, contatta l’assistenza per predisporre una finestra di deroga temporanea ed evitare di raggiungere il limite a metà migrazione.

---

Correlati

Gestisci un catalogo esteso? Vedi la gestione del catalogo sul nostro sito per scoprire come LabelGrid mantiene ordinate le tue release su larga scala. Vedi anche Trasferire il tuo catalogo.

---

Serve aiuto?

Per assistenza nella configurazione del caricamento in blocco:

• Integrazione API: vedi la Panoramica dell’API o contatta l’assistenza
• Attivazione DDEX: contatta il nostro team di assistenza con i tuoi requisiti

Il nostro team può aiutarti a scegliere il metodo giusto e ad accompagnarti nella configurazione.