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 หรือไม่ได้ระบุทั้งคู่ หากระบุไว้เพียงค่าเดียว หรือ endDate อยู่ก่อนเวลา startDate ระบบจะแสดงผล INVALID_ARGUMENT

endDate

object (Date)

วันที่ล่าสุดของเมตริกสำหรับดึงข้อมูลสุดพิเศษ ต้องระบุทั้ง startDate และ endDate หรือไม่ได้ระบุทั้งคู่ หากระบุไว้เพียงค่าเดียว หรือ 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 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

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

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

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี

month

integer

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

day

integer

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