Method: projects.histories.executions.steps.accessibilityClusters

• HTTP 요청
• 경로 매개변수
• 쿼리 매개변수
• 요청 본문
• 응답 본문
  • JSON 표현
• 승인 범위
• 제안ClusterProto
  • JSON 표현
• 제안카테고리
• 제안Proto
  • JSON 표현
• SafeHtmlProto
  • JSON 표현
• 제안우선순위
• 지역Proto
  • JSON 표현
• 시도 해봐!

특정 단계에 대한 접근성 클러스터를 나열합니다.

다음 표준 오류 코드 중 하나를 반환할 수 있습니다.

• 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(ERROR 우선)에 따라 정렬되어야 합니다. 범주는 우선순위가 가장 높은 클러스터별로 정렬되어야 합니다.

승인 범위

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

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

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

제안ClusterProto

우리가 밀접하게 관련되어 있다고 의심되는 유사한 제안 세트입니다.

이 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

제안Proto

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'은 GCS의 '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

지역Proto

직사각형 영역.

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

필드
topPx	integer 직사각형의 상단(픽셀)입니다. 항상 설정됩니다.
leftPx	integer 직사각형의 왼쪽 측면(픽셀 단위)입니다. 항상 설정됩니다.
heightPx	integer 높이(픽셀)입니다. 항상 설정됩니다.
widthPx	integer 너비(픽셀)입니다. 항상 설정됩니다.