Method: vitals.errors.issues.search

Menelusuri semua masalah error yang laporan-laporannya telah dikelompokkan.

Permintaan HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorIssues:search

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk dari masalah error, yang menunjukkan aplikasi yang menerima masalah error tersebut.

Format: apps/{app}

Parameter kueri

Parameter
interval

object (DateTimeInterval)

Opsional. Interval tanggal dan waktu untuk menelusuri masalah error. Waktu mulai dan berakhir harus selaras dengan jam dan menggunakan UTC sebagai zona waktu (atau kosong, yang dalam hal ini UTC juga akan digunakan).

Jika ditetapkan, hanya masalah error dengan laporan error terkait yang terjadi dalam interval tersebut yang akan ditampilkan. Jika tidak ditentukan, interval default 24 jam terakhir akan digunakan.

pageSize

integer

Opsional. Jumlah maksimum masalah error yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.

Jika tidak ditentukan, paling banyak 50 masalah error akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.

pageToken

string

Opsional. Token halaman, yang diterima dari panggilan sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk permintaan harus sesuai dengan panggilan yang memberikan token halaman.

filter

string

Opsional. Predikat pilihan untuk mengambil hanya sebagian masalah. Jumlah dalam masalah error yang ditampilkan hanya akan mencerminkan kejadian yang cocok dengan filter.

Untuk mengetahui dasar-dasar pemfilteran, lihat AIP-160.

** Nama kolom yang didukung:**

  • apiLevel: Hanya cocok dengan masalah error yang terjadi di versi Android yang diminta (ditentukan sebagai level API numerik). Contoh: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Hanya cocok dengan masalah error yang terjadi di kode versi aplikasi yang diminta. Contoh: versionCode = 123 OR versionCode = 456.
  • deviceModel: Cocok dengan masalah error yang terjadi di perangkat yang diminta. Contoh: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: Cocok dengan masalah error yang terjadi di merek perangkat yang diminta. Contoh: `deviceBrand = "Google".
  • deviceType: Cocok dengan masalah error yang terjadi di jenis perangkat yang diminta. Contoh: deviceType = "PHONE".
  • errorIssueType: Hanya cocok dengan masalah error dari jenis yang diminta. Kandidat yang valid: CRASH, ANR, NON_FATAL. Contoh: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: Cocok dengan masalah error pada status proses aplikasi, yang menunjukkan apakah aplikasi berjalan di latar depan (terlihat oleh pengguna) atau latar belakang. Kandidat yang valid: FOREGROUND, BACKGROUND. Contoh: appProcessState = FOREGROUND.
  • isUserPerceived: Cocok dengan masalah error yang dirasakan pengguna. Tidak disertai operator apa pun. Contoh: isUserPerceived.

** Operator yang didukung:**

  • Operator perbandingan: Satu-satunya operator perbandingan yang didukung adalah kesetaraan. Kolom yang difilter harus muncul di sisi kiri perbandingan.
  • Operator Logis: Operator logis AND dan OR dapat digunakan untuk membuat filter kompleks yang mengikuti bentuk normal konjungtif (CNF), yaitu konjungsi disjungsi. Operator OR lebih diutamakan daripada AND sehingga penggunaan tanda kurung tidak diperlukan saat membuat CNF.

Operator OR hanya didukung untuk membuat disjungsi yang berlaku untuk kolom yang sama, misalnya, versionCode = 123 OR errorIssueType = ANR bukan filter yang valid.

** Contoh **

Beberapa ekspresi pemfilteran yang valid: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

orderBy

string

Opsional. Menentukan kolom yang akan digunakan untuk mengurutkan hasil.

** Dimensi yang didukung:**

  • errorReportCount: Mengurutkan masalah berdasarkan jumlah laporan error.
  • distinctUsers: Mengurutkan masalah berdasarkan jumlah pengguna unik yang terpengaruh.

** Operasi yang didukung:**

  • asc untuk urutan menaik.
  • desc untuk urutan menurun.

Format: Kolom dan operasi, misalnya, errorReportCount desc

Catatan: saat ini hanya satu kolom yang didukung dalam satu waktu.

sampleErrorReportLimit

integer

Opsional. Jumlah laporan error sampel yang akan ditampilkan per ErrorIssue. Jika tidak ditentukan, 0 akan digunakan. Catatan: saat ini hanya 0 dan 1 yang didukung.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons dengan daftar masalah bernomor halaman yang cocok dengan permintaan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
Kolom
errorIssues[]

object (ErrorIssue)

ErrorIssues yang ditemukan.

nextPageToken

string

Token kelanjutan untuk mengambil halaman data berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.