- 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 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 |
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 |
Tham số truy vấn
Các tham số | |
---|---|
startDate |
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 |
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 |
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 |
Giá trị nextPageToken được trả về từ yêu cầu List 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 ( |
Các trường | |
---|---|
trafficStats[] |
Danh sách của 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ó 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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Biểu diễn dưới dạng JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Các trường | |
---|---|
year |
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 |
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 |
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. |