Beam Help
Demander de l'aide

How-to · Zoho CRM

Comment récupérer les tâches d'écriture en masse dans Zoho

Récupérez le statut et les résultats des tâches d'écriture en masse par programmation.

Récupérer une tâche d'écriture en masse dans Zoho CRM vous permet de vérifier le statut actuel et les détails d'une opération d'écriture en masse précédemment soumise, en utilisant son identifiant de tâche unique.


Pourquoi c'est important


Lorsque vous soumettez de grands volumes d'enregistrements à Zoho CRM via l'API d'écriture en masse, la tâche s'exécute de manière asynchrone. Vous avez besoin d'un moyen d'interroger ou d'inspecter cette tâche ultérieurement pour confirmer si elle a réussi, est toujours en cours de traitement ou a rencontré des erreurs. Cet endpoint est votre principal outil pour cette vérification de statut, et il est classé comme une opération sûre en lecture seule. [4]


---


Étape par étape


Étape 1. Confirmez que votre jeton OAuth inclut le scope CRM bulk correct avant d'effectuer toute requête. Le scope requis est ZohoCRM.bulk.ALL, qui accorde un accès complet aux opérations en masse dans Zoho CRM. Sans ce scope, l'API rejettera votre requête. [2]


Étape 2. Identifiez l'identifiant de tâche (jid) pour la tâche d'écriture en masse que vous souhaitez inspecter. Cet identifiant est retourné lorsque vous créez initialement une tâche d'écriture en masse via POST /bulk/v1/write. Conservez-en une trace au moment de la création afin de pouvoir y faire référence ultérieurement. [7]


Étape 3. Envoyez une requête GET vers l'endpoint de la tâche d'écriture en masse, en substituant votre identifiant de tâche dans le chemin :


GET /bulk/v1/write/{jid}

Remplacez {jid} par la chaîne d'identifiant de tâche réelle. Cet appel ne nécessite aucun corps de requête — l'identifiant de tâche dans le chemin est le seul paramètre requis. [1]


Étape 4. Si vous travaillez en Python, l'appel peut être effectué via le wrapper client CRM de la manière suivante :


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

Passez l'identifiant de tâche en tant qu'argument de type chaîne. La méthode émet la requête GET authentifiée et retourne les détails de la tâche sous forme d'objet de réponse. [1]


Étape 5. Lors de l'invocation via une couche d'outils de niveau supérieur, fournissez l'identifiant de tâche via la clé de paramètre jobid. En interne, cela correspond directement à la fonction getbulkwritejob décrite ci-dessus. [5]


Étape 6. Analysez la réponse pour examiner l'état actuel de la tâche. La réponse contiendra des métadonnées sur l'opération d'écriture en masse, y compris son statut de traitement. Si la tâche est toujours en cours d'exécution, répétez la requête après un court délai pour interroger l'achèvement. [4]


---


Erreurs courantes


  • Confusion entre les endpoints d'écriture et de lecture en masse. L'endpoint pour vérifier une tâche de *lecture* en masse est GET /bulk/v1/read/{jid}, qui est une opération entièrement distincte. Assurez-vous d'utiliser /bulk/v1/write/{jid} lors de la vérification d'une tâche d'écriture. [6]
  • Scope manquant ou incorrect. Si votre jeton OAuth a été généré sans ZohoCRM.bulk.ALL, la requête échouera avec une erreur d'autorisation. Régénérez votre jeton en incluant le scope correct. [2]
  • Utilisation d'un identifiant de tâche incorrect. Le jid doit correspondre à une tâche créée via POST /bulk/v1/write. Passer un identifiant de tâche de lecture à l'endpoint d'écriture, ou vice versa, retournera une erreur ou un résultat inattendu. [6][7]

---


Points à vérifier


  • Présence du scope : Vérifiez que ZohoCRM.bulk.ALL apparaît dans la liste des scopes de votre jeton OAuth actif avant d'effectuer l'appel. [2]
  • Chemin d'endpoint correct : Confirmez que l'URL contient /bulk/v1/write/ (et non /read/) suivi de l'identifiant de tâche exact reçu au moment de la création. [1][6]
  • Source de l'identifiant de tâche : Assurez-vous que la valeur jid a été capturée depuis la réponse originale de POST /bulk/v1/write, et non depuis une tâche de lecture ou une autre opération sans rapport. [7]

---


*Beam Help fournit une assistance experte indépendante pour Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme, consultez toujours la documentation officielle de Zoho.*

Sources cited

  1. [1] GET /bulk/v1/write/{jid}
  2. [2] config.py
  3. [3] server.py: chat_stream
  4. [4] get_bulk_write_job
  5. [5] get_bulk_write_job
  6. [6] GET /bulk/v1/read/{jid}
  7. [7] POST /bulk/v1/write
  8. [8] server.py: build_zoho_links
Récupérer les tâches d'écriture en masse | Beam Help — Beam Help