Method: projects.histories.executions.steps.accessibilityClusters

Liệt kê các cụm khả năng truy cập cho một Bước nhất định

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_PRECODITION - nếu một đối số trong yêu cầu không hợp lệ; ví dụ: nếu định dạng miền địa phươ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 này. Ví dụ: dự án/dự án của tôi/lịch sử/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Yêu cầu.

Tham số truy vấn

Thông số
locale

string

Định dạng được chấp nhận là định dạng Unicode chuẩn với dấu gạch nối làm dấu phân cách. Ngôn ngữ phải là chữ thường, Chữ viết ngôn ngữ - Viết hoa, Vùng - CHỮ HOA. Xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier để biết chi tiết.

Yêu cầu.

Nội dung yêu cầu

Phần thân 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 JSON
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Lĩnh vực
name

string

Tên tài nguyên đầy đủ của bước này. Ví dụ: dự án/dự án của tôi/lịch sử/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Luôn có quà.

clusters[]

object ( SuggestionClusterProto )

Một chuỗi các đề xuất trợ năng, được nhóm thành các cụm. Trong chuỗi, các cụm thuộc cùng Danh mục đề xuất phải liền kề nhau. Trong mỗi danh mục, các cụm phải được sắp xếp theo Ưu tiên đề xuất của chúng (trước tiên là LỖI). Các danh mục nên được sắp xếp theo cụm ưu tiên cao nhất của chúng.

Phạm vi ủy quyền

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

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

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

Đề xuấtCụmProto

Một tập hợp các gợi ý tương tự mà chúng tôi nghi ngờ có liên quan chặt chẽ với nhau.

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

Biểu diễn JSON
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Lĩnh vực
category

enum ( SuggestionCategory )

Danh mục mà những loại đề xuất này sẽ xuất hiện. Luôn luôn thiết lập.

suggestions[]

object ( SuggestionProto )

Một chuỗi các gợi ý. Tất cả các đề xuất trong một cụm phải có cùng Mức độ ưu tiên đề xuất và thuộc cùng Danh mục đề xuất. Các đề xuất có cùng URL ảnh chụp màn hình phải liền kề.

Danh mục đề xuất

Enum
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

Đề xuấtProto

Biểu diễn 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.
}
Lĩnh vực
title

string

Tiêu đề chung cho đề xuất, bằng ngôn ngữ của người dùng, không có đánh dấu. Luôn luôn thiết lập.

shortMessage

object ( SafeHtmlProto )

Thông báo ngắn gọn, bằng ngôn ngữ của người dùng, thể hiện gợi ý, có thể chứa đánh dấu. Luôn luôn thiết lập.

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 luôn thiết lập.

priority

enum ( SuggestionPriority )

Tầm quan trọng tương đối của một gợi ý. Luôn luôn thiết lập.

helpUrl

string

Tham khảo bài viết trong trung tâm trợ giúp liên quan đến loại đề xuất này. Luôn luôn thiết lập.

region

object ( RegionProto )

Vùng trong ảnh chụp màn hình có liên quan đến đề 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 các đề 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ể được sử dụng để sắp xếp các đề xuất thuộc cùng danh mục và có cùng mức độ ưu tiên. Các 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

ID của màn hình cho đề xuất. Nó được sử 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 tệp "1.png" trong GCS. Luôn luôn thiết lập.

Trường liên minh resource_id .

resource_id chỉ có thể là một trong những thứ sau:

resourceName

string

Tham chiếu đến một phần tử khung nhìn, được xác định bằng tên tài nguyên của nó, nếu có.

pseudoResourceId

string

Mã định danh dễ đọc của con người đối với chế độ xem nguồn nếu nó không có ResourceName. Đây là đường dẫn trong hệ thống phân cấp khả năng truy cập, một phần tử có tên tài nguyên; tương tự như XPath.

An toànHtmlProto

QUAN TRỌNG: Sẽ không an toàn khi chấp nhận tin nhắn 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 tin nhắn được tuần tự hóa không đáp ứng hợp đồng an toàn của loại đó là điều bình thường -- ví dụ: nó có thể chứa tập lệnh do kẻ tấn công kiểm soát. Hệ thống nhận SafeHtmlProto hoàn toàn tin tưởng nhà sản xuất SafeHtmlProto. Vì vậy, nói chung là an toàn khi trả lại tin nhắn này trong phản hồi RPC nhưng nhìn chung không an toàn khi chấp nhận nó trong các yêu cầu RPC.

Biểu diễn JSON
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Lĩnh vực
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

QUAN TRỌNG: Không bao giờ đặt hoặc đọc trường này, ngay cả từ các bài kiểm tra, nó là riêng tư. Xem tài liệu ở đầu tệp .proto để biết các gói ngôn ngữ lập trình dùng để tạo hoặc đọc thông báo này.

Ưu tiên đề xuất

Enum
unknownPriority
error
warning
info

VùngProto

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

Biểu diễn JSON
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Lĩnh vực
topPx

integer

Phần trên cùng của hình chữ nhật, tính bằng pixel. Luôn luôn thiết lập.

leftPx

integer

Phía bên trái của hình chữ nhật, tính bằng pixel. Luôn luôn thiết lập.

heightPx

integer

Chiều cao, tính bằng pixel. Luôn luôn thiết lập.

widthPx

integer

Chiều rộng, tính bằng pixel. Luôn luôn thiết lập.