Method: projects.histories.executions.steps.accessibilityClusters

दिए गए चरण के लिए, सुलभता क्लस्टर की सूची बनाता है

इनमें से कोई भी कैननिकल गड़बड़ी कोड दिख सकता है:

  • अनुमति_DENIED - अगर उपयोगकर्ता प्रोजेक्ट पढ़ने के लिए अधिकृत नहीं है
  • INVALID_LAMBDA - अगर अनुरोध के प्रारूप में दोष है
  • FAILED_PRECondition, - अगर अनुरोध में मौजूद कोई आर्ग्युमेंट अमान्य है; उदाहरण के लिए, अगर स्थान-भाषा का फ़ॉर्मैट गलत है
  • NOT_FOUND - अगर शामिल चरण मौजूद नहीं है

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

GET https://toolresults.googleapis.com/toolresults/v1beta3/{name=projects/*/histories/*/executions/*/steps/*}:accessibilityClusters

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

पाथ पैरामीटर

पैरामीटर
name

string

चरण के लिए संसाधन का पूरा नाम. उदाहरण के लिए, projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

ज़रूरी है.

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

पैरामीटर
locale

string

स्वीकार किया जाने वाला फ़ॉर्मैट, कैननिकल यूनिकोड फ़ॉर्मैट है, जिसमें डेलिमिटर के तौर पर हाइफ़न होता है. भाषा लोअरकेस, लैंग्वेज स्क्रिप्ट - कैपिटलाइज़्ड, क्षेत्र - अपरकेस होनी चाहिए. ज़्यादा जानकारी के लिए http://www.unicode.org/reports/tr35/#यूनिकोड_locale_identifier देखें.

ज़रूरी है.

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

अनुरोध का लेख खाली होना चाहिए.

जवाब का लेख

AccessibilityService.ListStepAccessibilityClusters के लिए रिस्पॉन्स मैसेज दिया जाता है.

अगर इंडेक्सिंग सही से हाे जाती है, ताे जवाब के लेख में नीचे दिए गए स्ट्रक्चर का डेटा शामिल होता है.

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

string

चरण के लिए संसाधन का पूरा नाम. उदाहरण के लिए, projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

हमेशा प्रज़ेंट करते हैं.
clusters[]

object (SuggestionClusterProto)

सुलभता सुझावों का क्रम, जिसे क्लस्टर में ग्रुप किया गया है. इस क्रम में, एक ही FeedbackCategory से जुड़े क्लस्टर को एक साथ रखा जाना चाहिए. हर कैटगरी में, क्लस्टर को उनकेसुझाव प्राथमिकता (पहले गड़बड़ियां) के हिसाब से क्रम में लगाया जाना चाहिए. कैटगरी को उनके सबसे ज़्यादा प्राथमिकता वाले क्लस्टर के हिसाब से क्रम में लगाया जाना चाहिए.

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

नीचे दिए गए OAuth स्कोप की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.

सुझाव क्लस्टरप्रोटो

मिलते-जुलते सुझावों का एक सेट, जो हमें लगता है कि काफ़ी हद तक एक-दूसरे से जुड़े हुए हैं.

यह प्रोटो और नेस्ट किए गए ज़्यादातर प्रोटो, foxandcrown.prelaunchreport.service.ShowionClusterProto से जुड़े हैं. साथ ही, यह PLR की निर्भरता को FTL से बदल रहा है.

JSON के काेड में दिखाना 
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
फ़ील्ड
category

enum (SuggestionCategory)

वह कैटगरी जिसमें इस तरह के सुझाव दिखने चाहिए. हमेशा सेट करें.
suggestions[]

object (SuggestionProto)

सुझावों का क्रम. किसी क्लस्टर में मौजूद सभी सुझावों के लिए एक जैसा सुझाव दिखाया जाना चाहिए. साथ ही, सुझाव एक ही कैटगरी से जुड़े होने चाहिए. एक ही स्क्रीनशॉट यूआरएल वाले सुझाव आस-पास होने चाहिए.

सुझाव की कैटगरी

एनम्स
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

सुझावप्रोटो

JSON के काेड में दिखाना 
{
  "title": string,
  "shortMessage": {
    object (SafeHtmlProto)
  },
  "longMessage": {
    object (SafeHtmlProto)
  },
  "priority": enum (SuggestionPriority),
  "helpUrl": string,
  "region": {
    object (RegionProto)
  },
  "secondaryPriority": number,
  "screenId": string,

  // Union field resource_id can be only one of the following:
  "resourceName": string,
  "pseudoResourceId": string
  // End of list of possible types for union field resource_id.
}
फ़ील्ड
title

string

उपयोगकर्ता की भाषा में, बिना मार्कअप के सुझाव के लिए सामान्य टाइटल. हमेशा सेट करें.
shortMessage

object (SafeHtmlProto)

उपयोगकर्ता की भाषा में सुझाया गया मैसेज, जिसमें मार्कअप शामिल हो सकता है, उसे सुझाव के तौर पर दिखाना. हमेशा सेट करें.
longMessage

object (SafeHtmlProto)

उपयोगकर्ता की भाषा में सुझाव के बारे में जानकारी दें. इसमें मार्कअप भी शामिल हो सकता है. हमेशा सेट करें.
priority

enum (SuggestionPriority)

किसी सुझाव की मिलती-जुलती अहमियत. हमेशा सेट करें.
helpUrl

string

इस तरह के सुझाव के बारे में सहायता केंद्र के लेख का रेफ़रंस. हमेशा सेट करें.
region

object (RegionProto)

स्क्रीनशॉट में मौजूद वह इलाका जो इस सुझाव से जुड़ा है. ज़रूरी नहीं.
secondaryPriority

number

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

string

सुझाव की स्क्रीन का आईडी. इसका इस्तेमाल, इससे जुड़े स्क्रीनशॉट का पाथ पाने के लिए किया जाता है. उदाहरण के लिए, screenId "1" "1.png" से मेल खाता है GCS (जीसीएस) में मौजूद फ़ाइल. हमेशा सेट करें.

यूनियन फ़ील्ड resource_id.

resource_id इनमें से सिर्फ़ एक हो सकता है:
resourceName

string

किसी व्यू एलिमेंट का रेफ़रंस, जिसकी पहचान उसके रिसॉर्स के नाम से की जाती है, अगर उस पर कोई रिसॉर्स हो.
pseudoResourceId

string

यह सोर्स व्यू का ऐसा आइडेंटिफ़ायर होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. ऐसा तब होता है, जब इसके संसाधन का नाम न हो. यह सुलभता हैरारकी में मौजूद एक पाथ है, जो रिसॉर्स के नाम वाला एलिमेंट है; जैसा कि दूसरी साइट पर है.

SafeHtmlProto

अहम जानकारी: किसी गैर-भरोसेमंद सोर्स से इस मैसेज को स्वीकार करना असुरक्षित है. ऐसा इसलिए, क्योंकि किसी हमलावर के लिए सुरक्षा से जुड़े समझौते की शर्तों को पूरा न करने वाले सीरियल मैसेज बनाना आसान नहीं है. उदाहरण के लिए, इसमें हमलावर की कंट्रोल वाली स्क्रिप्ट हो सकती है. SafehtmlProto पाने वाले सिस्टम को SafehtmlProto के निर्माता पर भरोसा नहीं होता. इसलिए, आम तौर पर RPC रिस्पॉन्स में इस मैसेज को लौटाना सुरक्षित होता है, लेकिन आम तौर पर RPC अनुरोधों में इसे स्वीकार करना सुरक्षित नहीं होता.

JSON के काेड में दिखाना 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
फ़ील्ड
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

अहम जानकारी: इस फ़ील्ड को कभी सेट न करें और न ही पढ़ें. यहां तक कि टेस्ट के दौरान भी, यह निजी होता है. उन प्रोग्रामिंग भाषा पैकेज के लिए .proto फ़ाइल में सबसे ऊपर मौजूद दस्तावेज़ देखें जिनका इस्तेमाल करके इस मैसेज को बनाना या पढ़ना है.

सुझावप्राथमिकता

एनम्स
unknownPriority
error
warning
info

रीजन प्रोटो

एक आयताकार क्षेत्र.

JSON के काेड में दिखाना 
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
फ़ील्ड
topPx

integer

रेक्टैंगल का सबसे ऊपरी हिस्सा, पिक्सल में. हमेशा सेट करें.
leftPx

integer

रेक्टैंगल का बाईं ओर, पिक्सल में. हमेशा सेट करें.
heightPx

integer

पिक्सल में ऊंचाई. हमेशा सेट करें.
widthPx

integer

पिक्सल में चौड़ाई. हमेशा सेट करें.