- طلب HTTP
- معلمات المسار
- معلمات الاستعلام
- هيئة الطلب
- هيئة الاستجابة
- نطاقات التفويض
- اقتراحClusterProto
- فئة الاقتراح
- اقتراح بروتو
- SafeHtmlProto
- أولوية الاقتراح
- المنطقةProto
- جربها!
يسرد مجموعات إمكانية الوصول لخطوة معينة
قد يُرجع أيًا من رموز الخطأ الأساسية التالية:
- 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 | اسم المورد الكامل للخطوة. على سبيل المثال،projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef مطلوب. |
معلمات الاستعلام
حدود | |
---|---|
locale | التنسيق المقبول هو تنسيق Unicode الأساسي مع واصلة كمحدد. يجب أن تكون اللغة صغيرة، ونص اللغة - كبير، والمنطقة - كبيرة. راجع http://www.unicode.org/reports/tr35/#Unicode_locale_identifier للحصول على التفاصيل. مطلوب. |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
رسالة استجابة لـ AccessibilityService.ListStepAccessibilityClusters.
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{
"name": string,
"clusters": [
{
object ( |
مجالات | |
---|---|
name | اسم المورد الكامل للخطوة. على سبيل المثال،projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef يقدم دائما. |
clusters[] | سلسلة من اقتراحات إمكانية الوصول، مجمعة في مجموعات. ضمن التسلسل، يجب أن تكون المجموعات التي تنتمي إلى نفس فئة الاقتراحات متجاورة. ضمن كل فئة، يجب ترتيب المجموعات حسب أولوية الاقتراح (الأخطاء أولاً). يجب أن يتم ترتيب الفئات حسب المجموعة ذات الأولوية العليا الخاصة بها. |
نطاقات التفويض
يتطلب نطاق OAuth التالي:
-
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .
اقتراحClusterProto
مجموعة من الاقتراحات المماثلة التي نشك في أنها مرتبطة ارتباطًا وثيقًا.
هذا النموذج الأولي ومعظم النماذج الأولية المتداخلة متفرعة من foxandcrown.prelaunchreport.service.SuggestionClusterProto، مما يؤدي إلى استبدال تبعيات PLR بـ FTL.
تمثيل جيسون |
---|
{ "category": enum ( |
مجالات | |
---|---|
category | الفئة التي يجب أن تظهر فيها هذه الأنواع من الاقتراحات. تعيين دائما. |
suggestions[] | سلسلة من الاقتراحات. يجب أن يكون لجميع الاقتراحات الموجودة داخل المجموعة نفس SuggestionPriority وأن تنتمي إلى نفس SuggestionCategory. يجب أن تكون الاقتراحات التي لها نفس عنوان URL للقطة الشاشة متجاورة. |
فئة الاقتراح
التعدادات | |
---|---|
unknownCategory | |
contentLabeling | |
touchTargetSize | |
lowContrast | |
implementation |
اقتراح بروتو
تمثيل جيسون |
---|
{ "title": string, "shortMessage": { object ( |
مجالات | |
---|---|
title | عنوان عام للاقتراح، بلغة المستخدم، بدون ترميز. تعيين دائما. |
shortMessage | رسالة مختصرة، بلغة المستخدم، تمثل الاقتراح، والتي قد تحتوي على علامات. تعيين دائما. |
longMessage | رسالة، بلغة المستخدم، تشرح الاقتراح، والتي قد تحتوي على ترميز. تعيين دائما. |
priority | الأهمية النسبية للاقتراح. تعيين دائما. |
helpUrl | إشارة إلى مقالة مركز المساعدة المتعلقة بهذا النوع من الاقتراحات. تعيين دائما. |
region | المنطقة الموجودة في لقطة الشاشة ذات الصلة بهذا الاقتراح. خياري. |
secondaryPriority | الأهمية النسبية للاقتراح مقارنة بالاقتراحات الأخرى التي لها نفس الأولوية والفئة. هذه قيمة لا معنى لها ويمكن استخدامها لطلب الاقتراحات الموجودة في نفس الفئة ولها نفس الأولوية. القيم الأكبر لها أولوية أعلى (أي أكثر أهمية). خياري. |
screenId | معرف الشاشة للاقتراح. يتم استخدامه للحصول على مسار لقطة الشاشة المقابل. على سبيل المثال، يتوافق معرف الشاشة "1" مع الملف "1.png" في GCS. تعيين دائما. |
حقل الاتحاد يمكن أن يكون | |
resourceName | إشارة إلى عنصر عرض، يتم تحديده بواسطة اسم المورد الخاص به، إذا كان يحتوي على واحد. |
pseudoResourceId | معرف يمكن قراءته إلى حد ما للعرض المصدر، إذا لم يكن يحتوي على اسم المورد. هذا مسار ضمن التسلسل الهرمي لإمكانية الوصول، وهو عنصر له اسم المورد؛ يشبه XPath. |
SafeHtmlProto
هام: من غير الآمن قبول هذه الرسالة من مصدر غير موثوق به، لأنه من السهل على المهاجم تزوير رسائل متسلسلة لا تفي بعقد الأمان الخاص بالنوع -- على سبيل المثال، يمكن أن تحتوي على برنامج نصي يتحكم فيه المهاجم. النظام الذي يتلقى SafeHtmlProto يثق ضمنيًا بمنتج SafeHtmlProto. لذلك، من الآمن بشكل عام إرجاع هذه الرسالة في استجابات RPC، ولكن من غير الآمن بشكل عام قبولها في طلبات RPC.
تمثيل جيسون |
---|
{ "privateDoNotAccessOrElseSafeHtmlWrappedValue": string } |
مجالات | |
---|---|
privateDoNotAccessOrElseSafeHtmlWrappedValue | هام: لا تقم أبدًا بتعيين أو قراءة هذا الحقل، حتى من الاختبارات، فهو خاص. راجع الوثائق الموجودة أعلى ملف .proto للتعرف على حزم لغات البرمجة التي يمكنك من خلالها إنشاء هذه الرسالة أو قراءتها. |
أولوية الاقتراح
التعدادات | |
---|---|
unknownPriority | |
error | |
warning | |
info |
المنطقةProto
منطقة مستطيلة.
تمثيل جيسون |
---|
{ "topPx": integer, "leftPx": integer, "heightPx": integer, "widthPx": integer } |
مجالات | |
---|---|
topPx | الجزء العلوي من المستطيل، بالبكسل. تعيين دائما. |
leftPx | الجانب الأيسر من المستطيل، بالبكسل. تعيين دائما. |
heightPx | الارتفاع بالبكسل. تعيين دائما. |
widthPx | العرض بالبكسل. تعيين دائما. |