Skip to content

gplay team grants set

Grant or adjust <email>'s access to one app (--package) via an upsert: gplay reads the member's current grants, then creates the grant if absent or updates it if present. Express permissions in friendly form — --role <bundle> XOR --permissions <alias,…> — resolved in app scope. Run gplay team permissions --scope app to list them.

Use --dry-run to rehearse: it reads the current state (an idempotent read, no write) and, with --output json, reports the resolved verb (create/update), the permission diff (current → desired, with add/remove), and the requires array. An admin-conferring grant requires the named --grant-admin (exit 3).

gplay team grants set <email> --package <pkg> [flags]
FlagDescription
--developer-id stringPlay Console Developer account id (overrides the active Account's, env, and project-local)
--dry-runrehearse: read current state and report the verb + diff without writing
--grant-adminacknowledge conferring admin (required when the permission set includes admin)
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
--package stringthe app (package name) to grant access to
--permissions stringspermission aliases or raw CAN_* enums (repeatable or comma-separated)
--role stringrole bundle to grant (viewer, reviewer, tester-manager, release-manager, admin)
FlagDescription
--account stringname of a stored Account to use (overrides env and active Account)
--retry intretry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry)
--service-account stringpath to a service-account JSON, or inline JSON content (overrides --account, env, and active Account)
--timeout durationper-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads)
-v, --verboselog flow steps to stderr (info level)