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

object (Date)

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