Method: domains.trafficStats.list

Liệt kê số liệu thống kê về lưu lượng truy cập cho tất cả các ngày hiện có. Trả về PERMISSION_DENIED nếu người dùng không có quyền truy cập vào TrafficStats cho miền.

Yêu cầu HTTP

GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
parent

string

Tên tài nguyên của miền có số liệu thống kê lưu lượng truy cập mà chúng tôi muốn liệt kê. Miền phải có dạng domains/{domain_name}, trong đó domain_name là tên miền đủ điều kiện.

Tham số truy vấn

Các tham số
startDate

object (Date)

Ngày sớm nhất của chỉ số để truy xuất bao gồm. startDate và endDate phải được chỉ định hoặc không xác định cả hai. Nếu chỉ có một giá trị được chỉ định hoặc endDate sớm hơn thời gian startDate thì INVALID_ACCOUNT sẽ được trả về.
endDate

object (Date)

Ngày gần đây nhất của số liệu để truy xuất loại trừ. startDate và endDate phải được chỉ định hoặc không xác định cả hai. Nếu chỉ có một giá trị được chỉ định hoặc endDate sớm hơn thời gian startDate thì INVALID_ACCOUNT sẽ được trả về.
pageSize

integer

Kích thước trang được yêu cầu. Máy chủ có thể trả về ít lưu lượng truy cập hơn so với yêu cầu. Nếu bạn chưa chỉ định, máy chủ sẽ chọn một chế độ mặc định phù hợp.
pageToken

string

Giá trị nextPageToken được trả về từ yêu cầu List trước đó, nếu có. Đây là giá trị của ListTrafficStatsResponse.next_page_token được trả về từ lệnh gọi trước đến phương thức trafficStats.list.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho trafficStats.list.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
Các trường
trafficStats[]

object (TrafficStats)

Danh sách của TrafficStats.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không có kết quả nào khác trong danh sách.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/postmaster.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có một năm, có một tháng không có ngày nào.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Các trường
year

integer

Năm của ngày tháng. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc 0 để chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.