您可以擷取特定網域在特定日期範圍內的電子郵件統計資料。
如要瞭解如何改善特定統計資料，請參閱「避免寄給 Gmail 使用者的郵件遭到封鎖或歸類為垃圾郵件」。
擷取指定日期範圍的統計資料
如要擷取特定日期範圍的統計資料，請呼叫 domains.domainStats.query()，並提供網域和日期範圍。以下程式碼範例說明如何擷取特定日期範圍的電子郵件統計資料：
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()
如果成功，回應主體會包含 DomainStats 的分頁陣列，結構如下：
{
"domainStats": [
{
object (DomainStats)
}
],
"nextPageToken": string
}
擷取網域的法規遵循狀態
如要擷取網域的合規狀態，請使用網域呼叫
domains.getComplianceStatus()。合規狀態包含寄件者政策架構 (SPF)、DomainKeys Identified Mail (DKIM) 和網域型郵件驗證、報告與一致性 (DMARC) 的合規資訊。以下程式碼範例說明如何擷取網域的法規遵循狀態：
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)
如果成功，回應主體會包含 ComplianceStatus 的執行個體。