Method: vitals.errors.reports.search

यह किसी ऐप्लिकेशन के लिए मिली गड़बड़ी की सभी रिपोर्ट खोजता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. रिपोर्ट का पैरंट रिसॉर्स. इससे पता चलता है कि रिपोर्ट किस ऐप्लिकेशन के लिए मिली हैं.

फ़ॉर्मैट: apps/{app}

क्वेरी पैरामीटर

पैरामीटर
interval

object (DateTimeInterval)

गड़बड़ी की रिपोर्ट खोजने के लिए, तारीख और समय का इंटरवल. शुरू और खत्म होने का समय, घंटे के हिसाब से होना चाहिए. साथ ही, टाइमज़ोन के लिए UTC का इस्तेमाल करना चाहिए. अगर टाइमज़ोन की जानकारी नहीं दी जाती है, तो भी UTC का इस्तेमाल किया जाएगा.

अगर यह सेट है, तो इस समयावधि में हुई गड़बड़ियों की रिपोर्ट ही दिखाई जाएंगी. अगर कोई समय अंतराल नहीं दिया गया है, तो पिछले 24 घंटों के डिफ़ॉल्ट समय अंतराल का इस्तेमाल किया जाएगा.
pageSize

integer

ज्यादा से ज्यादा कितनी रिपोर्ट दिखानी हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 50 रिपोर्ट दिखेंगी. ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. 100 से ज़्यादा वैल्यू को 100 में बदल दिया जाएगा.
pageToken

string

यह एक पेज टोकन है, जो पिछले reports.search कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से नतीजे दिखाने के दौरान, reports.search को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.
filter

string

रिपोर्ट का सिर्फ़ एक सबसेट पाने के लिए, चुनने की शर्त.

फ़िल्टर करने के बारे में बुनियादी जानकारी के लिए, कृपया AIP-160 देखें.

** इस्तेमाल किए जा सकने वाले फ़ील्ड के नाम:**

  • apiLevel: यह सिर्फ़ उन Android वर्शन में हुई गड़बड़ियों की रिपोर्ट से मेल खाता है जिनके लिए अनुरोध किया गया है. इन्हें सिर्फ़ संख्या वाले एपीआई लेवल के तौर पर दिखाया जाता है. उदाहरण: apiLevel = 28 OR apiLevel = 29.
  • versionCode: यह सिर्फ़ अनुरोध किए गए ऐप्लिकेशन वर्शन कोड में हुई गड़बड़ियों की रिपोर्ट से मेल खाता है. उदाहरण: versionCode = 123 OR versionCode = 456.
  • deviceModel: इससे अनुरोध किए गए डिवाइसों में हुई गड़बड़ियों का पता चलता है. उदाहरण: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: यह अनुरोध किए गए डिवाइस के ब्रैंड में हुई गड़बड़ियों से मेल खाता है. उदाहरण: `deviceBrand = "Google".
  • deviceType: यह अनुरोध किए गए डिवाइस टाइप में हुई गड़बड़ी की रिपोर्ट से मेल खाती है. उदाहरण: deviceType = "PHONE".
  • errorIssueType: सिर्फ़ अनुरोध किए गए टाइप की गड़बड़ी की रिपोर्ट से मेल खाता है. मान्य उम्मीदवार: CRASH, ANR, NON_FATAL. उदाहरण: errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId: यह सिर्फ़ उन गड़बड़ियों की रिपोर्ट से मैच करता है जिनके लिए गड़बड़ी के आईडी का अनुरोध किया गया है. उदाहरण: errorIssueId = 1234 OR errorIssueId = 4567.
  • errorReportId: गड़बड़ी की रिपोर्ट के आईडी के लिए अनुरोध की गई गड़बड़ी की रिपोर्ट से मेल खाती है. उदाहरण: errorReportId = 1234 OR errorReportId = 4567.
  • appProcessState: यह ऐप्लिकेशन की प्रोसेस की स्थिति के बारे में गड़बड़ी की रिपोर्ट से मेल खाता है. इससे पता चलता है कि ऐप्लिकेशन फ़ोरग्राउंड (उपयोगकर्ता को दिखने वाला) या बैकग्राउंड में चलता है. मान्य उम्मीदवार: FOREGROUND, BACKGROUND. उदाहरण: appProcessState = FOREGROUND.
  • isUserPerceived: यह उपयोगकर्ता को दिखने वाली गड़बड़ियों की रिपोर्ट से मैच करती है. इसके साथ कोई ऑपरेटर नहीं है. उदाहरण: isUserPerceived.

** ये ऑपरेटर इस्तेमाल किए जा सकते हैं:**

  • तुलना करने वाले ऑपरेटर: सिर्फ़ इक्वलिटी ऑपरेटर का इस्तेमाल किया जा सकता है. तुलना में फ़िल्टर किया गया फ़ील्ड, बाईं ओर दिखना चाहिए.
  • लॉजिकल ऑपरेटर: लॉजिकल ऑपरेटर AND और OR का इस्तेमाल करके, कंजंक्टिव नॉर्मल फ़ॉर्म (सीएनएफ़) के हिसाब से कॉम्प्लेक्स फ़िल्टर बनाए जा सकते हैं. जैसे, कंजंक्शन ऑफ़ डिसजंक्शन. OR ऑपरेटर को AND ऑपरेटर से ज़्यादा प्राथमिकता मिलती है. इसलिए, CNF बनाते समय कोष्ठक का इस्तेमाल करना ज़रूरी नहीं है.

OR ऑपरेटर का इस्तेमाल सिर्फ़ ऐसे डिसजंक्शन बनाने के लिए किया जा सकता है जो एक ही फ़ील्ड पर लागू होते हैं. उदाहरण के लिए, versionCode = 123 OR versionCode = ANR. फ़िल्टर एक्सप्रेशन versionCode = 123 OR errorIssueType = ANR मान्य नहीं है.

** उदाहरण **

फ़िल्टर करने के कुछ मान्य एक्सप्रेशन: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

जवाब में, सर्च क्वेरी से मेल खाने वाली गड़बड़ी की रिपोर्ट की पेज के हिसाब से सूची दी गई है.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
errorReports[]

object (ErrorReport)

मिली हुई गड़बड़ी की रिपोर्ट.
nextPageToken

string

रिपोर्ट का अगला पेज फ़ेच करने के लिए पेज टोकन.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.