Come eliminare un allegato di prodotto in Zoho Desk

L'eliminazione di un allegato di prodotto in Zoho Desk avviene tramite una singola chiamata API DELETE che individua il prodotto e l'allegato specifici tramite i rispettivi ID. Questo articolo ti guida attraverso l'endpoint, i parametri richiesti e uno snippet Python pronto all'uso.

Perché è importante

Quando gestisci il catalogo prodotti in Zoho Desk, file obsoleti o errati allegati a un record di prodotto possono creare confusione sia per gli agenti che per i clienti. Rimuovere gli allegati non aggiornati in modo programmatico è essenziale per i team che automatizzano la manutenzione del catalogo o integrano Zoho Desk con sistemi esterni. Conoscere l'endpoint corretto ti aiuta inoltre a evitare di eliminare accidentalmente allegati da ticket, attività o altri tipi di record — ognuno dei quali utilizza un percorso API diverso.

> Nota: Beam Help è una risorsa di supporto esperto indipendente, non il supporto ufficiale di Zoho.

---

Procedura passo dopo passo

Passaggio 1. Identifica il tuo productId e attachmentId.

Prima di effettuare qualsiasi chiamata API, hai bisogno di due informazioni: l'identificatore univoco del record di prodotto (productId) e l'identificatore univoco del file allegato (attachmentId). Entrambi sono stringhe. Puoi recuperarli dall'interfaccia di Zoho Desk o interrogando prima l'API dei prodotti. ^[1]

Passaggio 2. Costruisci la richiesta DELETE.

L'endpoint per rimuovere un allegato di prodotto segue questo schema:

DELETE /api/v1/products/{productId}/attachments/{attachmentId}

Sostituisci {productId} e {attachmentId} con i valori stringa effettivi raccolti nel Passaggio 1. ^[1]

Passaggio 3. Autenticati e invia la richiesta.

L'API di Zoho Desk richiede un token OAuth 2.0 valido nell'intestazione Authorization. Una volta inserito il token, esegui la richiesta DELETE. Non è necessario alcun corpo della richiesta — la risorsa è completamente identificata dal percorso URL. ^[1]

Passaggio 4. Usa l'helper Python (facoltativo).

Se la tua integrazione è basata su Python, la chiamata corrisponde al metodo deleteanattachment mostrato di seguito. Passa i tuoi ID come stringhe e, facoltativamente, fornisci un dizionario p per eventuali parametri di query aggiuntivi richiesti dalla tua configurazione: ^[1]

def delete_an_attachment(self, productId: str, attachmentId: str, p: dict = None):
    """Delete an Attachment from a product record"""
    return self.c.request(
        "DELETE",
        f"/api/v1/products/{productId}/attachments/{attachmentId}",
        p,
        None
    )

Chiamalo in questo modo:

result = client.delete_an_attachment(
    productId="123456789",
    attachmentId="987654321"
)

Passaggio 5. Conferma l'eliminazione.

Una risposta positiva restituirà in genere uno stato HTTP 200 o 204 senza corpo, indicando che l'allegato è stato rimosso. Se ricevi un errore, consulta la sezione di risoluzione dei problemi di seguito. ^[1]

---

Errori comuni

• Endpoint errato per il tipo di record. Zoho Desk espone endpoint separati per l'eliminazione degli allegati relativi a ticket (/api/v1/tickets/{ticketId}/attachments/{attachmentId}), account (/api/v1/accounts/{accountId}/attachments/{attachmentId}), attività (/api/v1/tasks/{taskId}/attachments/{attachmentId}), thread di ticket (/api/v1/tickets/{ticketid}/threads/{threadid}/attachments/{attachment_id}), bozze di transizione dei ticket e articoli dell'Help Center. [^2,3,4,5,6,7,8] Utilizzare un endpoint per allegati di ticket su un ID prodotto — o viceversa — restituirà un errore di risorsa non trovata. Verifica sempre di puntare a /api/v1/products/… quando lavori con i record di prodotto. ^[1]

• ID invertiti. Il productId e l'attachmentId devono comparire nelle posizioni corrette nel percorso URL. Invertirli causerà il fallimento della richiesta o, nel peggiore dei casi, potrebbe puntare a una risorsa non desiderata. ^[1]

• Token OAuth scaduto o mancante. Il verbo DELETE richiede la stessa sessione autenticata di qualsiasi altra chiamata API di Zoho Desk. Assicurati che il token non sia scaduto e che lo scope OAuth associato copra la gestione dei record di prodotto. ^[1]

---

Cosa verificare

• Segmenti del percorso corretti: Verifica che l'URL sia /api/v1/products/{productId}/attachments/{attachmentId} — e non una variante per ticket, attività o account — prima di eseguire la chiamata. ^[1]
• ID validi: Conferma che sia il productId che l'attachmentId esistano nel tuo portale Zoho Desk confrontandoli con il record di prodotto nell'interfaccia utente o tramite una precedente richiesta GET. ^[1]
• Stato della risposta HTTP: Una risposta 200 o 204 conferma il successo; un 404 indica che uno o entrambi gli ID non sono stati trovati, mentre un 401/403 segnala un problema di autenticazione o di permessi. ^[1]