Method: projects.getMetrics

รับข้อมูลเมตริกสำหรับสคริปต์ เช่น จำนวนการดำเนินการและผู้ใช้ที่ใช้งานอยู่

คำขอ HTTP

GET https://script.googleapis.com/v1/projects/{scriptId}/metrics

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

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

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

string

ช่องที่ต้องกรอกซึ่งระบุสคริปต์ที่จะรับเมตริก

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

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

enum (MetricsGranularity)

ช่องที่ต้องกรอกซึ่งระบุรายละเอียดของเมตริกที่จะแสดงผล

metricsFilter

object (MetricsFilter)

ช่องที่ไม่บังคับซึ่งมีตัวกรองที่จะใช้กับคำขอ ซึ่งจะจำกัดขอบเขตของเมตริกที่ส่งคืนกลับไปยังเมตริกที่ระบุไว้ในตัวกรอง

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

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

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

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

ทรัพยากรที่มีสถิติการใช้งานสำหรับสคริปต์ที่ระบุ โดยอิงตามตัวกรองและมาสก์ที่ให้ไว้ซึ่งอยู่ในคำขอ

การแสดง JSON
{
  "activeUsers": [
    {
      object (MetricsValue)
    }
  ],
  "totalExecutions": [
    {
      object (MetricsValue)
    }
  ],
  "failedExecutions": [
    {
      object (MetricsValue)
    }
  ]
}
ช่อง
activeUsers[]

object (MetricsValue)

จำนวนผู้ใช้ที่ใช้งานอยู่

totalExecutions[]

object (MetricsValue)

จำนวนการดำเนินการทั้งหมด

failedExecutions[]

object (MetricsValue)

จำนวนการดำเนินการที่ไม่สำเร็จ

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

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

  • https://www.googleapis.com/auth/script.metrics

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

MetricsGranularity

รายละเอียดของเมตริกที่จะแสดงข้อมูล

Enum
UNSPECIFIED_GRANULARITY รายละเอียดเมตริกเริ่มต้นที่ใช้ในการค้นหาไม่มีเมตริก
WEEKLY แสดงเมตริกรายสัปดาห์
DAILY แสดงเมตริกรายวันในระยะเวลา 7 วัน

MetricsFilter

ตัวกรองที่ใช้เพื่อลดขอบเขตของคำขอ

การแสดง JSON
{
  "deploymentId": string
}
ช่อง
deploymentId

string

ช่องที่ไม่บังคับซึ่งระบุการติดตั้งใช้งานที่เฉพาะเจาะจงเพื่อดึงข้อมูลเมตริก

MetricsValue

ค่าเมตริกที่เก็บจำนวนการดำเนินการที่นับ

การแสดง JSON
{
  "value": string,
  "startTime": string,
  "endTime": string
}
ช่อง
value

string

ระบุจำนวนการดำเนินการที่นับ

startTime

string (Timestamp format)

ช่องที่ต้องกรอกซึ่งระบุเวลาเริ่มต้นของช่วงเวลา

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

ช่องที่ต้องกรอกซึ่งระบุเวลาสิ้นสุดของช่วงเวลา

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"