Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / c4dca35925951a5b3c35314209b10337eaa516ee / . / docs / dyn / identitytoolkit_v3.relyingparty.html
blob: 678cdcafe2609a7390ddc1debc84c825b991f804 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]1<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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="identitytoolkit_v3.html">Google Identity Toolkit API</a> . <a href="identitytoolkit_v3.relyingparty.html">relyingparty</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#createAuthUri">createAuthUri(body)</a></code></p>
79<p class="firstline">Creates the URI used by the IdP to authenticate the user.</p>
80<p class="toc_element">
81 <code><a href="#deleteAccount">deleteAccount(body)</a></code></p>
82<p class="firstline">Delete user account.</p>
83<p class="toc_element">
84 <code><a href="#downloadAccount">downloadAccount(body)</a></code></p>
85<p class="firstline">Batch download user accounts.</p>
86<p class="toc_element">
87 <code><a href="#getAccountInfo">getAccountInfo(body)</a></code></p>
88<p class="firstline">Returns the account info.</p>
89<p class="toc_element">
90 <code><a href="#getOobConfirmationCode">getOobConfirmationCode(body)</a></code></p>
91<p class="firstline">Get a code for user action confirmation.</p>
92<p class="toc_element">
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]93 <code><a href="#getProjectConfig">getProjectConfig(delegatedProjectNumber=None, projectNumber=None)</a></code></p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]94<p class="firstline">Get project configuration.</p>
95<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]96 <code><a href="#getPublicKeys">getPublicKeys()</a></code></p>
97<p class="firstline">Get token signing public key.</p>
98<p class="toc_element">
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]99 <code><a href="#getRecaptchaParam">getRecaptchaParam()</a></code></p>
100<p class="firstline">Get recaptcha secure param.</p>
101<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]102 <code><a href="#resetPassword">resetPassword(body)</a></code></p>
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]103<p class="firstline">Reset password for a user.</p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]104<p class="toc_element">
105 <code><a href="#setAccountInfo">setAccountInfo(body)</a></code></p>
106<p class="firstline">Set account info for a user.</p>
107<p class="toc_element">
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]108 <code><a href="#setProjectConfig">setProjectConfig(body)</a></code></p>
109<p class="firstline">Set project configuration.</p>
110<p class="toc_element">
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]111 <code><a href="#signOutUser">signOutUser(body)</a></code></p>
112<p class="firstline">Sign out user.</p>
113<p class="toc_element">
114 <code><a href="#signupNewUser">signupNewUser(body)</a></code></p>
115<p class="firstline">Signup new user.</p>
116<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]117 <code><a href="#uploadAccount">uploadAccount(body)</a></code></p>
118<p class="firstline">Batch upload existing user accounts.</p>
119<p class="toc_element">
120 <code><a href="#verifyAssertion">verifyAssertion(body)</a></code></p>
121<p class="firstline">Verifies the assertion returned by the IdP.</p>
122<p class="toc_element">
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]123 <code><a href="#verifyCustomToken">verifyCustomToken(body)</a></code></p>
124<p class="firstline">Verifies the developer asserted ID token.</p>
125<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]126 <code><a href="#verifyPassword">verifyPassword(body)</a></code></p>
127<p class="firstline">Verifies the user entered password.</p>
128<h3>Method Details</h3>
129<div class="method">
130 <code class="details" id="createAuthUri">createAuthUri(body)</code>
131 <pre>Creates the URI used by the IdP to authenticate the user.
132
133Args:
134 body: object, The request body. (required)
135 The object takes the form of:
136
137{ # Request to get the IDP authentication URL.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]138 "sessionId": "A String", # The session_id passed by client.
139 "hostedDomain": "A String", # The hosted domain to restrict sign-in to accounts at that domain for Google Apps hosted accounts.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]140 "openidRealm": "A String", # Optional realm for OpenID protocol. The sub string "scheme://domain:port" of the param "continueUri" is used if this is not set.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]141 "oauthConsumerKey": "A String", # The developer's consumer key for OpenId OAuth Extension
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]142 "clientId": "A String", # The relying party OAuth client ID.
143 "oauthScope": "A String", # Additional oauth scopes, beyond the basid user profile, that the user would be prompted to grant
144 "otaApp": "A String", # The native app package for OTA installation.
145 "authFlowType": "A String", # Explicitly specify the auth flow type. Currently only support "CODE_FLOW" type. The field is only used for Google provider.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]146 "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name e.g. google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
147 "context": "A String", # The opaque value used by the client to maintain context info between the authentication request and the IDP callback.
148 "appId": "A String", # The app ID of the mobile app, base64(CERT_SHA1):PACKAGE_NAME for Android, BUNDLE_ID for iOS.
149 "continueUri": "A String", # The URI to which the IDP redirects the user after the federated login flow.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]150 "identifier": "A String", # The email or federated ID of the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]151 }
152
153
154Returns:
155 An object of the form:
156
157 { # Response of creating the IDP authentication URL.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]158 "sessionId": "A String", # Session ID which should be passed in the following verifyAssertion request.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]159 "kind": "identitytoolkit#CreateAuthUriResponse", # The fixed string identitytoolkit#CreateAuthUriResponse".
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]160 "captchaRequired": True or False, # True if captcha is required.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]161 "registered": True or False, # Whether the user is registered if the identifier is an email.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]162 "allProviders": [ # all providers the user has once used to do federated login
163 "A String",
164 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]165 "forExistingProvider": True or False, # True if the authUri is for user's existing provider.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]166 "providerId": "A String", # The provider ID of the auth URI.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]167 "authUri": "A String", # The URI used by the IDP to authenticate the user.
168 }</pre>
169</div>
170
171<div class="method">
172 <code class="details" id="deleteAccount">deleteAccount(body)</code>
173 <pre>Delete user account.
174
175Args:
176 body: object, The request body. (required)
177 The object takes the form of:
178
179{ # Request to delete account.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]180 "idToken": "A String", # The GITKit token or STS id token of the authenticated user.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]181 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]182 "localId": "A String", # The local ID of the user.
183 }
184
185
186Returns:
187 An object of the form:
188
189 { # Respone of deleting account.
190 "kind": "identitytoolkit#DeleteAccountResponse", # The fixed string "identitytoolkit#DeleteAccountResponse".
191 }</pre>
192</div>
193
194<div class="method">
195 <code class="details" id="downloadAccount">downloadAccount(body)</code>
196 <pre>Batch download user accounts.
197
198Args:
199 body: object, The request body. (required)
200 The object takes the form of:
201
202{ # Request to download user account in batch.
203 "nextPageToken": "A String", # The token for the next page. This should be taken from the previous response.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]204 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]205 "maxResults": 42, # The max number of results to return in the response.
206 }
207
208
209Returns:
210 An object of the form:
211
212 { # Respone of downloading accounts in batch.
213 "nextPageToken": "A String", # The next page token. To be used in a subsequent request to return the next page of results.
214 "kind": "identitytoolkit#DownloadAccountResponse", # The fixed string "identitytoolkit#DownloadAccountResponse".
215 "users": [ # The user accounts data.
216 { # Template for an individual account info.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]217 "passwordHash": "A String", # The user's hashed password.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]218 "displayName": "A String", # The name of the user.
219 "localId": "A String", # The local ID of the user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]220 "validSince": "A String", # Timestamp in seconds for valid login token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]221 "photoUrl": "A String", # The URL of the user profile photo.
222 "emailVerified": True or False, # Whether the email has been verified.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]223 "lastLoginAt": "A String", # last login timestamp.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]224 "disabled": True or False, # Whether the user is disabled.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]225 "version": 42, # Version of the user's password.
226 "providerUserInfo": [ # The IDP of the user.
227 {
228 "federatedId": "A String", # User's identifier at IDP.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]229 "displayName": "A String", # The user's display name at the IDP.
230 "photoUrl": "A String", # The user's photo url at the IDP.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]231 "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
232 "rawId": "A String", # User's raw identifier directly returned from IDP.
233 "email": "A String", # User's email at IDP.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]234 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]235 },
236 ],
237 "passwordUpdatedAt": 3.14, # The timestamp when the password was last updated.
238 "salt": "A String", # The user's password salt.
239 "email": "A String", # The email of the user.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]240 "createdAt": "A String", # User creation timestamp.
241 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]242 },
243 ],
244 }</pre>
245</div>
246
247<div class="method">
248 <code class="details" id="getAccountInfo">getAccountInfo(body)</code>
249 <pre>Returns the account info.
250
251Args:
252 body: object, The request body. (required)
253 The object takes the form of:
254
255{ # Request to get the account information.
256 "idToken": "A String", # The GITKit token of the authenticated user.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]257 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]258 "email": [ # The list of emails of the users to inquiry.
259 "A String",
260 ],
261 "localId": [ # The list of local ID's of the users to inquiry.
262 "A String",
263 ],
264 }
265
266
267Returns:
268 An object of the form:
269
270 { # Response of getting account information.
271 "kind": "identitytoolkit#GetAccountInfoResponse", # The fixed string "identitytoolkit#GetAccountInfoResponse".
272 "users": [ # The info of the users.
273 { # Template for an individual account info.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]274 "passwordHash": "A String", # The user's hashed password.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]275 "displayName": "A String", # The name of the user.
276 "localId": "A String", # The local ID of the user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]277 "validSince": "A String", # Timestamp in seconds for valid login token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]278 "photoUrl": "A String", # The URL of the user profile photo.
279 "emailVerified": True or False, # Whether the email has been verified.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]280 "lastLoginAt": "A String", # last login timestamp.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]281 "disabled": True or False, # Whether the user is disabled.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]282 "version": 42, # Version of the user's password.
283 "providerUserInfo": [ # The IDP of the user.
284 {
285 "federatedId": "A String", # User's identifier at IDP.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]286 "displayName": "A String", # The user's display name at the IDP.
287 "photoUrl": "A String", # The user's photo url at the IDP.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]288 "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
289 "rawId": "A String", # User's raw identifier directly returned from IDP.
290 "email": "A String", # User's email at IDP.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]291 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]292 },
293 ],
294 "passwordUpdatedAt": 3.14, # The timestamp when the password was last updated.
295 "salt": "A String", # The user's password salt.
296 "email": "A String", # The email of the user.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]297 "createdAt": "A String", # User creation timestamp.
298 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]299 },
300 ],
301 }</pre>
302</div>
303
304<div class="method">
305 <code class="details" id="getOobConfirmationCode">getOobConfirmationCode(body)</code>
306 <pre>Get a code for user action confirmation.
307
308Args:
309 body: object, The request body. (required)
310 The object takes the form of:
311
312{ # Request of getting a code for user confirmation (reset password, change email etc.)
313 "kind": "identitytoolkit#relyingparty", # The fixed string "identitytoolkit#relyingparty".
314 "requestType": "A String", # The request type.
315 "idToken": "A String", # The user's Gitkit login token for email change.
316 "challenge": "A String", # The recaptcha challenge presented to the user.
317 "newEmail": "A String", # The new email if the code is for email change.
318 "userIp": "A String", # The IP address of the user.
319 "email": "A String", # The email of the user.
320 "captchaResp": "A String", # The recaptcha response from the user.
321 }
322
323
324Returns:
325 An object of the form:
326
327 { # Response of getting a code for user confirmation (reset password, change email etc.).
328 "kind": "identitytoolkit#GetOobConfirmationCodeResponse", # The fixed string "identitytoolkit#GetOobConfirmationCodeResponse".
329 "oobCode": "A String", # The code to be send to the user.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]330 "email": "A String", # The email address that the email is sent to.
331 }</pre>
332</div>
333
334<div class="method">
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]335 <code class="details" id="getProjectConfig">getProjectConfig(delegatedProjectNumber=None, projectNumber=None)</code>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]336 <pre>Get project configuration.
337
338Args:
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]339 delegatedProjectNumber: string, Delegated GCP project number of the request.
340 projectNumber: string, GCP project number of the request.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]341
342Returns:
343 An object of the form:
344
345 { # Response of getting the project configuration.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]346 "apiKey": "A String", # Browser API key, needed when making http request to Apiary.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]347 "useEmailSending": True or False, # Whether to use email sending provided by Firebear.
348 "projectId": "A String", # Project ID of the relying party.
349 "enableAnonymousUser": True or False, # Whether anonymous user is enabled.
350 "authorizedDomains": [ # Authorized domains.
351 "A String",
352 ],
353 "resetPasswordTemplate": { # Template for an email template. # Reset password email template.
354 "body": "A String", # Email body.
355 "fromDisplayName": "A String", # From display name.
356 "from": "A String", # From address of the email.
357 "format": "A String", # Email body format.
358 "replyTo": "A String", # Reply-to address.
359 "subject": "A String", # Subject of the email.
360 },
361 "legacyResetPasswordTemplate": { # Template for an email template. # Legacy reset password email template.
362 "body": "A String", # Email body.
363 "fromDisplayName": "A String", # From display name.
364 "from": "A String", # From address of the email.
365 "format": "A String", # Email body format.
366 "replyTo": "A String", # Reply-to address.
367 "subject": "A String", # Subject of the email.
368 },
369 "verifyEmailTemplate": { # Template for an email template. # Verify email template.
370 "body": "A String", # Email body.
371 "fromDisplayName": "A String", # From display name.
372 "from": "A String", # From address of the email.
373 "format": "A String", # Email body format.
374 "replyTo": "A String", # Reply-to address.
375 "subject": "A String", # Subject of the email.
376 },
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]377 "allowPasswordUser": True or False, # Whether to allow password user sign in or sign up.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]378 "changeEmailTemplate": { # Template for an email template. # Change email template.
379 "body": "A String", # Email body.
380 "fromDisplayName": "A String", # From display name.
381 "from": "A String", # From address of the email.
382 "format": "A String", # Email body format.
383 "replyTo": "A String", # Reply-to address.
384 "subject": "A String", # Subject of the email.
385 },
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]386 "idpConfig": [ # OAuth2 provider configuration.
387 { # Template for a single idp configuration.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]388 "whitelistedAudiences": [ # Whitelisted client IDs for audience check.
389 "A String",
390 ],
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]391 "enabled": True or False, # Whether this IDP is enabled.
392 "clientId": "A String", # OAuth2 client ID.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]393 "secret": "A String", # OAuth2 client secret.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]394 "provider": "A String", # OAuth2 provider.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]395 "experimentPercent": 42, # Percent of users who will be prompted/redirected federated login for this IDP.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]396 },
397 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]398 }</pre>
399</div>
400
401<div class="method">
402 <code class="details" id="getPublicKeys">getPublicKeys()</code>
403 <pre>Get token signing public key.
404
405Args:
406
407Returns:
408 An object of the form:
409
410 { # Respone of getting public keys.
411 "a_key": "A String",
412 }</pre>
413</div>
414
415<div class="method">
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]416 <code class="details" id="getRecaptchaParam">getRecaptchaParam()</code>
417 <pre>Get recaptcha secure param.
418
419Args:
420
421Returns:
422 An object of the form:
423
424 { # Response of getting recaptcha param.
425 "kind": "identitytoolkit#GetRecaptchaParamResponse", # The fixed string "identitytoolkit#GetRecaptchaParamResponse".
426 "recaptchaSiteKey": "A String", # Site key registered at recaptcha.
427 "recaptchaStoken": "A String", # The stoken field for the recaptcha widget, used to request captcha challenge.
428 }</pre>
429</div>
430
431<div class="method">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]432 <code class="details" id="resetPassword">resetPassword(body)</code>
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]433 <pre>Reset password for a user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]434
435Args:
436 body: object, The request body. (required)
437 The object takes the form of:
438
439{ # Request to reset the password.
440 "newPassword": "A String", # The new password inputted by the user.
441 "oldPassword": "A String", # The old password inputted by the user.
442 "oobCode": "A String", # The confirmation code.
443 "email": "A String", # The email address of the user.
444 }
445
446
447Returns:
448 An object of the form:
449
450 { # Response of resetting the password.
451 "kind": "identitytoolkit#ResetPasswordResponse", # The fixed string "identitytoolkit#ResetPasswordResponse".
452 "email": "A String", # The user's email.
453 }</pre>
454</div>
455
456<div class="method">
457 <code class="details" id="setAccountInfo">setAccountInfo(body)</code>
458 <pre>Set account info for a user.
459
460Args:
461 body: object, The request body. (required)
462 The object takes the form of:
463
464{ # Request to set the account information.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]465 "instanceId": "A String", # Instance id token of the app.
466 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]467 "deleteAttribute": [ # The attributes users request to delete.
468 "A String",
469 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]470 "localId": "A String", # The local ID of the user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]471 "validSince": "A String", # Timestamp in seconds for valid login token.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]472 "photoUrl": "A String", # The photo url of the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]473 "captchaResponse": "A String", # Response to the captcha.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]474 "emailVerified": True or False, # Mark the email as verified or not.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]475 "lastLoginAt": "A String", # Last login timestamp.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]476 "provider": [ # The associated IDPs of the user.
477 "A String",
478 ],
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]479 "disableUser": True or False, # Whether to disable the user.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]480 "deleteProvider": [ # The IDPs the user request to delete.
481 "A String",
482 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]483 "captchaChallenge": "A String", # The captcha challenge.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]484 "oobCode": "A String", # The out-of-band code of the change email request.
485 "upgradeToFederatedLogin": True or False, # Mark the user to upgrade to federated login.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]486 "idToken": "A String", # The GITKit token of the authenticated user.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]487 "returnSecureToken": True or False, # Whether return sts id token and refresh token instead of gitkit token.
488 "displayName": "A String", # The name of the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]489 "password": "A String", # The new password of the user.
490 "email": "A String", # The email of the user.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]491 "createdAt": "A String", # The timestamp when the account is created.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]492 }
493
494
495Returns:
496 An object of the form:
497
498 { # Respone of setting the account information.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]499 "expiresIn": "A String", # If idToken is STS id token, then this field will be expiration time of STS id token in seconds.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]500 "kind": "identitytoolkit#SetAccountInfoResponse", # The fixed string "identitytoolkit#SetAccountInfoResponse".
501 "displayName": "A String", # The name of the user.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]502 "localId": "A String", # The local ID of the user.
503 "photoUrl": "A String", # The photo url of the user.
504 "idToken": "A String", # The Gitkit id token to login the newly sign up user.
505 "passwordHash": "A String", # The user's hashed password.
506 "newEmail": "A String", # The new email the user attempts to change to.
507 "refreshToken": "A String", # If idToken is STS id token, then this field will be refresh token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]508 "providerUserInfo": [ # The user's profiles at the associated IdPs.
509 {
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]510 "federatedId": "A String", # User's identifier at IDP.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]511 "providerId": "A String", # The IdP ID. For whitelisted IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
512 "displayName": "A String", # The user's display name at the IDP.
513 "photoUrl": "A String", # The user's photo url at the IDP.
514 },
515 ],
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]516 "email": "A String", # The email of the user.
517 }</pre>
518</div>
519
520<div class="method">
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]521 <code class="details" id="setProjectConfig">setProjectConfig(body)</code>
522 <pre>Set project configuration.
523
524Args:
525 body: object, The request body. (required)
526 The object takes the form of:
527
528{ # Request to set the project configuration.
529 "apiKey": "A String", # Browser API key, needed when making http request to Apiary.
530 "useEmailSending": True or False, # Whether to use email sending provided by Firebear.
531 "verifyEmailTemplate": { # Template for an email template. # Verify email template.
532 "body": "A String", # Email body.
533 "fromDisplayName": "A String", # From display name.
534 "from": "A String", # From address of the email.
535 "format": "A String", # Email body format.
536 "replyTo": "A String", # Reply-to address.
537 "subject": "A String", # Subject of the email.
538 },
539 "enableAnonymousUser": True or False, # Whether to enable anonymous user.
540 "authorizedDomains": [ # Authorized domains for widget redirect.
541 "A String",
542 ],
543 "resetPasswordTemplate": { # Template for an email template. # Reset password email template.
544 "body": "A String", # Email body.
545 "fromDisplayName": "A String", # From display name.
546 "from": "A String", # From address of the email.
547 "format": "A String", # Email body format.
548 "replyTo": "A String", # Reply-to address.
549 "subject": "A String", # Subject of the email.
550 },
551 "legacyResetPasswordTemplate": { # Template for an email template. # Legacy reset password email template.
552 "body": "A String", # Email body.
553 "fromDisplayName": "A String", # From display name.
554 "from": "A String", # From address of the email.
555 "format": "A String", # Email body format.
556 "replyTo": "A String", # Reply-to address.
557 "subject": "A String", # Subject of the email.
558 },
559 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
560 "allowPasswordUser": True or False, # Whether to allow password user sign in or sign up.
561 "changeEmailTemplate": { # Template for an email template. # Change email template.
562 "body": "A String", # Email body.
563 "fromDisplayName": "A String", # From display name.
564 "from": "A String", # From address of the email.
565 "format": "A String", # Email body format.
566 "replyTo": "A String", # Reply-to address.
567 "subject": "A String", # Subject of the email.
568 },
569 "idpConfig": [ # Oauth2 provider configuration.
570 { # Template for a single idp configuration.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]571 "whitelistedAudiences": [ # Whitelisted client IDs for audience check.
572 "A String",
573 ],
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]574 "enabled": True or False, # Whether this IDP is enabled.
575 "clientId": "A String", # OAuth2 client ID.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]576 "secret": "A String", # OAuth2 client secret.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]577 "provider": "A String", # OAuth2 provider.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]578 "experimentPercent": 42, # Percent of users who will be prompted/redirected federated login for this IDP.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]579 },
580 ],
581 }
582
583
584Returns:
585 An object of the form:
586
587 { # Response of setting the project configuration.
588 "projectId": "A String", # Project ID of the relying party.
589 }</pre>
590</div>
591
592<div class="method">
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]593 <code class="details" id="signOutUser">signOutUser(body)</code>
594 <pre>Sign out user.
595
596Args:
597 body: object, The request body. (required)
598 The object takes the form of:
599
600{ # Request to sign out user.
601 "instanceId": "A String", # Instance id token of the app.
602 "localId": "A String", # The local ID of the user.
603 }
604
605
606Returns:
607 An object of the form:
608
609 { # Response of signing out user.
610 "localId": "A String", # The local ID of the user.
611 }</pre>
612</div>
613
614<div class="method">
615 <code class="details" id="signupNewUser">signupNewUser(body)</code>
616 <pre>Signup new user.
617
618Args:
619 body: object, The request body. (required)
620 The object takes the form of:
621
622{ # Request to signup new user, create anonymous user or anonymous user reauth.
623 "instanceId": "A String", # Instance id token of the app.
624 "displayName": "A String", # The name of the user.
625 "captchaResponse": "A String", # Response to the captcha.
626 "idToken": "A String", # The GITKit token of the authenticated user.
627 "captchaChallenge": "A String", # The captcha challenge.
628 "password": "A String", # The new password of the user.
629 "email": "A String", # The email of the user.
630 }
631
632
633Returns:
634 An object of the form:
635
636 { # Response of signing up new user, creating anonymous user or anonymous user reauth.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]637 "expiresIn": "A String", # If idToken is STS id token, then this field will be expiration time of STS id token in seconds.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]638 "kind": "identitytoolkit#SignupNewUserResponse", # The fixed string "identitytoolkit#SignupNewUserResponse".
639 "displayName": "A String", # The name of the user.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]640 "localId": "A String", # The RP local ID of the user.
641 "idToken": "A String", # The Gitkit id token to login the newly sign up user.
642 "refreshToken": "A String", # If idToken is STS id token, then this field will be refresh token.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]643 "email": "A String", # The email of the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]644 }</pre>
645</div>
646
647<div class="method">
648 <code class="details" id="uploadAccount">uploadAccount(body)</code>
649 <pre>Batch upload existing user accounts.
650
651Args:
652 body: object, The request body. (required)
653 The object takes the form of:
654
655{ # Request to upload user account in batch.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]656 "hashAlgorithm": "A String", # The password hash algorithm.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]657 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]658 "users": [ # The account info to be stored.
659 { # Template for an individual account info.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]660 "passwordHash": "A String", # The user's hashed password.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]661 "displayName": "A String", # The name of the user.
662 "localId": "A String", # The local ID of the user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]663 "validSince": "A String", # Timestamp in seconds for valid login token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]664 "photoUrl": "A String", # The URL of the user profile photo.
665 "emailVerified": True or False, # Whether the email has been verified.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]666 "lastLoginAt": "A String", # last login timestamp.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]667 "disabled": True or False, # Whether the user is disabled.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]668 "version": 42, # Version of the user's password.
669 "providerUserInfo": [ # The IDP of the user.
670 {
671 "federatedId": "A String", # User's identifier at IDP.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]672 "displayName": "A String", # The user's display name at the IDP.
673 "photoUrl": "A String", # The user's photo url at the IDP.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]674 "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name, e.g., google.com, aol.com, live.net and yahoo.com. For other OpenID IdPs it's the OP identifier.
675 "rawId": "A String", # User's raw identifier directly returned from IDP.
676 "email": "A String", # User's email at IDP.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]677 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]678 },
679 ],
680 "passwordUpdatedAt": 3.14, # The timestamp when the password was last updated.
681 "salt": "A String", # The user's password salt.
682 "email": "A String", # The email of the user.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]683 "createdAt": "A String", # User creation timestamp.
684 "screenName": "A String", # User's screen name at Twitter.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]685 },
686 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]687 "signerKey": "A String", # The key for to hash the password.
688 "memoryCost": 42, # Memory cost for hash calculation. Used by scrypt similar algorithms.
689 "saltSeparator": "A String", # The salt separator.
690 "rounds": 42, # Rounds for hash calculation. Used by scrypt and similar algorithms.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]691 }
692
693
694Returns:
695 An object of the form:
696
697 { # Respone of uploading accounts in batch.
698 "kind": "identitytoolkit#UploadAccountResponse", # The fixed string "identitytoolkit#UploadAccountResponse".
699 "error": [ # The error encountered while processing the account info.
700 {
701 "index": 42, # The index of the malformed account, starting from 0.
702 "message": "A String", # Detailed error message for the account info.
703 },
704 ],
705 }</pre>
706</div>
707
708<div class="method">
709 <code class="details" id="verifyAssertion">verifyAssertion(body)</code>
710 <pre>Verifies the assertion returned by the IdP.
711
712Args:
713 body: object, The request body. (required)
714 The object takes the form of:
715
716{ # Request to verify the IDP assertion.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]717 "postBody": "A String", # The post body if the request is a HTTP POST.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]718 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
719 "instanceId": "A String", # Instance id token of the app.
720 "idToken": "A String", # The GITKit token of the authenticated user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]721 "pendingIdToken": "A String", # The GITKit token for the non-trusted IDP pending to be confirmed by the user.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]722 "sessionId": "A String", # Session ID, which should match the one in previous createAuthUri request.
723 "requestUri": "A String", # The URI to which the IDP redirects the user back. It may contain federated login result params added by the IDP.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]724 "returnSecureToken": True or False, # Whether return sts id token and refresh token instead of gitkit token.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]725 "returnRefreshToken": True or False, # Whether to return refresh tokens.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]726 }
727
728
729Returns:
730 An object of the form:
731
732 { # Response of verifying the IDP assertion.
733 "federatedId": "A String", # The unique ID identifies the IdP account.
734 "localId": "A String", # The RP local ID if it's already been mapped to the IdP account identified by the federated ID.
735 "photoUrl": "A String", # The URI of the public accessible profiel picture.
736 "inputEmail": "A String", # It's the identifier param in the createAuthUri request if the identifier is an email. It can be used to check whether the user input email is different from the asserted email.
737 "appScheme": "A String", # The custom scheme used by mobile app.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]738 "expiresIn": "A String", # If idToken is STS id token, then this field will be expiration time of STS id token in seconds.
739 "refreshToken": "A String", # If idToken is STS id token, then this field will be refresh token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]740 "verifiedProvider": [ # When action is 'map', contains the idps which can be used for confirmation.
741 "A String",
742 ],
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]743 "needEmail": True or False, # Whether need client to supply email to complete the federated login flow.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]744 "dateOfBirth": "A String", # The birth date of the IdP account.
745 "nickName": "A String", # The nick name of the user.
746 "email": "A String", # The email returned by the IdP. NOTE: The federated login user may not own the email.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]747 "screenName": "A String", # The screen_name of a Twitter user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]748 "oauthAccessToken": "A String", # The OAuth2 access token.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]749 "oauthTokenSecret": "A String", # The OAuth1 access token secret.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]750 "language": "A String", # The language preference of the user.
751 "needConfirmation": True or False, # Whether the assertion is from a non-trusted IDP and need account linking confirmation.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]752 "oauthIdToken": "A String", # The OIDC id token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]753 "fullName": "A String", # The full name of the user.
754 "kind": "identitytoolkit#VerifyAssertionResponse", # The fixed string "identitytoolkit#VerifyAssertionResponse".
755 "idToken": "A String", # The ID token.
756 "displayName": "A String", # The display name of the user.
757 "appInstallationUrl": "A String", # URL for OTA app installation.
758 "firstName": "A String", # The first name of the user.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]759 "oauthExpireIn": 42, # The lifetime in seconds of the OAuth2 access token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]760 "emailVerified": True or False, # The value is true if the IDP is also the email provider. It means the user owns the email.
761 "oauthScope": "A String", # The scope for the OpenID OAuth extension.
762 "oauthRequestToken": "A String", # The user approved request token for the OpenID OAuth extension.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]763 "oauthAuthorizationCode": "A String", # The OAuth2 authorization code.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]764 "originalEmail": "A String", # The original email stored in the mapping storage. It's returned when the federated ID is associated to a different email.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]765 "providerId": "A String", # The IdP ID. For white listed IdPs it's a short domain name e.g. google.com, aol.com, live.net and yahoo.com. If the "providerId" param is set to OpenID OP identifer other than the whilte listed IdPs the OP identifier is returned. If the "identifier" param is federated ID in the createAuthUri request. The domain part of the federated ID is returned.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]766 "context": "A String", # The opaque value used by the client to maintain context info between the authentication request and the IDP callback.
767 "lastName": "A String", # The last name of the user.
768 "action": "A String", # The action code.
769 "timeZone": "A String", # The timezone of the user.
770 "emailRecycled": True or False, # It's true if the email is recycled.
771 }</pre>
772</div>
773
774<div class="method">
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]775 <code class="details" id="verifyCustomToken">verifyCustomToken(body)</code>
776 <pre>Verifies the developer asserted ID token.
777
778Args:
779 body: object, The request body. (required)
780 The object takes the form of:
781
782{ # Request to verify a custom token
783 "instanceId": "A String", # Instance id token of the app.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]784 "returnSecureToken": True or False, # Whether return sts id token and refresh token instead of gitkit token.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]785 "token": "A String", # The custom token to verify
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]786 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]787 }
788
789
790Returns:
791 An object of the form:
792
793 { # Response from verifying a custom token
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]794 "expiresIn": "A String", # If idToken is STS id token, then this field will be expiration time of STS id token in seconds.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]795 "idToken": "A String", # The GITKit token for authenticated user.
796 "kind": "identitytoolkit#VerifyCustomTokenResponse", # The fixed string "identitytoolkit#VerifyCustomTokenResponse".
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]797 "refreshToken": "A String", # If idToken is STS id token, then this field will be refresh token.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]798 }</pre>
799</div>
800
801<div class="method">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]802 <code class="details" id="verifyPassword">verifyPassword(body)</code>
803 <pre>Verifies the user entered password.
804
805Args:
806 body: object, The request body. (required)
807 The object takes the form of:
808
809{ # Request to verify the password.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]810 "instanceId": "A String", # Instance id token of the app.
811 "delegatedProjectNumber": "A String", # GCP project number of the requesting delegated app. Currently only intended for Firebase V1 migration.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]812 "captchaResponse": "A String", # Response to the captcha.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]813 "idToken": "A String", # The GITKit token of the authenticated user.
814 "pendingIdToken": "A String", # The GITKit token for the non-trusted IDP, which is to be confirmed by the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]815 "captchaChallenge": "A String", # The captcha challenge.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]816 "returnSecureToken": True or False, # Whether return sts id token and refresh token instead of gitkit token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]817 "password": "A String", # The password inputed by the user.
818 "email": "A String", # The email of the user.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]819 }
820
821
822Returns:
823 An object of the form:
824
825 { # Request of verifying the password.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]826 "expiresIn": "A String", # If idToken is STS id token, then this field will be expiration time of STS id token in seconds.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]827 "kind": "identitytoolkit#VerifyPasswordResponse", # The fixed string "identitytoolkit#VerifyPasswordResponse".
828 "displayName": "A String", # The name of the user.
829 "localId": "A String", # The RP local ID if it's already been mapped to the IdP account identified by the federated ID.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]830 "oauthAccessToken": "A String", # The OAuth2 access token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]831 "photoUrl": "A String", # The URI of the user's photo at IdP
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]832 "oauthExpireIn": 42, # The lifetime in seconds of the OAuth2 access token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]833 "idToken": "A String", # The GITKit token for authenticated user.
834 "registered": True or False, # Whether the email is registered.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]835 "oauthAuthorizationCode": "A String", # The OAuth2 authorization code.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]836 "refreshToken": "A String", # If idToken is STS id token, then this field will be refresh token.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]837 "email": "A String", # The email returned by the IdP. NOTE: The federated login user may not own the email.
838 }</pre>
839</div>
840
841</body></html>