Halaman ini diterjemahkan oleh Cloud Translation API.

Laporan kueri

Report berisi hasil analisis satu bundle aplikasi dan mencakup hasil pemeriksaan kepatuhan dan pemantauan data. Hampir semua data yang ditawarkan melalui halaman Kepatuhan dan Pemantauan Data di Checks Console dapat diakses secara terprogram melalui laporan.

Checks API menyediakan metode Get dan List standar untuk mengakses laporan:

Pilih kolom yang akan ditampilkan

Karena laporan berisi banyak data, hanya kolom name dan resultsUri yang ditampilkan secara default. Untuk menampilkan kumpulan kolom yang berbeda, cantumkan secara eksplisit dalam parameter kueri URL fields.

Contoh:

GET https://checks.googleapis.com/v1alpha/accounts/123/apps/456/reports/789?fields=name,checks(type,state)

Retur:

{
  "name": "accounts/123/apps/456/reports/789",
  "checks": [
    {
      "type": "PRIVACY_POLICY_UPDATE_DATE_RECENT",
      "state": "PASSED"
    },
    ...
  ]
}

Kolom bertingkat dapat dicantumkan menggunakan sintaksis titik atau dengan menyertakannya dalam tanda kurung.

Misalnya,

fields=checks.type,checks.state

setara dengan

fields=checks(type,state)

Tanda kurung juga dapat digunakan secara rekursif, seperti:

fields=checks(type,state,evidence(permissions,sdks))

Hal ini memungkinkan ekspresi menjadi lebih ringkas.

Nilai parameter kueri fields juga dikenal sebagai masker kolom. Lihat Mask kolom untuk mempelajari lebih lanjut.

Berikut adalah contoh mask kolom lainnya untuk metode Get dan List:

Dapatkan

Ekspresi	Output
`*`	Menampilkan semua kolom.
`name,checks`	Menampilkan `name` dan semua kolom bertingkat dari `checks`.
`name,checks(type,state)`	Menampilkan `name`, `checks.type`, dan `checks.state`.
`name,dataMonitoring`	Menampilkan `name` dan semua kolom bertingkat dari `dataMonitoring`.

Daftar

Ekspresi	Output
`*`	Menampilkan semua kolom.
`reports(name,checks)`	Menampilkan `name` dan semua kolom bertingkat dari `checks`.
`reports(name,checks(type,state))`	Menampilkan `name`, `checks.type`, dan `checks.state`.
`reports(name,dataMonitoring)`	Menampilkan `name` dan semua kolom bertingkat dari `dataMonitoring`.

Memfilter laporan

Anda dapat memfilter laporan yang ditampilkan oleh metode List dengan meneruskan ekspresi filter menggunakan parameter kueri URL filter.

Berikut beberapa contohnya:

Ekspresi	Output
`appBundle.releaseType = PRE_RELEASE`	Hanya menampilkan laporan app bundle pra-rilis.
`appBundle.releaseType = PUBLIC`	Hanya menampilkan laporan app bundle publik.
`appBundle.codeReferenceId = abc123`	Menampilkan laporan dengan `codeReferenceId` sama dengan `abc123`.

Pemfilteran menurut jalur kolom ini tidak didukung:

checks.evidence.dataTypes.dataTypeEvidence.endpoints.attributedSdks.sdk.id
checks.evidence.dataTypes.dataTypeEvidence.endpoints.endpointDetails.endpoint.domain
checks.evidence.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.htmlContent
checks.evidence.privacyPolicyTexts.policyFragment.htmlContent
checks.evidence.sdkIssues.sdk.id
dataMonitoring.dataTypes.dataTypeEvidence.endpoints.attributedSdks.sdk.id
dataMonitoring.dataTypes.dataTypeEvidence.endpoints.endpointDetails.endpoint.domain
dataMonitoring.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.htmlContent
dataMonitoring.dataTypes.dataTypeEvidence.privacyPolicyTexts.policyFragment.sourceUri
dataMonitoring.permissions.metadata.lastDetectedAppVersion
resultsUri

Lihat AIP-160 untuk mempelajari cara membuat ekspresi filter lainnya.

Memfilter pemeriksaan dalam laporan

Anda dapat memfilter pemeriksaan dalam laporan dengan meneruskan ekspresi filter menggunakan parameter kueri URL checksFilter. Hanya pemeriksaan yang cocok dengan ekspresi filter yang disertakan dalam respons. Parameter ini didukung oleh metode List dan Get.