Method: projects.histories.executions.steps.accessibilityClusters

Mencantumkan klaster aksesibilitas untuk Langkah tertentu

Dapat mengembalikan salah satu kode kesalahan kanonik berikut:

  • PERMISSION_DENIED - jika pengguna tidak berwenang untuk membaca proyek
  • INVALID_ARGUMENT - jika permintaan salah format
  • FAILED_PRECONDITION - jika argumen dalam permintaan tidak valid; misalnya jika format lokal salah
  • NOT_FOUND - jika Langkah yang memuatnya tidak ada

permintaan HTTP

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

URL menggunakan sintaks Transcoding gRPC .

Parameter jalur

Parameter
name

string

Nama sumber daya lengkap untuk langkah tersebut. Misalnya, project/proyek-saya/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Diperlukan.

Parameter kueri

Parameter
locale

string

Format yang diterima adalah format Unicode kanonik dengan tanda hubung sebagai pembatas. Bahasa harus menggunakan huruf kecil, Skrip Bahasa - Kapitalisasi, Wilayah - HURUF BESAR. Lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier untuk detailnya.

Diperlukan.

Permintaan tubuh

Badan permintaan harus kosong.

Badan respons

Pesan respons untuk AccessibilityService.ListStepAccessibilityClusters.

Jika berhasil, isi respons berisi data dengan struktur berikut:

Representasi JSON
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Bidang
name

string

Nama sumber daya lengkap untuk langkah tersebut. Misalnya, project/proyek-saya/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Selalu hadir.

clusters[]

object ( SuggestionClusterProto )

Serangkaian saran aksesibilitas, dikelompokkan ke dalam kelompok. Dalam urutan tersebut, klaster yang termasuk dalam SuggestionCategory yang sama harus berdekatan. Dalam setiap kategori, cluster harus diurutkan berdasarkan SuggestionPriority (ERROR terlebih dahulu). Kategori harus diurutkan berdasarkan cluster dengan prioritas tertinggi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi lebih lanjut, lihat Ikhtisar Otentikasi .

SaranClusterProto

Serangkaian saran serupa yang kami duga berkaitan erat.

Proto ini dan sebagian besar proto bersarang merupakan cabang dari foxandcrown.prelaunchreport.service.SuggestionClusterProto, menggantikan dependensi PLR dengan FTL.

Representasi JSON
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Bidang
category

enum ( SuggestionCategory )

Kategori tempat jenis saran ini akan muncul. Selalu atur.

suggestions[]

object ( SuggestionProto )

Serangkaian saran. Semua saran dalam klaster harus memiliki SuggestionPriority yang sama dan termasuk dalam SuggestionCategory yang sama. Saran dengan URL tangkapan layar yang sama harus bersebelahan.

Kategori Saran

Enum
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

SaranProto

Representasi 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.
}
Bidang
title

string

Judul umum untuk saran, dalam bahasa pengguna, tanpa markup. Selalu atur.

shortMessage

object ( SafeHtmlProto )

Pesan ringkas, dalam bahasa pengguna, mewakili saran, yang mungkin berisi markup. Selalu atur.

longMessage

object ( SafeHtmlProto )

Pesan, dalam bahasa pengguna, menjelaskan saran, yang mungkin berisi markup. Selalu atur.

priority

enum ( SuggestionPriority )

Pentingnya relatif sebuah saran. Selalu atur.

helpUrl

string

Referensi ke artikel pusat bantuan mengenai jenis saran ini. Selalu atur.

region

object ( RegionProto )

Wilayah dalam tangkapan layar yang relevan dengan saran ini. Opsional.

secondaryPriority

number

Kepentingan relatif suatu saran dibandingkan dengan saran lain yang mempunyai prioritas dan kategori yang sama. Ini adalah nilai tidak berarti yang dapat digunakan untuk mengurutkan saran yang berada dalam kategori yang sama dan memiliki prioritas yang sama. Nilai yang lebih besar memiliki prioritas yang lebih tinggi (yaitu lebih penting). Opsional.

screenId

string

ID layar untuk saran. Ini digunakan untuk mendapatkan jalur tangkapan layar yang sesuai. Misalnya, screenId "1" berhubungan dengan file "1.png" di GCS. Selalu atur.

Bidang gabungan resource_id .

resource_id hanya dapat berupa salah satu dari berikut ini:

resourceName

string

Referensi ke elemen tampilan, diidentifikasi berdasarkan nama sumber dayanya, jika ada.

pseudoResourceId

string

Pengidentifikasi tampilan sumber yang agak dapat dibaca manusia, jika tidak memiliki resourceName. Ini adalah jalur dalam hierarki aksesibilitas, elemen dengan nama sumber daya; mirip dengan XPath.

SafeHtmlProto

PENTING: Tidak aman menerima pesan ini dari sumber yang tidak tepercaya, karena mudah bagi penyerang untuk memalsukan pesan berseri yang tidak memenuhi kontrak keamanan jenis tersebut -- misalnya, pesan tersebut dapat berisi skrip yang dikendalikan penyerang. Sistem yang menerima SafeHtmlProto secara implisit mempercayai produsen SafeHtmlProto. Jadi, secara umum aman untuk mengembalikan pesan ini dalam tanggapan RPC, namun secara umum tidak aman untuk menerimanya dalam permintaan RPC.

Representasi JSON
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Bidang
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

PENTING: Jangan pernah mengatur atau membaca bidang ini, bahkan dari pengujian, ini bersifat pribadi. Lihat dokumentasi di bagian atas file .proto untuk paket bahasa pemrograman yang dapat digunakan untuk membuat atau membaca pesan ini.

Prioritas Saran

Enum
unknownPriority
error
warning
info

WilayahProto

Wilayah berbentuk persegi panjang.

Representasi JSON
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Bidang
topPx

integer

Bagian atas persegi panjang, dalam piksel. Selalu atur.

leftPx

integer

Sisi kiri persegi panjang, dalam piksel. Selalu atur.

heightPx

integer

Tingginya, dalam piksel. Selalu atur.

widthPx

integer

Lebarnya, dalam piksel. Selalu atur.

,

Mencantumkan klaster aksesibilitas untuk Langkah tertentu

Dapat mengembalikan salah satu kode kesalahan kanonik berikut:

  • PERMISSION_DENIED - jika pengguna tidak berwenang untuk membaca proyek
  • INVALID_ARGUMENT - jika permintaan salah format
  • FAILED_PRECONDITION - jika argumen dalam permintaan tidak valid; misalnya jika format lokal salah
  • NOT_FOUND - jika Langkah yang memuatnya tidak ada

permintaan HTTP

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

URL menggunakan sintaks Transcoding gRPC .

Parameter jalur

Parameter
name

string

Nama sumber daya lengkap untuk langkah tersebut. Misalnya, project/proyek-saya/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Diperlukan.

Parameter kueri

Parameter
locale

string

Format yang diterima adalah format Unicode kanonik dengan tanda hubung sebagai pembatas. Bahasa harus menggunakan huruf kecil, Skrip Bahasa - Kapitalisasi, Wilayah - HURUF BESAR. Lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier untuk detailnya.

Diperlukan.

Permintaan tubuh

Badan permintaan harus kosong.

Badan respons

Pesan respons untuk AccessibilityService.ListStepAccessibilityClusters.

Jika berhasil, isi respons berisi data dengan struktur berikut:

Representasi JSON
{
  "name": string,
  "clusters": [
    {
      object (SuggestionClusterProto)
    }
  ]
}
Bidang
name

string

Nama sumber daya lengkap untuk langkah tersebut. Misalnya, project/proyek-saya/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef

Selalu hadir.

clusters[]

object ( SuggestionClusterProto )

Serangkaian saran aksesibilitas, dikelompokkan ke dalam kelompok. Dalam urutan tersebut, klaster yang termasuk dalam SuggestionCategory yang sama harus berdekatan. Dalam setiap kategori, cluster harus diurutkan berdasarkan SuggestionPriority (ERROR terlebih dahulu). Kategori harus diurutkan berdasarkan cluster dengan prioritas tertinggi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi lebih lanjut, lihat Ikhtisar Otentikasi .

SaranClusterProto

Serangkaian saran serupa yang kami duga berkaitan erat.

Proto ini dan sebagian besar proto bersarang merupakan cabang dari foxandcrown.prelaunchreport.service.SuggestionClusterProto, menggantikan dependensi PLR dengan FTL.

Representasi JSON
{
  "category": enum (SuggestionCategory),
  "suggestions": [
    {
      object (SuggestionProto)
    }
  ]
}
Bidang
category

enum ( SuggestionCategory )

Kategori tempat jenis saran ini akan muncul. Selalu atur.

suggestions[]

object ( SuggestionProto )

Serangkaian saran. Semua saran dalam klaster harus memiliki SuggestionPriority yang sama dan termasuk dalam SuggestionCategory yang sama. Saran dengan URL tangkapan layar yang sama harus bersebelahan.

Kategori Saran

Enum
unknownCategory
contentLabeling
touchTargetSize
lowContrast
implementation

SaranProto

Representasi 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.
}
Bidang
title

string

Judul umum untuk saran, dalam bahasa pengguna, tanpa markup. Selalu atur.

shortMessage

object ( SafeHtmlProto )

Pesan ringkas, dalam bahasa pengguna, mewakili saran, yang mungkin berisi markup. Selalu atur.

longMessage

object ( SafeHtmlProto )

Pesan, dalam bahasa pengguna, menjelaskan saran, yang mungkin berisi markup. Selalu atur.

priority

enum ( SuggestionPriority )

Pentingnya relatif sebuah saran. Selalu atur.

helpUrl

string

Referensi ke artikel pusat bantuan mengenai jenis saran ini. Selalu atur.

region

object ( RegionProto )

Wilayah dalam tangkapan layar yang relevan dengan saran ini. Opsional.

secondaryPriority

number

Kepentingan relatif suatu saran dibandingkan dengan saran lain yang mempunyai prioritas dan kategori yang sama. Ini adalah nilai tidak berarti yang dapat digunakan untuk mengurutkan saran yang berada dalam kategori yang sama dan memiliki prioritas yang sama. Nilai yang lebih besar memiliki prioritas yang lebih tinggi (yaitu lebih penting). Opsional.

screenId

string

ID layar untuk saran. Ini digunakan untuk mendapatkan jalur tangkapan layar yang sesuai. Misalnya, screenId "1" berhubungan dengan file "1.png" di GCS. Selalu atur.

Bidang gabungan resource_id .

resource_id hanya dapat berupa salah satu dari berikut ini:

resourceName

string

Referensi ke elemen tampilan, diidentifikasi berdasarkan nama sumber dayanya, jika ada.

pseudoResourceId

string

Pengidentifikasi tampilan sumber yang agak dapat dibaca manusia, jika tidak memiliki resourceName. Ini adalah jalur dalam hierarki aksesibilitas, elemen dengan nama sumber daya; mirip dengan XPath.

SafeHtmlProto

PENTING: Tidak aman menerima pesan ini dari sumber yang tidak tepercaya, karena mudah bagi penyerang untuk memalsukan pesan berseri yang tidak memenuhi kontrak keamanan jenis tersebut -- misalnya, pesan tersebut dapat berisi skrip yang dikendalikan penyerang. Sistem yang menerima SafeHtmlProto secara implisit mempercayai produsen SafeHtmlProto. Jadi, secara umum aman untuk mengembalikan pesan ini dalam tanggapan RPC, namun secara umum tidak aman untuk menerimanya dalam permintaan RPC.

Representasi JSON
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Bidang
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

PENTING: Jangan pernah mengatur atau membaca bidang ini, bahkan dari pengujian, ini bersifat pribadi. Lihat dokumentasi di bagian atas file .proto untuk paket bahasa pemrograman yang dapat digunakan untuk membuat atau membaca pesan ini.

Prioritas Saran

Enum
unknownPriority
error
warning
info

WilayahProto

Wilayah berbentuk persegi panjang.

Representasi JSON
{
  "topPx": integer,
  "leftPx": integer,
  "heightPx": integer,
  "widthPx": integer
}
Bidang
topPx

integer

Bagian atas persegi panjang, dalam piksel. Selalu atur.

leftPx

integer

Sisi kiri persegi panjang, dalam piksel. Selalu atur.

heightPx

integer

Tingginya, dalam piksel. Selalu atur.

widthPx

integer

Lebarnya, dalam piksel. Selalu atur.