Files
google-apis-rs/google_games1_cli/scores_get/index.html
2024-03-05 21:06:01 +01:00

364 lines
16 KiB
HTML

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="http://byron.github.io/google-apis-rs/google-games1-cli/scores_get/" />
<link rel="shortcut icon" href="../img/favicon.ico" />
<title>Get - Games v5.0.4+20240228</title>
<link rel="stylesheet" href="../css/theme.css" />
<link rel="stylesheet" href="../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "Get";
var mkdocs_page_input_path = "scores_get.md";
var mkdocs_page_url = "/google-apis-rs/google-games1-cli/scores_get/";
</script>
<script src="../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href=".." class="icon icon-home"> Games v5.0.4+20240228
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="..">Home</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Achievement Definitions</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../achievement-definitions_list/">List</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Achievements</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../achievements_increment/">Increment</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../achievements_list/">List</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../achievements_reveal/">Reveal</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../achievements_set-steps-at-least/">Set Steps At Least</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../achievements_unlock/">Unlock</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../achievements_update-multiple/">Update Multiple</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Applications</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../applications_get/">Get</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../applications_get-end-point/">Get End Point</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../applications_played/">Played</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../applications_verify/">Verify</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Events</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../events_list-by-player/">List By Player</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../events_list-definitions/">List Definitions</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../events_record/">Record</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Leaderboards</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../leaderboards_get/">Get</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../leaderboards_list/">List</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Metagame</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../metagame_get-metagame-config/">Get Metagame Config</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../metagame_list-categories-by-player/">List Categories By Player</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Players</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../players_get/">Get</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../players_get-multiple-application-player-ids/">Get Multiple Application Player Ids</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../players_get-scoped-player-ids/">Get Scoped Player Ids</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../players_list/">List</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Recall</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../recall_link-persona/">Link Persona</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../recall_reset-persona/">Reset Persona</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../recall_retrieve-tokens/">Retrieve Tokens</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../recall_unlink-persona/">Unlink Persona</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Revisions</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../revisions_check/">Check</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Scores</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal current" href="./">Get</a>
<ul class="current">
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../scores_list/">List</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../scores_list-window/">List Window</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../scores_submit/">Submit</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../scores_submit-multiple/">Submit Multiple</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Snapshots</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../snapshots_get/">Get</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../snapshots_list/">List</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Stats</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../stats_get/">Get</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="..">Games v5.0.4+20240228</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href=".." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Scores &raquo;</li>
<li>Get</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/games1-cli/edit/master/docs/scores_get.md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<p>Get high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, <code>leaderboardId</code> can be set to <code>ALL</code> to retrieve data for all leaderboards in a given time span. `NOTE: You cannot ask for &#39;ALL&#39; leaderboards and &#39;ALL&#39; timeSpans in the same request; only one parameter may be set to &#39;ALL&#39;.</p>
<h1 id="scopes">Scopes</h1>
<p>You will need authorization for the <em>https://www.googleapis.com/auth/games</em> scope to make a valid call.</p>
<p>If unset, the scope for this method defaults to <em>https://www.googleapis.com/auth/games</em>.
You can set the scope for this method like this: <code>games1 --scope &lt;scope&gt; scores get ...</code></p>
<h1 id="required-scalar-arguments">Required Scalar Arguments</h1>
<ul>
<li><strong>&lt;player-id&gt;</strong> <em>(string)</em><ul>
<li>A player ID. A value of <code>me</code> may be used in place of the authenticated player&#39;s ID.</li>
</ul>
</li>
<li><strong>&lt;leaderboard-id&gt;</strong> <em>(string)</em><ul>
<li>The ID of the leaderboard. Can be set to &#39;ALL&#39; to retrieve data for all leaderboards for this application.</li>
</ul>
</li>
<li><strong>&lt;time-span&gt;</strong> <em>(string)</em><ul>
<li>The time span for the scores and ranks you&#39;re requesting.</li>
</ul>
</li>
</ul>
<h1 id="optional-output-flags">Optional Output Flags</h1>
<p>The method's return value a JSON encoded structure, which will be written to standard output by default.</p>
<ul>
<li><strong>-o out</strong><ul>
<li><em>out</em> specifies the <em>destination</em> to which to write the server's result to.
It will be a JSON-encoded structure.
The <em>destination</em> may be <code>-</code> to indicate standard output, or a filepath that is to contain the received bytes.
If unset, it defaults to standard output.</li>
</ul>
</li>
</ul>
<h1 id="optional-method-properties">Optional Method Properties</h1>
<p>You may set the following properties to further configure the call. Please note that <code>-p</code> is followed by one
or more key-value-pairs, and is called like this <code>-p k1=v1 k2=v2</code> even though the listing below repeats the
<code>-p</code> for completeness.</p>
<ul>
<li>
<p><strong>-p include-rank-type=string</strong></p>
<ul>
<li>The types of ranks to return. If the parameter is omitted, no ranks will be returned.</li>
</ul>
</li>
<li>
<p><strong>-p language=string</strong></p>
<ul>
<li>The preferred language to use for strings returned by this method.</li>
</ul>
</li>
<li>
<p><strong>-p max-results=integer</strong></p>
<ul>
<li>The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified <code>maxResults</code>.</li>
</ul>
</li>
<li>
<p><strong>-p page-token=string</strong></p>
<ul>
<li>The token returned by the previous request.</li>
</ul>
</li>
</ul>
<h1 id="optional-general-properties">Optional General Properties</h1>
<p>The following properties can configure any call, and are not specific to this method.</p>
<ul>
<li>
<p><strong>-p $-xgafv=string</strong></p>
<ul>
<li>V1 error format.</li>
</ul>
</li>
<li>
<p><strong>-p access-token=string</strong></p>
<ul>
<li>OAuth access token.</li>
</ul>
</li>
<li>
<p><strong>-p alt=string</strong></p>
<ul>
<li>Data format for response.</li>
</ul>
</li>
<li>
<p><strong>-p callback=string</strong></p>
<ul>
<li>JSONP</li>
</ul>
</li>
<li>
<p><strong>-p fields=string</strong></p>
<ul>
<li>Selector specifying which fields to include in a partial response.</li>
</ul>
</li>
<li>
<p><strong>-p key=string</strong></p>
<ul>
<li>API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.</li>
</ul>
</li>
<li>
<p><strong>-p oauth-token=string</strong></p>
<ul>
<li>OAuth 2.0 token for the current user.</li>
</ul>
</li>
<li>
<p><strong>-p pretty-print=boolean</strong></p>
<ul>
<li>Returns response with indentations and line breaks.</li>
</ul>
</li>
<li>
<p><strong>-p quota-user=string</strong></p>
<ul>
<li>Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.</li>
</ul>
</li>
<li>
<p><strong>-p upload-type=string</strong></p>
<ul>
<li>Legacy upload protocol for media (e.g. &#34;media&#34;, &#34;multipart&#34;).</li>
</ul>
</li>
<li>
<p><strong>-p upload-protocol=string</strong></p>
<ul>
<li>Upload protocol for media (e.g. &#34;raw&#34;, &#34;multipart&#34;).</li>
</ul>
</li>
</ul>
</div>
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href="../revisions_check/" class="btn btn-neutral float-left" title="Check"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../scores_list/" class="btn btn-neutral float-right" title="List">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
<p>Copyright &copy; 2015-2020, `Sebastian Thiel`</p>
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/games1-cli" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
<span><a href="../revisions_check/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../scores_list/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
<script>var base_url = '..';</script>
<script src="../js/theme_extra.js" defer></script>
<script src="../js/theme.js" defer></script>
<script src="../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);
};
</script>
</body>
</html>