Comment déplacer des produits vers la corbeille dans Zoho Desk

Le déplacement de produits vers la corbeille dans Zoho Desk s'effectue via un unique appel API DELETE vers l'endpoint /api/v1/products, qui transfère les produits sélectionnés dans la corbeille plutôt que de les supprimer définitivement.

Pourquoi c'est important

Lorsque vous devez retirer ou nettoyer des fiches produits dans Zoho Desk sans les supprimer définitivement, les déplacer vers la corbeille vous offre un filet de sécurité permettant une récupération ultérieure. Cela est particulièrement utile lors de réorganisations de catalogue ou lors de la mise hors service de produits qui peuvent encore être référencés dans des tickets historiques. Connaître la bonne opération API et les scopes OAuth requis garantit que votre intégration ou automatisation gère cela proprement.

Étape par étape

Étape 1. Vérifiez que votre token OAuth inclut le scope Zoho Desk correct avant d'effectuer tout appel API. Pour les opérations au niveau des produits et des paramètres, votre token doit couvrir des scopes tels que Desk.settings.ALL ou la permission Desk.settings.DELETE appropriée. Sans le bon scope, la requête sera rejetée au niveau de la couche d'autorisation. ^[3]

Étape 2. Construisez votre requête DELETE ciblant l'endpoint des produits. L'opération est deletemoveproductstotrash, et le chemin de base est :

DELETE /api/v1/products

Cet endpoint accepte un dictionnaire de paramètres de requête optionnel (p) que vous pouvez utiliser pour spécifier quel(s) produit(s) déplacer. ^[1]

Étape 3. Transmettez les paramètres de filtre ou d'identification requis dans le dictionnaire p. Par exemple, si vous utilisez le wrapper client Python, l'appel ressemble à ceci :

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

La méthode envoie une requête DELETE vers /api/v1/products avec vos paramètres ajoutés en tant que paramètres de requête. ^[1]

Étape 4. Examinez la réponse de l'API pour confirmer que l'opération a réussi. Une opération de mise à la corbeille réussie retournera un objet de réponse indiquant que les produits ont été déplacés. Si la réponse contient un code d'erreur, vérifiez la configuration de vos scopes et les valeurs des paramètres avant de réessayer. ^[1]

Étape 5. Si vous travaillez dans une intégration multi-produits qui gère également des articles ou des tickets, notez que chaque type d'entité possède son propre endpoint de corbeille dédié. Les articles utilisent DELETE /api/v1/helpcenter/{helpcenter_id}/articles, et les tickets utilisent POST /api/v1/tickets/trash — ce sont des opérations distinctes qui ne doivent pas être confondues avec l'endpoint des produits. ^{[2] [4]}

Erreurs courantes

• Scopes OAuth manquants ou insuffisants. La cause la plus fréquente d'une requête échouée est un token qui ne dispose pas du scope Desk.settings.DELETE ou Desk.settings.ALL nécessaire. Vérifiez toujours que votre configuration ZOHODESKSCOPES inclut les permissions au niveau des paramètres avant de déployer. ^[3]

• Confusion entre les méthodes HTTP selon les types d'entités. Le déplacement de produits vers la corbeille utilise DELETE, tandis que le déplacement de tickets vers la corbeille utilise POST vers /api/v1/tickets/trash. Confondre le verbe HTTP ou le chemin d'endpoint entraînera une opération échouée ou non souhaitée. ^{[1] [4]}

• Omission du paramètre p. Si aucun identifiant de produit n'est fourni dans les paramètres de requête, l'API peut ne pas savoir sur quels enregistrements agir. Confirmez toujours quels champs d'identification l'endpoint attend et incluez-les dans le dictionnaire p. ^[1]

• Incompatibilité de centre de données. Zoho Desk est disponible sur plusieurs centres de données (.com, .eu, .in, etc.). Assurez-vous que votre URL de base correspond au centre de données où votre organisation Desk est hébergée, sinon les requêtes échoueront ou seront mal acheminées. ^[5]

Ce qu'il faut vérifier

• Couverture des scopes : Vérifiez que votre token OAuth actif inclut Desk.settings.DELETE ou Desk.settings.ALL et que le token n'a pas expiré. ^[3]
• Endpoint et méthode corrects : Confirmez que vous appelez bien DELETE /api/v1/products — et non les endpoints de corbeille des articles ou des tickets — et que les identifiants de produits sont transmis dans le paramètre p. ^[1]
• Validation de la réponse : Après l'appel, vérifiez la réponse de l'API pour un statut de succès et confirmez que le produit n'apparaît plus dans votre liste de produits actifs (il devrait maintenant se trouver dans la corbeille, récupérable si nécessaire). ^[1]

---

*Beam Help est une ressource d'assistance experte indépendante pour les utilisateurs de Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme ou les questions de facturation, contactez Zoho directement.*