Come eliminare le impostazioni di monitoraggio del tempo in Zoho Desk

L'eliminazione delle impostazioni di monitoraggio del tempo in Zoho Desk avviene tramite una singola chiamata API DELETE all'endpoint delle impostazioni di monitoraggio del tempo — non è necessario alcun corpo della richiesta, ad eccezione di eventuali parametri di query facoltativi.

Perché è importante

Se il tuo team di supporto ha configurato regole di monitoraggio del tempo che non sono più pertinenti — ad esempio, dopo un cambiamento del modello di fatturazione o una ristrutturazione dipartimentale — potresti dover eliminare completamente quelle impostazioni anziché semplicemente aggiornarle. Conoscere l'endpoint corretto e lo scope OAuth richiesto evita sprechi di tempo nel debug ed errori accidentali di autorizzazione. Questo è particolarmente utile per gli sviluppatori che automatizzano la gestione della configurazione di Zoho Desk tramite script o pipeline CI.

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 relativa alle impostazioni. Lo scope necessario è Desk.settings.DELETE (o il più ampio Desk.settings.ALL). Senza questo scope nel token, la richiesta verrà rifiutata a livello di autorizzazione. ^[2]

Passaggio 2. Assicurati che il tuo client sia inizializzato con un token di accesso valido e il corretto orgId per la tua organizzazione Zoho Desk. Se l'orgId è assente o non aggiornato, il livello API non può instradare la richiesta al portale corretto. Puoi recuperare l'ID della tua organizzazione chiamando l'endpoint dell'elenco delle organizzazioni e leggendo il campo id dal primo risultato. ^[7]

Passaggio 3. Invia una richiesta DELETE al seguente endpoint:

DELETE /api/v1/timetracking/settings

Non è necessario alcun corpo JSON. Puoi passare parametri di query facoltativi tramite il dizionario p se il tuo livello di integrazione lo supporta. ^[1]

Passaggio 4. Se stai utilizzando il wrapper Python che incapsula il client Zoho Desk, chiama il metodo come mostrato di seguito:

response = api.delete_time_track_settings(p=None)

Passa un dizionario a p solo se devi fornire parametri di query string; altrimenti None è accettabile. ^[1]

Passaggio 5. Controlla il codice di stato HTTP della risposta. Un'eliminazione riuscita restituirà uno stato 2xx. Se ricevi un errore 4xx, rivedi i tuoi scope OAuth (Passaggio 1) e la configurazione dell'orgId (Passaggio 2). Se ricevi un errore 5xx, il problema è lato server di Zoho Desk e potrebbe essere transitorio — riprova con un back-off esponenziale.

Passaggio 6. Se desideri modificare solo impostazioni specifiche del monitoraggio del tempo anziché rimuoverle completamente, utilizza PATCH /api/v1/timetracking/settings con un payload di dati. Questa è l'operazione di aggiornamento e accetta sia un corpo data che i parametri di query facoltativi p. ^[5]

Errori comuni

• Scope mancante: La causa più frequente di una risposta 403 Forbidden è un token OAuth generato senza Desk.settings.DELETE. Ri-autorizza il flusso OAuth e includi esplicitamente questo scope (o Desk.settings.ALL) nella stringa degli scope. ^[2][3]
• orgId errato o mancante: Zoho Desk supporta più organizzazioni. Se l'intestazione orgId è assente o errata, l'API non può identificare le impostazioni di quale portale eliminare. Scopri e salva sempre l'orgId dall'endpoint delle organizzazioni prima di effettuare chiamate alle impostazioni. ^[7]
• Confusione tra DELETE e PATCH: La chiamata DELETE rimuove la configurazione delle impostazioni di monitoraggio del tempo, mentre PATCH /api/v1/timetracking/settings la aggiorna. Assicurati di utilizzare il verbo corretto in base alle tue intenzioni. ^[1][5]

Cosa verificare

• Verifica dello scope: Conferma che Desk.settings.DELETE o Desk.settings.ALL sia presente nell'elenco degli scope del token OAuth attivo prima di eseguire la chiamata. ^[2]
• Presenza dell'orgId: Verifica che il tuo client Zoho Desk sia inizializzato con una stringa orgId non vuota, recuperata dall'endpoint delle organizzazioni se non è già memorizzata. ^[7]
• Stato della risposta: Dopo la chiamata DELETE, verifica che il codice di stato HTTP sia nell'intervallo 2xx per confermare che le impostazioni siano state rimosse con successo. ^[1]

---

*Beam Help fornisce supporto esperto indipendente per i prodotti Zoho. Non siamo il supporto ufficiale Zoho — per problemi a livello di piattaforma, ti invitiamo a contattare direttamente Zoho.*