بازیابی آمار ایمیل‌ها

شما می‌توانید آمار ایمیل را برای یک محدوده تاریخی خاص در یک دامنه خاص بازیابی کنید.

برای کسب اطلاعات در مورد نحوه بهبود برخی آمارها، به جلوگیری از مسدود شدن یا ارسال ایمیل به کاربران Gmail به هرزنامه مراجعه کنید.

توجه: اگر مقادیر برخی از آمارها را نمی‌بینید، ممکن است به اندازه کافی ایمیل روزانه ارسال نکنید. فقط دامنه‌هایی که روزانه حداقل به ۵۰ کاربر ایمیل ارسال می‌کنند، آمار را دریافت می‌کنند. برای اطلاعات بیشتر، به سوالات متداول ابزارهای مدیریت ایمیل مراجعه کنید.

بازیابی آمار برای یک محدوده تاریخ

برای بازیابی آمار برای یک محدوده تاریخ خاص، تابع domains.domainStats.query() را با دامنه و محدوده تاریخ فراخوانی کنید. در زیر نمونه کدی آمده است که نحوه بازیابی آمار ایمیل برای یک محدوده تاریخ خاص را نشان می‌دهد:

جاوا

/**
   * 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;
}

پایتون

"""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()

در صورت موفقیت، بدنه پاسخ شامل یک آرایه صفحه‌بندی شده از DomainStats با ساختار زیر است:

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

بازیابی وضعیت انطباق برای یک دامنه

برای بازیابی وضعیت انطباق برای یک دامنه، تابع domains.getComplianceStatus() را با دامنه فراخوانی کنید. وضعیت انطباق شامل اطلاعات انطباق برای چارچوب سیاست فرستنده (SPF)، ایمیل شناسایی‌شده با کلیدهای دامنه (DKIM) و احراز هویت، گزارش‌دهی و انطباق پیام مبتنی بر دامنه (DMARC) است. در زیر نمونه کدی آمده است که نحوه بازیابی وضعیت انطباق برای یک دامنه را نشان می‌دهد:

جاوا

/**
   * 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;
}

پایتون

"""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)

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از ComplianceStatus است.