Gamification

Returns the users ranked by points earned in the selected period. When `period` is omitted, all-time points are used; when `limit` is omitted, up to 100 positions are returned. Results are limited to the products and users accessible with the current credentials. Filtering by `product_id` narrows that scope and never widens it: requesting products outside the scope returns an empty ranking. Each entry includes the user's name and avatar only when the credentials also have the `users.read` permission; otherwise the `user` object is `null`. Rankings are eventually consistent. Manual point adjustments are reflected on the next request, while automatically awarded points may take up to `cache_ttl_seconds` to appear.