Method: domains.trafficStats.list

แสดงรายการสถิติการเข้าชมสำหรับวันที่มีให้บริการทั้งหมด แสดงผล PERMISSION_DENIED หากผู้ใช้ไม่มีสิทธิ์เข้าถึง TrafficStats สำหรับโดเมน

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ชื่อทรัพยากรของโดเมนที่เราจะแสดงสถิติการเข้าชม ซึ่งควรอยู่ในรูปแบบ domains/{domain_name} โดยที่ domain_name คือชื่อโดเมนที่สมบูรณ์ในตัวเอง

พารามิเตอร์การค้นหา

พารามิเตอร์
startDate

object (Date)

วันแรกของเมตริกที่จะเรียกข้อมูลจะต้องระบุ startDate และ endDate หรือไม่ได้ระบุทั้งคู่ ถ้าระบุเพียง 1 ตัว หรือ endDate อยู่ก่อนเวลา startDate ระบบจะแสดงผล INVALID_ARGUMENT
endDate

object (Date)

วันที่ล่าสุดของเมตริกที่จะเรียกข้อมูลเฉพาะตัว คุณต้องระบุทั้ง startDate และ endDate หรือไม่ได้ระบุทั้งคู่ ถ้าระบุเพียง 1 ตัว หรือ endDate อยู่ก่อนเวลา startDate ระบบจะแสดงผล INVALID_ARGUMENT
pageSize

integer

ขนาดหน้าที่ขอ เซิร์ฟเวอร์อาจแสดงผล TrafficStats น้อยกว่าที่ขอ หากไม่ระบุ เซิร์ฟเวอร์จะเลือกค่าเริ่มต้นที่เหมาะสม
pageToken

string

ค่า nextPageToken ที่แสดงผลจากคำขอรายการก่อนหน้า หากมี นี่คือค่าของ ListTrafficStatsResponse.next_page_token ที่ส่งคืนจากการเรียกไปยังเมธอด trafficStats.list ก่อนหน้านี้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ trafficStats.list

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "trafficStats": [
    {
      object (TrafficStats)
    }
  ],
  "nextPageToken": string
}
ช่อง
trafficStats[]

object (TrafficStats)

รายการ TrafficStats
nextPageToken

string

โทเค็นสำหรับดึงผลการค้นหาหน้าถัดไป หรือเว้นว่างไว้หากไม่มีผลลัพธ์เพิ่มเติมในรายการ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • วันที่แบบเต็มพร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • 1 ปีเท่านั้น โดยมี 0 เดือนกับ 0 วัน
  • ปีและเดือนที่มี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่ต้องใส่ปี
month

integer

เดือนของปี ค่านี้ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ