list_emails

E-mail · macOS

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Utilisez-le lorsque l'utilisateur souhaite voir ou trier sa boîte de réception sur ce Mac (Apple Mail — tout compte ajouté à Mail.app : iCloud, Gmail, IMAP, Exchange). Répertorie les en-têtes des e-mails (objet, expéditeur, date, non lu) ; appelez read_email(message_id) pour le corps entier. Pour une boîte aux lettres Microsoft 365 NOT ajoutée à Mail.app, utilisez m365_list_emails. IMPORTANT : sur les machines avec plus de 2 comptes, appelez avec account=<name> (depuis list_email_accounts). Sans cela, et lorsque l'index rapide ne peut pas répondre, list_emails renvoie la liste des comptes au lieu de tous les analyser : l'analyse de chaque compte en un seul appel n'a pas de limite de temps et peut également bloquer Mail pour d'autres demandes (#2268). Exactement 1 compte n'est pas affecté. Prend en charge la pagination : utilisez le décalage pour parcourir les résultats (par exemple, offset=20 pour la page 2 avec limite=20). Le paramètre de limite est plafonné à 50 par appel (20 par défaut) ; pour en savoir plus, page avec décalage plutôt que de demander une limite plus grande.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "account": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "offset": {
      "default": "0",
      "minimum": 0,
      "type": "integer"
    },
    "unread_only": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour list_emails. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "limit": 5
}