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 có sẵn. Trả về PERMISSION_DENIED nếu người dùng không có quyền truy cập 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

Thông số
parent

string

Tên tài nguyên của miền có thống kê lưu lượng truy cập mà chúng tôi muốn liệt kê. Tên 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

Thông số
startDate

object (Date)

Ngày đầu tiên của chỉ số cần truy xuất toàn bộ. Cả startDate và endDate đều phải được chỉ định hoặc không chỉ định cả hai. Nếu chỉ có một giá trị được chỉ định hoặc endDate sớm hơn startDate, thì INVALID_ARGUMENT sẽ được trả về.

endDate

object (Date)

Ngày gần đây nhất của chỉ số để truy xuất dữ liệu độc quyền. Cả startDate và endDate đều phải được chỉ định hoặc không chỉ định cả hai. Nếu chỉ có một giá trị được chỉ định hoặc endDate sớm hơn startDate, thì INVALID_ARGUMENT sẽ được trả về.

pageSize

integer

Kích thước trang được yêu cầu. Máy chủ có thể trả về ít TrafficStats hơn so với yêu cầu. Nếu bạn không 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ừ một yêu cầu Danh sách 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
}
Trường
trafficStats[]

object (TrafficStats)

Danh sách 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òn kết quả nào 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 nhật. 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 Lịch Gregory. Thông tin này có thể đại diện cho một trong những trường hợp 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, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
  • Một năm riêng biệt, tháng không tháng và ngày không tháng.
  • 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
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.

month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 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ị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.