- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- cuerpo de la solicitud
- Cuerpo de respuesta
- Ámbitos de autorización
- SugerenciaClusterProto
- SugerenciaCategoría
- SugerenciaProto
- SafeHtmlProto
- SugerenciaPrioridad
- RegionProto
- ¡Intentalo!
Enumera los clústeres de accesibilidad para un paso determinado
Puede devolver 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 tiene un formato incorrecto
- FAILED_PRECONDITION: si un argumento en la solicitud no es válido; por ejemplo, si el formato local es incorrecto
- NOT_FOUND - si el paso contenedor no existe
Solicitud HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/{name=projects/*/histories/*/executions/*/steps/*}:accessibilityClusters
La URL usa la sintaxis de transcodificación de gRPC .
Parámetros de ruta
Parámetros | |
---|---|
name | Un nombre de recurso completo del paso. Por ejemplo, proyectos/mi-proyecto/historias/bh.1234567890abcdef/ejecuciones/ 1234567890123456789/pasos/bs.1234567890abcdef Requerido. |
Parámetros de consulta
Parámetros | |
---|---|
locale | El formato aceptado es el formato Unicode canónico con guión como delimitador. El idioma debe estar en minúsculas, la secuencia de comandos del idioma: en mayúsculas, la región: MAYÚSCULAS. Consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier para obtener detalles. Requerido. |
cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de respuesta
Mensaje de respuesta para AccessibilityService.ListStepAccessibilityClusters.
Si tiene éxito, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"name": string,
"clusters": [
{
object ( |
Campos | |
---|---|
name | Un nombre de recurso completo del paso. Por ejemplo, proyectos/mi-proyecto/historias/bh.1234567890abcdef/ejecuciones/ 1234567890123456789/pasos/bs.1234567890abcdef Siempre presentes. |
clusters[] | Una secuencia de sugerencias de accesibilidad, agrupadas en grupos. Dentro de la secuencia, los clústeres que pertenecen a la misma categoría de sugerencias deben ser adyacentes. Dentro de cada categoría, los clústeres deben ordenarse por su Prioridad de sugerencia (los ERRORES primero). Las categorías deben ordenarse por su grupo de mayor prioridad. |
Ámbitos de autorización
Requiere el siguiente alcance de OAuth:
-
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulte Descripción general de la autenticación .
SugerenciaClusterProto
Un conjunto de sugerencias similares que sospechamos están estrechamente relacionadas.
Este prototipo y la mayoría de los prototipos anidados se derivan de foxandcrown.prelaunchreport.service.SuggestionClusterProto, reemplazando las dependencias de PLR con FTL.
Representación JSON |
---|
{ "category": enum ( |
Campos | |
---|---|
category | Categoría en la que deben aparecer este tipo de sugerencias. Siempre listo. |
suggestions[] | Una secuencia de sugerencias. Todas las sugerencias dentro de un clúster deben tener la misma Prioridad de sugerencia y pertenecer a la misma Categoría de sugerencia. Las sugerencias con la misma URL de captura de pantalla deben estar adyacentes. |
SugerenciaCategoría
Enumeraciones | |
---|---|
unknownCategory | |
contentLabeling | |
touchTargetSize | |
lowContrast | |
implementation |
SugerenciaProto
Representación JSON |
---|
{ "title": string, "shortMessage": { object ( |
Campos | |
---|---|
title | Título general de la sugerencia, en el idioma del usuario, sin marcado. Siempre listo. |
shortMessage | Mensaje conciso, en el idioma del usuario, que representa la sugerencia, que puede contener marcado. Siempre listo. |
longMessage | Mensaje, en el idioma del usuario, explicando la sugerencia, que puede contener marcado. Siempre listo. |
priority | Importancia relativa de una sugerencia. Siempre listo. |
helpUrl | Referencia a un artículo del centro de ayuda sobre este tipo de sugerencia. Siempre listo. |
region | Región dentro de la captura de pantalla que es relevante para esta sugerencia. Opcional. |
secondaryPriority | 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 | ID de la pantalla para la sugerencia. Se utiliza para obtener la ruta de captura de pantalla correspondiente. Por ejemplo, screenId "1" corresponde al archivo "1.png" en GCS. Siempre listo. |
Campo de unión | |
resourceName | Referencia a un elemento de vista, identificado por su nombre de recurso, si lo tiene. |
pseudoResourceId | Un identificador algo legible por humanos de la vista de origen, si no tiene un resourceName. Esta es una ruta dentro de la jerarquía de accesibilidad, un elemento con nombre de recurso; similar a un XPath. |
SafeHtmlProto
IMPORTANTE: No es seguro aceptar este mensaje de una fuente que no es de confianza, 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 del SafeHtmlProto. Por lo tanto, generalmente es seguro devolver este mensaje en las respuestas de RPC, pero generalmente no es seguro aceptarlo en las solicitudes de RPC.
Representación JSON |
---|
{ "privateDoNotAccessOrElseSafeHtmlWrappedValue": string } |
Campos | |
---|---|
privateDoNotAccessOrElseSafeHtmlWrappedValue | IMPORTANTE: Nunca configures ni leas este campo, ni siquiera de pruebas, es privado. Consulte la documentación en la parte superior del archivo .proto para conocer los paquetes de lenguaje de programación con los que crear o leer este mensaje. |
SugerenciaPrioridad
Enumeraciones | |
---|---|
unknownPriority | |
error | |
warning | |
info |
RegionProto
Una región rectangular.
Representación JSON |
---|
{ "topPx": integer, "leftPx": integer, "heightPx": integer, "widthPx": integer } |
Campos | |
---|---|
topPx | La parte superior del rectángulo, en píxeles. Siempre listo. |
leftPx | El lado izquierdo del rectángulo, en píxeles. Siempre listo. |
heightPx | La altura, en píxeles. Siempre listo. |
widthPx | El ancho, en píxeles. Siempre listo. |