Gmail API

L'API Gmail vous permet d'afficher et de gérer les données de votre boîte aux lettres Gmail telles que 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 du 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 avoir 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
Ne plus recevoir de notifications push pour la boîte aux lettres de l'utilisateur donné.
watch POST /gmail/v1/users/{userId}/watch
Configure ou met à jour une montre de notification 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}
Le brouillon spécifié est immédiatement et définitivement supprimé.
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 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
Répertorie 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é, ainsi que 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 aux lettres de l'utilisateur.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Corrigez 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 par 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 standards 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 l'utilisateur, comme pour IMAP APPEND, en contournant la plupart des analyses et des classifications.
list GET /gmail/v1/users/{userId}/messages
Répertorie les messages de 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 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 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 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 paire de clés différente à 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 a é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
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 une paire de clés de chiffrement côté client de manière définitive et immédiate.

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 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 être associé à n'importe quel état de validation) et révoque toute validation nécessaire.
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
Répertorie 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 éventuellement 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 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'envoi "De" 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 en tant que pour le compte spécifié.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Corrigez 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 d'alias spécifiée.

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 "send-as" 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 "send-as" spécifié.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Insère (importe) la configuration S/MIME fournie pour l'alias d'envoi spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Répertorie 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 "send-as" 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 thread spécifié.
list GET /gmail/v1/users/{userId}/threads
Répertorie 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.