Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Rapports sur les requêtes

Un Report contient le résultat d'une seule analyse d'app bundle et inclut les vérifications de conformité et les résultats de surveillance des données. Presque toutes les données proposées sur les pages Conformité et Surveillance des données de la console Checks sont accessibles par programmation via des rapports.

L'API Checks fournit des méthodes Get et List standards pour accéder aux rapports :

Sélectionner les champs à renvoyer

Étant donné que les rapports contiennent de nombreuses données, seuls les champs name et resultsUri sont renvoyés par défaut. Pour renvoyer un autre ensemble de champs, listez-les explicitement dans le paramètre de requête URL fields.

Exemple :

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

Renvoie :

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

Les champs imbriqués peuvent être listés à l'aide de la syntaxe avec point ou en les plaçant entre parenthèses.

Par exemple,

fields=checks.type,checks.state

équivaut à

fields=checks(type,state)

Les parenthèses peuvent également être utilisées de manière récursive, comme dans l'exemple suivant :

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

Cela permet de rendre les expressions plus concises.

La valeur du paramètre de requête fields est également appelée masque de champ. Pour en savoir plus, consultez Masques de champ.

Vous trouverez ci-dessous d'autres exemples de masques de champ pour les méthodes Get et List :

Télécharger

Expression	Sortie
`*`	Renvoie tous les champs.
`name,checks`	Renvoie `name` et tous les champs imbriqués de `checks`.
`name,checks(type,state)`	Renvoie `name`, `checks.type` et `checks.state`.
`name,dataMonitoring`	Renvoie `name` et tous les champs imbriqués de `dataMonitoring`.

Liste

Expression	Sortie
`*`	Renvoie tous les champs.
`reports(name,checks)`	Renvoie `name` et tous les champs imbriqués de `checks`.
`reports(name,checks(type,state))`	Renvoie `name`, `checks.type` et `checks.state`.
`reports(name,dataMonitoring)`	Renvoie `name` et tous les champs imbriqués de `dataMonitoring`.

Filtrer les rapports

Vous pouvez filtrer les rapports renvoyés par la méthode List en transmettant une expression de filtre à l'aide du paramètre de requête URL filter.

Voici quelques exemples :

Expression	Sortie
`appBundle.releaseType = PRE_RELEASE`	Ne renvoie que les rapports des app bundles en préversion.
`appBundle.releaseType = PUBLIC`	Ne renvoie que les rapports des app bundles publics.
`appBundle.codeReferenceId = abc123`	Renvoie les rapports où `codeReferenceId` est égal à `abc123`.

Le filtrage par ces chemins d'accès de champ n'est pas pris en charge :

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

Pour savoir comment créer d'autres expressions de filtre, consultez AIP-160.

Filtrer les vérifications dans les rapports

Vous pouvez filtrer les vérifications dans les rapports en transmettant une expression de filtre à l'aide du paramètre de requête URL checksFilter. Seules les vérifications correspondant à l'expression de filtre sont incluses dans la réponse. Ce paramètre est compatible avec les méthodes List et Get.