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 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

단계의 전체 리소스 이름입니다. 예: projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

필수 항목입니다.

쿼리 매개변수

매개변수
locale

string

허용되는 형식은 하이픈을 구분 기호로 사용한 표준 유니코드 형식입니다. 언어는 소문자여야 합니다. 언어 스크립트 - 대문자로 표시, 지역 - 대문자를 입력하세요. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_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)

클러스터로 그룹화된 일련의 접근성 추천입니다. 시퀀스 내에서 동일한 SuggestionCategory에 속한 클러스터가 인접해야 합니다. 각 카테고리 내에서 클러스터는 SuggestionPriority (오류 우선)에 따라 정렬해야 합니다. 카테고리는 우선순위가 가장 높은 클러스터를 기준으로 정렬되어야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

추천 클러스터 프로토

밀접한 관련이 있다고 생각되는 일련의 유사한 제안입니다.

이 proto와 대부분의 중첩된 proto는 foxandcrown.prelaunchreport.service.SuggestionClusterProto에서 분기되며 PLR의 종속 항목이 FTL의 종속 항목으로 대체됩니다.

JSON 표현 
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
필드
category

enum (SuggestionCategory)

이러한 유형의 추천이 표시될 카테고리입니다. 항상 설정합니다.
suggestions[]

object (SuggestionProto)

일련의 제안입니다. 클러스터 내의 모든 추천은 동일한 SuggestionPriority를 가져야 하며 동일한 SuggestionCategory에 속해야 합니다. 스크린샷 URL이 동일한 추천은 인접해야 합니다.

추천 카테고리

열거형
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

SuggestionProto

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

추천 화면의 ID입니다. 상응하는 스크린샷 경로를 가져오는 데 사용됩니다. 예: screenId '1' '1.png'에 해당 생성합니다 항상 설정합니다.

통합 필드 resource_id.

resource_id는 다음 중 하나여야 합니다.
resourceName

string

리소스 이름으로 식별되는 뷰 요소에 대한 참조입니다(리소스 이름이 있는 경우).
pseudoResourceId

string

resourceName이 없는 경우 사람이 읽을 수 있는 소스 뷰의 식별자입니다. 리소스 이름이 있는 요소인 접근성 계층 구조 내의 경로입니다. XPath와 비슷합니다.

SafeHtmlProto

중요: 신뢰할 수 없는 출처의 메시지를 받는 것은 안전하지 않습니다. 공격자가 유형의 안전 계약을 충족하지 않는 직렬화된 메시지(예: 공격자가 제어하는 스크립트를 포함할 수 있음)를 위조하는 것은 위험하기 때문입니다. SafeHTMLProto를 수신하는 시스템이 SafeHTMLProto의 제작자를 암시적으로 신뢰합니다. 따라서 일반적으로 RPC 응답으로 이 메시지를 반환하는 것은 안전하지만 RPC 요청에서 수락하는 것은 일반적으로 안전하지 않습니다.

JSON 표현 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
필드
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

중요: 이 입력란은 테스트에서도 비공개이므로 설정하거나 읽지 마세요. 이 메시지를 만들거나 읽는 데 사용하는 프로그래밍 언어 패키지는 .proto 파일 상단에 있는 문서를 참조하세요.

추천 우선순위

열거형
unknownPriority
error
warning
info

RegionProto

직사각형 영역입니다.

JSON 표현 
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
필드
topPx

integer

직사각형의 상단입니다(픽셀 단위). 항상 설정합니다.
leftPx

integer

직사각형의 왼쪽(픽셀)입니다. 항상 설정합니다.
heightPx

integer

픽셀 단위의 높이입니다. 항상 설정합니다.
widthPx

integer

픽셀 단위의 너비입니다. 항상 설정합니다.