Method: vitals.stuckbackgroundwakelockrate.query

ค้นหาเมตริกในชุดเมตริก

คำขอ HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

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

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

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

string

ต้องระบุ ชื่อทรัพยากร

รูปแบบ: apps/{app}/stuckBackgroundWakelockRateMetricSet

เนื้อความของคำขอ

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

การแสดง JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
ช่อง
timelineSpec

object (TimelineSpec)

การระบุพารามิเตอร์การรวบรวมไทม์ไลน์

ระยะเวลาการรวบรวมที่รองรับ

  • DAILY: จะได้รับการรวบรวมในช่วงวันที่ในปฏิทิน เนื่องจากข้อจำกัดในอดีต เขตเวลาที่รองรับจึงมีเพียง America/Los_Angeles
dimensions[]

string

มิติข้อมูลที่จะใช้แบ่งข้อมูล

มิติข้อมูลที่รองรับ

  • apiLevel (string): ระดับ API ของ Android ที่ทำงานในอุปกรณ์ของผู้ใช้ เช่น 26.
  • versionCode (int64): เวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้
  • deviceModel (string): ตัวระบุที่ไม่ซ้ำกันของรุ่นอุปกรณ์ของผู้ใช้ รูปแบบของตัวระบุคือ "deviceBrand/device" โดยที่ deviceBrand สอดคล้องกับ Build.BRAND และ device สอดคล้องกับ Build.DEVICE เช่น google/coral
  • deviceBrand (string): ตัวระบุที่ไม่ซ้ำกันของแบรนด์อุปกรณ์ของผู้ใช้ เช่น google
  • deviceType (string): ประเภท (หรือที่เรียกว่ารูปแบบของอุปกรณ์) ของอุปกรณ์ของผู้ใช้ เช่น โทรศัพท์
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์เป็น MB ในกลุ่ม (3 GB, 4 GB ฯลฯ)
  • deviceSocMake (string): แบรนด์ของระบบบนชิปหลักของอุปกรณ์ เช่น Samsung ข้อมูลอ้างอิง
  • deviceSocModel (string): รุ่นของระบบบนชิปหลักของอุปกรณ์ เช่น "Exynos 2100" ข้อมูลอ้างอิง
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น Qualcomm
  • deviceCpuModel (string): รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ยี่ห้อ GPU ของอุปกรณ์ เช่น ARM
  • deviceGpuModel (string): รุ่นของ GPU ของอุปกรณ์ เช่น มาลี
  • deviceGpuVersion (string): เวอร์ชันของ GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ใหญ่
  • deviceScreenDpi (string): ความหนาแน่นของหน้าจอของอุปกรณ์ เช่น mdpi, hdpi
metrics[]

string

เมตริกที่จะรวม

เมตริกที่รองรับ

  • stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงการรวบรวมข้อมูลที่มี Wake Lock ทำงานอยู่เบื้องหลังนานกว่า 1 ชั่วโมง
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่องของ stuckBgWakelockRate ในช่วง 7 วันที่ผ่านมา ระบบจะถ่วงน้ำหนักค่ารายวันตามจำนวนผู้ใช้ที่ไม่ซ้ำกันในวันนั้น
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยต่อเนื่องของ stuckBgWakelockRate ในช่วง 28 วันที่ผ่านมา ระบบจะถ่วงน้ำหนักค่ารายวันตามจำนวนผู้ใช้ที่ไม่ซ้ำกันในวันนั้น
  • distinctUsers (google.type.Decimal): จำนวนผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวบรวมที่ใช้เป็นค่าการปรับให้เป็นค่ามาตรฐานสำหรับเมตริก stuckBgWakelockRate ระบบจะนับผู้ใช้ในเมตริกนี้หากแอปทำงานใดๆ ในอุปกรณ์ กล่าวคือ ไม่ใช่แค่การใช้งานในเบื้องหน้าที่ใช้งานอยู่ แต่ยังรวมถึงการทำงานในเบื้องหลังด้วย โปรดระมัดระวังไม่ให้รวมจำนวนนี้เพิ่มเติม เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง ระบบจะปัดเศษค่าให้เป็นค่าทวีคูณที่ใกล้เคียงที่สุดของ 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า
filter

string

ตัวกรองที่จะใช้กับข้อมูล นิพจน์การกรองเป็นไปตามมาตรฐาน AIP-160 และรองรับการกรองตามความเท่ากันของมิติข้อมูลแบบแยกรายละเอียดทั้งหมด
pageSize

integer

ขนาดสูงสุดของข้อมูลที่แสดง

หากไม่ระบุ ระบบจะแสดงผลแถวอย่างมาก 1, 000 แถว ค่าสูงสุดคือ 100000 และค่าที่สูงกว่า 100000 จะถูกบังคับให้เป็น 100000
pageToken

string

โทเค็นหน้าเว็บที่ได้รับจากการเรียกก่อนหน้า ระบุข้อมูลนี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุในคำขอต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
userCohort

enum (UserCohort)

มุมมองผู้ใช้เพื่อเลือก ข้อมูลเอาต์พุตจะสอดคล้องกับมุมมองที่เลือก ค่าที่รองรับมีเพียง OS_PUBLIC

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

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

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

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

object (MetricsRow)

แถวข้อมูลที่แสดงผล
nextPageToken

string

โทเค็นการต่อเนื่องเพื่อดึงข้อมูลหน้าถัดไป

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

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

  • https://www.googleapis.com/auth/playdeveloperreporting

ดูข้อมูลเพิ่มเติมได้ที่OAuth 2.0 Overview