Gmail API

L'API Gmail vous permet d'afficher et de gérer les données des boîtes 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 disposer de 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 utilisateur donnée.
watch POST /gmail/v1/users/{userId}/watch
Configurez ou mettez à jour une montre intégrant les notifications push dans la boîte aux lettres de l'utilisateur donnée.

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 associé au 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 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 indiqués 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é, 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 aux lettres 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 aux lettres de cet utilisateur, avec une analyse et une classification standards de la distribution des e-mails semblables à 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, de la même manière que IMAP APPEND, afin de contourner la plupart des processus d'analyse et de classification.
list GET /gmail/v1/users/{userId}/messages
Répertorie 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 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 du 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 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 de 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 éventuellement requise pour son utilisation.
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 pour le 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
Présente 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 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}
Appliquez un correctif à l'alias d'envoi spécifié.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Met à jour un alias d'envoi en tant que.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Envoie un e-mail de validation à l'alias d'adresse e-mail 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 en tant que 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ère (importez) la configuration S/MIME donnée pour l'alias d'envoi en tant que spécifié.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Répertorie les configurations S/MIME pour l'alias d'envoi en tant que 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 en tant que spécifié.

Ressource REST: v1.users.threads

Méthodes
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Supprime immédiatement et définitivement le thread 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 thread.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Place le thread spécifié dans la corbeille.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Supprime le thread spécifié de la corbeille.