Method: projects.histories.executions.steps.accessibilityClusters

Belirli bir Adım için erişilebilirlik kümelerini listeler

Aşağıdaki standart hata kodlarından herhangi birini döndürebilir:

  • PERMISSION_DENIED - kullanıcının projeyi okuma yetkisi yoksa
  • INVALID_ARGUMENT - istek hatalı biçimlendirilmişse
  • FAILED_PRECONDITION - istekteki bir argüman geçersizse; örneğin yerel ayar formatı yanlışsa
  • NOT_FOUND - içeren Adım mevcut değilse

HTTP isteği

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

URL, gRPC Kod Dönüştürme sözdizimini kullanır.

Yol parametreleri

Parametreler
name

string

Adımın tam kaynak adı. Örneğin, projeler/projem/geçmişler/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Gerekli.

Sorgu parametreleri

Parametreler
locale

string

Kabul edilen biçim, sınırlayıcı olarak kısa çizgi içeren standart Unicode biçimidir. Dil küçük harf, Dil Komut Dosyası - Büyük Harf, Bölge - BÜYÜK HARF olmalıdır. Ayrıntılar için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresine bakın.

Gerekli.

Talep gövdesi

İstek gövdesi boş olmalıdır.

Yanıt gövdesi

AccessibilityService.ListStepAccessibilityClusters için yanıt iletisi.

Başarılı olursa yanıt gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Alanlar
name

string

Adımın tam kaynak adı. Örneğin, projeler/projem/geçmişler/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Daima sunar.

clusters[]

object ( SuggestionClusterProto )

Kümeler halinde gruplandırılmış bir dizi erişilebilirlik önerisi. Sıra içinde aynı ÖneriKategorisine ait olan kümeler bitişik olmalıdır. Her kategoride kümeler Öneri Önceliğine göre sıralanmalıdır (önce HATALAR). Kategoriler en yüksek öncelikli kümelerine göre sıralanmalıdır.

Yetki kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış bölümüne bakın.

ÖneriKümesiProto

Birbiriyle yakından ilişkili olduğundan şüphelendiğimiz bir dizi benzer öneri.

Bu protokol ve iç içe geçmiş protokollerin çoğu foxandcrown.prelaunchreport.service.SuggestionClusterProto'dan dallanmıştır ve PLR'nin bağımlılıkları FTL'lerle değiştirilmiştir.

JSON gösterimi
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Alanlar
category

enum ( SuggestionCategory )

Bu tür önerilerin görüneceği kategori. Her zaman ayarlayın.

suggestions[]

object ( SuggestionProto )

Bir dizi öneri. Bir küme içindeki önerilerin tümü aynı Öneri Önceliğine sahip olmalı ve aynı Öneri Kategorisine ait olmalıdır. Aynı ekran görüntüsü URL'sine sahip öneriler bitişik olmalıdır.

ÖneriKategorisi

Numaralandırmalar
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

ÖneriProto

JSON gösterimi
{
  "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.
}
Alanlar
title

string

Önerinin kullanıcının dilinde, işaretlemesiz genel başlığı. Her zaman ayarlayın.

shortMessage

object ( SafeHtmlProto )

İşaretleme içerebilecek, öneriyi temsil eden, kullanıcının dilinde kısa mesaj. Her zaman ayarlayın.

longMessage

object ( SafeHtmlProto )

İşaretleme içerebilecek, öneriyi açıklayan, kullanıcının dilindeki mesaj. Her zaman ayarlayın.

priority

enum ( SuggestionPriority )

Bir önerinin göreceli önemi. Her zaman ayarlayın.

helpUrl

string

Bu tür önerilerle ilgili bir yardım merkezi makalesine referans. Her zaman ayarlayın.

region

object ( RegionProto )

Ekran görüntüsündeki bu öneriyle alakalı bölge. İsteğe bağlı.

secondaryPriority

number

Bir önerinin, aynı önceliğe ve kategoriye sahip diğer önerilerle karşılaştırıldığında göreceli önemi. Aynı kategoride ve aynı önceliğe sahip önerileri sıralamak için kullanılabilecek anlamsız bir değerdir. Daha büyük değerler daha yüksek önceliğe sahiptir (yani daha önemlidir). İsteğe bağlı.

screenId

string

Öneri için ekranın kimliği. İlgili ekran görüntüsü yolunu almak için kullanılır. Örneğin, screenId "1", GCS'deki "1.png" dosyasına karşılık gelir. Her zaman ayarlayın.

Birleşim alanı resource_id .

resource_id aşağıdakilerden yalnızca biri olabilir:

resourceName

string

Varsa, kaynak adıyla tanımlanan bir görünüm öğesine başvuru.

pseudoResourceId

string

KaynakAdı yoksa, kaynak görünümünün insanlar tarafından okunabilir bir tanımlayıcısı. Bu, erişilebilirlik hiyerarşisi içindeki bir yoldur, kaynak adına sahip bir öğedir; XPath'a benzer.

SafeHtmlProto

ÖNEMLİ: Bir saldırganın, türün güvenlik sözleşmesini karşılamayan serileştirilmiş mesajların sahtesini yapması önemsiz olduğundan, güvenilmeyen bir kaynaktan gelen bu mesajı kabul etmek güvenli değildir; örneğin, saldırgan tarafından kontrol edilen komut dosyası içerebilir. SafeHtmlProto alan bir sistem, SafeHtmlProto üreticisine dolaylı olarak güvenir. Bu nedenle, bu mesajı RPC yanıtlarında döndürmek genellikle güvenlidir, ancak RPC isteklerinde kabul etmek genellikle güvenli değildir.

JSON gösterimi
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Alanlar
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

ÖNEMLİ: Testlerde bile bu alanı asla ayarlamayın veya okumayın, özeldir. Bu mesajın oluşturulacağı veya okunacağı programlama dili paketleri için .proto dosyasının üst kısmındaki belgelere bakın.

ÖneriÖncelik

Numaralandırmalar
unknownPriority
error
warning
info

BölgeProto

Dikdörtgen bir bölge.

JSON gösterimi
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Alanlar
topPx

integer

Dikdörtgenin piksel cinsinden üst kısmı. Her zaman ayarlayın.

leftPx

integer

Dikdörtgenin sol tarafı, piksel cinsinden. Her zaman ayarlayın.

heightPx

integer

Yükseklik, piksel cinsinden. Her zaman ayarlayın.

widthPx

integer

Genişlik, piksel cinsinden. Her zaman ayarlayın.