Come spostare i prodotti nel cestino in Zoho Desk

Lo spostamento dei prodotti nel cestino in Zoho Desk avviene tramite una singola chiamata API DELETE all'endpoint /api/v1/products, che trasferisce i prodotti selezionati nel cestino anziché eliminarli definitivamente.

Perché è importante

Quando hai bisogno di ritirare o riordinare i record di prodotto in Zoho Desk senza eliminarli in modo permanente, spostarli nel cestino ti offre una rete di sicurezza con possibilità di recupero. Questo è particolarmente utile durante le riorganizzazioni del catalogo o quando si dismettono prodotti che potrebbero essere ancora referenziati in ticket storici. Conoscere la corretta operazione API e gli scope OAuth necessari garantisce che la tua integrazione o automazione gestisca tutto in modo pulito.

Procedura passo dopo passo

Passaggio 1. Verifica che il tuo token OAuth includa lo scope corretto di Zoho Desk prima di effettuare qualsiasi chiamata API. Per le operazioni a livello di prodotto e impostazioni, il token deve coprire scope come Desk.settings.ALL o il permesso Desk.settings.DELETE pertinente. Senza lo scope corretto, la richiesta verrà rifiutata a livello di autorizzazione. ^[3]

Passaggio 2. Costruisci la tua richiesta DELETE puntando all'endpoint dei prodotti. L'operazione è deletemoveproductstotrash e il percorso base è:

DELETE /api/v1/products

Questo endpoint accetta un dizionario di parametri query opzionale (p) che puoi utilizzare per specificare quale prodotto o quali prodotti spostare. ^[1]

Passaggio 3. Passa i parametri di filtro o identificatore richiesti all'interno del dizionario p. Ad esempio, se stai utilizzando il wrapper client Python, la chiamata si presenta così:

result = client.delete_move_products_to_trash(p={"id": "your_product_id"})

Il metodo invia una richiesta DELETE a /api/v1/products con i tuoi parametri aggiunti come parametri query. ^[1]

Passaggio 4. Esamina la risposta API per confermare che l'operazione sia riuscita. Un'operazione di spostamento nel cestino andata a buon fine restituirà un oggetto di risposta che indica che i prodotti sono stati spostati. Se la risposta contiene un codice di errore, verifica la configurazione dello scope e i valori dei parametri prima di riprovare. ^[1]

Passaggio 5. Se stai lavorando in un'integrazione multi-prodotto che gestisce anche articoli o ticket, tieni presente che ogni tipo di entità ha il proprio endpoint dedicato per il cestino. Gli articoli utilizzano DELETE /api/v1/helpcenter/{helpcenter_id}/articles e i ticket utilizzano POST /api/v1/tickets/trash — si tratta di operazioni separate che non devono essere confuse con l'endpoint dei prodotti. ^{[2] [4]}

Errori comuni

• Scope OAuth mancanti o insufficienti. La causa più frequente di una richiesta fallita è un token privo dello scope Desk.settings.DELETE o Desk.settings.ALL necessario. Verifica sempre che la configurazione ZOHODESKSCOPES includa i permessi a livello di impostazioni prima di effettuare il deployment. ^[3]

• Confusione tra metodi HTTP per tipi di entità diversi. Lo spostamento dei prodotti nel cestino utilizza DELETE, mentre lo spostamento dei ticket nel cestino utilizza POST verso /api/v1/tickets/trash. Confondere il verbo HTTP o il percorso dell'endpoint comporterà un'operazione fallita o non intenzionale. ^{[1] [4]}

• Omissione del parametro p. Se non viene fornito alcun identificatore di prodotto nei parametri query, l'API potrebbe non sapere su quali record agire. Verifica sempre quali campi identificatori si aspetta l'endpoint e includili nel dizionario p. ^[1]

• Mancata corrispondenza del data center. Zoho Desk è disponibile su più data center (.com, .eu, .in, ecc.). Assicurati che il tuo URL base corrisponda al data center in cui è ospitata la tua organizzazione Desk, altrimenti le richieste falliranno o verranno instradate in modo errato. ^[5]

Cosa verificare

• Copertura degli scope: Verifica che il tuo token OAuth attivo includa Desk.settings.DELETE o Desk.settings.ALL e che il token non sia scaduto. ^[3]
• Endpoint e metodo corretti: Conferma di stare chiamando DELETE /api/v1/products — non gli endpoint del cestino per articoli o ticket — e che gli identificatori di prodotto vengano passati nel parametro p. ^[1]
• Validazione della risposta: Dopo la chiamata, controlla la risposta API per verificare uno stato di successo e conferma che il prodotto non compaia più nell'elenco dei prodotti attivi (dovrebbe ora trovarsi nel cestino, recuperabile se necessario). ^[1]

---

*Beam Help è una risorsa di supporto esperto indipendente per gli utenti Zoho — non siamo il supporto ufficiale Zoho. Per problemi a livello di piattaforma o domande sulla fatturazione, contatta direttamente Zoho.*