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, utilisez les 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
Arrêtez de recevoir des notifications push pour la boîte de réception de l'utilisateur donné.
watch POST /gmail/v1/users/{userId}/watch
Configurez ou mettez à jour une surveillance des notifications push sur la boîte aux lettres de l'utilisateur donné.

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
Répertorie les brouillons dans la boîte de réception 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
Répertorie l'historique de toutes les modifications apportées à la boîte de réception donné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
Répertorie tous les libellés de la boîte de réception de l'utilisateur.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Appliquez un correctif au 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 de nombreux messages par ID de message.
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 uniquement dans la boîte de réception de cet utilisateur, avec une analyse et une classification standard de la distribution des e-mails, semblable à la réception via SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Insertion directe d'un message dans la boîte de réception de cet utilisateur, comme avec IMAP APPEND, en contournant la plupart des analyses et classifications.
list GET /gmail/v1/users/{userId}/messages
Répertorie les messages de la boîte de réception 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 indiqués dans les en-têtes To, Cc et Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Place le message spécifié dans 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 de message spécifiée.

Ressource REST: v1.users.settings

Méthodes
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Récupère 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 la 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 linguistiques.
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
Répertorie les identités chiffrées côté client d'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 pour le chiffrement côté client et des métadonnées de clé privée pour 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 était 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
Répertorie 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é dont l'état de validation est défini directement 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
Répertorie 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
Répertorie les adresses de transfert du 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 personnalisé.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Supprime l'alias d'envoi spécifié.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Récupère l'alias d'envoi spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs
Répertorie les alias d'envoi pour le compte spécifié.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Appliquez un correctif à l'alias d'envoi spécifié.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Met à jour un alias d'envoi.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Envoie un e-mail de validation à l'adresse de l'alias d'envoi 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 d'envoi 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 d'envoi spécifié.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Insérez (importez) la configuration S/MIME donnée pour l'alias d'envoi spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Liste les configurations S/MIME pour l'alias d'envoi 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 d'envoi 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
Répertorie les fils de discussion dans la boîte de réception 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.