Recuperar estatísticas de e-mail

É possível recuperar estatísticas de e-mail para um período específico em um domínio específico.

Para saber como melhorar determinadas estatísticas, consulte Impedir que e-mails para usuários do Gmail sejam bloqueados ou enviados para a pasta "Spam".

Observação:se você não encontrar valores para algumas estatísticas, talvez não envie e-mails suficientes por dia. Somente os domínios que enviam e-mails para pelo menos 50 usuários por dia recebem estatísticas. Para mais informações, consulte as Perguntas frequentes do Postmaster Tools.

Recuperar estatísticas de um período

Para recuperar estatísticas de um período específico, chame domains.domainStats.query() com o domínio e o período. Confira abaixo um exemplo de código que mostra como recuperar estatísticas de e-mail para um período específico:

Java

/**
 * Lists domain statistics for a specific date range.
 *
 * @param service Authorized Gmail PostmasterTools API instance.
 * @param domainName The fully qualified domain name.
 * @param startDate The first day of the date range to retrieve statistics.
 * @param endDate The last day of the date range to retrieve statistics.
 * @param pageSize The number of DomainStats to get per request.
 * @param pageToken The nextPageToken value from a previous List request,
 *     if any.
 * @return Response message for query domain stats request.
 * @throws IOException
 */
public static QueryDomainStatsResponse queryDomainStats(
    PostmasterTools service, String domainName, Date startDate, Date endDate,
    int pageSize, String pageToken) throws IOException {
  QueryDomainStatsResponse queryDomainStatsResponse =
      service.domains().domainStats()
          .query("domains/" + domainName)
          .setStartDate(startDate)
          .setEndDate(endDate)
          .setPageSize(pageSize)
          .setPageToken(pageToken)
          .execute();
  System.out.println(queryDomainStatsResponse.toPrettyString());
  return queryDomainStatsResponse;
}

Python

def query_domain_stats(service, domain_name, start_date, end_date,
                       page_size, page_token):
  """Queries the domain stats for a domain for a specific date range.

  Args:
    service: Authorized Gmail PostmasterTools API instance.
    domain_name: The fully qualified domain name.
    start_date: The first day of the date range to retrieve statistics.
    end_date: The last day of the date range to retrieve statistics.
    page_size: The number of DomainStats to get per request.
    page_token: The nextPageToken value from a previous List request, if any.

  Returns:
    The domain stats of the domain for this date range.
  """
  try:
    query = 'domains/' + domain_name
    query_domain_stats_response = service.domains().domainStats().query(
        parent=query,
        startDate=start_date,
        endDate=end_date,
        pageSize=page_size,
        pageToken=page_token).execute()
    print(query_domain_stats_response)
    return query_domain_stats_response
  except errors.HttpError as err:
    print(f'An error occurred: {err}')

Se a solicitação for bem-sucedida, o corpo da resposta vai conter uma matriz paginada de DomainStat com a seguinte estrutura:

{
  "domainStats": [
    {
      object (DomainStat)
    }
  ],
  "nextPageToken": string
}

Recuperar o status de conformidade de um domínio

Para recuperar o status de conformidade de um domínio, chame domains.getComplianceStatus() com o domínio. O status de conformidade contém informações de conformidade para Sender Policy Framework (SPF), DomainKeys Identified Mail (DKIM) e Relatórios, conformidade e autenticação de mensagens com base no domínio (DMARC). Confira abaixo um exemplo de código que mostra como recuperar o status de conformidade de um domínio:

Java

/**
 * Gets the compliance status for a domain.
 *
 * @param service Authorized Gmail PostmasterTools API instance.
 * @param domainName The fully qualified domain name.
 * @return The compliance status of the domain.
 * @throws IOException
 */
public static DomainComplianceStatus getComplianceStatus(
    PostmasterTools service, String domainName) throws IOException {
  String query = String.format("domains/%s/complianceStatus", domainName);
  DomainComplianceStatus complianceStatus =
      service.domains().getComplianceStatus(query).execute();
  System.out.println(complianceStatus.toPrettyString());
  return complianceStatus;
}

Python

def get_compliance_status(service, domain_name):
  """Gets the compliance status for a domain.

  Args:
    service: Authorized Gmail PostmasterTools API instance.
    domain_name: The fully qualified domain name.

  Returns:
    The compliance status of the domain.
  """
  try:
    query = 'domains/%s/complianceStatus' % domain_name
    compliance_status = service.domains().getComplianceStatus(
        name=query).execute()
    print(compliance_status)
    return compliance_status
  except errors.HttpError as err:
    print(f'An error occurred: {err}')

Se a solicitação for bem-sucedida, o corpo da resposta vai conter uma instância de DomainComplianceStatus.