Comment lister tous les fuseaux horaires dans Zoho Desk

Récupérer la liste complète des fuseaux horaires disponibles dans Zoho Desk se résume à un seul appel API authentifié qui retourne tous les fuseaux horaires que votre organisation peut utiliser pour la planification et les paramètres de localisation.

Pourquoi c'est important

Lors de la configuration des profils d'agents, des horaires d'ouverture ou des politiques SLA dans Zoho Desk, vous devez fournir un identifiant de fuseau horaire valide. Plutôt que de deviner la chaîne exacte attendue par Zoho Desk, vous pouvez interroger l'endpoint des fuseaux horaires pour obtenir la liste de référence. Cela est particulièrement utile lors de la création d'intégrations ou d'automatisations qui définissent les champs de fuseau horaire par programmation au nom des utilisateurs.

Étape par étape

Étape 1. Assurez-vous que votre jeton OAuth inclut les scopes Zoho Desk appropriés avant d'effectuer tout appel API. Vous aurez au minimum besoin de Desk.basic.READ dans votre liste de scopes, qui couvre les données organisationnelles et de référence telles que les fuseaux horaires. ^[2]

Étape 2. Authentifiez votre client en utilisant le flux OAuth standard de Zoho. Si votre jeton d'accès a expiré, le client doit le rafraîchir automatiquement à l'aide du jeton de rafraîchissement stocké avant de continuer. ^[5]

Étape 3. Envoyez une requête GET à l'endpoint des fuseaux horaires de Zoho Desk :

GET /api/v1/timeZones

Cette opération — identifiée en interne sous le nom listalltime_zones — accepte un dictionnaire de paramètres de requête optionnel (p) si vous avez besoin de transmettre des filtres ou des indications de pagination, bien qu'aucun paramètre ne soit requis pour un listage de base. ^[1]

Étape 4. Si vous travaillez en Python et disposez déjà d'une instance ZohoDeskApi configurée (voir Étape 2), vous pouvez appeler la méthode directement :

time_zones = api.list_all_time_zones()

Passez un dictionnaire à l'argument p si vous souhaitez inclure des paramètres de requête optionnels ; sinon, laissez-le vide. ^[1]

Étape 5. Analysez la réponse. Le contenu retourné contiendra les enregistrements de fuseaux horaires pris en charge par votre organisation Zoho Desk. Stockez ou affichez les chaînes d'identifiants pertinentes afin de pouvoir les réutiliser lors de la création ou de la mise à jour d'enregistrements nécessitant un champ de fuseau horaire. ^[1]

Erreurs courantes

• Scope manquant. Si votre jeton OAuth a été généré sans Desk.basic.READ, l'API rejettera la requête avec une erreur d'autorisation. Vérifiez la chaîne de scope complète dans votre configuration d'environnement et régénérez le jeton si nécessaire. ^[2]
• orgId manquant. L'API de Zoho Desk requiert qu'un identifiant d'organisation valide soit transmis avec la plupart des requêtes. Si votre client n'a pas encore récupéré l'orgId, il tentera de le récupérer automatiquement depuis l'endpoint des organisations lors du premier appel — mais si cela échoue également (par exemple en raison d'un scope manquant), les appels suivants, y compris la requête des fuseaux horaires, pourront aussi échouer. Confirmez que le deskorgid est stocké et non vide avant d'effectuer l'appel. ^{[4] [5]}
• Domaine de base incorrect. Zoho Desk est disponible dans plusieurs régions de centres de données (US, EU, AU, IN, etc.). Assurez-vous que l'api_domain utilisé par votre client correspond à la région où votre portail Desk est hébergé, sinon l'endpoint retournera une redirection ou une erreur plutôt que des données. ^[5]

Ce qu'il faut vérifier

• Vérifiez que Desk.basic.READ (et tout autre scope requis) apparaît dans la liste des scopes de votre jeton OAuth actif avant d'appeler GET /api/v1/timeZones. ^[2]
• Confirmez qu'un deskorgid valide est disponible pour votre client API afin que la requête soit acheminée vers la bonne organisation Zoho Desk. ^[4]
• Inspectez le contenu de la réponse pour vous assurer qu'il contient une liste non vide d'entrées de fuseaux horaires avant d'utiliser un identifiant dans des appels ultérieurs de création ou de mise à jour d'enregistrements. ^[1]

---

*Beam Help fournit une assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Référez-vous toujours à la dernière documentation de l'API Zoho Desk pour tout changement concernant le comportement des endpoints ou les exigences de scope OAuth.*