Method: publishers.items.queryMetrics

ค้นหาเมตริกสำหรับสินค้า

คำขอ HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

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

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

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

string

ต้องระบุ ชื่อของรายการที่จะค้นหาเมตริก รูปแบบ: publishers/{publisher}/items/{item}

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

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

object (TimeSpec)

ต้องระบุ ข้อกำหนดเวลาในการค้นหาชุดเมตริก
metrics[]

string

ต้องระบุ เมตริกที่จะค้นหาชุดเมตริก

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

  • installs: จำนวนการติดตั้งรายการ
  • installs-7d: จำนวนการติดตั้งรายการในช่วง 7 วันที่ผ่านมา
  • uninstalls: จำนวนการถอนการติดตั้งรายการ
  • users: จำนวนผู้ใช้ที่ใช้งานอยู่รายวันของรายการ
  • users-7d: จำนวนผู้ใช้ที่ใช้งานอยู่ 7 วันของรายการ
  • การแสดงผล: จำนวนการแสดงผลของสินค้าในหน้าร้านทั้งหมด
  • page-views: จำนวนการดูหน้ารายละเอียดของรายการ
dimensions[]

string

ไม่บังคับ มิติข้อมูลที่จะแบ่งเมตริกตาม ระบุมิติข้อมูลได้สูงสุด 1 รายการ

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

  • os: ระบบปฏิบัติการของผู้ใช้
  • app-version: เวอร์ชันของสินค้า
  • country: ประเทศของผู้ใช้
  • install-source: แหล่งที่มาของการติดตั้ง
  • install-type: ประเภทการติดตั้ง (จากเว็บสโตร์, ในหน้า หรืออื่นๆ)
  • language: ภาษาของผู้ใช้
  • enabled: รายการเปิดใช้หรือปิดใช้อยู่
  • utm-campaign: แคมเปญ UTM ของผู้ใช้
  • utm-content: เนื้อหา UTM ของผู้ใช้
  • utm-medium: สื่อ UTM ของผู้ใช้
  • utm-source: แหล่งที่มา UTM ของผู้ใช้
  • utm-term: คำ UTM ของผู้ใช้
pageSize

integer

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

string

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

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

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

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

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

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

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

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

object (MetricRow)

แถวเมตริก
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken ได้เพื่อดึงข้อมูลหน้าถัดไป หากไม่มีช่องนี้ แสดงว่าไม่มีหน้าถัดไป

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

TimeSpec

ช่วงวันที่สำหรับการค้นหาเมตริก

การแสดง JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
ฟิลด์
firstDate

object (Date)

ไม่บังคับ วันที่แรก (รวม) ของข้อกำหนดเวลา หากไม่ได้ตั้งค่า ระบบจะไม่ใช้ขอบเขตที่ต่ำกว่า
lastDate

object (Date)

ไม่บังคับ วันที่ล่าสุด (รวม) ของข้อกำหนดเวลา หากไม่ได้ตั้งค่า ระบบจะไม่ใช้ขอบเขตบน

วันที่

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

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน โดยมีปีเป็นศูนย์ (เช่น วันครบรอบ)
  • ปีอย่างเดียว โดยมีเดือนเป็นศูนย์และวันเป็นศูนย์
  • ปีและเดือน โดยมีวันที่เป็นศูนย์ (เช่น วันที่หมดอายุของบัตรเครดิต)

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

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

integer

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

integer

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

integer

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

MetricRow

เมตริกและค่ามิติข้อมูลแถวเดียว

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
ช่อง
date

object (Date)

วันที่ของบันทึก
dimensionValues[]

string

คอลัมน์ค่ามิติข้อมูลสำหรับแถว
metricValues[]

object (MetricValue)

คอลัมน์เมตริกสำหรับแถว

MetricValue

แสดงค่าของเมตริกเดียว

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

string

ชื่อของเมตริก
value

string (int64 format)

ค่าของเมตริก
uniqueUserCount

string (int64 format)

จํานวนผู้ใช้ที่ไม่ซ้ำซึ่งเชื่อมโยงกับเมตริก (หากมี)