Come recuperare i job di scrittura massiva in Zoho

Recuperare un job di scrittura massiva in Zoho CRM consente di verificare lo stato attuale e i dettagli di un'operazione di scrittura massiva precedentemente inviata, utilizzando il suo ID job univoco.

Perché è importante

Quando invii grandi volumi di record a Zoho CRM tramite l'API di scrittura massiva, il job viene eseguito in modo asincrono. È necessario un modo per interrogare o ispezionare quel job in un secondo momento, per confermare se è andato a buon fine, è ancora in elaborazione o ha riscontrato errori. Questo endpoint è lo strumento principale per tale verifica dello stato ed è classificato come un'operazione sicura e di sola lettura. ^[4]

---

Procedura passo dopo passo

Passaggio 1. Verifica che il tuo token OAuth includa lo scope corretto per le operazioni massive di CRM prima di effettuare qualsiasi richiesta. Lo scope richiesto è ZohoCRM.bulk.ALL, che concede accesso completo alle operazioni massive in Zoho CRM. Senza questo scope, l'API rifiuterà la tua richiesta. ^[2]

Passaggio 2. Identifica l'ID job (jid) del job di scrittura massiva che desideri ispezionare. Questo ID viene restituito quando crei originariamente un job di scrittura massiva tramite POST /bulk/v1/write. Conserva un registro di esso al momento della creazione in modo da poterlo consultare in seguito. ^[7]

Passaggio 3. Invia una richiesta GET all'endpoint del job di scrittura massiva, sostituendo il tuo ID job nel percorso:

GET /bulk/v1/write/{jid}

Sostituisci {jid} con la stringa dell'ID job effettivo. Questa chiamata non richiede un corpo della richiesta — l'ID job nel percorso è l'unico parametro obbligatorio. ^[1]

Passaggio 4. Se stai lavorando in Python, la chiamata può essere effettuata tramite il wrapper del client CRM in questo modo:

def get_bulk_write_job(self, jid: str):
    return self.c.request("GET", f"/bulk/v1/write/{jid}")

Passa l'ID job come argomento stringa. Il metodo esegue la richiesta GET autenticata e restituisce i dettagli del job come oggetto risposta. ^[1]

Passaggio 5. Quando si richiama questa funzione tramite un livello di strumenti di livello superiore, fornisci l'ID job tramite la chiave del parametro jobid. Internamente, questo si mappa direttamente alla funzione getbulkwritejob descritta sopra. ^[5]

Passaggio 6. Analizza la risposta per esaminare lo stato attuale del job. La risposta conterrà metadati sull'operazione di scrittura massiva, incluso il suo stato di elaborazione. Se il job è ancora in esecuzione, ripeti la richiesta dopo un breve ritardo per verificarne il completamento. ^[4]

---

Errori comuni

• Confondere gli endpoint di scrittura massiva e lettura massiva. L'endpoint per verificare un job di *lettura* massiva è GET /bulk/v1/read/{jid}, che è un'operazione completamente separata. Assicurati di utilizzare /bulk/v1/write/{jid} quando verifichi un job di scrittura. ^[6]
• Scope mancante o errato. Se il tuo token OAuth è stato generato senza ZohoCRM.bulk.ALL, la richiesta fallirà con un errore di autorizzazione. Rigenera il token con lo scope corretto incluso. ^[2]
• Utilizzo dell'ID job errato. Il jid deve corrispondere a un job creato tramite POST /bulk/v1/write. Passare l'ID di un job di lettura all'endpoint di scrittura, o viceversa, restituirà un errore o un risultato imprevisto. ^[6][7]

---

Cosa verificare

• Scope presente: Verifica che ZohoCRM.bulk.ALL compaia nell'elenco degli scope del tuo token OAuth attivo prima di effettuare la chiamata. ^[2]
• Percorso endpoint corretto: Conferma che l'URL contenga /bulk/v1/write/ (non /read/) seguito dall'ID job esatto ricevuto al momento della creazione. ^[1][6]
• Origine dell'ID job: Assicurati che il valore jid sia stato acquisito dalla risposta originale di POST /bulk/v1/write, e non da un job di lettura o da un'altra operazione non correlata. ^[7]

---

*Beam Help fornisce supporto esperto indipendente per Zoho — non siamo il supporto ufficiale di Zoho. Per problemi a livello di piattaforma, fai sempre riferimento alla documentazione ufficiale di Zoho.*