- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Ngày
- Hãy làm thử!
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
Tham số | |
---|---|
parent |
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 |
Tham số truy vấn
Tham số | |
---|---|
startDate |
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 |
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 |
Kích thước trang được yêu cầu. Máy chủ có thể trả về ít TrafficStats hơn mức 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 |
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 |
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 ( |
Trường | |
---|---|
trafficStats[] |
Danh sách TrafficStats. |
nextPageToken |
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ể là 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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Biểu diễn dưới dạng JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Trường | |
---|---|
year |
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 |
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 |
Ngày trong tháng. Phải có giá trị 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. |