بازیابی معیارهای ایمیل

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

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

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

بازیابی معیارها برای یک روز خاص

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

جاوا

/**
   * Gets the traffic stats for a domain for a specific date.
   *
   * @param service Authorized Gmail PostmasterTools API instance.
   * @param domainName The fully qualified domain name.
   * @param date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
   * @return The traffic stats of the domain for this date.
   * @throws IOException
   */
public static TrafficStats getTrafficStats(PostmasterTools service, String domainName, String date) throws IOException {
  String query = String.format("domains/%s/trafficStats/%s", domainName, date);
  TrafficStats trafficStats = service.domains().trafficStats().get(query).execute();
  System.out.println(trafficStats.toPrettyString());
  return trafficStats;
}

پایتون

"""Gets the traffic stats for a domain for a specific date.

  Args:
  service: Authorized Gmail PostmasterTools API instance.
  domain_name: The fully qualified domain name.
  date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.

  Returns:
  The traffic stats of the domain for this date.
  """
def get_traffic_stats(service, domain_name, date):
    """Gets the traffic stats for a domain for a specific date.

  Args:
    service: Authorized Gmail PostmasterTools API instance.
    domain_name: The fully qualified domain name.
    date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.

  Returns:
    The traffic stats of the domain for this date.
    """
    try:
        query = 'domains/%s/trafficStats/%s' %(domain_name,date)
        traffic_stats = service.domains().trafficStats().get(name=query).execute();
        print(traffic_stats);
        return traffic_stats;
    except errors.HttpError as err:
        print('An error occurred: %s' % err)

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

بازیابی معیارها برای تمام روزها

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

جاوا

/**
   * Lists traffic statistics for all available days.
   *
   * @param service Authorized Gmail PostmasterTools API instance.
   * @param domainName The fully qualified domain name.
   * @param pageSize The number of TrafficStats to get per request.
   * @param pageToken The nextPageToken value returned from a previous List request, if any.
   * @return Response message for list traffic stats request.
   * @throws IOException
   */
public static ListTrafficStatsResponse listTrafficStats(PostmasterTools service, String domainName,
                                                      int pageSize,
                                                      String pageToken) throws IOException {
  ListTrafficStatsResponse listTrafficStatsResponse = service.domains().trafficStats().list("domains/" + domainName)
          .setPageSize(pageSize)
          .setPageToken(pageToken)
          .execute();
  System.out.println(listTrafficStatsResponse.toPrettyString());
  return null;
}

پایتون

"""Gets the traffic stats for a domain for a specific date.

  Args:
  service: Authorized Gmail PostmasterTools API instance.
  domain_name: The fully qualified domain name.
  date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
  page_size The number of TrafficStats to get per request.
  page_token The nextPageToken value returned from a previous List request, if any.

  Returns:
  The traffic stats of the domain for this date.
  """
def list_traffic_stats(service, domain_name, date, page_size, page_token):
  """Gets the traffic stats for a domain for a specific date.

    Args:
    service: Authorized Gmail PostmasterTools API instance.
    domain_name: The fully qualified domain name.
    date The date to get the domain traffic stats. Must be in "YYYYMMDD" format.
    page_size The number of TrafficStats to get per request.
    page_token The nextPageToken value returned from a previous List request, if any.

    Returns:
    The traffic stats of the domain for this date.
    """
    try:
        query = 'domains/' + domain_name
        list_traffic_stats_response = service.domains().trafficStats().list(parent=query, pageSize=page_size, pageToken=page_token).execute();
        print(list_traffic_stats_response);
        return list_traffic_stats_response;
    except errors.HttpError as err:
        print('An error occurred: %s' % err)

if __name__ == '__main__':
    main()

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

{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}