Method: vitals.errors.issues.search

यह उन सभी गड़बड़ियों को खोजता है जिनमें रिपोर्ट को ग्रुप किया गया है.

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. गड़बड़ी की समस्याओं का पैरंट संसाधन. इससे पता चलता है कि ये समस्याएं किस ऐप्लिकेशन के लिए मिली हैं.

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

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

पैरामीटर
interval

object (DateTimeInterval)

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

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

integer

गड़बड़ी की ज़्यादा से ज़्यादा कितनी समस्याएं दिखानी हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

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

string

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

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

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

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

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

** उदाहरण **

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

string

इस फ़ील्ड का इस्तेमाल, नतीजों को क्रम से लगाने के लिए किया जाएगा.

** इस्तेमाल किए जा सकने वाले डाइमेंशन:**

  • errorReportCount: गड़बड़ी की रिपोर्ट की संख्या के हिसाब से, ऑर्डर से जुड़ी समस्याओं को क्रम से लगाता है.
  • distinctUsers: इससे, उन यूनीक उपयोगकर्ताओं की संख्या के हिसाब से ऑर्डर की समस्याएं दिखती हैं जिन पर असर पड़ा है.

** ये कार्रवाइयां की जा सकती हैं:**

  • asc को बढ़ते क्रम में लगाएं.
  • घटते क्रम के लिए desc.

फ़ॉर्मैट: एक फ़ील्ड और एक ऑपरेशन, जैसे कि errorReportCount desc

ध्यान दें: फ़िलहाल, एक बार में सिर्फ़ एक फ़ील्ड का इस्तेमाल किया जा सकता है.
sampleErrorReportLimit

integer

ज़रूरी नहीं. हर ErrorIssue के लिए, गड़बड़ी की रिपोर्ट के कितने सैंपल दिखाने हैं. अगर यह वैल्यू नहीं दी गई है, तो 0 का इस्तेमाल किया जाएगा. ध्यान दें: फ़िलहाल, सिर्फ़ 0 और 1 के लिए यह सुविधा उपलब्ध है.

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

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

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

जवाब में, अनुरोध से मेल खाने वाली समस्याओं की पेज के हिसाब से सूची दी गई है.

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

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

object (ErrorIssue)

ErrorIssues that were found.
nextPageToken

string

डेटा का अगला पेज फ़ेच करने के लिए, जारी रखने का टोकन.

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

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

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

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