Come recuperare le regole di condivisione dati in Zoho

Recuperare le regole di condivisione dati in Zoho CRM e Zoho Desk è semplice tramite endpoint API dedicati — puoi ottenere l'elenco completo delle regole oppure una singola regola tramite il suo ID, a seconda del caso d'uso.

Perché è importante

Le regole di condivisione dati controllano quali record sono visibili tra ruoli e territori nella tua organizzazione Zoho. Verificare o ispezionare queste regole in modo programmatico è essenziale quando si aggiungono nuovi utenti, si risolvono problemi di visibilità o si automatizzano controlli di governance. In qualità di supporto esperto indipendente (Beam Help — non supporto ufficiale Zoho), illustriamo di seguito entrambi gli approcci per CRM e Desk.

Procedura passo dopo passo

Passaggio 1. Autenticati e ottieni un token di accesso.

Prima di chiamare qualsiasi endpoint delle impostazioni, la tua integrazione deve disporre di un token di accesso OAuth valido. Il token viene recuperato tramite il flusso OAuth di Zoho e scade dopo il periodo specificato nel campo expiresin della risposta del token (in genere 3600 secondi). Salva il valore accesstoken e aggiornalo prima che scada. ^[4]

Passaggio 2. Recupera tutte le regole di condivisione dati in Zoho CRM.

Invia una richiesta GET all'endpoint /settings/datasharingrules. Questo restituisce l'intera raccolta di regole di condivisione dati configurate per la tua organizzazione CRM. Non sono richiesti parametri di percorso aggiuntivi. ^[2]

# Example call
response = client.get_data_sharing_rules()

Includi l'intestazione Authorization: Bearer <access_token> in ogni richiesta. ^[4]

Passaggio 3. Recupera una singola regola di condivisione dati tramite ID in Zoho CRM.

Quando hai bisogno dei dettagli di una sola regola specifica, aggiungi l'identificatore della regola al percorso: /settings/datasharingrules/{ruleid}. Sostituisci {ruleid} con la stringa ID effettiva della regola che desideri ispezionare. ^[1]

# Example call
response = client.get_data_sharing_rule(rule_id="your_rule_id_here")

Questa chiamata mirata è più efficiente rispetto al recupero dell'elenco completo quando conosci già l'identificatore della regola. ^[1]

Passaggio 4. Recupera la documentazione sulla gestione delle regole di condivisione dati in Zoho Desk.

Per gli ambienti Zoho Desk, l'endpoint pertinente è GET /api/v1/doc/datasharingrulesmanagemen. Questo endpoint accetta un parametro opzionale p per scopi di paginazione o filtraggio. ^[3]

# Example call
response = client.get_data_sharing_rules_management(p={"page": 1})

Assicurati che il token OAuth di Desk includa lo scope Desk.settings.READ appropriato prima di effettuare questa chiamata. ^[7]

Passaggio 5. Verifica che gli scope OAuth coprano l'accesso alle impostazioni.

Per Zoho CRM, il token deve includere ZohoCRM.org.ALL o uno scope equivalente a livello di organizzazione per leggere le risorse delle impostazioni. Per Zoho Desk, lo scope richiesto è Desk.settings.READ (o Desk.settings.ALL). Senza questi scope, l'API restituirà un errore di autorizzazione anziché i dati delle regole. ^[7]

Errori comuni

• Token assente o scaduto. Se la chiave accesstoken è assente dalla risposta OAuth, l'integrazione restituirà un errore anziché procedere. Verifica sempre che accesstoken sia presente nel payload del token prima di effettuare chiamate successive. ^[4]

• Endpoint errato per il prodotto. L'endpoint delle regole CRM (/settings/datasharingrules) e l'endpoint delle regole Desk (/api/v1/doc/datasharingrulesmanagemen) sono distinti. Inviare un token con scope CRM all'endpoint Desk — o viceversa — produrrà un errore di autenticazione o di risorsa non trovata. ^[1][2][3]

• Formato ruleid non corretto. L'endpoint per la singola regola richiede una stringa ruleid valida nel percorso. Passare un identificatore nullo, vuoto o formattato in modo errato causerà il fallimento della richiesta o un risultato inatteso. ^[1]

• Scope Desk insufficienti. Zoho Desk dispone di definizioni di scope granulari. Se il token è stato generato senza Desk.settings.READ, l'endpoint di gestione delle regole di condivisione dati sarà inaccessibile anche se sono presenti altri scope Desk. ^[7]

Cosa verificare

• Copertura degli scope: Verifica che il token OAuth includa ZohoCRM.org.ALL per le chiamate CRM e Desk.settings.READ per le chiamate Desk prima di eseguire qualsiasi richiesta. ^[7]
• Validità del token: Conferma che il timestamp tokenexpiresat non sia scaduto; aggiorna il token in modo proattivo se mancano pochi minuti alla scadenza. ^[4]
• URL base e prodotto corretti: Verifica che le richieste CRM puntino al percorso /settings/datasharingrules e le richieste Desk a /api/v1/doc/datasharingrulesmanagemen, poiché mescolarli produrrà errori. ^[1][2][3]