Ta strona została przetłumaczona przez Cloud Translation API.

Raporty zapytań

Report zawiera wynik pojedynczej analizy pakietu aplikacji i obejmuje wyniki kontroli zgodności oraz monitorowania danych. Prawie wszystkie dane, które są dostępne na stronach Zgodność i Monitorowanie danych w Konsoli weryfikacji, można uzyskać automatycznie za pomocą raportów.

Interfejs Checks API udostępnia standardowe metody Get i List umożliwiające dostęp do raportów:

Wybierz pola, które mają być zwracane

Raporty zawierają dużo danych, więc domyślnie zwracane są tylko pola name i resultsUri. Aby zwrócić inny zestaw pól, wymień je wyraźnie w parametrze zapytania URL fields.

Przykład:

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

Zwraca:

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

Pola zagnieżdżone można wyświetlać za pomocą składni z kropką lub umieszczając je w nawiasach.

Na przykład

fields=checks.type,checks.state

to tyle samo co

fields=checks(type,state)

Nawiasów można też używać rekurencyjnie, np.:

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

Dzięki temu wyrażenia są bardziej zwięzłe.

Wartość parametru zapytania fields jest też nazywana maską pól. Więcej informacji znajdziesz w sekcji Maski pól.

Oto więcej przykładów masek pól w przypadku metod Get i List:

Pobierz

Wyrażenie	Wyniki
`*`	Zwraca wszystkie pola.
`name,checks`	Zwraca `name` i wszystkie zagnieżdżone pola `checks`.
`name,checks(type,state)`	Zwraca wartości `name`, `checks.type` i `checks.state`.
`name,dataMonitoring`	Zwraca `name` i wszystkie zagnieżdżone pola `dataMonitoring`.

Lista

Wyrażenie	Wyniki
`*`	Zwraca wszystkie pola.
`reports(name,checks)`	Zwraca `name` i wszystkie zagnieżdżone pola `checks`.
`reports(name,checks(type,state))`	Zwraca wartości `name`, `checks.type` i `checks.state`.
`reports(name,dataMonitoring)`	Zwraca `name` i wszystkie zagnieżdżone pola `dataMonitoring`.

Filtruj raporty

Raporty zwracane przez metodę List możesz filtrować, przekazując wyrażenie filtra za pomocą parametru zapytania URL filter.

Oto przykłady:

Wyrażenie	Wyniki
`appBundle.releaseType = PRE_RELEASE`	Zwraca tylko raporty dotyczące pakietów aplikacji w wersji przedpremierowej.
`appBundle.releaseType = PUBLIC`	Zwraca tylko raporty dotyczące publicznych pakietów aplikacji.
`appBundle.codeReferenceId = abc123`	Zwraca raporty, w których `codeReferenceId` jest równe `abc123`.

Filtrowanie według tych ścieżek pól nie jest obsługiwane:

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

Więcej informacji o tworzeniu wyrażeń filtra znajdziesz w AIP-160.

Filtrowanie weryfikacji w raportach

Możesz filtrować sprawdzanie w raportach, przekazując wyrażenie filtra za pomocą checksFilterparametru zapytania adresu URL. Odpowiedź zawiera tylko kontrole pasujące do wyrażenia filtra. Ten parametr jest obsługiwany przez metody List i Get.