Method: projects.histories.executions.steps.accessibilityClusters

Liệt kê các cụm hỗ trợ tiếp cận cho một Bước cụ thể

Có thể trả về bất kỳ mã lỗi chuẩn nào sau đây:

  • PERMISSION_DENIED - nếu người dùng không được phép đọc dự án
  • INVALID_ARGUMENT - nếu yêu cầu không đúng định dạng
  • FAILED_PREPRE – nếu một đối số trong yêu cầu không hợp lệ; ví dụ: nếu định dạng ngôn ngữ không chính xác
  • NOT_FOUND - nếu Bước chứa không tồn tại

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Tên tài nguyên đầy đủ của bước. Ví dụ: project/my-project/hiStories/bh.1234567890abcdef/executions/ 1234567890123456789/step/bs.1234567890abcdef

Bắt buộc.

Tham số truy vấn

Thông số
locale

string

Định dạng được chấp nhận là định dạng Unicode chính tắc có dấu gạch nối làm dấu phân tách. Ngôn ngữ phải là chữ thường, ngôn ngữ tập lệnh – Viết hoa, Khu vực – CHỮ HOA. Truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier để biết thông tin chi tiết.

Bắt buộc.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho AccessibilityService.ListStepAccessibilityClusters.

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Trường
name

string

Tên tài nguyên đầy đủ của bước. Ví dụ: project/my-project/hiStories/bh.1234567890abcdef/executions/ 1234567890123456789/step/bs.1234567890abcdef

Luôn hiển thị.
clusters[]

object (SuggestionClusterProto)

Một chuỗi các đề xuất hỗ trợ tiếp cận, được nhóm thành nhiều cụm. Trong trình tự, các cụm thuộc cùng một Đề xuất phải liền kề. Trong mỗi danh mục, các cụm phải được sắp xếp theo Đề xuất ưu tiên của chúng (các lỗi trước tiên). Bạn nên sắp xếp các danh mục theo cụm có mức độ ưu tiên cao nhất.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau đây:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.

Đề xuấtClusterProto

Một tập hợp các đề xuất tương tự mà chúng tôi nghi ngờ có liên quan chặt chẽ.

Proto này và hầu hết các proto lồng nhau được phân nhánh từ foxandcrown.prelaunchreport.service.suggestedionClusterProto, thay thế các phần phụ thuộc của PLR bằng các phần phụ thuộc của FTL.

Biểu diễn dưới dạng JSON 
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Trường
category

enum (SuggestionCategory)

Danh mục mà các loại đề xuất này sẽ xuất hiện. Luôn đặt.
suggestions[]

object (SuggestionProto)

Một chuỗi các đề xuất. Tất cả đề xuất trong một cụm phải có cùng Đề xuất ưu tiên và thuộc cùng một Đề xuất. Các đề xuất có cùng URL ảnh chụp màn hình nên ở gần nhau.

Danh mục đề xuất

Enum
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

Đề xuấtProto

Biểu diễn dưới dạng 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.
}
Trường
title

string

Tiêu đề chung của gợi ý, bằng ngôn ngữ của người dùng, không có mã đánh dấu. Luôn đặt.
shortMessage

object (SafeHtmlProto)

Thông báo ngắn gọn trong ngôn ngữ của người dùng, tượng trưng cho đề xuất (có thể chứa mã đánh dấu). Luôn đặt.
longMessage

object (SafeHtmlProto)

Thông báo, bằng ngôn ngữ của người dùng, giải thích đề xuất, có thể chứa đánh dấu. Luôn đặt.
priority

enum (SuggestionPriority)

Tầm quan trọng tương đối của đề xuất. Luôn đặt.
helpUrl

string

Tham chiếu đến bài viết trong trung tâm trợ giúp liên quan đến loại đề xuất này. Luôn đặt.
region

object (RegionProto)

Khu vực trong ảnh chụp màn hình có liên quan đến nội dung đề xuất này. Không bắt buộc.
secondaryPriority

number

Tầm quan trọng tương đối của một đề xuất so với những đề xuất khác có cùng mức độ ưu tiên và danh mục. Đây là một giá trị vô nghĩa có thể dùng để sắp xếp các đề xuất thuộc cùng một danh mục và có cùng mức độ ưu tiên. Giá trị lớn hơn có mức độ ưu tiên cao hơn (nghĩa là quan trọng hơn). Không bắt buộc.
screenId

string

Mã nhận dạng của màn hình cho đề xuất. Thuộc tính này được dùng để lấy đường dẫn ảnh chụp màn hình tương ứng. Ví dụ: screenId "1" tương ứng với "1.png" trong GCS. Luôn đặt.

Trường kết hợp resource_id.

resource_id chỉ có thể là một trong những trạng thái sau đây:
resourceName

string

Tham chiếu đến một phần tử khung hiển thị, được xác định theo tên tài nguyên, nếu có.
pseudoResourceId

string

Giá trị nhận dạng mà con người có thể đọc được của khung hiển thị nguồn, nếu không có resourceName. Đây là một đường dẫn trong hệ phân cấp hỗ trợ tiếp cận, một phần tử có tên tài nguyên; tương tự như q.

SafeHtmlProto

QUAN TRỌNG: Không an toàn khi chấp nhận thư này từ một nguồn không đáng tin cậy vì việc kẻ tấn công giả mạo các thông báo được chuyển đổi tuần tự không hoàn thành hợp đồng an toàn của kiểu là không đáng tin cậy vì việc này có thể chứa tập lệnh kiểm soát của kẻ tấn công. Một hệ thống nhận được SafehtmlProto cũng ngầm tin tưởng thực thể tạo của SafehtmlProto. Vì vậy, việc trả lại thông báo này trong phản hồi RPC nói chung là an toàn, nhưng việc chấp nhận thông báo này trong yêu cầu RPC thường là không an toàn.

Biểu diễn dưới dạng JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Trường
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

LƯU Ý QUAN TRỌNG: Đừng bao giờ đặt hay đọc trường này, ngay cả khi được kiểm thử, vì trường này là trường riêng tư. Hãy xem tài liệu ở đầu tệp .proto để biết các gói ngôn ngữ lập trình bạn có thể dùng để tạo hoặc đọc thông báo này.

Mức độ ưu tiên của đề xuất

Enum
unknownPriority
error
warning
info

Khu vựcProto

Một vùng hình chữ nhật.

Biểu diễn dưới dạng JSON 
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Trường
topPx

integer

Phần trên cùng của hình chữ nhật, tính bằng pixel. Luôn đặt.
leftPx

integer

Nửa bên trái của hình chữ nhật, tính bằng pixel. Luôn đặt.
heightPx

integer

Chiều cao, tính bằng pixel. Luôn đặt.
widthPx

integer

Chiều rộng, tính bằng pixel. Luôn đặt.