Truy xuất số liệu thống kê về email

Bạn có thể truy xuất số liệu thống kê về email cho một phạm vi ngày cụ thể trên một miền cụ thể.

Để biết thông tin về cách cải thiện một số số liệu thống kê, hãy tham khảo bài viết Ngăn tình trạng thư gửi đến người dùng Gmail bị chặn hoặc chuyển vào thư mục thư rác.

Lưu ý: Nếu không thấy giá trị cho một số số liệu thống kê, thì có thể bạn không gửi đủ số lượng email mỗi ngày. Chỉ những miền gửi thư cho ít nhất 50 người dùng mỗi ngày mới nhận được số liệu thống kê. Để biết thêm thông tin, hãy tham khảo Câu hỏi thường gặp về Postmaster Tools.

Truy xuất số liệu thống kê cho một phạm vi ngày

Để truy xuất số liệu thống kê cho một phạm vi ngày cụ thể, hãy gọi domains.domainStats.query() bằng miền và phạm vi ngày. Sau đây là một mã mẫu cho biết cách truy xuất số liệu thống kê về email cho một khoảng thời gian cụ thể:

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}')

Nếu thành công, nội dung phản hồi sẽ chứa một mảng được phân trang gồm DomainStat có cấu trúc sau:

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

Truy xuất trạng thái tuân thủ của một miền

Để truy xuất trạng thái tuân thủ của một miền, hãy gọi domains.getComplianceStatus() bằng miền đó. Trạng thái tuân thủ chứa thông tin tuân thủ cho Khung chính sách người gửi (SPF), Thư được xác thực bằng khoá miền (DKIM) và Báo cáo và hợp chuẩn, xác thực thư dựa trên miền (DMARC). Sau đây là một đoạn mã mẫu cho biết cách truy xuất trạng thái tuân thủ của một miền:

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}')

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của DomainComplianceStatus.