Blame - docs/dyn/games_v1.rooms.html - platform/external/python/google-api-python-client

blob: 4e9052e0d205a3311db5605e52e7578b0f788867 [file] [log] [blame]

John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1	<html><body>
				2	<style>
				3
				4	body, h1, h2, h3, div, span, p, pre, a {
				5	margin: 0;
				6	padding: 0;
				7	border: 0;
				8	font-weight: inherit;
				9	font-style: inherit;
				10	font-size: 100%;
				11	font-family: inherit;
				12	vertical-align: baseline;
				13	}
				14
				15	body {
				16	font-size: 13px;
				17	padding: 1em;
				18	}
				19
				20	h1 {
				21	font-size: 26px;
				22	margin-bottom: 1em;
				23	}
				24
				25	h2 {
				26	font-size: 24px;
				27	margin-bottom: 1em;
				28	}
				29
				30	h3 {
				31	font-size: 20px;
				32	margin-bottom: 1em;
				33	margin-top: 1em;
				34	}
				35
				36	pre, code {
				37	line-height: 1.5;
				38	font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
				39	}
				40
				41	pre {
				42	margin-top: 0.5em;
				43	}
				44
				45	h1, h2, h3, p {
				46	font-family: Arial, sans serif;
				47	}
				48
				49	h1, h2, h3 {
				50	border-bottom: solid #CCC 1px;
				51	}
				52
				53	.toc_element {
				54	margin-top: 0.5em;
				55	}
				56
				57	.firstline {
				58	margin-left: 2 em;
				59	}
				60
				61	.method {
				62	margin-top: 1em;
				63	border: solid 1px #CCC;
				64	padding: 1em;
				65	background: #EEE;
				66	}
				67
				68	.details {
				69	font-weight: bold;
				70	font-size: 14px;
				71	}
				72
				73	</style>
				74
				75	<h1><a href="games_v1.html">Google Play Game Services API</a> . <a href="games_v1.rooms.html">rooms</a></h1>
				76	<h2>Instance Methods</h2>
				77	<p class="toc_element">
				78	<code><a href="#create">create(body, language=None)</a></code></p>
				79	<p class="firstline">Create a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				80	<p class="toc_element">
				81	<code><a href="#decline">decline(roomId, language=None)</a></code></p>
				82	<p class="firstline">Decline an invitation to join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				83	<p class="toc_element">
				84	<code><a href="#dismiss">dismiss(roomId)</a></code></p>
				85	<p class="firstline">Dismiss an invitation to join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				86	<p class="toc_element">
				87	<code><a href="#get">get(roomId, language=None)</a></code></p>
				88	<p class="firstline">Get the data for a room.</p>
				89	<p class="toc_element">
				90	<code><a href="#join">join(roomId, body, language=None)</a></code></p>
				91	<p class="firstline">Join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				92	<p class="toc_element">
				93	<code><a href="#leave">leave(roomId, body, language=None)</a></code></p>
				94	<p class="firstline">Leave a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				95	<p class="toc_element">
				96	<code><a href="#list">list(pageToken=None, language=None, maxResults=None)</a></code></p>
				97	<p class="firstline">Returns invitations to join rooms.</p>
				98	<p class="toc_element">
				99	<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
				100	<p class="firstline">Retrieves the next page of results.</p>
				101	<p class="toc_element">
				102	<code><a href="#reportStatus">reportStatus(roomId, body, language=None)</a></code></p>
				103	<p class="firstline">Updates sent by a client reporting the status of peers in a room. For internal use by the Games SDK only. Calling this method directly is unsupported.</p>
				104	<h3>Method Details</h3>
				105	<div class="method">
				106	<code class="details" id="create">create(body, language=None)</code>
				107	<pre>Create a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				108
				109	Args:
				110	body: object, The request body. (required)
				111	The object takes the form of:
				112
				113	{ # This is a JSON template for a room creation request.
				114	"kind": "games#roomCreateRequest", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomCreateRequest.
				115	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				116	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				117	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				118	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				119	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				120	},
				121	"invitedPlayerIds": [ # The player IDs to invite to the room.
				122	"A String",
				123	],
				124	"variant": 42, # The variant / mode of the application to be played. This can be any integer value, or left blank. You should use a small number of variants to keep the auto-matching pool as large as possible.
				125	"capabilities": [ # The capabilities that this client supports for realtime communication.
				126	"A String",
				127	],
				128	"networkDiagnostics": { # This is a JSON template for network diagnostics reported for a client. # Network diagnostics for the client creating the room.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	129	"kind": "games#networkDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#networkDiagnostics.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	130	"iosNetworkType": 42, # iOS network type as defined in Reachability.h.
				131	"networkOperatorCode": "A String", # The MCC+MNC code for the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperator() On iOS, see: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	132	"androidNetworkSubtype": 42, # The Android network subtype.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	133	"networkOperatorName": "A String", # The name of the carrier of the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperatorName() On iOS: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html#//apple_ref/occ/instp/CTCarrier/carrierName
				134	"registrationLatencyMillis": 42, # The amount of time in milliseconds it took for the client to establish a connection with the XMPP server.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	135	"androidNetworkType": 42, # The Android network type.
				136	},
				137	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the player creating the room.
				138	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				139	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				140	},
				141	"requestId": "A String", # A randomly generated numeric ID. This number is used at the server to ensure that the request is handled correctly across retries.
				142	}
				143
				144	language: string, The preferred language to use for strings returned by this method.
				145
				146	Returns:
				147	An object of the form:
				148
				149	{ # This is a JSON template for a room resource object.
				150	"status": "A String", # The status of the room.
				151	# Possible values are:
				152	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				153	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				154	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				155	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				156	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				157	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				158	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				159	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				160	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				161	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				162	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				163	},
				164	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				165	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				166	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				167	"participantId": "A String", # The ID of the participant that modified the room.
				168	},
				169	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				170	"roomId": "A String", # Globally unique ID for a room.
				171	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				172	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				173	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				174	},
				175	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				176	{ # This is a JSON template for a participant in a room.
				177	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				178	"status": "A String", # The status of the participant with respect to the room.
				179	# Possible values are:
				180	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				181	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				182	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				183	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				184	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				185	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				186	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				187	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				188	"displayName": "A String", # The name to display for the anonymous player.
				189	},
				190	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				191	# Possible values are:
				192	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				193	# - "GAME_LEFT" - The game chose to remove the player from the room.
				194	# - "ABANDONED" - The player switched to another application and abandoned the room.
				195	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				196	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				197	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				198	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				199	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				200	"A String",
				201	],
				202	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				203	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				204	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	205	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				206	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				207	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	208	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	209	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	210	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				211	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				212	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				213	},
				214	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	215	"title": "A String", # The player's title rewarded for their game activities.
				216	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				217	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				218	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				219	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				220	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				221	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				222	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				223	"minExperiencePoints": "A String", # The minimum experience points for this level.
				224	"level": 42, # The level for the user.
				225	},
				226	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				227	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				228	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				229	"minExperiencePoints": "A String", # The minimum experience points for this level.
				230	"level": 42, # The level for the user.
				231	},
				232	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	233	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				234	},
				235	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				236	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				237	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				238	},
				239	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				240	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				241	},
				242	],
				243	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				244	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				245	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				246	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				247	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				248	"participantId": "A String", # The ID of the participant that modified the room.
				249	},
				250	"applicationId": "A String", # The ID of the application being played.
				251	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				252	}</pre>
				253	</div>
				254
				255	<div class="method">
				256	<code class="details" id="decline">decline(roomId, language=None)</code>
				257	<pre>Decline an invitation to join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				258
				259	Args:
				260	roomId: string, The ID of the room. (required)
				261	language: string, The preferred language to use for strings returned by this method.
				262
				263	Returns:
				264	An object of the form:
				265
				266	{ # This is a JSON template for a room resource object.
				267	"status": "A String", # The status of the room.
				268	# Possible values are:
				269	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				270	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				271	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				272	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				273	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				274	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				275	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				276	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				277	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				278	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				279	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				280	},
				281	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				282	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				283	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				284	"participantId": "A String", # The ID of the participant that modified the room.
				285	},
				286	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				287	"roomId": "A String", # Globally unique ID for a room.
				288	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				289	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				290	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				291	},
				292	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				293	{ # This is a JSON template for a participant in a room.
				294	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				295	"status": "A String", # The status of the participant with respect to the room.
				296	# Possible values are:
				297	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				298	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				299	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				300	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				301	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				302	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				303	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				304	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				305	"displayName": "A String", # The name to display for the anonymous player.
				306	},
				307	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				308	# Possible values are:
				309	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				310	# - "GAME_LEFT" - The game chose to remove the player from the room.
				311	# - "ABANDONED" - The player switched to another application and abandoned the room.
				312	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				313	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				314	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				315	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				316	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				317	"A String",
				318	],
				319	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				320	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				321	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	322	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				323	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				324	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	325	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	326	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	327	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				328	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				329	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				330	},
				331	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	332	"title": "A String", # The player's title rewarded for their game activities.
				333	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				334	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				335	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				336	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				337	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				338	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				339	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				340	"minExperiencePoints": "A String", # The minimum experience points for this level.
				341	"level": 42, # The level for the user.
				342	},
				343	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				344	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				345	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				346	"minExperiencePoints": "A String", # The minimum experience points for this level.
				347	"level": 42, # The level for the user.
				348	},
				349	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	350	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				351	},
				352	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				353	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				354	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				355	},
				356	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				357	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				358	},
				359	],
				360	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				361	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				362	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				363	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				364	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				365	"participantId": "A String", # The ID of the participant that modified the room.
				366	},
				367	"applicationId": "A String", # The ID of the application being played.
				368	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				369	}</pre>
				370	</div>
				371
				372	<div class="method">
				373	<code class="details" id="dismiss">dismiss(roomId)</code>
				374	<pre>Dismiss an invitation to join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				375
				376	Args:
				377	roomId: string, The ID of the room. (required)
				378	</pre>
				379	</div>
				380
				381	<div class="method">
				382	<code class="details" id="get">get(roomId, language=None)</code>
				383	<pre>Get the data for a room.
				384
				385	Args:
				386	roomId: string, The ID of the room. (required)
				387	language: string, The preferred language to use for strings returned by this method.
				388
				389	Returns:
				390	An object of the form:
				391
				392	{ # This is a JSON template for a room resource object.
				393	"status": "A String", # The status of the room.
				394	# Possible values are:
				395	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				396	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				397	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				398	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				399	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				400	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				401	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				402	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				403	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				404	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				405	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				406	},
				407	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				408	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				409	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				410	"participantId": "A String", # The ID of the participant that modified the room.
				411	},
				412	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				413	"roomId": "A String", # Globally unique ID for a room.
				414	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				415	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				416	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				417	},
				418	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				419	{ # This is a JSON template for a participant in a room.
				420	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				421	"status": "A String", # The status of the participant with respect to the room.
				422	# Possible values are:
				423	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				424	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				425	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				426	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				427	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				428	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				429	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				430	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				431	"displayName": "A String", # The name to display for the anonymous player.
				432	},
				433	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				434	# Possible values are:
				435	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				436	# - "GAME_LEFT" - The game chose to remove the player from the room.
				437	# - "ABANDONED" - The player switched to another application and abandoned the room.
				438	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				439	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				440	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				441	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				442	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				443	"A String",
				444	],
				445	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				446	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				447	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	448	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				449	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				450	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	451	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	452	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	453	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				454	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				455	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				456	},
				457	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	458	"title": "A String", # The player's title rewarded for their game activities.
				459	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				460	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				461	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				462	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				463	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				464	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				465	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				466	"minExperiencePoints": "A String", # The minimum experience points for this level.
				467	"level": 42, # The level for the user.
				468	},
				469	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				470	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				471	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				472	"minExperiencePoints": "A String", # The minimum experience points for this level.
				473	"level": 42, # The level for the user.
				474	},
				475	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	476	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				477	},
				478	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				479	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				480	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				481	},
				482	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				483	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				484	},
				485	],
				486	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				487	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				488	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				489	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				490	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				491	"participantId": "A String", # The ID of the participant that modified the room.
				492	},
				493	"applicationId": "A String", # The ID of the application being played.
				494	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				495	}</pre>
				496	</div>
				497
				498	<div class="method">
				499	<code class="details" id="join">join(roomId, body, language=None)</code>
				500	<pre>Join a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				501
				502	Args:
				503	roomId: string, The ID of the room. (required)
				504	body: object, The request body. (required)
				505	The object takes the form of:
				506
				507	{ # This is a JSON template for a join room request.
				508	"networkDiagnostics": { # This is a JSON template for network diagnostics reported for a client. # Network diagnostics for the client joining the room.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	509	"kind": "games#networkDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#networkDiagnostics.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	510	"iosNetworkType": 42, # iOS network type as defined in Reachability.h.
				511	"networkOperatorCode": "A String", # The MCC+MNC code for the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperator() On iOS, see: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	512	"androidNetworkSubtype": 42, # The Android network subtype.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	513	"networkOperatorName": "A String", # The name of the carrier of the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperatorName() On iOS: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html#//apple_ref/occ/instp/CTCarrier/carrierName
				514	"registrationLatencyMillis": 42, # The amount of time in milliseconds it took for the client to establish a connection with the XMPP server.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	515	"androidNetworkType": 42, # The Android network type.
				516	},
				517	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the player joining the room.
				518	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				519	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				520	},
				521	"kind": "games#roomJoinRequest", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomJoinRequest.
				522	"capabilities": [ # The capabilities that this client supports for realtime communication.
				523	"A String",
				524	],
				525	}
				526
				527	language: string, The preferred language to use for strings returned by this method.
				528
				529	Returns:
				530	An object of the form:
				531
				532	{ # This is a JSON template for a room resource object.
				533	"status": "A String", # The status of the room.
				534	# Possible values are:
				535	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				536	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				537	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				538	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				539	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				540	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				541	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				542	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				543	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				544	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				545	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				546	},
				547	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				548	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				549	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				550	"participantId": "A String", # The ID of the participant that modified the room.
				551	},
				552	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				553	"roomId": "A String", # Globally unique ID for a room.
				554	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				555	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				556	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				557	},
				558	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				559	{ # This is a JSON template for a participant in a room.
				560	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				561	"status": "A String", # The status of the participant with respect to the room.
				562	# Possible values are:
				563	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				564	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				565	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				566	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				567	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				568	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				569	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				570	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				571	"displayName": "A String", # The name to display for the anonymous player.
				572	},
				573	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				574	# Possible values are:
				575	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				576	# - "GAME_LEFT" - The game chose to remove the player from the room.
				577	# - "ABANDONED" - The player switched to another application and abandoned the room.
				578	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				579	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				580	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				581	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				582	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				583	"A String",
				584	],
				585	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				586	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				587	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	588	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				589	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				590	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	591	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	592	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	593	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				594	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				595	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				596	},
				597	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	598	"title": "A String", # The player's title rewarded for their game activities.
				599	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				600	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				601	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				602	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				603	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				604	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				605	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				606	"minExperiencePoints": "A String", # The minimum experience points for this level.
				607	"level": 42, # The level for the user.
				608	},
				609	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				610	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				611	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				612	"minExperiencePoints": "A String", # The minimum experience points for this level.
				613	"level": 42, # The level for the user.
				614	},
				615	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	616	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				617	},
				618	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				619	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				620	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				621	},
				622	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				623	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				624	},
				625	],
				626	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				627	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				628	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				629	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				630	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				631	"participantId": "A String", # The ID of the participant that modified the room.
				632	},
				633	"applicationId": "A String", # The ID of the application being played.
				634	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				635	}</pre>
				636	</div>
				637
				638	<div class="method">
				639	<code class="details" id="leave">leave(roomId, body, language=None)</code>
				640	<pre>Leave a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				641
				642	Args:
				643	roomId: string, The ID of the room. (required)
				644	body: object, The request body. (required)
				645	The object takes the form of:
				646
				647	{ # This is a JSON template for a leave room request.
				648	"kind": "games#roomLeaveRequest", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomLeaveRequest.
				649	"reason": "A String", # Reason for leaving the match.
				650	# Possible values are:
				651	# - "PLAYER_LEFT" - The player chose to leave the room..
				652	# - "GAME_LEFT" - The game chose to remove the player from the room.
				653	# - "REALTIME_ABANDONED" - The player switched to another application and abandoned the room.
				654	# - "REALTIME_PEER_CONNECTION_FAILURE" - The client was unable to establish a connection to other peer(s).
				655	# - "REALTIME_SERVER_CONNECTION_FAILURE" - The client was unable to communicate with the server.
				656	# - "REALTIME_SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				657	# - "REALTIME_TIMEOUT" - The client timed out while waiting for a room.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	658	# - "REALTIME_CLIENT_DISCONNECTING" - The client disconnects without first calling Leave.
				659	# - "REALTIME_SIGN_OUT" - The user signed out of G+ while in the room.
				660	# - "REALTIME_GAME_CRASHED" - The game crashed.
				661	# - "REALTIME_ROOM_SERVICE_CRASHED" - RoomAndroidService crashed.
				662	# - "REALTIME_DIFFERENT_CLIENT_ROOM_OPERATION" - Another client is trying to enter a room.
				663	# - "REALTIME_SAME_CLIENT_ROOM_OPERATION" - The same client is trying to enter a new room.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	664	"leaveDiagnostics": { # This is a JSON template for room leave diagnostics. # Diagnostics for a player leaving the room.
				665	"kind": "games#roomLeaveDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomLeaveDiagnostics.
				666	"socketsUsed": True or False, # Whether or not sockets were used.
				667	"iosNetworkType": 42, # iOS network type as defined in Reachability.h.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	668	"networkOperatorCode": "A String", # The MCC+MNC code for the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperator() On iOS, see: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	669	"peerSession": [ # Diagnostics about all peer sessions.
				670	{ # This is a JSON template for peer session diagnostics.
				671	"unreliableChannel": { # This is a JSON template for peer channel diagnostics. # Unreliable channel diagnostics.
				672	"bytesReceived": { # This is a JSON template for aggregate stats. # Number of bytes received.
				673	"count": "A String", # The number of messages sent between a pair of peers.
				674	"max": "A String", # The maximum amount.
				675	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				676	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				677	"min": "A String", # The minimum amount.
				678	},
				679	"kind": "games#peerChannelDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#peerChannelDiagnostics.
				680	"bytesSent": { # This is a JSON template for aggregate stats. # Number of bytes sent.
				681	"count": "A String", # The number of messages sent between a pair of peers.
				682	"max": "A String", # The maximum amount.
				683	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				684	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				685	"min": "A String", # The minimum amount.
				686	},
				687	"numSendFailures": 42, # Number of send failures.
				688	"numMessagesLost": 42, # Number of messages lost.
				689	"numMessagesReceived": 42, # Number of messages received.
				690	"numMessagesSent": 42, # Number of messages sent.
				691	"roundtripLatencyMillis": { # This is a JSON template for aggregate stats. # Roundtrip latency stats in milliseconds.
				692	"count": "A String", # The number of messages sent between a pair of peers.
				693	"max": "A String", # The maximum amount.
				694	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				695	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				696	"min": "A String", # The minimum amount.
				697	},
				698	},
				699	"kind": "games#peerSessionDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#peerSessionDiagnostics.
				700	"reliableChannel": { # This is a JSON template for peer channel diagnostics. # Reliable channel diagnostics.
				701	"bytesReceived": { # This is a JSON template for aggregate stats. # Number of bytes received.
				702	"count": "A String", # The number of messages sent between a pair of peers.
				703	"max": "A String", # The maximum amount.
				704	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				705	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				706	"min": "A String", # The minimum amount.
				707	},
				708	"kind": "games#peerChannelDiagnostics", # Uniquely identifies the type of this resource. Value is always the fixed string games#peerChannelDiagnostics.
				709	"bytesSent": { # This is a JSON template for aggregate stats. # Number of bytes sent.
				710	"count": "A String", # The number of messages sent between a pair of peers.
				711	"max": "A String", # The maximum amount.
				712	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				713	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				714	"min": "A String", # The minimum amount.
				715	},
				716	"numSendFailures": 42, # Number of send failures.
				717	"numMessagesLost": 42, # Number of messages lost.
				718	"numMessagesReceived": 42, # Number of messages received.
				719	"numMessagesSent": 42, # Number of messages sent.
				720	"roundtripLatencyMillis": { # This is a JSON template for aggregate stats. # Roundtrip latency stats in milliseconds.
				721	"count": "A String", # The number of messages sent between a pair of peers.
				722	"max": "A String", # The maximum amount.
				723	"kind": "games#aggregateStats", # Uniquely identifies the type of this resource. Value is always the fixed string games#aggregateStats.
				724	"sum": "A String", # The total number of bytes sent for messages between a pair of peers.
				725	"min": "A String", # The minimum amount.
				726	},
				727	},
				728	"connectedTimestampMillis": "A String", # Connected time in milliseconds.
				729	"participantId": "A String", # The participant ID of the peer.
				730	},
				731	],
				732	"androidNetworkSubtype": 42, # Android network subtype. http://developer.android.com/reference/android/net/NetworkInfo.html#getSubtype()
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	733	"networkOperatorName": "A String", # The name of the carrier of the client's network connection. On Android: http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperatorName() On iOS: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html#//apple_ref/occ/instp/CTCarrier/carrierName
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	734	"androidNetworkType": 42, # Android network type. http://developer.android.com/reference/android/net/NetworkInfo.html#getType()
				735	},
				736	}
				737
				738	language: string, The preferred language to use for strings returned by this method.
				739
				740	Returns:
				741	An object of the form:
				742
				743	{ # This is a JSON template for a room resource object.
				744	"status": "A String", # The status of the room.
				745	# Possible values are:
				746	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				747	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				748	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				749	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				750	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				751	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				752	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				753	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				754	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				755	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				756	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				757	},
				758	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				759	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				760	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				761	"participantId": "A String", # The ID of the participant that modified the room.
				762	},
				763	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				764	"roomId": "A String", # Globally unique ID for a room.
				765	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				766	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				767	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				768	},
				769	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				770	{ # This is a JSON template for a participant in a room.
				771	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				772	"status": "A String", # The status of the participant with respect to the room.
				773	# Possible values are:
				774	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				775	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				776	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				777	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				778	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				779	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				780	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				781	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				782	"displayName": "A String", # The name to display for the anonymous player.
				783	},
				784	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				785	# Possible values are:
				786	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				787	# - "GAME_LEFT" - The game chose to remove the player from the room.
				788	# - "ABANDONED" - The player switched to another application and abandoned the room.
				789	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				790	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				791	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				792	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				793	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				794	"A String",
				795	],
				796	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				797	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				798	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	799	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				800	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				801	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	802	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	803	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	804	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				805	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				806	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				807	},
				808	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	809	"title": "A String", # The player's title rewarded for their game activities.
				810	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				811	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				812	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				813	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				814	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				815	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				816	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				817	"minExperiencePoints": "A String", # The minimum experience points for this level.
				818	"level": 42, # The level for the user.
				819	},
				820	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				821	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				822	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				823	"minExperiencePoints": "A String", # The minimum experience points for this level.
				824	"level": 42, # The level for the user.
				825	},
				826	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	827	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				828	},
				829	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				830	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				831	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				832	},
				833	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				834	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				835	},
				836	],
				837	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				838	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				839	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				840	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				841	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				842	"participantId": "A String", # The ID of the participant that modified the room.
				843	},
				844	"applicationId": "A String", # The ID of the application being played.
				845	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				846	}</pre>
				847	</div>
				848
				849	<div class="method">
				850	<code class="details" id="list">list(pageToken=None, language=None, maxResults=None)</code>
				851	<pre>Returns invitations to join rooms.
				852
				853	Args:
				854	pageToken: string, The token returned by the previous request.
				855	language: string, The preferred language to use for strings returned by this method.
				856	maxResults: integer, The maximum number of rooms to return in the response, used for paging. For any response, the actual number of rooms to return may be less than the specified maxResults.
				857
				858	Returns:
				859	An object of the form:
				860
				861	{ # This is a JSON template for a list of rooms.
				862	"nextPageToken": "A String", # The pagination token for the next page of results.
				863	"items": [ # The rooms.
				864	{ # This is a JSON template for a room resource object.
				865	"status": "A String", # The status of the room.
				866	# Possible values are:
				867	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				868	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				869	# - "ROOM_CONNECTING" - Players have joined and are connecting to each other (either before or after auto-matching).
				870	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				871	# - "ROOM_DELETED" - The room should no longer be shown on the client. Returned in sync calls when a player joins a room (as a tombstone), or for rooms where all joined participants have left.
				872	"kind": "games#room", # Uniquely identifies the type of this resource. Value is always the fixed string games#room.
				873	"autoMatchingCriteria": { # This is a JSON template for a room auto-match criteria object. # Criteria for auto-matching players into this room.
				874	"kind": "games#roomAutoMatchingCriteria", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchingCriteria.
				875	"minAutoMatchingPlayers": 42, # The minimum number of players that should be added to the room by auto-matching.
				876	"exclusiveBitmask": "A String", # A bitmask indicating when auto-matches are valid. When ANDed with other exclusive bitmasks, the result must be zero. Can be used to support exclusive roles within a game.
				877	"maxAutoMatchingPlayers": 42, # The maximum number of players that should be added to the room by auto-matching.
				878	},
				879	"creationDetails": { # This is a JSON template for room modification metadata. # Details about the room creation.
				880	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				881	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				882	"participantId": "A String", # The ID of the participant that modified the room.
				883	},
				884	"description": "A String", # This short description is generated by our servers and worded relative to the player requesting the room. It is intended to be displayed when the room is shown in a list (that is, an invitation to a room.)
				885	"roomId": "A String", # Globally unique ID for a room.
				886	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the auto-matching queue.
				887	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				888	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				889	},
				890	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				891	{ # This is a JSON template for a participant in a room.
				892	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				893	"status": "A String", # The status of the participant with respect to the room.
				894	# Possible values are:
				895	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				896	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				897	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				898	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				899	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				900	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				901	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				902	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				903	"displayName": "A String", # The name to display for the anonymous player.
				904	},
				905	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				906	# Possible values are:
				907	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				908	# - "GAME_LEFT" - The game chose to remove the player from the room.
				909	# - "ABANDONED" - The player switched to another application and abandoned the room.
				910	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				911	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				912	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				913	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				914	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				915	"A String",
				916	],
				917	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				918	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				919	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	920	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				921	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				922	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	923	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	924	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	925	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				926	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				927	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				928	},
				929	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	930	"title": "A String", # The player's title rewarded for their game activities.
				931	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				932	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				933	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				934	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				935	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				936	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				937	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				938	"minExperiencePoints": "A String", # The minimum experience points for this level.
				939	"level": 42, # The level for the user.
				940	},
				941	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				942	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				943	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				944	"minExperiencePoints": "A String", # The minimum experience points for this level.
				945	"level": 42, # The level for the user.
				946	},
				947	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	948	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				949	},
				950	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				951	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				952	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				953	},
				954	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				955	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				956	},
				957	],
				958	"roomStatusVersion": 42, # The version of the room status: an increasing counter, used by the client to ignore out-of-order updates to room status.
				959	"variant": 42, # The variant / mode of the application being played; can be any integer value, or left blank.
				960	"lastUpdateDetails": { # This is a JSON template for room modification metadata. # Details about the last update to the room.
				961	"kind": "games#roomModification", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomModification.
				962	"modifiedTimestampMillis": "A String", # The timestamp at which they modified the room, in milliseconds since the epoch in UTC.
				963	"participantId": "A String", # The ID of the participant that modified the room.
				964	},
				965	"applicationId": "A String", # The ID of the application being played.
				966	"inviterId": "A String", # The ID of the participant that invited the user to the room. Not set if the user was not invited to the room.
				967	},
				968	],
				969	"kind": "games#roomList", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomList.
				970	}</pre>
				971	</div>
				972
				973	<div class="method">
				974	<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
				975	<pre>Retrieves the next page of results.
				976
				977	Args:
				978	previous_request: The request for the previous page. (required)
				979	previous_response: The response from the request for the previous page. (required)
				980
				981	Returns:
				982	A request object that you can call 'execute()' on to request the next
				983	page. Returns None if there are no more items in the collection.
				984	</pre>
				985	</div>
				986
				987	<div class="method">
				988	<code class="details" id="reportStatus">reportStatus(roomId, body, language=None)</code>
				989	<pre>Updates sent by a client reporting the status of peers in a room. For internal use by the Games SDK only. Calling this method directly is unsupported.
				990
				991	Args:
				992	roomId: string, The ID of the room. (required)
				993	body: object, The request body. (required)
				994	The object takes the form of:
				995
				996	{ # This is a JSON template for an update on the status of peers in a room.
				997	"kind": "games#roomP2PStatuses", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomP2PStatuses.
				998	"updates": [ # The updates for the peers.
				999	{ # This is a JSON template for an update on the status of a peer in a room.
				1000	"status": "A String", # The status of the peer in the room.
				1001	# Possible values are:
				1002	# - "CONNECTION_ESTABLISHED" - The client established a P2P connection with the peer.
				1003	# - "CONNECTION_FAILED" - The client failed to establish directed presence with the peer.
				1004	"kind": "games#roomP2PStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomP2PStatus.
				1005	"participantId": "A String", # The ID of the participant.
				1006	"unreliableRoundtripLatencyMillis": 42, # The amount of time in milliseconds it took to send packets back and forth on the unreliable channel with this peer.
				1007	"connectionSetupLatencyMillis": 42, # The amount of time in milliseconds it took to establish connections with this peer.
				1008	"error": "A String", # The error code in event of a failure.
				1009	# Possible values are:
				1010	# - "P2P_FAILED" - The client failed to establish a P2P connection with the peer.
				1011	# - "PRESENCE_FAILED" - The client failed to register to receive P2P connections.
				1012	# - "RELAY_SERVER_FAILED" - The client received an error when trying to use the relay server to establish a P2P connection with the peer.
				1013	"error_reason": "A String", # More detailed diagnostic message returned in event of a failure.
				1014	},
				1015	],
				1016	}
				1017
				1018	language: string, The preferred language to use for strings returned by this method.
				1019
				1020	Returns:
				1021	An object of the form:
				1022
				1023	{ # This is a JSON template for the status of a room that the player has joined.
				1024	"status": "A String", # The status of the room.
				1025	# Possible values are:
				1026	# - "ROOM_INVITING" - One or more players have been invited and not responded.
				1027	# - "ROOM_AUTO_MATCHING" - One or more slots need to be filled by auto-matching.
				1028	# - "ROOM_CONNECTING" - Players have joined are connecting to each other (either before or after auto-matching).
				1029	# - "ROOM_ACTIVE" - All players have joined and connected to each other.
				1030	# - "ROOM_DELETED" - All joined players have left.
				1031	"kind": "games#roomStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomStatus.
				1032	"autoMatchingStatus": { # This is a JSON template for status of room automatching that is in progress. # Auto-matching status for this room. Not set if the room is not currently in the automatching queue.
				1033	"kind": "games#roomAutoMatchStatus", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomAutoMatchStatus.
				1034	"waitEstimateSeconds": 42, # An estimate for the amount of time (in seconds) that auto-matching is expected to take to complete.
				1035	},
				1036	"participants": [ # The participants involved in the room, along with their statuses. Includes participants who have left or declined invitations.
				1037	{ # This is a JSON template for a participant in a room.
				1038	"autoMatched": True or False, # True if this participant was auto-matched with the requesting player.
				1039	"status": "A String", # The status of the participant with respect to the room.
				1040	# Possible values are:
				1041	# - "PARTICIPANT_INVITED" - The participant has been invited to join the room, but has not yet responded.
				1042	# - "PARTICIPANT_JOINED" - The participant has joined the room (either after creating it or accepting an invitation.)
				1043	# - "PARTICIPANT_DECLINED" - The participant declined an invitation to join the room.
				1044	# - "PARTICIPANT_LEFT" - The participant joined the room and then left it.
				1045	"kind": "games#roomParticipant", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomParticipant.
				1046	"autoMatchedPlayer": { # This is a JSON template for an anonymous player # Information about a player that has been anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				1047	"kind": "games#anonymousPlayer", # Uniquely identifies the type of this resource. Value is always the fixed string games#anonymousPlayer.
				1048	"avatarImageUrl": "A String", # The base URL for the image to display for the anonymous player.
				1049	"displayName": "A String", # The name to display for the anonymous player.
				1050	},
				1051	"leaveReason": "A String", # The reason the participant left the room; populated if the participant status is PARTICIPANT_LEFT.
				1052	# Possible values are:
				1053	# - "PLAYER_LEFT" - The player explicitly chose to leave the room.
				1054	# - "GAME_LEFT" - The game chose to remove the player from the room.
				1055	# - "ABANDONED" - The player switched to another application and abandoned the room.
				1056	# - "PEER_CONNECTION_FAILURE" - The client was unable to establish or maintain a connection to other peer(s) in the room.
				1057	# - "SERVER_ERROR" - The client received an error response when it tried to communicate with the server.
				1058	# - "TIMEOUT" - The client timed out while waiting for players to join and connect.
				1059	# - "PRESENCE_FAILURE" - The client's XMPP connection ended abruptly.
				1060	"capabilities": [ # The capabilities which can be used when communicating with this participant.
				1061	"A String",
				1062	],
				1063	"player": { # This is a JSON template for a Player resource. # Information about the player. Not populated if this player was anonymously auto-matched against the requesting player. (Either player or autoMatchedPlayer will be set.)
				1064	"kind": "games#player", # Uniquely identifies the type of this resource. Value is always the fixed string games#player.
				1065	"displayName": "A String", # The name to display for the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	1066	"name": { # An object representation of the individual components of the player's name. For some players, these fields may not be present.
				1067	"givenName": "A String", # The given name of this player. In some places, this is known as the first name.
				1068	"familyName": "A String", # The family name of this player. In some places, this is known as the last name.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1069	},
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	1070	"lastPlayedWith": { # This is a JSON template for metadata about a player playing a game with the currently authenticated user. # Details about the last time this player played a multiplayer game with the currently authenticated player. Populated for PLAYED_WITH player collection members.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1071	"autoMatched": True or False, # True if the player was auto-matched with the currently authenticated user.
				1072	"kind": "games#played", # Uniquely identifies the type of this resource. Value is always the fixed string games#played.
				1073	"timeMillis": "A String", # The last time the player played the game in milliseconds since the epoch in UTC.
				1074	},
				1075	"playerId": "A String", # The ID of the player.
Craig Citro	065b530	2014-08-14 00:47:23 -0700	[diff] [blame^]	1076	"title": "A String", # The player's title rewarded for their game activities.
				1077	"experienceInfo": { # This is a JSON template for 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player.
				1078	"lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
				1079	"currentExperiencePoints": "A String", # The current number of experience points for the player.
				1080	"kind": "games#playerExperienceInfo", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerExperienceInfo.
				1081	"currentLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The current level of the player.
				1082	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				1083	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				1084	"minExperiencePoints": "A String", # The minimum experience points for this level.
				1085	"level": 42, # The level for the user.
				1086	},
				1087	"nextLevel": { # This is a JSON template for 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
				1088	"maxExperiencePoints": "A String", # The maximum experience points for this level.
				1089	"kind": "games#playerLevel", # Uniquely identifies the type of this resource. Value is always the fixed string games#playerLevel.
				1090	"minExperiencePoints": "A String", # The minimum experience points for this level.
				1091	"level": 42, # The level for the user.
				1092	},
				1093	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1094	"avatarImageUrl": "A String", # The base URL for the image that represents the player.
				1095	},
				1096	"clientAddress": { # This is a JSON template for the client address when setting up a room. # Client address for the participant.
				1097	"kind": "games#roomClientAddress", # Uniquely identifies the type of this resource. Value is always the fixed string games#roomClientAddress.
				1098	"xmppAddress": "A String", # The XMPP address of the client on the Google Games XMPP network.
				1099	},
				1100	"connected": True or False, # True if this participant is in the fully connected set of peers in the room.
				1101	"id": "A String", # An identifier for the participant in the scope of the room. Cannot be used to identify a player across rooms or in other contexts.
				1102	},
				1103	],
				1104	"statusVersion": 42, # The version of the status for the room: an increasing counter, used by the client to ignore out-of-order updates to room status.
				1105	"roomId": "A String", # Globally unique ID for a room.
				1106	}</pre>
				1107	</div>
				1108
				1109	</body></html>