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 गड़बड़ियों की जानकारी दिखेगी. इसकी ज़्यादा से ज़्यादा वैल्यू 1000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, उसे 1000 पर सेट कर दिया जाएगा.
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 देखें.