Skip to content

gplay checks

Analyze app privacy, compliance, and AI safety with the Google Checks API.

gplay checks <subcommand> [flags]

Analyze app privacy, compliance, and AI safety with the Google Checks API.

Checks commands use the https://www.googleapis.com/auth/checks OAuth scope and the https://checks.googleapis.com/v1alpha API surface. App bundle analysis uses the current media upload endpoint, /upload/v1alpha/{parent=accounts//apps/}/reports:analyzeUpload.

List and inspect apps connected to Checks.

gplay checks apps <subcommand> [flags]

List apps under a Checks account.

gplay checks apps list --account <account-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--output Output format: json (default), table, markdown json
--page-size Results per page (1-50) 10
--paginate Fetch all pages false
--pretty Pretty-print JSON output false

Get a Checks app.

gplay checks apps get --account <account-id> --app <app-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false

List and inspect Checks compliance reports.

gplay checks reports <subcommand> [flags]

List Checks reports for an app.

gplay checks reports list --account <account-id> --app <app-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--checks-filter AIP-160 filter for checks within reports ``
--filter AIP-160 filter for reports ``
--output Output format: json (default), table, markdown json
--page-size Results per page (1-50) 10
--paginate Fetch all pages false
--pretty Pretty-print JSON output false

Get a Checks report.

gplay checks reports get --account <account-id> --app <app-id> --report <report-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--checks-filter AIP-160 filter for checks within the report ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--report Checks report ID or resource name ``

Manage Checks app analysis operations.

gplay checks operations <subcommand> [flags]

Get a Checks operation.

gplay checks operations get --account <account-id> --app <app-id> --operation <operation-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--operation Operation ID or resource name ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false

Wait for a Checks operation.

gplay checks operations wait --account <account-id> --app <app-id> --operation <operation-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--operation Operation ID or resource name ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--timeout Maximum time to wait 10m0s

Cancel a Checks operation.

gplay checks operations cancel --account <account-id> --app <app-id> --operation <operation-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--operation Operation ID or resource name ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false

List Checks operations for an app.

gplay checks operations list --account <account-id> --app <app-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--filter AIP-160 filter for operations ``
--output Output format: json (default), table, markdown json
--page-size Results per page (1-50) 10
--paginate Fetch all pages false
--pretty Pretty-print JSON output false

Delete a Checks operation.

gplay checks operations delete --account <account-id> --app <app-id> --operation <operation-id> [flags]
Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--operation Operation ID or resource name ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false

Upload an app binary for Checks compliance analysis.

gplay checks upload --account <account-id> --app <app-id> --binary <path> [flags]

Upload an APK, AAB, or IPA to the Checks media upload endpoint and start an asynchronous compliance analysis.

Use –severity-threshold PRIORITY in CI before release commands to fail the pipeline when high-priority failed checks are present. The command polls operations.get when –wait is true and prints progress to stderr.

Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--binary Path to APK, AAB, or IPA file ``
--binary-type App binary file type: ANDROID_APK, ANDROID_AAB, IOS_IPA ANDROID_APK
--checks-filter AIP-160 filter for checks in the resulting report (e.g. state = FAILED) ``
--code-ref Git commit hash or changelist number for the upload ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--severity-threshold Fail if a failed check meets severity: PRIORITY, POTENTIAL, OPPORTUNITY ``
--wait Wait for analysis to complete and print the report true
--wait-timeout Maximum time to wait for analysis 10m0s

Alias for gplay checks upload.

gplay checks analyze --account <account-id> --app <app-id> --binary <path> [flags]

Upload an APK, AAB, or IPA to the Checks media upload endpoint and start an asynchronous compliance analysis.

Use –severity-threshold PRIORITY in CI before release commands to fail the pipeline when high-priority failed checks are present. The command polls operations.get when –wait is true and prints progress to stderr.

Flag Description Default
--account Checks account ID (overrides GPLAY_CHECKS_ACCOUNT/checks_account) ``
--app Checks app ID or resource name ``
--binary Path to APK, AAB, or IPA file ``
--binary-type App binary file type: ANDROID_APK, ANDROID_AAB, IOS_IPA ANDROID_APK
--checks-filter AIP-160 filter for checks in the resulting report (e.g. state = FAILED) ``
--code-ref Git commit hash or changelist number for the upload ``
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--severity-threshold Fail if a failed check meets severity: PRIORITY, POTENTIAL, OPPORTUNITY ``
--wait Wait for analysis to complete and print the report true
--wait-timeout Maximum time to wait for analysis 10m0s

Classify app content with Checks AI safety policies.

gplay checks content <subcommand> [flags]

Classify text content against Checks AI safety policies.

gplay checks content classify --text <content> [flags]
Flag Description Default
--classifier-version Classifier version: STABLE or LATEST ``
--context Prompt or context that generated the content ``
--language ISO 639-1 language code ``
--output Output format: json (default), table, markdown json
--policies Comma-separated policies, or all all
--pretty Pretty-print JSON output false
--severity-threshold Fail if any policy result is VIOLATIVE false
--text Text content to classify, or @file ``

Classify text content against Checks AI safety policies.

gplay checks classify --text <content> [flags]
Flag Description Default
--classifier-version Classifier version: STABLE or LATEST ``
--context Prompt or context that generated the content ``
--language ISO 639-1 language code ``
--output Output format: json (default), table, markdown json
--policies Comma-separated policies, or all all
--pretty Pretty-print JSON output false
--severity-threshold Fail if any policy result is VIOLATIVE false
--text Text content to classify, or @file ``