Method: vitals.stuckbackgroundwakelockrate.query

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

คำขอ HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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): ประเภท (หรือที่เรียกว่าฟอร์มแฟกเตอร์) ของอุปกรณ์ของผู้ใช้ เช่น PHONE
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์เป็น MB ในบัคเก็ต (3GB, 4GB ฯลฯ)
  • deviceSocMake (string): ผู้ผลิตระบบหลักบนชิปของอุปกรณ์ เช่น Samsung Reference
  • deviceSocModel (string): รุ่นของระบบวงจรรวมบนชิปหลักของอุปกรณ์ เช่น "Exynos 2100" Reference
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น Qualcomm
  • deviceCpuModel (string): รุ่น CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ผู้ผลิต GPU ของอุปกรณ์ เช่น ARM
  • deviceGpuModel (string): รุ่น GPU ของอุปกรณ์ เช่น Mali
  • deviceGpuVersion (string): เวอร์ชัน GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น NORMAL, LARGE
  • deviceScreenDpi (string): ความหนาแน่นของหน้าจอของอุปกรณ์ เช่น mdpi, hdpi
metrics[]

string

ไม่บังคับ เมตริกที่จะรวม

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

  • stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในระยะเวลารวมที่มีการล็อกการทำงานของอุปกรณ์ในเบื้องหลังนานกว่า 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 แถว ค่าสูงสุดคือ 100,000 หากค่าสูงกว่า 100,000 ระบบจะบังคับให้เป็น 100,000
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