- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- วันที่
- ลองใช้งาน
แสดงรายการสถิติการเข้าชมของทุกวันที่มี แสดงผล PERMISSION_DENIED หากผู้ใช้ไม่มีสิทธิ์เข้าถึง TrafficStats สำหรับโดเมน
คำขอ HTTP
GET https://gmailpostmastertools.googleapis.com/v1/{parent=domains/*}/trafficStats
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ชื่อทรัพยากรของโดเมนที่มีสถิติการเข้าชมที่เราต้องการแสดง ซึ่งควรอยู่ในรูปแบบ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
startDate |
วันแรกของเมตริกที่จะดึงข้อมูลแบบรวม ต้องระบุทั้ง startDate และ endDate หรือไม่ได้ระบุทั้งคู่ หากระบุไว้เพียงค่าเดียว หรือ endDate อยู่ก่อนเวลา startDate ระบบจะแสดงผล INVALID_ARGUMENT |
endDate |
วันที่ล่าสุดของเมตริกสำหรับดึงข้อมูลสุดพิเศษ ต้องระบุทั้ง startDate และ endDate หรือไม่ได้ระบุทั้งคู่ หากระบุไว้เพียงค่าเดียว หรือ endDate อยู่ก่อนเวลา startDate ระบบจะแสดงผล INVALID_ARGUMENT |
pageSize |
ขนาดหน้าที่ขอ เซิร์ฟเวอร์อาจแสดงผล TrafficStats น้อยกว่าที่ขอ หากไม่ระบุ เซิร์ฟเวอร์จะเลือกค่าเริ่มต้นที่เหมาะสม |
pageToken |
ค่า nextPageToken ที่แสดงผลจากคำขอรายการก่อนหน้า หากมี นี่คือค่าของ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ trafficStats.list
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"trafficStats": [
{
object ( |
ช่อง | |
---|---|
trafficStats[] |
รายการ TrafficStats |
nextPageToken |
โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป หรือเว้นว่างไว้หากไม่มีผลลัพธ์เพิ่มเติมในรายการ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/postmaster.readonly
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
วันที่
แสดงวันที่ในปฏิทินบางส่วนหรือทั้งหมด เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
- วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ไม่ใช่ 0
- 1 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
- ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
- 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)
ประเภทที่เกี่ยวข้อง:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
การแสดง JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
ช่อง | |
---|---|
year |
ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี |
month |
เดือนของปี ต้องมีค่าตั้งแต่ 1 ถึง 12 หรือ 0 เพื่อระบุปีที่ไม่มีเดือนและวัน |
day |
วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และจะใช้ได้สำหรับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือ 1 ปีและเดือนที่วันไม่มีนัยสำคัญ |