Gmail API

L'API Gmail vous permet d'afficher et de gérer les données de votre boîte aux lettres Gmail, comme les fils de discussion, les messages et les libellés.

Service : gmail.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, conformez-vous aux informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut posséder plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://gmail.googleapis.com

Ressource REST : v1.users

Méthodes
getProfile GET /gmail/v1/users/{userId}/profile
Récupère le profil Gmail de l'utilisateur actuel.
stop POST /gmail/v1/users/{userId}/stop
Désactive la diffusion des notifications push pour la boîte aux lettres de l'utilisateur spécifié.
watch POST /gmail/v1/users/{userId}/watch
Configurez ou mettez à jour une surveillance des notifications push dans la boîte aux lettres de l'utilisateur spécifié.

Ressource REST : v1.users.drafts

Méthodes
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Crée un brouillon avec le libellé DRAFT.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
Supprime immédiatement et définitivement le brouillon spécifié.
get GET /gmail/v1/users/{userId}/drafts/{id}
Récupère le brouillon spécifié.
list GET /gmail/v1/users/{userId}/drafts
Liste les brouillons dans la boîte aux lettres de l'utilisateur.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Envoie le brouillon existant spécifié aux destinataires dans les en-têtes To, Cc et Bcc.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Remplace le contenu d'un brouillon.

Ressource REST : v1.users.history

Méthodes
list GET /gmail/v1/users/{userId}/history
Liste l'historique de toutes les modifications apportées à la boîte aux lettres indiquée.

Ressource REST : v1.users.labels

Méthodes
create POST /gmail/v1/users/{userId}/labels
Crée un libellé.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Supprime immédiatement et définitivement le libellé spécifié, et le supprime de tous les messages et fils de discussion auxquels il est appliqué.
get GET /gmail/v1/users/{userId}/labels/{id}
Récupère le libellé spécifié.
list GET /gmail/v1/users/{userId}/labels
Liste tous les libellés de la boîte aux lettres de l'utilisateur.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Corrige le libellé spécifié.
update PUT /gmail/v1/users/{userId}/labels/{id}
Met à jour le libellé spécifié.

Ressource REST : v1.users.messages

Méthodes
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Supprime plusieurs messages à l'aide de leur ID.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Modifie les libellés des messages spécifiés.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Supprime immédiatement et définitivement le message spécifié.
get GET /gmail/v1/users/{userId}/messages/{id}
Récupère le message spécifié.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Importe un message dans la boîte aux lettres de cet utilisateur uniquement, avec une analyse et une classification standard des e-mails, comme pour la réception via SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Insère directement un message dans la boîte aux lettres de cet utilisateur uniquement, comme IMAP APPEND, en contournant la plupart des analyses et classifications.
list GET /gmail/v1/users/{userId}/messages
Liste les messages dans la boîte aux lettres de l'utilisateur.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Modifie les libellés du message spécifié.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Envoie le message spécifié aux destinataires des en-têtes To, Cc et Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Déplace le message spécifié vers la corbeille.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Supprime le message spécifié de la corbeille.

Ressource REST : v1.users.messages.attachments

Méthodes
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Récupère la pièce jointe du message spécifié.

Ressource REST : v1.users.settings

Méthodes
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Obtient le paramètre de transfert automatique pour le compte spécifié.
getImap GET /gmail/v1/users/{userId}/settings/imap
Récupère les paramètres IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Récupère les paramètres de langue.
getPop GET /gmail/v1/users/{userId}/settings/pop
Récupère les paramètres POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Récupère les paramètres de réponse automatique.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Met à jour le paramètre de transfert automatique pour le compte spécifié.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Met à jour les paramètres IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Met à jour les paramètres de langue.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Met à jour les paramètres POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Met à jour les paramètres de la réponse automatique.

Ressource REST : v1.users.settings.cse.identities

Méthodes
create POST /gmail/v1/users/{userId}/settings/cse/identities
Crée et configure une identité de chiffrement côté client autorisée à envoyer des e-mails à partir du compte utilisateur.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Supprime une identité de chiffrement côté client.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Récupère une configuration d'identité de chiffrement côté client.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Liste les identités chiffrées côté client pour un utilisateur authentifié.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Associe une autre paire de clés à une identité de chiffrement côté client existante.

Ressource REST : v1.users.settings.cse.keypairs

Méthodes
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Crée et importe une chaîne de certificats de clé publique S/MIME et des métadonnées de clé privée pour le chiffrement côté client de l'utilisateur authentifié.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Désactive une paire de clés de chiffrement côté client.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Active une paire de clés de chiffrement côté client qui avait été désactivée.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Récupère une paire de clés de chiffrement côté client existante.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Liste les paires de clés de chiffrement côté client pour un utilisateur authentifié.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Supprime définitivement et immédiatement une paire de clés de chiffrement côté client.

Ressource REST : v1.users.settings.delegates

Méthodes
create POST /gmail/v1/users/{userId}/settings/delegates
Ajoute un délégué avec son état de validation directement défini sur accepted, sans envoyer d'e-mail de validation.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Supprime le délégué spécifié (qui peut avoir n'importe quel état de validation) et révoque toute validation qui aurait pu être requise pour l'utiliser.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Récupère le délégué spécifié.
list GET /gmail/v1/users/{userId}/settings/delegates
Liste les délégués du compte spécifié.

Ressource REST : v1.users.settings.filters

Méthodes
create POST /gmail/v1/users/{userId}/settings/filters
Crée un filtre.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Supprime immédiatement et définitivement le filtre spécifié.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Récupère un filtre.
list GET /gmail/v1/users/{userId}/settings/filters
Liste les filtres de messages d'un utilisateur Gmail.

Ressource REST : v1.users.settings.forwardingAddresses

Méthodes
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Crée une adresse de transfert.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Supprime l'adresse de transfert spécifiée et révoque toute validation qui aurait pu être requise.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Récupère l'adresse de transfert spécifiée.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Liste les adresses de transfert pour le compte spécifié.

Ressource REST : v1.users.settings.sendAs

Méthodes
create POST /gmail/v1/users/{userId}/settings/sendAs
Crée un alias d'expéditeur "De" personnalisé.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Supprime l'alias "Envoyer sous" spécifié.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Récupère l'alias "Envoyer sous" spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs
Liste les alias "Envoyer sous" pour le compte spécifié.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Modifie l'alias "Envoyer en tant que" spécifié.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Met à jour un alias "Envoyer sous".
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Envoie un e-mail de validation à l'adresse de l'alias "Envoyer sous" spécifié.

Ressource REST : v1.users.settings.sendAs.smimeInfo

Méthodes
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Supprime la configuration S/MIME spécifiée pour l'alias "Envoyer sous" spécifié.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Récupère la configuration S/MIME spécifiée pour l'alias "Envoyer sous" spécifié.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Insérez (importez) la configuration S/MIME donnée pour l'alias "Envoyer sous" spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Liste les configurations S/MIME pour l'alias "Envoyer sous" spécifié.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Définit la configuration S/MIME par défaut pour l'alias "Envoyer sous" spécifié.

Ressource REST : v1.users.threads

Méthodes
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Supprime immédiatement et définitivement le fil de discussion spécifié.
get GET /gmail/v1/users/{userId}/threads/{id}
Récupère le fil de discussion spécifié.
list GET /gmail/v1/users/{userId}/threads
Liste les fils de discussion dans la boîte aux lettres de l'utilisateur.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Modifie les libellés appliqués au fil de discussion.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Place le fil de discussion spécifié dans la corbeille.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Supprime le fil de discussion spécifié de la corbeille.