Gmail Postmaster Tools API

L'API Postmaster Tools est une API RESTful qui permet d'accéder de manière programmatique aux métriques sur le trafic d'e-mails (comme les rapports de spam, les erreurs de distribution, etc.) qui sont actuellement disponibles dans l'interface utilisateur Gmail Postmaster Tools.

Service : gmailpostmastertools.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://gmailpostmastertools.googleapis.com

Ressource REST : v2.domainStats

Méthodes
batchQuery POST /v2/domainStats:batchQuery
Exécute un lot de requêtes QueryDomainStats pour plusieurs domaines.

Ressource REST : v2.domains

Méthodes
create POST /v2/domains
Ajoute un domaine au compte de l'utilisateur.
delete DELETE /v2/{name=domains/*}
Supprime un domaine du compte de l'utilisateur.
get GET /v2/{name=domains/*}
Récupère des informations détaillées sur un domaine que vous avez enregistré.
getComplianceStatus GET /v2/{name=domains/*/complianceStatus}
Récupère l'état de conformité d'un domaine donné.
getVerificationToken GET /v2/{name=domains/*/verificationToken}
Obtient un jeton de validation utilisé pour valider la propriété d'un utilisateur sur un domaine.
list GET /v2/domains
Récupère la liste de tous les domaines que vous avez enregistrés, ainsi que leurs métadonnées correspondantes.
verify POST /v2/{name=domains/*}:verify
Valide la propriété d'un domaine par un utilisateur au niveau du DNS.

Ressource REST : v2.domains.domainStats

Méthodes
query POST /v2/{parent=domains/*}/domainStats:query
Récupère une liste de statistiques de domaine pour un domaine et une période donnés.

Ressource REST : v2.domains.users

Méthodes
create POST /v2/{parent=domains/*}/users
Crée un utilisateur ayant accès à un domaine.
delete DELETE /v2/{name=domains/*/users/*}
Supprime un utilisateur d'un domaine.
get GET /v2/{name=domains/*/users/*}
Récupère des informations détaillées sur un utilisateur ayant accès à un domaine.
list GET /v2/{parent=domains/*}/users
Liste les utilisateurs ayant accès à un domaine.
patch PATCH /v2/{user.name=domains/*/users/*}
Met à jour un utilisateur pour un domaine.