Method: projects.histories.executions.steps.accessibilityClusters

يسرد مجموعات إمكانية الوصول لخطوة معينة

قد يُرجع أيًا من رموز الخطأ الأساسية التالية:

  • PERMISSION_DENIED - إذا كان المستخدم غير مصرح له بقراءة المشروع
  • INVALID_ARGUMENT - إذا كان الطلب غير صحيح
  • FAILED_PRECONDITION - إذا كانت الوسيطة في الطلب غير صالحة؛ على سبيل المثال، إذا كان تنسيق اللغة غير صحيح
  • NOT_FOUND - إذا كانت الخطوة المحتوية غير موجودة

طلب HTTP

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

يستخدم عنوان URL بناء جملة gRPC Transcoding .

معلمات المسار

حدود
name

string

اسم المورد الكامل للخطوة. على سبيل المثال،projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

مطلوب.

معلمات الاستعلام

حدود
locale

string

التنسيق المقبول هو تنسيق Unicode الأساسي مع واصلة كمحدد. يجب أن تكون اللغة صغيرة، ونص اللغة - كبير، والمنطقة - كبيرة. راجع http://www.unicode.org/reports/tr35/#Unicode_locale_identifier للحصول على التفاصيل.

مطلوب.

هيئة الطلب

يجب أن يكون نص الطلب فارغًا.

هيئة الاستجابة

رسالة استجابة لـ AccessibilityService.ListStepAccessibilityClusters.

في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل جيسون
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
مجالات
name

string

اسم المورد الكامل للخطوة. على سبيل المثال،projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

يقدم دائما.

clusters[]

object ( SuggestionClusterProto )

سلسلة من اقتراحات إمكانية الوصول، مجمعة في مجموعات. ضمن التسلسل، يجب أن تكون المجموعات التي تنتمي إلى نفس فئة الاقتراحات متجاورة. ضمن كل فئة، يجب ترتيب المجموعات حسب أولوية الاقتراح (الأخطاء أولاً). يجب أن يتم ترتيب الفئات حسب المجموعة ذات الأولوية العليا الخاصة بها.

نطاقات التفويض

يتطلب نطاق OAuth التالي:

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

لمزيد من المعلومات، راجع نظرة عامة على المصادقة .

اقتراحClusterProto

مجموعة من الاقتراحات المماثلة التي نشك في أنها مرتبطة ارتباطًا وثيقًا.

هذا النموذج الأولي ومعظم النماذج الأولية المتداخلة متفرعة من foxandcrown.prelaunchreport.service.SuggestionClusterProto، مما يؤدي إلى استبدال تبعيات PLR بـ FTL.

تمثيل جيسون
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
مجالات
category

enum ( SuggestionCategory )

الفئة التي يجب أن تظهر فيها هذه الأنواع من الاقتراحات. تعيين دائما.

suggestions[]

object ( SuggestionProto )

سلسلة من الاقتراحات. يجب أن يكون لجميع الاقتراحات الموجودة داخل المجموعة نفس SuggestionPriority وأن تنتمي إلى نفس SuggestionCategory. يجب أن تكون الاقتراحات التي لها نفس عنوان URL للقطة الشاشة متجاورة.

فئة الاقتراح

التعدادات
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

اقتراح بروتو

تمثيل جيسون
{
  "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

معرف الشاشة للاقتراح. يتم استخدامه للحصول على مسار لقطة الشاشة المقابل. على سبيل المثال، يتوافق معرف الشاشة "1" مع الملف "1.png" في GCS. تعيين دائما.

حقل الاتحاد resource_id .

يمكن أن يكون resource_id واحدًا فقط مما يلي:

resourceName

string

إشارة إلى عنصر عرض، يتم تحديده بواسطة اسم المورد الخاص به، إذا كان يحتوي على واحد.

pseudoResourceId

string

معرف يمكن قراءته إلى حد ما للعرض المصدر، إذا لم يكن يحتوي على اسم المورد. هذا مسار ضمن التسلسل الهرمي لإمكانية الوصول، وهو عنصر له اسم المورد؛ يشبه XPath.

SafeHtmlProto

هام: من غير الآمن قبول هذه الرسالة من مصدر غير موثوق به، لأنه من السهل على المهاجم تزوير رسائل متسلسلة لا تفي بعقد الأمان الخاص بالنوع -- على سبيل المثال، يمكن أن تحتوي على برنامج نصي يتحكم فيه المهاجم. النظام الذي يتلقى SafeHtmlProto يثق ضمنيًا بمنتج SafeHtmlProto. لذلك، من الآمن بشكل عام إرجاع هذه الرسالة في استجابات RPC، ولكن من غير الآمن بشكل عام قبولها في طلبات RPC.

تمثيل جيسون
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
مجالات
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

هام: لا تقم أبدًا بتعيين أو قراءة هذا الحقل، حتى من الاختبارات، فهو خاص. راجع الوثائق الموجودة أعلى ملف .proto للتعرف على حزم لغات البرمجة التي يمكنك من خلالها إنشاء هذه الرسالة أو قراءتها.

أولوية الاقتراح

التعدادات
unknownPriority
error
warning
info

المنطقةProto

منطقة مستطيلة.

تمثيل جيسون
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
مجالات
topPx

integer

الجزء العلوي من المستطيل، بالبكسل. تعيين دائما.

leftPx

integer

الجانب الأيسر من المستطيل، بالبكسل. تعيين دائما.

heightPx

integer

الارتفاع بالبكسل. تعيين دائما.

widthPx

integer

العرض بالبكسل. تعيين دائما.