- リソース: Player
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ProfileSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- FriendsListVisibility
- PlayerExperienceInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- PlayerLevel
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- FriendStatus
- メソッド
リソース: Player
プレーヤー リソース。
JSON 表現 |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
フィールド | |
---|---|
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
playerId |
プレーヤーの ID。 |
displayName |
プレーヤーに表示する名前。 |
avatarImageUrl |
プレーヤーを表す画像のベース URL。 |
bannerUrlPortrait |
縦表示のプレーヤー バナー画像の URL。 |
bannerUrlLandscape |
横表示のプレーヤー バナー画像の URL。 |
originalPlayerId |
対象のゲームに初めてログインしたときに、このプレーヤーが使用したプレーヤー ID。これは、リクエスト元のプレーヤーの Player.get が呼び出されたときにのみ、プレーヤー ID がその後変更され、プレーヤー ID の再マッピングをサポートしているクライアントにのみ入力されます。 |
profileSettings |
プレーヤーのプロフィール設定。プレーヤーのプロフィールを他のプレーヤーに表示するかどうかを制御します。 |
name |
プレーヤー名の個々のコンポーネントを表すオブジェクト。一部のプレーヤーでは、これらのフィールドが存在しない場合があります。 |
name.familyName |
このプレーヤーのファミリー名です。一部の地域では、これは姓と呼ばれています。 |
name.givenName |
このプレーヤーの名前。一部の地域では、これはファースト ネームと呼ばれています。 |
experienceInfo |
プレーヤーの Play ゲームのエクスペリエンス情報を表すオブジェクト。 |
title |
ゲーム アクティビティに対して報酬が与えられるプレーヤーのタイトル。 |
friendStatus |
リクエスト元に対する特定のプレーヤーの友だちステータス。プレーヤーがフレンドリストをゲームと共有していない場合は未設定です。 |
gamePlayerId |
アプリごとの一意のプレーヤー ID。 |
ProfileSettings
プロフィール設定
JSON 表現 |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
フィールド | |
---|---|
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
profileVisible |
現在ログインしているプレーヤーにプレーヤーのプロフィールを表示するかどうか。 |
friendsListVisibility |
|
FriendsListVisibility
プレーヤーのフレンドリストがこのゲームに表示されるかどうか、リクエストできるかどうかを指定します。このフィールドは、現在ログインしているプレーヤーに対してのみ入力されます。
列挙型 | |
---|---|
VISIBLE |
フレンドリストは現在、ゲームに表示されます。 |
REQUEST_REQUIRED |
デベロッパーは友だちリストへのアクセス権はありませんが、Android API を呼び出して同意ダイアログを表示することはできます。 |
UNAVAILABLE |
このユーザーは友達リストは現在利用できません。また、ユーザーが完全に辞退したか、友達機能が利用できないため、現時点ではアクセスをリクエストすることもできません。この状態では、友達リストへのアクセスをリクエストしようとしても失敗します。 |
PlayerExperienceInfo
プレーヤーのエクスペリエンスに関する 1P/3P メタデータ。
JSON 表現 |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
フィールド | |
---|---|
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
currentExperiencePoints |
プレーヤーの現在の経験値。 |
lastLevelUpTimestampMillis |
プレーヤーがレベルアップしたときのタイムスタンプ(Unix エポック UTC からのミリ秒数)。 |
currentLevel |
プレーヤーの現在のレベル。 |
nextLevel |
プレーヤーの次のレベル。現在のレベルが最大レベルである場合は、現在のレベルと同じにする必要があります。 |
PlayerLevel
ユーザーのレベルに関するファースト パーティ/サードパーティのメタデータ。
JSON 表現 |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
フィールド | |
---|---|
kind |
このリソースのタイプを一意に識別します。値は常に固定文字列 |
level |
ユーザーのレベル。 |
minExperiencePoints |
このレベルの最低経験値。 |
maxExperiencePoints |
このレベルの最大経験値。 |
FriendStatus
プレーヤー間の友人関係を定義します。
列挙型 | |
---|---|
NO_RELATIONSHIP |
プレーヤー間に関係はありません。 |
FRIEND |
プレーヤーとリクエストしたユーザーは友だちです。 |
メソッド |
|
---|---|
|
指定された ID のプレーヤー リソースを取得します。 |
|
呼び出し元のアプリと同じデベロッパーによってリクエストされたすべてのゲームで、現在認証されているプレーヤーのアプリケーション プレーヤー ID を取得します。 |
|
現在認証されているユーザーのスコープが設定されたプレーヤー ID を取得します。 |
|
現在認証されているユーザーのプレーヤーのコレクションを取得します。 |