Vous pouvez récupérer des métriques sur les e-mails pour un jour spécifique sur un domaine spécifique ou pour tous les jours sur un domaine spécifique.
Pour savoir comment améliorer certaines métriques, consultez Empêcher le blocage ou le placement dans le dossier "Spam" des messages envoyés aux utilisateurs Gmail.
Récupérer des métriques pour un jour spécifique
Pour récupérer des métriques pour un jour spécifique, appelez domains.trafficStats.get() avec le domaine et le jour. Vous trouverez ci-dessous un exemple de code montrant comment récupérer les métriques de messagerie pour un jour spécifique:
Java
/**
* Gets the traffic stats for a domain for a specific date.
*
* @param service Authorized Gmail PostmasterTools API instance.
* @param domainName The fully qualified domain name.
* @param date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
* @return The traffic stats of the domain for this date.
* @throws IOException
*/
public static TrafficStats getTrafficStats(PostmasterTools service, String domainName, String date) throws IOException {
String query = String.format("domains/%s/trafficStats/%s", domainName, date);
TrafficStats trafficStats = service.domains().trafficStats().get(query).execute();
System.out.println(trafficStats.toPrettyString());
return trafficStats;
}
Python
"""Gets the traffic stats for a domain for a specific date.
Args:
service: Authorized Gmail PostmasterTools API instance.
domain_name: The fully qualified domain name.
date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
Returns:
The traffic stats of the domain for this date.
"""
def get_traffic_stats(service, domain_name, date):
"""Gets the traffic stats for a domain for a specific date.
Args:
service: Authorized Gmail PostmasterTools API instance.
domain_name: The fully qualified domain name.
date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
Returns:
The traffic stats of the domain for this date.
"""
try:
query = 'domains/%s/trafficStats/%s' %(domain_name,date)
traffic_stats = service.domains().trafficStats().get(name=query).execute();
print(traffic_stats);
return traffic_stats;
except errors.HttpError as err:
print('An error occurred: %s' % err)
Si la requête aboutit, le corps de la réponse contient une instance d'TrafficStats.
Récupérer les métriques pour tous les jours
Pour récupérer les métriques pour tous les jours, appelez domains.trafficStats.list() avec le domaine. Vous trouverez ci-dessous un exemple de code montrant comment récupérer les métriques de messagerie pour tous les jours:
Java
/**
* Lists traffic statistics for all available days.
*
* @param service Authorized Gmail PostmasterTools API instance.
* @param domainName The fully qualified domain name.
* @param pageSize The number of TrafficStats to get per request.
* @param pageToken The nextPageToken value returned from a previous List request, if any.
* @return Response message for list traffic stats request.
* @throws IOException
*/
public static ListTrafficStatsResponse listTrafficStats(PostmasterTools service, String domainName,
int pageSize,
String pageToken) throws IOException {
ListTrafficStatsResponse listTrafficStatsResponse = service.domains().trafficStats().list("domains/" + domainName)
.setPageSize(pageSize)
.setPageToken(pageToken)
.execute();
System.out.println(listTrafficStatsResponse.toPrettyString());
return null;
}
Python
"""Gets the traffic stats for a domain for a specific date.
Args:
service: Authorized Gmail PostmasterTools API instance.
domain_name: The fully qualified domain name.
date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
page_size The number of TrafficStats to get per request.
page_token The nextPageToken value returned from a previous List request, if any.
Returns:
The traffic stats of the domain for this date.
"""
def list_traffic_stats(service, domain_name, date, page_size, page_token):
"""Gets the traffic stats for a domain for a specific date.
Args:
service: Authorized Gmail PostmasterTools API instance.
domain_name: The fully qualified domain name.
date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
page_size The number of TrafficStats to get per request.
page_token The nextPageToken value returned from a previous List request, if any.
Returns:
The traffic stats of the domain for this date.
"""
try:
query = 'domains/' + domain_name
list_traffic_stats_response = service.domains().trafficStats().list(parent=query, pageSize=page_size, pageToken=page_token).execute();
print(list_traffic_stats_response);
return list_traffic_stats_response;
except errors.HttpError as err:
print('An error occurred: %s' % err)
if __name__ == '__main__':
main()
Si la requête aboutit, le corps de la réponse contient un tableau paginé d'TrafficStats avec la structure suivante:
{
"trafficStats": [
{
object (TrafficStats)
}
],
"nextPageToken": string
}