Method: projects.histories.executions.steps.accessibilityClusters

Enumera los clústeres de accesibilidad para un paso determinado

Puede mostrar cualquiera de los siguientes códigos de error canónicos:

  • PERMISSION_DENIED: Si el usuario no está autorizado para leer el proyecto.
  • INVALID_ARGUMENT: Si la solicitud está malformada.
  • FAILED_PRECONDITION: Si un argumento en la solicitud no es válido; p.ej., si el formato de la configuración regional es incorrecto
  • NOT_FOUND: Si el paso que lo contiene no existe.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

El nombre completo del recurso del paso. Por ejemplo, projects/my-project/historias/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Obligatorio.

Parámetros de consulta

Parámetros
locale

string

El formato aceptado es el formato canónico Unicode con guion como delimitador. El idioma debe estar en minúsculas, Language Script - mayúsculas, Región - MAYÚSCULA. Consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier para obtener más información.

Obligatorio.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para AccessibilityService.ListStepAccessibilityClusters.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Campos
name

string

El nombre completo del recurso del paso. Por ejemplo, projects/my-project/historias/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Siempre se presenta.
clusters[]

object (SuggestionClusterProto)

Una secuencia de sugerencias de accesibilidad agrupadas en clústeres. Dentro de la secuencia, los clústeres que pertenecen a la misma Sugerencia Category deben ser adyacentes. Dentro de cada categoría, los clústeres se deben ordenar según su SuggestedPriority (primero los ERRORes). Las categorías deben ordenarse según el clúster de mayor prioridad.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

SuggestedClusterProto

Un conjunto de sugerencias similares que sospechamos que están estrechamente relacionadas.

Este proto y la mayoría de los archivos proto anidados se ramifican desde foxandcrown.prelaunchreport.service.SuggestedClusterProto, y reemplazan las dependencias de PLR con FTL.

Representación JSON 
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Campos
category

enum (SuggestionCategory)

La categoría en la que deberían aparecer estos tipos de sugerencias. Siempre establecido.
suggestions[]

object (SuggestionProto)

Una secuencia de sugerencias. Todas las sugerencias de un clúster deben tener la misma SuggestedPriority y pertenecer a la misma SuggestedCategory. Las sugerencias con la misma URL de captura de pantalla deben ser adyacentes.

Categoría de sugerencia

Enums
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

Proto.sugerencia

Representació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.
}
Campos
title

string

Es el título general de la sugerencia, en el idioma del usuario, sin lenguaje de marcado. Siempre establecido.
shortMessage

object (SafeHtmlProto)

Mensaje conciso, en el idioma del usuario, que representa la sugerencia y que puede contener lenguaje de marcado. Siempre establecido.
longMessage

object (SafeHtmlProto)

Es un mensaje en el que se explica la sugerencia, que puede contener lenguaje de marcado, en el idioma del usuario. Siempre establecido.
priority

enum (SuggestionPriority)

Importancia relativa de una sugerencia. Siempre establecido.
helpUrl

string

Referencias a un artículo del Centro de ayuda sobre este tipo de sugerencias. Siempre establecido.
region

object (RegionProto)

Región en la captura de pantalla que es relevante para esta sugerencia. Opcional.
secondaryPriority

number

Es la importancia relativa de una sugerencia en comparación con otras sugerencias que tienen la misma prioridad y categoría. Este es un valor sin sentido que se puede usar para ordenar sugerencias que están en la misma categoría y tienen la misma prioridad. Los valores más grandes tienen mayor prioridad (es decir, son más importantes). Opcional.
screenId

string

Es el ID de la pantalla para la sugerencia. Se usa para obtener la ruta de acceso de la captura de pantalla correspondiente. Por ejemplo, screenId “1” corresponde a "1.png". en GCS. Siempre establecido.

Campo de unión resource_id.

resource_id puede ser una de las siguientes opciones:
resourceName

string

Referencia a un elemento de vista, identificado por su nombre de recurso, si tiene uno.
pseudoResourceId

string

Es un identificador de la vista de origen legible por humanos, si no tiene un resourceName. Esta es una ruta de acceso dentro de la jerarquía de accesibilidad, un elemento con nombre de recurso. similar a una XPath.

SafeHtmlProto

IMPORTANTE: No es seguro aceptar este mensaje de una fuente no confiable, ya que es trivial para un atacante falsificar mensajes serializados que no cumplen con el contrato de seguridad del tipo. Por ejemplo, podría contener una secuencia de comandos controlada por el atacante. Un sistema que recibe un SafeHtmlProto confía implícitamente en el productor de SafeHtmlProto. Por lo tanto, suele ser seguro mostrar este mensaje en respuestas de RPC, pero generalmente no es seguro aceptarlo en solicitudes de RPC.

Representación JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Campos
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

IMPORTANTE: Nunca configures ni leas este campo, ya que es privado, ni siquiera si se trata de pruebas. Consulta la documentación en la parte superior del archivo .proto para conocer los paquetes del lenguaje de programación con los que puedes crear o leer este mensaje.

Prioridad de sugerencias

Enums
unknownPriority
error
warning
info

Proto de región

Una región rectangular.

Representación JSON 
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Campos
topPx

integer

Parte superior del rectángulo, en píxeles. Siempre establecido.
leftPx

integer

Parte izquierda del rectángulo, en píxeles. Siempre establecido.
heightPx

integer

Es la altura en píxeles. Siempre establecido.
widthPx

integer

Es el ancho en píxeles. Siempre establecido.