Method: vitals.errors.reports.search

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. रिपोर्ट का पैरंट रिसॉर्स, जिसमें वह ऐप्लिकेशन शामिल है जिसके लिए उन्हें मिला था.

फ़ॉर्मैट: ऐप्लिकेशन/{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: सिर्फ़ अनुरोध किए गए टाइप की गड़बड़ी की रिपोर्ट से मेल खाता है. मान्य उम्मीदवार: JAVA_CRASH, NATIVE_CRASH, ANR. उदाहरण: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: सिर्फ़ अनुरोध की गई गड़बड़ी के आईडी से जुड़ी गड़बड़ी की रिपोर्ट से मेल खाता है. उदाहरण: errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: यह गड़बड़ी की रिपोर्ट से, ऐप्लिकेशन की प्रोसेस की स्थिति के बारे में मैच करता है. इससे पता चलता है कि कोई ऐप्लिकेशन फ़ोरग्राउंड में चलता है (उपयोगकर्ता को दिखता है) या बैकग्राउंड में. मान्य उम्मीदवार: FOREGROUND, BACKGROUND. उदाहरण: appProcessState = FOREGROUND.
  • isUserPerceived: यूज़र-पर्सीव्ड गड़बड़ी की रिपोर्ट से मेल खाता है. इसके साथ कोई ऑपरेटर काम नहीं करता. उदाहरण: isUserPerceived.

** काम करने वाले ऑपरेटर:**

  • कंपैरिज़न ऑपरेटर: 'बराबरी', काम करने वाला सिर्फ़ एक तुलना ऑपरेटर है. फ़िल्टर किया गया फ़ील्ड, तुलना की बाईं ओर दिखना चाहिए.
  • लॉजिकल ऑपरेटर: लॉजिकल ऑपरेटर AND और OR का इस्तेमाल, कंजंक्टिव नॉर्मल फ़ॉर्म (CNF) के बाद जटिल फ़िल्टर बनाने के लिए किया जा सकता है. जैसे, संयोजकों के समुच्चयबोधक. 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)

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

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

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

खोज क्वेरी से मिलती-जुलती गड़बड़ियों की रिपोर्ट की पेज नंबर वाली सूची के साथ जवाब.

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

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

object (ErrorReport)

गड़बड़ी की शिकायतें मिली.
nextPageToken

string

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

अनुमति देने के दायरे

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

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

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