Method: vitals.errors.reports.search

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

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

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{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 देखें.