E-Mail-Statistiken abrufen

Sie können E‑Mail-Statistiken für einen bestimmten Zeitraum für eine bestimmte Domain abrufen.

Informationen dazu, wie Sie bestimmte Statistiken verbessern können, finden Sie im Hilfeartikel Vermeiden, dass E‑Mails an Gmail-Nutzer blockiert oder an den Spamordner gesendet werden.

Hinweis: Wenn Sie für einige Statistiken keine Werte sehen, senden Sie möglicherweise nicht genügend E‑Mails pro Tag. Statistiken werden nur für Domains bereitgestellt, von denen täglich E‑Mails an mindestens 50 Nutzer gesendet werden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu Postmaster Tools.

Statistiken für einen Zeitraum abrufen

Wenn Sie Statistiken für einen bestimmten Zeitraum abrufen möchten, rufen Sie domains.domainStats.query() mit der Domain und dem Zeitraum auf. Im folgenden Codebeispiel wird gezeigt, wie Sie E‑Mail-Statistiken für einen bestimmten Zeitraum abrufen:

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 for which to retrieve statistics.
   * @param endDate The last day of the date range for which to retrieve statistics.
   * @param pageSize The number of DomainStats to get per request.
   * @param pageToken The nextPageToken value returned 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 null;
}

Python

"""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 for which to retrieve statistics.
  end_date: The last day of the date range for which to retrieve statistics.
  page_size: The number of DomainStats to get per request.
  page_token: The nextPageToken value returned from a previous List request, if any.

  Returns:
  The domain stats of the domain for this date range.
  """
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 for which to retrieve statistics.
    end_date: The last day of the date range for which to retrieve statistics.
    page_size: The number of DomainStats to get per request.
    page_token: The nextPageToken value returned 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=endDate, pageSize=page_size, pageToken=page_token).execute();
        print(query_domain_stats_response);
        return query_domain_stats_response;
    except errors.HttpError as err:
        print('An error occurred: %s' % err)

if __name__ == '__main__':
    main()

Bei Erfolg enthält der Antworttext ein paginiertes Array von DomainStats mit der folgenden Struktur:

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

Compliance-Status für eine Domain abrufen

Wenn Sie den Compliance-Status für eine Domain abrufen möchten, rufen Sie domains.getComplianceStatus() mit der Domain auf. Der Compliance-Status enthält Compliance-Informationen für Sender Policy Framework (SPF), DomainKeys Identified Mail (DKIM) und Domain-based Message Authentication, Reporting and Conformance (DMARC). Im folgenden Codebeispiel wird gezeigt, wie Sie den Compliance-Status für eine Domain abrufen:

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 ComplianceStatus getComplianceStatus(PostmasterTools service, String domainName) throws IOException {
  String query = String.format("domains/%s/complianceStatus", domainName);
  ComplianceStatus complianceStatus = service.domains().getComplianceStatus(query).execute();
  System.out.println(complianceStatus.toPrettyString());
  return complianceStatus;
}

Python

"""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.
  """
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('An error occurred: %s' % err)

Bei Erfolg enthält der Antworttext eine Instanz von ComplianceStatus.