Puedes recuperar métricas de correo electrónico de un día específico en un dominio específico o de todos los días en un dominio específico.
Si deseas obtener información para mejorar ciertas métricas, consulta Evita que los correos electrónicos enviados a usuarios de Gmail se bloqueen o envíen a la carpeta de spam.
Cómo recuperar métricas de un día específico
Para recuperar las métricas de un día específico, llama a domains.trafficStats.get() con el dominio y el día. A continuación, se muestra una muestra de código que muestra cómo recuperar las métricas de correo electrónico de un día específico:
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 se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de TrafficStats.
Cómo recuperar métricas de todos los días
Para recuperar las métricas de todos los días, llama a domains.trafficStats.list() con el dominio. A continuación, se muestra una muestra de código que muestra cómo recuperar las métricas de correo electrónico de todos los días:
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 se ejecuta correctamente, el cuerpo de la respuesta contiene un array paginado de TrafficStats con la siguiente estructura:
{
"trafficStats": [
{
object (TrafficStats)
}
],
"nextPageToken": string
}