استرداد إحصاءات البريد الإلكتروني

يمكنك استرداد إحصاءات البريد الإلكتروني لنطاق زمني محدّد على نطاق محدّد.

للحصول على معلومات حول كيفية تحسين إحصاءات معيّنة، يُرجى الرجوع إلى منع حظر الرسائل الإلكترونية المُرسَلة إلى مستخدمي Gmail أو إرسالها إلى مجلد الرسائل غير المرغوب فيها.

ملاحظة: إذا لم تظهر لك قيم لبعض الإحصاءات، من المحتمل أنّك لا ترسل عددًا كافيًا من الرسائل الإلكترونية يوميًا. لا تتلقّى الإحصاءات سوى النطاقات التي ترسل رسائل إلكترونية إلى 50 مستخدمًا على الأقل يوميًا. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول أدوات Postmaster.

استرداد الإحصاءات لنطاق زمني

لاسترداد إحصاءات لنطاق زمني محدّد، استدعِ الدالة 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;
}

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

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على مصفوفة مقسّمة إلى صفحات من 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;
}

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)

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ComplianceStatus.