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
  • GEÇERSİZ_BİLGİ - istek hatalı biçimlendirilmişse
  • FAILED_PRETERMS - istekteki bir bağımsız değişken geçersiz olursa; ör. yerel ayar biçimi 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öz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Adımın tam kaynak adı. Örneğin, projects/my-project/hihistory/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Zorunlu.

Sorgu parametreleri

Parametreler
locale

string

Kabul edilen biçim, sınırlayıcı olarak kısa çizginin kullanıldığı standart Unicode biçimidir. Dil küçük harfle yazılmalı, Dil Komut Dosyası - Büyük Harf Kullanımı, Bölge - BÜYÜK HARF olmalıdır. Ayrıntılar için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın.

Zorunlu.

İstek içeriği

İsteğin gövdesi boş olmalıdır.

Yanıt gövdesi

AccessibilityService.ListStepAccessibilityClusters için yanıt mesajı.

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

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

string

Adımın tam kaynak adı. Örneğin, projects/my-project/hihistory/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Her zaman sunar.

clusters[]

object (SuggestionClusterProto)

Kümeler halinde gruplandırılmış bir dizi erişilebilirlik önerisi. Dizi içinde, aynı SuggestionCategory'a ait kümeler bitişik olmalıdır. Her bir kategoride, kümeler ÖneriÖnceliklerine göre sıralanmalıdır (önce HATA). Kategoriler, en yüksek öncelikli kümeye göre sıralanmalıdır.

Yetkilendirme 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ış başlıklı makaleye bakın.

ÖneriKümesiProtosu

Yakından alakalı olduğundan şüphelendiğimiz bir dizi benzer öneri.

Bu proto ve iç içe yerleştirilmiş protoların çoğu, foxandcrown.prelaunchreport.service.SuggestionClusterProto'dan dallara ayrılmıştır ve PLR'nin bağımlılıkları FTL'lerle değiştirilir.

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

enum (SuggestionCategory)

Bu tür önerilerin gösterileceği kategori. Her zaman hazır.

suggestions[]

object (SuggestionProto)

Bir dizi öneri. Bir kümedeki tüm öneriler aynı SuggestionPriority'ye sahip olmalı ve aynı SuggestionCategory öğesine ait olmalıdır. Aynı ekran görüntüsü URL'sine sahip öneriler bitişik olmalıdır.

ÖneriKategorisi

Sıralamalar
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

Öneri Protokolü

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şaretleme olmadan genel başlığı. Her zaman hazır.

shortMessage

object (SafeHtmlProto)

Kullanıcının dilinde, öneriyi temsil eden ve işaretleme içerebilen kısa mesaj. Her zaman hazır.

longMessage

object (SafeHtmlProto)

İşaretlemeyi içerebilecek, kullanıcının dilinde, öneriyi açıklayan mesaj. Her zaman hazır.

priority

enum (SuggestionPriority)

Bir önerinin göreceli önemi. Her zaman hazır.

helpUrl

string

Bu tür önerilerle ilgili bir Yardım Merkezi makalesine referans verme. Her zaman hazır.

region

object (RegionProto)

Ekran görüntüsünde bu öneriyle alakalı olan 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. Bu, aynı kategoride ve aynı önceliğe sahip önerileri sıralamak için kullanılabilecek anlamsız bir değerdir. Daha büyük değerlerin önceliği daha yüksektir (yani daha önemlidir). İsteğe bağlı.

screenId

string

Öneriye ait ekranın kimliği. İlgili ekran görüntüsü yolunu almak için kullanılır. Örneğin, screenId "1" "1.png"ye karşılık gelir dosyası oluşturabilirsiniz. Her zaman hazır.

Birleştirme alanı resource_id.

resource_id şunlardan yalnızca biri olabilir:

resourceName

string

Bir görünüm öğesine (varsa kaynak adıyla tanımlanan) başvuru.

pseudoResourceId

string

sourceName'e sahip değilse kaynak görünümünün insanlar tarafından okunabilecek bir tanımlayıcısı. Bu, erişilebilirlik hiyerarşisindeki bir yoldur ve kaynak adına sahip bir öğedir; XPath'e benzer.

SafeHtmlProto

ÖNEMLİ: Güvenilmeyen bir kaynaktan gelen bu iletinin kabul edilmesi güvenli değildir. Örneğin, saldırgan tarafından kontrol edilen bir komut dosyası içerebilir ve bu tür iletilerin bir saldırgan tarafından sahte iletiler oluşturması önemli değildir. SafeHTMLProto alan bir sistem, Dolaylı olarak SafeHTMLProto'nun üreticisine güvenir. Dolayısıyla bu mesajın RPC yanıtlarında döndürülmesi genellikle güvenlidir ancak RPC isteklerinde kabul etmek genellikle güvenli değildir.

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

string

ÖNEMLİ: Testlerde bile olsa bu alanı hiçbir zaman ayarlamayın veya okumayın. Alan gizlidir. Bu mesajı oluşturmak veya okumak için kullanılacak programlama dili paketleri için .proto dosyasının üst kısmındaki dokümanlara bakın.

ÖneriÖnceliği

Sıralamalar
unknownPriority
error
warning
info

Bölge Protokolü

Dikdörtgen 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 hazır.

leftPx

integer

Dikdörtgenin piksel cinsinden sol kenarı. Her zaman hazır.

heightPx

integer

Piksel cinsinden yükseklik. Her zaman hazır.

widthPx

integer

Piksel cinsinden genişlik. Her zaman hazır.