{ "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/firebase": { "description": "View and administer all your Firebase data and settings" }, "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "mtlsRootUrl": "https://identitytoolkit.mtls.googleapis.com/", "discoveryVersion": "v1", "resources": { "projects": { "resources": { "tenants": { "methods": { "createSessionCookie": { "description": "Creates a session cookie for the given Identity Platform ID token. The session cookie is used by the client to preserve the user's login state.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "targetProjectId", "tenantId" ], "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}:createSessionCookie", "parameters": { "targetProjectId": { "type": "string", "description": "The ID of the project that the account belongs to.", "location": "path", "pattern": "^[^/]+$", "required": true }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant the account belongs to.", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}:createSessionCookie", "response": { "$ref": "GoogleCloudIdentitytoolkitV1CreateSessionCookieResponse" }, "id": "identitytoolkit.projects.tenants.createSessionCookie", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1CreateSessionCookieRequest" } }, "accounts": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Signs up a new email and password user or anonymous user, or upgrades an anonymous user to email and password. For an admin request with a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control), creates a new anonymous, email and password, or phone number user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts", "parameters": { "targetProjectId": { "location": "path", "pattern": "^[^/]+$", "required": true, "description": "The project ID of the project which the user should belong to. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control). If this is not set, the target project is inferred from the scope associated to the Bearer access token.", "type": "string" }, "tenantId": { "type": "string", "description": "The ID of the Identity Platform tenant to create a user under. If not set, the user will be created under the default Identity Platform project.", "location": "path", "pattern": "^[^/]+$", "required": true } }, "parameterOrder": [ "targetProjectId", "tenantId" ], "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpResponse" }, "id": "identitytoolkit.projects.tenants.accounts", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpRequest" } } }, "resources": { "accounts": { "methods": { "batchDelete": { "parameterOrder": [ "targetProjectId", "tenantId" ], "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:batchDelete", "parameters": { "targetProjectId": { "location": "path", "pattern": "^[^/]+$", "required": true, "description": "If `tenant_id` is specified, the ID of the Google Cloud project that the Identity Platform tenant belongs to. Otherwise, the ID of the Google Cloud project that accounts belong to.", "type": "string" }, "tenantId": { "description": "If the accounts belong to an Identity Platform tenant, the ID of the tenant. If the accounts belong to a default Identity Platform project, the field is not needed.", "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Batch deletes multiple accounts. For accounts that fail to be deleted, error info is contained in the response. The method ignores accounts that do not exist or are duplicated in the request. This method requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsRequest" }, "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:batchDelete", "response": { "$ref": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsResponse" }, "id": "identitytoolkit.projects.tenants.accounts.batchDelete", "httpMethod": "POST" }, "update": { "request": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoRequest" }, "id": "identitytoolkit.projects.tenants.accounts.update", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:update", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoResponse" }, "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:update", "parameters": { "targetProjectId": { "description": "The project ID for the project that the account belongs to. Specifying this field requires Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control). Requests from end users should pass an Identity Platform ID token instead.", "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string" }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant that the account belongs to. Requests from end users should pass an Identity Platform ID token rather than setting this field.", "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string" } }, "parameterOrder": [ "targetProjectId", "tenantId" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates account-related information for the specified user by setting specific fields or applying action codes. Requests from administrators and end users are supported." }, "delete": { "id": "identitytoolkit.projects.tenants.accounts.delete", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:delete", "response": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a user's account.", "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:delete", "parameters": { "targetProjectId": { "type": "string", "description": "The ID of the project which the account belongs to. Should only be specified in authenticated requests that specify local_id of an account.", "location": "path", "pattern": "^[^/]+$", "required": true }, "tenantId": { "type": "string", "description": "The ID of the tenant that the account belongs to, if applicable. Only require to be specified for authenticated requests bearing a Google OAuth 2.0 credential that specify local_id of an account that belongs to an Identity Platform tenant.", "pattern": "^[^/]+$", "required": true, "location": "path" } }, "parameterOrder": [ "targetProjectId", "tenantId" ] }, "sendOobCode": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sends an out-of-band confirmation code for an account. Requests from a authenticated request can optionally return a link including the OOB code instead of sending it.", "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:sendOobCode", "parameters": { "targetProjectId": { "type": "string", "description": "The Project ID of the Identity Platform project which the account belongs to. To specify this field, it requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "pattern": "^[^/]+$", "required": true, "location": "path" }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant the account belongs to.", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "parameterOrder": [ "targetProjectId", "tenantId" ], "id": "identitytoolkit.projects.tenants.accounts.sendOobCode", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:sendOobCode", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeRequest" } }, "query": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "description": "Looks up user accounts within a project or a tenant based on conditions in the request.", "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:query", "parameters": { "targetProjectId": { "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path", "description": "The ID of the project to which the result is scoped." }, "tenantId": { "description": "The ID of the tenant to which the result is scoped.", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "parameterOrder": [ "targetProjectId", "tenantId" ], "id": "identitytoolkit.projects.tenants.accounts.query", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:query", "response": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoRequest" } }, "batchCreate": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "description": "Uploads multiple accounts into the Google Cloud project. If there is a problem uploading one or more of the accounts, the rest will be uploaded, and a list of the errors will be returned. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:batchCreate", "parameters": { "targetProjectId": { "type": "string", "description": "The Project ID of the Identity Platform project which the account belongs to.", "location": "path", "pattern": "^[^/]+$", "required": true }, "tenantId": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "The ID of the Identity Platform tenant the account belongs to.", "type": "string" } }, "parameterOrder": [ "targetProjectId", "tenantId" ], "id": "identitytoolkit.projects.tenants.accounts.batchCreate", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:batchCreate", "response": { "$ref": "GoogleCloudIdentitytoolkitV1UploadAccountResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1UploadAccountRequest" } }, "batchGet": { "parameterOrder": [ "targetProjectId", "tenantId" ], "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:batchGet", "parameters": { "targetProjectId": { "type": "string", "description": "If `tenant_id` is specified, the ID of the Google Cloud project that the Identity Platform tenant belongs to. Otherwise, the ID of the Google Cloud project that the accounts belong to.", "location": "path", "pattern": "^[^/]+$", "required": true }, "tenantId": { "type": "string", "description": "The ID of the Identity Platform tenant the accounts belongs to. If not specified, accounts on the Identity Platform project are returned.", "pattern": "^[^/]+$", "required": true, "location": "path" }, "maxResults": { "location": "query", "description": "The maximum number of results to return. Must be at least 1 and no greater than 1000. By default, it is 20.", "type": "integer", "format": "int32" }, "delegatedProjectNumber": { "deprecated": true, "location": "query", "type": "string", "format": "int64" }, "nextPageToken": { "description": "The pagination token from the response of a previous request.", "type": "string", "location": "query" } }, "description": "Download account information for all accounts on the project in a paginated manner. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).. Furthermore, additional permissions are needed to get password hash, password salt, and password version from accounts; otherwise these fields are redacted.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "id": "identitytoolkit.projects.tenants.accounts.batchGet", "httpMethod": "GET", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:batchGet", "response": { "$ref": "GoogleCloudIdentitytoolkitV1DownloadAccountResponse" } }, "lookup": { "description": "Gets account information for all matched accounts. For an end user request, retrieves the account of the end user. For an admin request with Google OAuth 2.0 credential, retrieves one or multiple account(s) with matching criteria.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "targetProjectId", "tenantId" ], "flatPath": "v1/projects/{projectsId}/tenants/{tenantsId}/accounts:lookup", "parameters": { "targetProjectId": { "type": "string", "description": "The ID of the Google Cloud project that the account or the Identity Platform tenant specified by `tenant_id` belongs to. Should only be specified by authenticated requests bearing a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "location": "path", "pattern": "^[^/]+$", "required": true }, "tenantId": { "location": "path", "pattern": "^[^/]+$", "required": true, "description": "The ID of the tenant that the account belongs to. Should only be specified by authenticated requests from a developer.", "type": "string" } }, "id": "identitytoolkit.projects.tenants.accounts.lookup", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/tenants/{+tenantId}/accounts:lookup", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoRequest" } } } } } }, "accounts": { "methods": { "batchCreate": { "description": "Uploads multiple accounts into the Google Cloud project. If there is a problem uploading one or more of the accounts, the rest will be uploaded, and a list of the errors will be returned. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:batchCreate", "parameters": { "targetProjectId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "required": true, "description": "The Project ID of the Identity Platform project which the account belongs to." } }, "path": "v1/projects/{+targetProjectId}/accounts:batchCreate", "response": { "$ref": "GoogleCloudIdentitytoolkitV1UploadAccountResponse" }, "id": "identitytoolkit.projects.accounts.batchCreate", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1UploadAccountRequest" } }, "batchGet": { "description": "Download account information for all accounts on the project in a paginated manner. To use this method requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).. Furthermore, additional permissions are needed to get password hash, password salt, and password version from accounts; otherwise these fields are redacted.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:batchGet", "parameters": { "targetProjectId": { "description": "If `tenant_id` is specified, the ID of the Google Cloud project that the Identity Platform tenant belongs to. Otherwise, the ID of the Google Cloud project that the accounts belong to.", "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string" }, "maxResults": { "location": "query", "description": "The maximum number of results to return. Must be at least 1 and no greater than 1000. By default, it is 20.", "type": "integer", "format": "int32" }, "tenantId": { "location": "query", "description": "The ID of the Identity Platform tenant the accounts belongs to. If not specified, accounts on the Identity Platform project are returned.", "type": "string" }, "delegatedProjectNumber": { "type": "string", "format": "int64", "location": "query", "deprecated": true }, "nextPageToken": { "location": "query", "description": "The pagination token from the response of a previous request.", "type": "string" } }, "path": "v1/projects/{+targetProjectId}/accounts:batchGet", "response": { "$ref": "GoogleCloudIdentitytoolkitV1DownloadAccountResponse" }, "id": "identitytoolkit.projects.accounts.batchGet", "httpMethod": "GET" }, "lookup": { "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:lookup", "parameters": { "targetProjectId": { "type": "string", "description": "The ID of the Google Cloud project that the account or the Identity Platform tenant specified by `tenant_id` belongs to. Should only be specified by authenticated requests bearing a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "location": "path", "pattern": "^[^/]+$", "required": true } }, "description": "Gets account information for all matched accounts. For an end user request, retrieves the account of the end user. For an admin request with Google OAuth 2.0 credential, retrieves one or multiple account(s) with matching criteria.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoRequest" }, "path": "v1/projects/{+targetProjectId}/accounts:lookup", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoResponse" }, "id": "identitytoolkit.projects.accounts.lookup", "httpMethod": "POST" }, "sendOobCode": { "description": "Sends an out-of-band confirmation code for an account. Requests from a authenticated request can optionally return a link including the OOB code instead of sending it.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:sendOobCode", "parameters": { "targetProjectId": { "description": "The Project ID of the Identity Platform project which the account belongs to. To specify this field, it requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "id": "identitytoolkit.projects.accounts.sendOobCode", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/accounts:sendOobCode", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeRequest" } }, "query": { "id": "identitytoolkit.projects.accounts.query", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/accounts:query", "response": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoRequest" }, "description": "Looks up user accounts within a project or a tenant based on conditions in the request.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:query", "parameters": { "targetProjectId": { "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path", "description": "The ID of the project to which the result is scoped." } } }, "update": { "path": "v1/projects/{+targetProjectId}/accounts:update", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoResponse" }, "id": "identitytoolkit.projects.accounts.update", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoRequest" }, "description": "Updates account-related information for the specified user by setting specific fields or applying action codes. Requests from administrators and end users are supported.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:update", "parameters": { "targetProjectId": { "type": "string", "description": "The project ID for the project that the account belongs to. Specifying this field requires Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control). Requests from end users should pass an Identity Platform ID token instead.", "pattern": "^[^/]+$", "required": true, "location": "path" } } }, "delete": { "flatPath": "v1/projects/{projectsId}/accounts:delete", "parameters": { "targetProjectId": { "type": "string", "description": "The ID of the project which the account belongs to. Should only be specified in authenticated requests that specify local_id of an account.", "location": "path", "pattern": "^[^/]+$", "required": true } }, "parameterOrder": [ "targetProjectId" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a user's account.", "request": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountRequest" }, "path": "v1/projects/{+targetProjectId}/accounts:delete", "response": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountResponse" }, "id": "identitytoolkit.projects.accounts.delete", "httpMethod": "POST" }, "batchDelete": { "request": { "$ref": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsRequest" }, "id": "identitytoolkit.projects.accounts.batchDelete", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/accounts:batchDelete", "response": { "$ref": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsResponse" }, "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts:batchDelete", "parameters": { "targetProjectId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "required": true, "description": "If `tenant_id` is specified, the ID of the Google Cloud project that the Identity Platform tenant belongs to. Otherwise, the ID of the Google Cloud project that accounts belong to." } }, "description": "Batch deletes multiple accounts. For accounts that fail to be deleted, error info is contained in the response. The method ignores accounts that do not exist or are duplicated in the request. This method requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ] } } } }, "methods": { "accounts": { "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}/accounts", "parameters": { "targetProjectId": { "location": "path", "pattern": "^[^/]+$", "required": true, "description": "The project ID of the project which the user should belong to. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control). If this is not set, the target project is inferred from the scope associated to the Bearer access token.", "type": "string" } }, "description": "Signs up a new email and password user or anonymous user, or upgrades an anonymous user to email and password. For an admin request with a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control), creates a new anonymous, email and password, or phone number user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpRequest" }, "id": "identitytoolkit.projects.accounts", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}/accounts", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpResponse" } }, "queryAccounts": { "id": "identitytoolkit.projects.queryAccounts", "httpMethod": "POST", "path": "v1/projects/{+targetProjectId}:queryAccounts", "response": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1QueryUserInfoRequest" }, "description": "Looks up user accounts within a project or a tenant based on conditions in the request.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ], "parameterOrder": [ "targetProjectId" ], "flatPath": "v1/projects/{projectsId}:queryAccounts", "parameters": { "targetProjectId": { "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path", "description": "The ID of the project to which the result is scoped." } } }, "createSessionCookie": { "path": "v1/projects/{+targetProjectId}:createSessionCookie", "response": { "$ref": "GoogleCloudIdentitytoolkitV1CreateSessionCookieResponse" }, "id": "identitytoolkit.projects.createSessionCookie", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1CreateSessionCookieRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a session cookie for the given Identity Platform ID token. The session cookie is used by the client to preserve the user's login state.", "flatPath": "v1/projects/{projectsId}:createSessionCookie", "parameters": { "targetProjectId": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "The ID of the project that the account belongs to.", "type": "string" } }, "parameterOrder": [ "targetProjectId" ] } } }, "accounts": { "methods": { "signInWithIdp": { "path": "v1/accounts:signInWithIdp", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithIdpResponse" }, "id": "identitytoolkit.accounts.signInWithIdp", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithIdpRequest" }, "description": "Signs in or signs up a user using credentials from an Identity Provider (IdP). This is done by manually providing an IdP credential, or by providing the authorization response obtained via the authorization request from CreateAuthUri. If the sign-in succeeds, a new Identity Platform ID token and refresh token are issued for the authenticated user. A new Identity Platform user account will be created if the user has not previously signed in to the IdP with the same account. In addition, when the \"One account per email address\" setting is enabled, there should not be an existing Identity Platform user account with the same email address for a new user account to be created. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:signInWithIdp", "parameters": {} }, "resetPassword": { "path": "v1/accounts:resetPassword", "response": { "$ref": "GoogleCloudIdentitytoolkitV1ResetPasswordResponse" }, "id": "identitytoolkit.accounts.resetPassword", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1ResetPasswordRequest" }, "description": "Resets the password of an account either using an out-of-band code generated by sendOobCode or by specifying the email and password of the account to be modified. Can also check the purpose of an out-of-band code without consuming it.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:resetPassword", "parameters": {} }, "lookup": { "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoRequest" }, "path": "v1/accounts:lookup", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetAccountInfoResponse" }, "id": "identitytoolkit.accounts.lookup", "httpMethod": "POST", "flatPath": "v1/accounts:lookup", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets account information for all matched accounts. For an end user request, retrieves the account of the end user. For an admin request with Google OAuth 2.0 credential, retrieves one or multiple account(s) with matching criteria." }, "signUp": { "id": "identitytoolkit.accounts.signUp", "httpMethod": "POST", "path": "v1/accounts:signUp", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignUpRequest" }, "description": "Signs up a new email and password user or anonymous user, or upgrades an anonymous user to email and password. For an admin request with a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control), creates a new anonymous, email and password, or phone number user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:signUp", "parameters": {} }, "signInWithGameCenter": { "id": "identitytoolkit.accounts.signInWithGameCenter", "httpMethod": "POST", "path": "v1/accounts:signInWithGameCenter", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithGameCenterResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithGameCenterRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Signs in or signs up a user with iOS Game Center credentials. If the sign-in succeeds, a new Identity Platform ID token and refresh token are issued for the authenticated user. The bundle ID is required in the request header as `x-ios-bundle-identifier`. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project. Apple has [deprecated the `playerID` field](https://developer.apple.com/documentation/gamekit/gkplayer/1521127-playerid/). The Apple platform Firebase SDK will use `gamePlayerID` and `teamPlayerID` from version 10.5.0 and onwards. Upgrading to SDK version 10.5.0 or later updates existing integrations that use `playerID` to instead use `gamePlayerID` and `teamPlayerID`. When making calls to `signInWithGameCenter`, you must include `playerID` along with the new fields `gamePlayerID` and `teamPlayerID` to successfully identify all existing users. Upgrading existing Game Center sign in integrations to SDK version 10.5.0 or later is irreversible.", "flatPath": "v1/accounts:signInWithGameCenter", "parameters": {}, "parameterOrder": [] }, "createAuthUri": { "flatPath": "v1/accounts:createAuthUri", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "If an email identifier is specified, checks and returns if any user account is registered with the email. If there is a registered account, fetches all providers associated with the account's email. If [email enumeration protection](https://cloud.google.com/identity-platform/docs/admin/email-enumeration-protection) is enabled, this method returns an empty list. If the provider ID of an Identity Provider (IdP) is specified, creates an authorization URI for the IdP. The user can be directed to this URI to sign in with the IdP. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "request": { "$ref": "GoogleCloudIdentitytoolkitV1CreateAuthUriRequest" }, "path": "v1/accounts:createAuthUri", "response": { "$ref": "GoogleCloudIdentitytoolkitV1CreateAuthUriResponse" }, "id": "identitytoolkit.accounts.createAuthUri", "httpMethod": "POST" }, "signInWithEmailLink": { "description": "Signs in or signs up a user with a out-of-band code from an email link. If a user does not exist with the given email address, a user record will be created. If the sign-in succeeds, an Identity Platform ID and refresh token are issued for the authenticated user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:signInWithEmailLink", "parameters": {}, "id": "identitytoolkit.accounts.signInWithEmailLink", "httpMethod": "POST", "path": "v1/accounts:signInWithEmailLink", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkRequest" } }, "verifyIosClient": { "request": { "$ref": "GoogleCloudIdentitytoolkitV1VerifyIosClientRequest" }, "id": "identitytoolkit.accounts.verifyIosClient", "httpMethod": "POST", "path": "v1/accounts:verifyIosClient", "response": { "$ref": "GoogleCloudIdentitytoolkitV1VerifyIosClientResponse" }, "flatPath": "v1/accounts:verifyIosClient", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Verifies an iOS client is a real iOS device. If the request is valid, a receipt will be sent in the response and a secret will be sent via Apple Push Notification Service. The client should send both of them back to certain Identity Platform APIs in a later call (for example, /accounts:sendVerificationCode), in order to verify the client. The bundle ID is required in the request header as `x-ios-bundle-identifier`. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project." }, "update": { "id": "identitytoolkit.accounts.update", "httpMethod": "POST", "path": "v1/accounts:update", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1SetAccountInfoRequest" }, "description": "Updates account-related information for the specified user by setting specific fields or applying action codes. Requests from administrators and end users are supported.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:update", "parameters": {} }, "signInWithPassword": { "parameterOrder": [], "flatPath": "v1/accounts:signInWithPassword", "parameters": {}, "description": "Signs in a user with email and password. If the sign-in succeeds, a new Identity Platform ID token and refresh token are issued for the authenticated user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithPasswordRequest" }, "path": "v1/accounts:signInWithPassword", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithPasswordResponse" }, "id": "identitytoolkit.accounts.signInWithPassword", "httpMethod": "POST" }, "issueSamlResponse": { "flatPath": "v1/accounts:issueSamlResponse", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Experimental", "request": { "$ref": "GoogleCloudIdentitytoolkitV1IssueSamlResponseRequest" }, "id": "identitytoolkit.accounts.issueSamlResponse", "httpMethod": "POST", "path": "v1/accounts:issueSamlResponse", "response": { "$ref": "GoogleCloudIdentitytoolkitV1IssueSamlResponseResponse" } }, "sendOobCode": { "parameterOrder": [], "flatPath": "v1/accounts:sendOobCode", "parameters": {}, "description": "Sends an out-of-band confirmation code for an account. Requests from a authenticated request can optionally return a link including the OOB code instead of sending it.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeRequest" }, "id": "identitytoolkit.accounts.sendOobCode", "httpMethod": "POST", "path": "v1/accounts:sendOobCode", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetOobCodeResponse" } }, "delete": { "parameterOrder": [], "flatPath": "v1/accounts:delete", "parameters": {}, "description": "Deletes a user's account.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountRequest" }, "path": "v1/accounts:delete", "response": { "$ref": "GoogleCloudIdentitytoolkitV1DeleteAccountResponse" }, "id": "identitytoolkit.accounts.delete", "httpMethod": "POST" }, "sendVerificationCode": { "id": "identitytoolkit.accounts.sendVerificationCode", "httpMethod": "POST", "path": "v1/accounts:sendVerificationCode", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SendVerificationCodeResponse" }, "request": { "$ref": "GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sends a SMS verification code for phone number sign-in. To localize the text of the SMS sent to the user, set the HTTP header `X-Firebase-Locale` to the language code that corresponds with the user's locale. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "flatPath": "v1/accounts:sendVerificationCode", "parameters": {}, "parameterOrder": [] }, "signInWithCustomToken": { "flatPath": "v1/accounts:signInWithCustomToken", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Signs in or signs up a user by exchanging a custom Auth token. Upon a successful sign-in or sign-up, a new Identity Platform ID token and refresh token are issued for the user. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenRequest" }, "id": "identitytoolkit.accounts.signInWithCustomToken", "httpMethod": "POST", "path": "v1/accounts:signInWithCustomToken", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenResponse" } }, "signInWithPhoneNumber": { "path": "v1/accounts:signInWithPhoneNumber", "response": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberResponse" }, "id": "identitytoolkit.accounts.signInWithPhoneNumber", "httpMethod": "POST", "request": { "$ref": "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberRequest" }, "description": "Completes a phone number authentication attempt. If a user already exists with the given phone number, an ID token is minted for that user. Otherwise, a new user is created and associated with the phone number. This method may also be used to link a phone number to an existing user. To localize the text of the SMS sent to the user, set the HTTP header `X-Firebase-Locale` to the language code that corresponds with the user's locale. An [API key](https://cloud.google.com/docs/authentication/api-keys) is required in the request in order to identify the Google Cloud project.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "flatPath": "v1/accounts:signInWithPhoneNumber", "parameters": {} } } }, "v1": { "methods": { "getSessionCookiePublicKeys": { "id": "identitytoolkit.getSessionCookiePublicKeys", "httpMethod": "GET", "path": "v1/sessionCookiePublicKeys", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetSessionCookiePublicKeysResponse" }, "description": "Retrieves the set of public keys of the session cookie JSON Web Token (JWT) signer that can be used to validate the session cookie created through createSessionCookie.", "parameterOrder": [], "flatPath": "v1/sessionCookiePublicKeys", "parameters": {} }, "getProjects": { "id": "identitytoolkit.getProjects", "httpMethod": "GET", "path": "v1/projects", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetProjectConfigResponse" }, "flatPath": "v1/projects", "parameters": { "firebaseAppId": { "description": "The Firebase app ID, for applications that use Firebase. This can be found in the Firebase console for your project. If set, a check will be performed to ensure that the app ID is valid for the retrieved project. If not valid, the request will be rejected with a client error.", "type": "string", "location": "query" }, "delegatedProjectNumber": { "location": "query", "description": "Project Number of the delegated project request. This field should only be used as part of the Firebase V1 migration.", "type": "string", "format": "int64" }, "clientId": { "description": "The RP OAuth client ID. If set, a check will be performed to ensure that the OAuth client is valid for the retrieved project and the request rejected with a client error if not valid.", "type": "string", "location": "query" }, "androidPackageName": { "description": "Android package name to check against the real android package name. If this field is provided, and sha1_cert_hash is not provided, the action will throw an error if this does not match the real android package name.", "type": "string", "location": "query" }, "projectNumber": { "description": "Project number of the configuration to retrieve. This field is deprecated and should not be used by new integrations.", "type": "string", "format": "int64", "location": "query" }, "returnDynamicLink": { "description": "Whether dynamic link should be returned.", "type": "boolean", "location": "query" }, "iosBundleId": { "description": "iOS bundle id to check against the real ios bundle id. If this field is provided, the action will throw an error if this does not match the real iOS bundle id.", "type": "string", "location": "query" }, "sha1Cert": { "description": "SHA-1 Android application cert hash. If set, a check will be performed to ensure that the cert hash is valid for the retrieved project and android_package_name.", "type": "string", "location": "query" } }, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a project's public Identity Toolkit configuration. (Legacy) This method also supports authenticated calls from a developer to retrieve non-public configuration." }, "getPublicKeys": { "flatPath": "v1/publicKeys", "parameters": {}, "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves public keys of the legacy Identity Toolkit token signer to enable third parties to verify the legacy ID token. For now the X509 pem cert is the only format supported.", "id": "identitytoolkit.getPublicKeys", "httpMethod": "GET", "path": "v1/publicKeys", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" } }, "getRecaptchaParams": { "parameterOrder": [], "flatPath": "v1/recaptchaParams", "parameters": {}, "description": "Gets parameters needed for generating a reCAPTCHA challenge.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/recaptchaParams", "response": { "$ref": "GoogleCloudIdentitytoolkitV1GetRecaptchaParamResponse" }, "id": "identitytoolkit.getRecaptchaParams", "httpMethod": "GET" } } } }, "basePath": "", "protocol": "rest", "kind": "discovery#restDescription", "version": "v1", "name": "identitytoolkit", "version_module": true, "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "uploadType": { "location": "query", "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "prettyPrint": { "default": "true", "location": "query", "type": "boolean", "description": "Returns response with indentations and line breaks." }, "alt": { "type": "string", "default": "json", "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "location": "query" }, "upload_protocol": { "location": "query", "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "$.xgafv": { "type": "string", "enum": [ "1", "2" ], "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ], "description": "V1 error format." }, "callback": { "location": "query", "type": "string", "description": "JSONP" } }, "id": "identitytoolkit:v1", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "ownerName": "Google", "servicePath": "", "fullyEncodeReservedExpansion": true, "canonicalName": "Identity Toolkit", "baseUrl": "https://identitytoolkit.googleapis.com/", "title": "Identity Toolkit API", "batchPath": "batch", "ownerDomain": "google.com", "description": "The Google Identity Toolkit API lets you use open standards to verify a user's identity.", "documentationLink": "https://cloud.google.com/identity-platform", "rootUrl": "https://identitytoolkit.googleapis.com/", "schemas": { "GoogleCloudIdentitytoolkitV1SignInWithGameCenterResponse": { "id": "GoogleCloudIdentitytoolkitV1SignInWithGameCenterResponse", "description": "Response message for SignInWithGameCenter", "type": "object", "properties": { "localId": { "description": "The ID of the authenticated user. Always present in the response.", "type": "string" }, "gamePlayerId": { "description": "The user's Game Center game player ID. A unique identifier for a player of the game. https://developer.apple.com/documentation/gamekit/gkplayer/3113960-gameplayerid", "type": "string" }, "playerId": { "description": "The user's Game Center player ID. Pass `playerID` along with `gamePlayerID` and `teamPlayerID` to initiate the migration of a user's Game Center player ID to `gamePlayerID`.", "type": "string" }, "displayName": { "description": "Display name of the authenticated user.", "type": "string" }, "teamPlayerId": { "description": "The user's Game Center team player ID. A unique identifier for a player of all the games that you distribute using your developer account. https://developer.apple.com/documentation/gamekit/gkplayer/3174857-teamplayerid", "type": "string" }, "expiresIn": { "description": "The number of seconds until the ID token expires.", "type": "string", "format": "int64" }, "idToken": { "description": "An Identity Platform ID token for the authenticated user.", "type": "string" }, "isNewUser": { "description": "Whether the logged in user was created by this request.", "type": "boolean" }, "refreshToken": { "description": "An Identity Platform refresh token for the authenticated user.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1GetProjectConfigResponse": { "id": "GoogleCloudIdentitytoolkitV1GetProjectConfigResponse", "description": "Response message for GetProjectConfig.", "type": "object", "properties": { "resetPasswordTemplate": { "description": "Email template for reset password. This field is only returned for authenticated calls from a developer.", "$ref": "GoogleCloudIdentitytoolkitV1EmailTemplate" }, "legacyResetPasswordTemplate": { "description": "Reset password email template for legacy Firebase V1 app. This field is only returned for authenticated calls from a developer.", "$ref": "GoogleCloudIdentitytoolkitV1EmailTemplate" }, "enableAnonymousUser": { "description": "Whether anonymous user is enabled. This field is only returned for authenticated calls from a developer.", "type": "boolean" }, "revertSecondFactorAdditionTemplate": { "description": "Email template for reverting second factor additions. This field is only returned for authenticated calls from a developer.", "$ref": "GoogleCloudIdentitytoolkitV1EmailTemplate" }, "apiKey": { "description": "Google Cloud API key. This field is only returned for authenticated calls from a developer.", "type": "string" }, "allowPasswordUser": { "description": "Whether to allow password account sign up. This field is only returned for authenticated calls from a developer.", "type": "boolean" }, "idpConfig": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1IdpConfig" }, "description": "OAuth2 provider config. This field is only returned for authenticated calls from a developer.", "type": "array" }, "dynamicLinksDomain": { "description": "The Firebase Dynamic Links domain used to construct links for redirects to native apps.", "type": "string" }, "changeEmailTemplate": { "description": "Email template for change email. This field is only returned for authenticated calls from a developer.", "$ref": "GoogleCloudIdentitytoolkitV1EmailTemplate" }, "useEmailSending": { "description": "Whether to use email sending. This field is only returned for authenticated calls from a developer.", "type": "boolean" }, "projectId": { "description": "The project id of the retrieved configuration.", "type": "string" }, "authorizedDomains": { "description": "Authorized domains for widget redirect.", "type": "array", "items": { "type": "string" } }, "verifyEmailTemplate": { "description": "Email template for verify email. This field is only returned for authenticated calls from a developer.", "$ref": "GoogleCloudIdentitytoolkitV1EmailTemplate" } } }, "GoogleCloudIdentitytoolkitV1EmailTemplate": { "properties": { "replyTo": { "description": "Reply-to address", "type": "string" }, "format": { "enum": [ "EMAIL_BODY_FORMAT_UNSPECIFIED", "PLAINTEXT", "HTML" ], "enumDescriptions": [ "Default value. Do not use.", "Email body is in plain text format.", "Email body is in HTML format." ], "description": "Email body format", "type": "string" }, "customized": { "description": "Whether the body or subject of the email is customized.", "type": "boolean" }, "body": { "description": "Email body", "type": "string" }, "locale": { "description": "Value is in III language code format (e.g. \"zh-CN\", \"es\"). Both '-' and '_' separators are accepted.", "type": "string" }, "subject": { "description": "Subject of the email", "type": "string" }, "fromLocalPart": { "description": "Local part of From address", "type": "string" }, "fromDisplayName": { "description": "From display name", "type": "string" }, "disabled": { "description": "Whether the template is disabled. If true, a default template will be used.", "type": "boolean" }, "from": { "description": "From address of the email", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1EmailTemplate", "description": "Email template", "type": "object" }, "GoogleCloudIdentitytoolkitV1GetAccountInfoResponse": { "id": "GoogleCloudIdentitytoolkitV1GetAccountInfoResponse", "description": "Response message for GetAccountInfo.", "type": "object", "properties": { "kind": { "deprecated": true, "type": "string" }, "users": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1UserInfo" }, "description": "The information of specific user account(s) matching the parameters in the request.", "type": "array" } } }, "GoogleCloudIdentitytoolkitV1SignInWithPasswordRequest": { "properties": { "password": { "description": "Required. The password the user provides to sign in to the account.", "type": "string" }, "idToken": { "type": "string", "deprecated": true }, "email": { "description": "Required. The email the user is signing in with. The length of email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production.", "type": "string" }, "returnSecureToken": { "description": "Should always be true.", "type": "boolean" }, "recaptchaVersion": { "description": "The reCAPTCHA version of the reCAPTCHA token in the captcha_response.", "type": "string", "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" ], "enumDescriptions": [ "The reCAPTCHA version is not specified.", "The reCAPTCHA enterprise." ] }, "delegatedProjectNumber": { "deprecated": true, "type": "string", "format": "int64" }, "pendingIdToken": { "deprecated": true, "type": "string" }, "captchaResponse": { "description": "The reCAPTCHA token provided by the reCAPTCHA client-side integration. reCAPTCHA Enterprise uses it for risk assessment. Required when reCAPTCHA Enterprise is enabled.", "type": "string" }, "instanceId": { "deprecated": true, "type": "string" }, "captchaChallenge": { "type": "string", "deprecated": true }, "clientType": { "enumDescriptions": [ "Client type is not specified.", "Client type is web.", "Client type is android.", "Client type is ios." ], "enum": [ "CLIENT_TYPE_UNSPECIFIED", "CLIENT_TYPE_WEB", "CLIENT_TYPE_ANDROID", "CLIENT_TYPE_IOS" ], "description": "The client type, web, android or ios. Required when reCAPTCHA Enterprise is enabled.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform instance in the project.", "type": "string" } }, "description": "Request message for SignInWithPassword.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SignInWithPasswordRequest" }, "GoogleCloudIdentitytoolkitV1TotpInfo": { "properties": {}, "description": "Information about TOTP MFA.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1TotpInfo" }, "GoogleCloudIdentitytoolkitV1CreateAuthUriRequest": { "description": "Request message for CreateAuthUri.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1CreateAuthUriRequest", "properties": { "providerId": { "description": "The provider ID of the IdP for the user to sign in with. This should be a provider ID enabled for sign-in, which is either from the list of [default supported IdPs](https://cloud.google.com/identity-platform/docs/reference/rest/v2/defaultSupportedIdps/list), or of the format `oidc.*` or `saml.*`. Some examples are `google.com`, `facebook.com`, `oidc.testapp`, and `saml.testapp`. At least one of the fields `identifier` and `provider_id` must be set.", "type": "string" }, "hostedDomain": { "description": "Used for the Google provider. The G Suite hosted domain of the user in order to restrict sign-in to users at that domain.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant to create an authorization URI or lookup an email identifier for. If not set, the operation will be performed in the default Identity Platform instance in the project.", "type": "string" }, "oauthScope": { "description": "Additional space-delimited OAuth 2.0 scopes specifying the scope of the authentication request with the IdP. Used for OAuth 2.0 IdPs. For the Google provider, the authorization code flow will be used if this field is set.", "type": "string" }, "appId": { "type": "string", "deprecated": true }, "context": { "description": "An opaque string used to maintain contextual information between the authentication request and the callback from the IdP.", "type": "string" }, "openidRealm": { "deprecated": true, "type": "string" }, "authFlowType": { "description": "Used for the Google provider. The type of the authentication flow to be used. If present, this should be `CODE_FLOW` to specify the authorization code flow. Otherwise, the default ID Token flow will be used.", "type": "string" }, "otaApp": { "type": "string", "deprecated": true }, "customParameter": { "additionalProperties": { "type": "string" }, "description": "Additional customized query parameters to be added to the authorization URI. The following parameters are reserved and cannot be added: `client_id`, `response_type`, `scope`, `redirect_uri`, `state`. For the Microsoft provider, the Azure AD tenant to sign-in to can be specified in the `tenant` custom parameter.", "type": "object" }, "continueUri": { "description": "A valid URL for the IdP to redirect the user back to. The URL cannot contain fragments or the reserved `state` query parameter.", "type": "string" }, "sessionId": { "description": "A session ID that can be verified against in SignInWithIdp to prevent session fixation attacks. If absent, a random string will be generated and returned as the session ID.", "type": "string" }, "identifier": { "description": "The email identifier of the user account to fetch associated providers for. At least one of the fields `identifier` and `provider_id` must be set. The length of the email address should be less than 256 characters and in the format of `name@domain.tld`. The email address should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production.", "type": "string" }, "oauthConsumerKey": { "type": "string", "deprecated": true } } }, "GoogleCloudIdentitytoolkitV1CreateAuthUriResponse": { "description": "Response message for CreateAuthUri.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1CreateAuthUriResponse", "properties": { "signinMethods": { "description": "The list of sign-in methods that the user has previously used. Each element is one of `password`, `emailLink`, or the provider ID of an IdP. Present only when a registered email identifier is set in the request. If [email enumeration protection](https://cloud.google.com/identity-platform/docs/admin/email-enumeration-protection) is enabled, this method returns an empty list.", "type": "array", "items": { "type": "string" } }, "sessionId": { "description": "The session ID from the request, or a random string generated by CreateAuthUri if absent. It is used to prevent session fixation attacks.", "type": "string" }, "allProviders": { "type": "array", "items": { "type": "string" }, "deprecated": true }, "forExistingProvider": { "description": "Whether the user has previously signed in with the provider ID in the request. Present only when a registered email identifier is set in the request.", "type": "boolean" }, "captchaRequired": { "description": "Whether a CAPTCHA is needed because there have been too many failed login attempts by the user. Present only when a registered email identifier is set in the request.", "type": "boolean" }, "authUri": { "description": "The authorization URI for the requested provider. Present only when a provider ID is set in the request.", "type": "string" }, "providerId": { "description": "The provider ID from the request, if provided.", "type": "string" }, "registered": { "description": "Whether the email identifier represents an existing account. Present only when an email identifier is set in the request.", "type": "boolean" }, "kind": { "deprecated": true, "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SignInWithIdpResponse": { "description": "Response message for SignInWithIdp.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SignInWithIdpResponse", "properties": { "timeZone": { "description": "The time zone for the user's account at the IdP.", "type": "string" }, "errorMessage": { "description": "The error message returned if `return_idp_credential` is set to `true` and either the `FEDERATED_USER_ID_ALREADY_LINKED` or `EMAIL_EXISTS` error is encountered. This field's value is either `FEDERATED_USER_ID_ALREADY_LINKED` or `EMAIL_EXISTS`.", "type": "string" }, "providerId": { "description": "The provider ID of the IdP that the user is signing in to. Always present in the response.", "type": "string" }, "firstName": { "description": "The first name for the user's account at the IdP.", "type": "string" }, "kind": { "deprecated": true, "type": "string" }, "tenantId": { "description": "The value of the `tenant_id` field in the request.", "type": "string" }, "email": { "description": "The email address of the user's account at the IdP.", "type": "string" }, "oauthTokenSecret": { "description": "The OAuth 1.0 token secret from the IdP, if available. Only present for the Twitter provider.", "type": "string" }, "refreshToken": { "description": "An Identity Platform refresh token for the authenticated user.", "type": "string" }, "screenName": { "description": "The screen name for the user's account at the Twitter IdP or the login name for the user's account at the GitHub IdP.", "type": "string" }, "context": { "description": "The opaque string set in CreateAuthUri that is used to maintain contextual information between the authentication request and the callback from the IdP.", "type": "string" }, "oauthAccessToken": { "description": "The OAuth access token from the IdP, if available.", "type": "string" }, "displayName": { "description": "The display name for the user's account at the IdP.", "type": "string" }, "oauthRefreshToken": { "description": "The OAuth 2.0 refresh token from the IdP, if available and `return_refresh_token` is set to `true`.", "type": "string" }, "oauthIdToken": { "description": "The OpenID Connect ID token from the IdP, if available.", "type": "string" }, "rawUserInfo": { "description": "The stringified JSON response containing all the data corresponding to the user's account at the IdP.", "type": "string" }, "dateOfBirth": { "description": "The date of birth for the user's account at the IdP.", "type": "string" }, "idToken": { "description": "An Identity Platform ID token for the authenticated user.", "type": "string" }, "federatedId": { "description": "The user's account ID at the IdP. Always present in the response.", "type": "string" }, "originalEmail": { "description": "The main (top-level) email address of the user's Identity Platform account, if different from the email address at the IdP. Only present if the \"One account per email address\" setting is enabled.", "type": "string" }, "verifiedProvider": { "items": { "type": "string" }, "description": "A list of provider IDs that the user can sign in to in order to resolve a `need_confirmation` error. Only present if `need_confirmation` is set to `true`.", "type": "array" }, "mfaPendingCredential": { "description": "An opaque string that functions as proof that the user has successfully passed the first factor authentication.", "type": "string" }, "needEmail": { "deprecated": true, "type": "boolean" }, "emailVerified": { "description": "Whether the user account's email address is verified.", "type": "boolean" }, "emailRecycled": { "description": "Whether or not there is an existing Identity Platform user account with the same email address but linked to a different account at the same IdP. Only present if the \"One account per email address\" setting is enabled and the email address at the IdP is verified.", "type": "boolean" }, "inputEmail": { "type": "string", "deprecated": true }, "needConfirmation": { "description": "Whether or not there is an existing Identity Platform user account with the same email address as the current account signed in at the IdP, and the account's email address is not verified at the IdP. The user will need to sign in to the existing Identity Platform account and then link the current credential from the IdP to it. Only present if the \"One account per email address\" setting is enabled.", "type": "boolean" }, "localId": { "description": "The ID of the authenticated Identity Platform user. Always present in the response.", "type": "string" }, "fullName": { "description": "The full name for the user's account at the IdP.", "type": "string" }, "isNewUser": { "description": "Whether or not a new Identity Platform account was created for the authenticated user.", "type": "boolean" }, "nickName": { "description": "The nickname for the user's account at the IdP.", "type": "string" }, "pendingToken": { "description": "An opaque string that can be used as a credential from the IdP the user is signing into. The pending token obtained here can be set in a future SignInWithIdp request to sign the same user in with the IdP again.", "type": "string" }, "oauthExpireIn": { "description": "The number of seconds until the OAuth access token from the IdP expires.", "type": "integer", "format": "int32" }, "oauthAuthorizationCode": { "description": "The OAuth 2.0 authorization code, if available. Only present for the Google provider.", "type": "string" }, "language": { "description": "The language preference for the user's account at the IdP.", "type": "string" }, "mfaInfo": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" }, "description": "Info on which multi-factor authentication providers are enabled for the account. Present if the user needs to complete the sign-in using multi-factor authentication.", "type": "array" }, "lastName": { "description": "The last name for the user's account at the IdP.", "type": "string" }, "expiresIn": { "description": "The number of seconds until the Identity Platform ID token expires.", "type": "string", "format": "int64" }, "photoUrl": { "description": "The URL of the user's profile picture at the IdP.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1OpenIdConnectKey": { "properties": { "use": { "description": "Key use.", "type": "string" }, "n": { "description": "Modulus for the RSA public key, it is represented as the base64url encoding of the value's big endian representation.", "type": "string" }, "kid": { "description": "Unique string to identify this key.", "type": "string" }, "kty": { "description": "Key type.", "type": "string" }, "alg": { "description": "Signature algorithm.", "type": "string" }, "e": { "description": "Exponent for the RSA public key, it is represented as the base64url encoding of the value's big endian representation.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1OpenIdConnectKey", "description": "Represents a public key of the session cookie signer, formatted as a [JSON Web Key (JWK)](https://tools.ietf.org/html/rfc7517).", "type": "object" }, "GoogleCloudIdentitytoolkitV1VerifyIosClientRequest": { "id": "GoogleCloudIdentitytoolkitV1VerifyIosClientRequest", "description": "Request message for VerifyIosClient", "type": "object", "properties": { "appToken": { "description": "A device token that the iOS client gets after registering to APNs (Apple Push Notification service).", "type": "string" }, "isSandbox": { "description": "Whether the app token is in the iOS sandbox. If false, the app token is in the production environment.", "type": "boolean" } } }, "GoogleCloudIdentitytoolkitV1SignInWithIdpRequest": { "properties": { "returnSecureToken": { "description": "Should always be true.", "type": "boolean" }, "pendingToken": { "description": "An opaque string from a previous SignInWithIdp response. If set, it can be used to repeat the sign-in operation from the previous SignInWithIdp operation. This may be present if the user needs to confirm their account information as part of a previous federated login attempt, or perform account linking.", "type": "string" }, "sessionId": { "description": "The session ID returned from a previous CreateAuthUri call. This field is verified against that session ID to prevent session fixation attacks. Required if the user is signing in with an authorization response from a previous CreateAuthUri authorization request.", "type": "string" }, "delegatedProjectNumber": { "type": "string", "format": "int64", "deprecated": true }, "autoCreate": { "type": "boolean", "deprecated": true }, "requestUri": { "description": "Required. The URL to which the IdP redirects the user back. This can be set to `http://localhost` if the user is signing in with a manually provided IdP credential.", "type": "string" }, "postBody": { "description": "If the user is signing in with an authorization response obtained via a previous CreateAuthUri authorization request, this is the body of the HTTP POST callback from the IdP, if present. Otherwise, if the user is signing in with a manually provided IdP credential, this should be a URL-encoded form that contains the credential (e.g. an ID token or access token for OAuth 2.0 IdPs) and the provider ID of the IdP that issued the credential. For example, if the user is signing in to the Google provider using a Google ID token, this should be set to id_token`=[GOOGLE_ID_TOKEN]&providerId=google.com`, where `[GOOGLE_ID_TOKEN]` should be replaced with the Google ID token. If the user is signing in to the Facebook provider using a Facebook authentication token, this should be set to id_token`=[FACEBOOK_AUTHENTICATION_TOKEN]&providerId=facebook. com&nonce= [NONCE]`, where `[FACEBOOK_AUTHENTICATION_TOKEN]` should be replaced with the Facebook authentication token. Nonce is required for validating the token. The request will fail if no nonce is provided. If the user is signing in to the Facebook provider using a Facebook access token, this should be set to access_token`=[FACEBOOK_ACCESS_TOKEN]&providerId=facebook. com`, where `[FACEBOOK_ACCESS_TOKEN]` should be replaced with the Facebook access token. If the user is signing in to the Twitter provider using a Twitter OAuth 1.0 credential, this should be set to access_token`=[TWITTER_ACCESS_TOKEN]&oauth_token_secret= [TWITTER_TOKEN_SECRET]&providerId=twitter.com`, where `[TWITTER_ACCESS_TOKEN]` and `[TWITTER_TOKEN_SECRET]` should be replaced with the Twitter OAuth access token and Twitter OAuth token secret respectively.", "type": "string" }, "idToken": { "description": "A valid Identity Platform ID token. If passed, the user's account at the IdP will be linked to the account represented by this ID token.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform project.", "type": "string" }, "pendingIdToken": { "type": "string", "deprecated": true }, "returnIdpCredential": { "description": "Whether or not to return OAuth credentials from the IdP on the following errors: `FEDERATED_USER_ID_ALREADY_LINKED` and `EMAIL_EXISTS`.", "type": "boolean" }, "returnRefreshToken": { "description": "Whether or not to return the OAuth refresh token from the IdP, if available.", "type": "boolean" } }, "id": "GoogleCloudIdentitytoolkitV1SignInWithIdpRequest", "description": "Request message for SignInWithIdp.", "type": "object" }, "GoogleCloudIdentitytoolkitV1QueryUserInfoRequest": { "properties": { "expression": { "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1SqlExpression" } }, "offset": { "description": "The number of accounts to skip from the beginning of matching records. Only valid when `return_user_info` is set to `true`.", "type": "string", "format": "int64" }, "order": { "type": "string", "enum": [ "ORDER_UNSPECIFIED", "ASC", "DESC" ], "enumDescriptions": [ "Order is not specified.", "Sort on ascending order.", "Sort on descending order." ] }, "returnUserInfo": { "description": "If `true`, this request will return the accounts matching the query. If `false`, only the __count__ of accounts matching the query will be returned. Defaults to `true`.", "type": "boolean" }, "sortBy": { "enum": [ "SORT_BY_FIELD_UNSPECIFIED", "USER_ID", "NAME", "CREATED_AT", "LAST_LOGIN_AT", "USER_EMAIL" ], "enumDescriptions": [ "Sort field is not specified.", "Sort result by userId.", "Sort result by name.", "Sort result by createdAt.", "Sort result by lastLoginAt.", "Sort result by userEmail." ], "type": "string" }, "limit": { "description": "The maximum number of accounts to return with an upper limit of __500__. Defaults to _500_. Only valid when `return_user_info` is set to `true`.", "type": "string", "format": "int64" }, "tenantId": { "description": "The ID of the tenant to which the result is scoped.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1QueryUserInfoRequest", "description": "Request message for QueryUserInfo.", "type": "object" }, "GoogleCloudIdentitytoolkitV1GetRecaptchaParamResponse": { "description": "Response message for GetRecaptchaParam.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1GetRecaptchaParamResponse", "properties": { "recaptchaSiteKey": { "description": "The reCAPTCHA v2 site key used to invoke the reCAPTCHA service. Always present.", "type": "string" }, "kind": { "type": "string", "deprecated": true }, "recaptchaStoken": { "type": "string", "deprecated": true }, "producerProjectNumber": { "description": "The producer project number used to generate PIA tokens", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberRequest": { "id": "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberRequest", "description": "Request message for SignInWithPhoneNumber.", "type": "object", "properties": { "sessionInfo": { "description": "Encrypted session information from the response of sendVerificationCode. In the case of authenticating with an SMS code this must be specified, but in the case of using a temporary proof it can be unspecified.", "type": "string" }, "temporaryProof": { "description": "A proof of the phone number verification, provided from a previous signInWithPhoneNumber request. If this is passed, the caller must also pass in the phone_number field the phone number that was verified in the previous request.", "type": "string" }, "code": { "description": "User-entered verification code from an SMS sent to the user's phone.", "type": "string" }, "idToken": { "description": "A valid ID token for an Identity Platform account. If passed, this request will link the phone number to the user represented by this ID token if the phone number is not in use, or will reauthenticate the user if the phone number is already linked to the user.", "type": "string" }, "operation": { "enum": [ "VERIFY_OP_UNSPECIFIED", "SIGN_UP_OR_IN", "REAUTH", "UPDATE", "LINK" ], "deprecated": true, "enumDescriptions": [ "Operation is not specified.", "Verify operation is to sign up/sign in.", "Verify operation is to reauth.", "Verify operation is to update.", "Verify operation is to link." ], "type": "string" }, "phoneNumber": { "description": "The user's phone number to sign in with. This is necessary in the case of uing a temporary proof, in which case it must match the phone number that was authenticated in the request that generated the temporary proof. This field is ignored if a session info is passed.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform project.", "type": "string" }, "verificationProof": { "description": "Do not use.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1DeleteAccountRequest": { "properties": { "idToken": { "description": "The Identity Platform ID token of the account to delete. Require to be specified for requests from end users that lack Google OAuth 2.0 credential. Authenticated requests bearing a Google OAuth2 credential with proper permissions may pass local_id to specify the account to delete alternatively.", "type": "string" }, "localId": { "description": "The ID of user account to delete. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control). Requests from users lacking the credential should pass an ID token instead.", "type": "string" }, "delegatedProjectNumber": { "deprecated": true, "type": "string", "format": "int64" }, "tenantId": { "description": "The ID of the tenant that the account belongs to, if applicable. Only require to be specified for authenticated requests bearing a Google OAuth 2.0 credential that specify local_id of an account that belongs to an Identity Platform tenant.", "type": "string" }, "targetProjectId": { "description": "The ID of the project which the account belongs to. Should only be specified in authenticated requests that specify local_id of an account.", "type": "string" } }, "description": "Request message for DeleteAccount.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1DeleteAccountRequest" }, "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenResponse": { "id": "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenResponse", "description": "Response message for SignInWithCustomToken.", "type": "object", "properties": { "refreshToken": { "description": "An Identity Platform refresh token for the authenticated user.", "type": "string" }, "idToken": { "description": "An Identity Platform ID token for the authenticated user.", "type": "string" }, "isNewUser": { "description": "Whether the authenticated user was created by this request.", "type": "boolean" }, "kind": { "type": "string", "deprecated": true }, "expiresIn": { "description": "The number of seconds until the ID token expires.", "type": "string", "format": "int64" } } }, "GoogleCloudIdentitytoolkitV1Argon2Parameters": { "id": "GoogleCloudIdentitytoolkitV1Argon2Parameters", "description": "The parameters for Argon2 hashing algorithm.", "type": "object", "properties": { "memoryCostKib": { "description": "Required. The memory cost in kibibytes. Maximum is 32768.", "type": "integer", "format": "int32" }, "hashLengthBytes": { "description": "Required. The desired hash length in bytes. Minimum is 4 and maximum is 1024.", "type": "integer", "format": "int32" }, "parallelism": { "description": "Required. The degree of parallelism, also called threads or lanes. Minimum is 1, maximum is 16.", "type": "integer", "format": "int32" }, "hashType": { "description": "Required. Must not be HASH_TYPE_UNSPECIFIED.", "type": "string", "enumDescriptions": [ "The hash type is not specified.", "An Argon2 variant, Argon2d.", "An Argon2 variant, Argonid. Recommended.", "An Argon2 variant, Argon2i." ], "enum": [ "HASH_TYPE_UNSPECIFIED", "ARGON2_D", "ARGON2_ID", "ARGON2_I" ] }, "iterations": { "description": "Required. The number of iterations to perform. Minimum is 1, maximum is 16.", "type": "integer", "format": "int32" }, "version": { "description": "The version of the Argon2 algorithm. This defaults to VERSION_13 if not specified.", "type": "string", "enum": [ "VERSION_UNSPECIFIED", "VERSION_10", "VERSION_13" ], "enumDescriptions": [ "The version is not specified.", "The previous version, 0x10.", "The current version, 0x13. The default value for version." ] }, "associatedData": { "description": "The additional associated data, if provided, is appended to the hash value to provide an additional layer of security. A base64-encoded string if specified via JSON.", "type": "string", "format": "byte" } } }, "GoogleCloudIdentitytoolkitV1VerifyIosClientResponse": { "id": "GoogleCloudIdentitytoolkitV1VerifyIosClientResponse", "description": "Response message for VerifyIosClient.", "type": "object", "properties": { "receipt": { "description": "Receipt of successful app token validation.", "type": "string" }, "suggestedTimeout": { "description": "Suggested time that the client should wait in seconds for delivery of the push notification.", "type": "string", "format": "int64" } } }, "GoogleCloudIdentitytoolkitV1MfaFactor": { "properties": { "displayName": { "description": "Display name for this mfa option e.g. \"corp cell phone\".", "type": "string" }, "phoneInfo": { "description": "Phone number to receive OTP for MFA.", "type": "string" } }, "type": "object", "id": "GoogleCloudIdentitytoolkitV1MfaFactor" }, "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsRequest": { "properties": { "localIds": { "description": "Required. List of user IDs to be deleted.", "type": "array", "items": { "type": "string" } }, "tenantId": { "description": "If the accounts belong to an Identity Platform tenant, the ID of the tenant. If the accounts belong to a default Identity Platform project, the field is not needed.", "type": "string" }, "force": { "description": "Whether to force deleting accounts that are not in disabled state. If false, only disabled accounts will be deleted, and accounts that are not disabled will be added to the `errors`.", "type": "boolean" } }, "description": "Request message for BatchDeleteAccounts.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsRequest" }, "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenRequest": { "id": "GoogleCloudIdentitytoolkitV1SignInWithCustomTokenRequest", "description": "Request message for SignInWithCustomToken.", "type": "object", "properties": { "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to. If present, the ID should match the tenant_id in the token.", "type": "string" }, "returnSecureToken": { "description": "Should always be true.", "type": "boolean" }, "delegatedProjectNumber": { "deprecated": true, "type": "string", "format": "int64" }, "instanceId": { "deprecated": true, "type": "string" }, "token": { "description": "Required. The custom Auth token asserted by the developer. The token should be a [JSON Web Token (JWT)](https://tools.ietf.org/html/rfc7519) that includes the claims listed in the [API reference](https://cloud.google.com/identity-platform/docs/reference/rest/client/) under the \"Custom Token Claims\" section.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1UserNotification": { "properties": { "notificationCode": { "enumDescriptions": [ "No notification specified.", "Password missing lowercase character.", "Password missing uppercase character.", "Password missing numeric character.", "Password missing non alphanumeric character.", "Password less than minimum required length.", "Password greater than maximum required length." ], "enum": [ "NOTIFICATION_CODE_UNSPECIFIED", "MISSING_LOWERCASE_CHARACTER", "MISSING_UPPERCASE_CHARACTER", "MISSING_NUMERIC_CHARACTER", "MISSING_NON_ALPHANUMERIC_CHARACTER", "MINIMUM_PASSWORD_LENGTH", "MAXIMUM_PASSWORD_LENGTH" ], "description": "Warning notification enum. Can be used for localization.", "type": "string" }, "notificationMessage": { "description": "Warning notification string. Can be used as fallback.", "type": "string" } }, "description": "Warning notifications for the user.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1UserNotification" }, "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberResponse": { "properties": { "verificationProofExpiresIn": { "description": "Do not use.", "type": "string", "format": "int64" }, "temporaryProofExpiresIn": { "description": "The number of seconds until the temporary proof expires.", "type": "string", "format": "int64" }, "localId": { "description": "The id of the authenticated user. Present in the case of a successful authentication. In the case when the phone could be verified but the account operation could not be performed, a temporary proof will be returned instead.", "type": "string" }, "idToken": { "description": "Identity Platform ID token for the authenticated user.", "type": "string" }, "isNewUser": { "description": "Whether the authenticated user was created by this request.", "type": "boolean" }, "refreshToken": { "description": "Refresh token for the authenticated user.", "type": "string" }, "temporaryProof": { "description": "A proof of the phone number verification, provided if a phone authentication is successful but the user operation fails. This happens when the request tries to link a phone number to a user with an ID token or reauthenticate with an ID token but the phone number is linked to a different user.", "type": "string" }, "verificationProof": { "description": "Do not use.", "type": "string" }, "expiresIn": { "description": "The number of seconds until the ID token expires.", "type": "string", "format": "int64" }, "phoneNumber": { "description": "Phone number of the authenticated user. Always present in the response.", "type": "string" } }, "description": "Response message for SignInWithPhoneNumber.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SignInWithPhoneNumberResponse" }, "GoogleCloudIdentitytoolkitV1SignInWithPasswordResponse": { "id": "GoogleCloudIdentitytoolkitV1SignInWithPasswordResponse", "description": "Response message for SignInWithPassword.", "type": "object", "properties": { "oauthAccessToken": { "deprecated": true, "description": "The OAuth2 access token.", "type": "string" }, "refreshToken": { "description": "An Identity Platform refresh token for the authenticated user.", "type": "string" }, "email": { "description": "The email of the authenticated user. Always present in the response.", "type": "string" }, "kind": { "type": "string", "deprecated": true }, "localId": { "description": "The ID of the authenticated user. Always present in the response.", "type": "string" }, "profilePicture": { "description": "The user's profile picture stored in the account's attributes.", "type": "string" }, "expiresIn": { "description": "The number of seconds until the Identity Platform ID token expires.", "type": "string", "format": "int64" }, "mfaPendingCredential": { "description": "An opaque string that functions as proof that the user has successfully passed the first factor authentication.", "type": "string" }, "userNotifications": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1UserNotification" }, "description": "Warning notifications for the user.", "type": "array" }, "idToken": { "description": "An Identity Platform ID token for the authenticated user.", "type": "string" }, "mfaInfo": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" }, "description": "Info on which multi-factor authentication providers are enabled for the account. Present if the user needs to complete the sign-in using multi-factor authentication.", "type": "array" }, "oauthAuthorizationCode": { "type": "string", "deprecated": true }, "registered": { "deprecated": true, "description": "Whether the email is for an existing account. Always true.", "type": "boolean" }, "oauthExpireIn": { "deprecated": true, "description": "The access token expiration time in seconds.", "type": "integer", "format": "int32" }, "displayName": { "description": "The user's display name stored in the account's attributes.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1GetAccountInfoRequest": { "properties": { "phoneNumber": { "description": "The phone number of one or more accounts to fetch. Should only be specified by authenticated requests from a developer and should be in E.164 format, for example, +15555555555.", "type": "array", "items": { "type": "string" } }, "targetProjectId": { "description": "The ID of the Google Cloud project that the account or the Identity Platform tenant specified by `tenant_id` belongs to. Should only be specified by authenticated requests bearing a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "string" }, "delegatedProjectNumber": { "type": "string", "format": "int64", "deprecated": true }, "idToken": { "description": "The Identity Platform ID token of the account to fetch. Require to be specified for requests from end users.", "type": "string" }, "email": { "description": "The email address of one or more accounts to fetch. The length of email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production. Should only be specified by authenticated requests from a developer.", "type": "array", "items": { "type": "string" } }, "federatedUserId": { "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1FederatedUserIdentifier" } }, "initialEmail": { "items": { "type": "string" }, "description": "The initial email of one or more accounts to fetch. The length of email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production. Should only be specified by authenticated requests from a developer.", "type": "array" }, "tenantId": { "description": "The ID of the tenant that the account belongs to. Should only be specified by authenticated requests from a developer.", "type": "string" }, "localId": { "description": "The ID of one or more accounts to fetch. Should only be specified by authenticated requests bearing a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "array", "items": { "type": "string" } } }, "description": "Request message for GetAccountInfo.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1GetAccountInfoRequest" }, "GoogleCloudIdentitytoolkitV1SqlExpression": { "description": "Query conditions used to filter results.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SqlExpression", "properties": { "userId": { "description": "A string that the account's local ID should match. Only one of `email`, `phone_number`, or `user_id` should be specified in a SqlExpression If more than one is specified, only the first (in that order) will be applied.", "type": "string" }, "phoneNumber": { "description": "A string that the account's phone number should match. Only one of `email`, `phone_number`, or `user_id` should be specified in a SqlExpression. If more than one is specified, only the first (in that order) will be applied.", "type": "string" }, "email": { "description": "A case insensitive string that the account's email should match. Only one of `email`, `phone_number`, or `user_id` should be specified in a SqlExpression. If more than one is specified, only the first (in that order) will be applied.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1DeleteAccountResponse": { "description": "Response message for DeleteAccount.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1DeleteAccountResponse", "properties": { "kind": { "deprecated": true, "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SetAccountInfoRequest": { "id": "GoogleCloudIdentitytoolkitV1SetAccountInfoRequest", "description": "Request message for SetAccountInfo.", "type": "object", "properties": { "emailVerified": { "description": "Whether the user's email has been verified. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "type": "boolean" }, "customAttributes": { "description": "JSON formatted custom attributes to be stored in the Identity Platform ID token. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "type": "string" }, "instanceId": { "deprecated": true, "type": "string" }, "localId": { "description": "The ID of the user. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control). For requests from end-users, an ID token should be passed instead.", "type": "string" }, "deleteProvider": { "items": { "type": "string" }, "description": "The Identity Providers to unlink from the user's account.", "type": "array" }, "password": { "description": "The user's new password to be updated in the account's attributes. The password must be at least 6 characters long.", "type": "string" }, "linkProviderUserInfo": { "description": "The provider to be linked to the user's account. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "$ref": "GoogleCloudIdentitytoolkitV1ProviderUserInfo" }, "lastLoginAt": { "description": "The timestamp in milliseconds when the account last logged in.", "type": "string", "format": "int64" }, "deleteAttribute": { "type": "array", "items": { "type": "string", "enum": [ "USER_ATTRIBUTE_NAME_UNSPECIFIED", "EMAIL", "DISPLAY_NAME", "PROVIDER", "PHOTO_URL", "PASSWORD", "RAW_USER_INFO" ], "enumDescriptions": [ "User attribute name is not specified.", "User attribute key name is email.", "User attribute key name is displayName.", "User attribute key name is provider.", "User attribute key name is photoURL.", "User attribute key name is password.", "User attribute key name is rawUserInfo." ] } }, "mfa": { "description": "The multi-factor authentication related information to be set on the user's account. This will overwrite any previous multi-factor related information on the account. Specifying this field requires a Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control).", "$ref": "GoogleCloudIdentitytoolkitV1MfaInfo" }, "delegatedProjectNumber": { "deprecated": true, "type": "string", "format": "int64" }, "targetProjectId": { "description": "The project ID for the project that the account belongs to. Specifying this field requires Google OAuth 2.0 credential with proper [permissions] (https://cloud.google.com/identity-platform/docs/access-control). Requests from end users should pass an Identity Platform ID token instead.", "type": "string" }, "photoUrl": { "description": "The user's new photo URL for the account's profile photo to be updated in the account's attributes. The length of the URL must be less than or equal to 2048 characters.", "type": "string" }, "captchaResponse": { "description": "The response from reCaptcha challenge. This is required when the system detects possible abuse activities.", "type": "string" }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant that the account belongs to. Requests from end users should pass an Identity Platform ID token rather than setting this field.", "type": "string" }, "email": { "description": "The user's new email to be updated in the account's attributes. The length of email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production. If [email enumeration protection](https://cloud.google.com/identity-platform/docs/admin/email-enumeration-protection) is enabled, the email cannot be changed by the user without verifying the email first, but it can be changed by an administrator.", "type": "string" }, "disableUser": { "description": "If true, marks the account as disabled, meaning the user will no longer be able to sign-in.", "type": "boolean" }, "validSince": { "description": "Specifies the minimum timestamp in seconds for an Identity Platform ID token to be considered valid.", "type": "string", "format": "int64" }, "createdAt": { "description": "The timestamp in milliseconds when the account was created.", "type": "string", "format": "int64" }, "phoneNumber": { "description": "The phone number to be updated in the account's attributes.", "type": "string" }, "returnSecureToken": { "description": "Whether or not to return an ID and refresh token. Should always be true.", "type": "boolean" }, "displayName": { "description": "The user's new display name to be updated in the account's attributes. The length of the display name must be less than or equal to 256 characters.", "type": "string" }, "provider": { "items": { "type": "string" }, "description": "The Identity Providers that the account should be associated with.", "type": "array" }, "upgradeToFederatedLogin": { "description": "Whether the account should be restricted to only using federated login.", "type": "boolean" }, "captchaChallenge": { "deprecated": true, "type": "string" }, "oobCode": { "description": "The out-of-band code to be applied on the user's account. The following out-of-band code types are supported: * VERIFY_EMAIL * RECOVER_EMAIL * REVERT_SECOND_FACTOR_ADDITION * VERIFY_AND_CHANGE_EMAIL", "type": "string" }, "idToken": { "description": "A valid Identity Platform ID token. Required when attempting to change user-related information.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1GetOobCodeResponse": { "properties": { "oobCode": { "description": "If return_oob_link is true in the request, the OOB code to send.", "type": "string" }, "kind": { "type": "string", "deprecated": true }, "oobLink": { "description": "If return_oob_link is true in the request, the OOB link to be sent to the user. This returns the constructed link including [Firebase Dynamic Link](https://firebase.google.com/docs/dynamic-links) related parameters.", "type": "string" }, "email": { "description": "If return_oob_link is false in the request, the email address the verification was sent to.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1GetOobCodeResponse", "description": "Response message for GetOobCode.", "type": "object" }, "GoogleCloudIdentitytoolkitV1BatchDeleteErrorInfo": { "properties": { "index": { "description": "The index of the errored item in the original local_ids field.", "type": "integer", "format": "int32" }, "localId": { "description": "The corresponding user ID.", "type": "string" }, "message": { "description": "Detailed error message.", "type": "string" } }, "description": "Error info for account failed to be deleted.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1BatchDeleteErrorInfo" }, "GoogleCloudIdentitytoolkitV1ResetPasswordResponse": { "properties": { "requestType": { "type": "string", "enumDeprecated": [ false, false, true, true, false, true, false, false, true ], "enum": [ "OOB_REQ_TYPE_UNSPECIFIED", "PASSWORD_RESET", "OLD_EMAIL_AGREE", "NEW_EMAIL_ACCEPT", "VERIFY_EMAIL", "RECOVER_EMAIL", "EMAIL_SIGNIN", "VERIFY_AND_CHANGE_EMAIL", "REVERT_SECOND_FACTOR_ADDITION" ], "enumDescriptions": [ "Oob code type is not specified.", "reset password", "", "", "verify the account's email address by sending an email", "", "sign in with email only", "This flow sends an email to the specified new email, and when applied by clicking the link in the email changes the account's email to the new email. Used when the account must have verified email at all times, such as MFA accounts.", "" ] }, "kind": { "deprecated": true, "type": "string" }, "mfaInfo": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" }, "email": { "description": "The email associated with the out-of-band code that was used.", "type": "string" }, "newEmail": { "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1ResetPasswordResponse", "description": "Response message for ResetPassword.", "type": "object" }, "GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest": { "properties": { "captchaResponse": { "description": "Optional. The reCAPTCHA Enterprise token provided by the reCAPTCHA client-side integration. Required when reCAPTCHA enterprise is enabled.", "type": "string" }, "iosReceipt": { "description": "Receipt of successful iOS app token validation. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). This should come from the response of verifyIosClient. If present, the caller should also provide the `ios_secret`, as well as a bundle ID in the `x-ios-bundle-identifier` header, which must match the bundle ID from the verifyIosClient request.", "type": "string" }, "clientType": { "description": "Optional. The client type, web, android or ios. Required when reCAPTCHA Enterprise is enabled.", "type": "string", "enumDescriptions": [ "Client type is not specified.", "Client type is web.", "Client type is android.", "Client type is ios." ], "enum": [ "CLIENT_TYPE_UNSPECIFIED", "CLIENT_TYPE_WEB", "CLIENT_TYPE_ANDROID", "CLIENT_TYPE_IOS" ] }, "safetyNetToken": { "description": "Android only. Safety Net has been deprecated. Use play_integrity_token instead.", "type": "string" }, "tenantId": { "description": "Tenant ID of the Identity Platform tenant the user is signing in to.", "type": "string" }, "iosSecret": { "description": "Secret delivered to iOS app as a push notification. Should be passed with an `ios_receipt` as well as the `x-ios-bundle-identifier` header.", "type": "string" }, "recaptchaToken": { "description": "Recaptcha token for app verification. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). The recaptcha should be generated by calling getRecaptchaParams and the recaptcha token will be generated on user completion of the recaptcha challenge.", "type": "string" }, "autoRetrievalInfo": { "description": "Android only. Used by Google Play Services to identify the app for auto-retrieval.", "$ref": "GoogleCloudIdentitytoolkitV1AutoRetrievalInfo" }, "recaptchaVersion": { "description": "Optional. The reCAPTCHA version of the reCAPTCHA token in the captcha_response. Required when reCAPTCHA Enterprise is enabled.", "type": "string", "enumDescriptions": [ "The reCAPTCHA version is not specified.", "The reCAPTCHA enterprise." ], "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" ] }, "phoneNumber": { "description": "The phone number to send the verification code to in E.164 format.", "type": "string" }, "playIntegrityToken": { "description": "Android only. Used to assert application identity in place of a recaptcha token (and safety_net_token). At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, , or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). A Play Integrity Token can be generated via the [PlayIntegrity API](https://developer.android.com/google/play/integrity) with applying SHA256 to the `phone_number` field as the nonce.", "type": "string" } }, "description": "Request message for SendVerificationCode. 'captcha_response' is required when reCAPTCHA enterprise is enabled, or otherwise at least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest" }, "GoogleCloudIdentitytoolkitV1MfaEnrollment": { "properties": { "displayName": { "description": "Display name for this mfa option e.g. \"corp cell phone\".", "type": "string" }, "totpInfo": { "description": "Contains information specific to TOTP MFA.", "$ref": "GoogleCloudIdentitytoolkitV1TotpInfo" }, "enrolledAt": { "description": "Timestamp when the account enrolled this second factor.", "type": "string", "format": "google-datetime" }, "unobfuscatedPhoneInfo": { "readOnly": true, "description": "Output only. Unobfuscated phone_info.", "type": "string" }, "emailInfo": { "description": "Contains information specific to email MFA.", "$ref": "GoogleCloudIdentitytoolkitV1EmailInfo" }, "mfaEnrollmentId": { "description": "ID of this MFA option.", "type": "string" }, "phoneInfo": { "description": "Normally this will show the phone number associated with this enrollment. In some situations, such as after a first factor sign in, it will only show the obfuscated version of the associated phone number.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1MfaEnrollment", "description": "Information on which multi-factor authentication (MFA) providers are enabled for an account.", "type": "object" }, "GoogleCloudIdentitytoolkitV1SignUpResponse": { "properties": { "refreshToken": { "description": "An Identity Platform refresh token for the created user. This field is only set for non-admin requests.", "type": "string" }, "email": { "description": "The created user's email.", "type": "string" }, "idToken": { "description": "An Identity Platform ID token for the created user. This field is only set for non-admin requests.", "type": "string" }, "displayName": { "description": "The created user's display name.", "type": "string" }, "kind": { "type": "string" }, "expiresIn": { "description": "The number of seconds until the ID token expires.", "type": "string", "format": "int64" }, "localId": { "description": "The ID of the created user. Always present in the response.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1SignUpResponse", "description": "Response message for SignUp.", "type": "object" }, "GoogleCloudIdentitytoolkitV1SendVerificationCodeResponse": { "properties": { "sessionInfo": { "description": "Encrypted session information. This can be used in signInWithPhoneNumber to authenticate the phone number.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1SendVerificationCodeResponse", "description": "Response message for SendVerificationCode.", "type": "object" }, "GoogleCloudIdentitytoolkitV1IssueSamlResponseRequest": { "id": "GoogleCloudIdentitytoolkitV1IssueSamlResponseRequest", "description": "Request message for IssueSamlResponse.", "type": "object", "properties": { "samlAppEntityId": { "description": "SAML app entity id specified in Google Admin Console for each app. If developers want to redirect to a third-party app rather than a G Suite app, they'll probably they need this. When it's used, we'll return a RelayState. This includes a SAMLRequest, which can be used to trigger a SP-initiated SAML flow to redirect to the real app.", "type": "string" }, "rpId": { "description": "Relying Party identifier, which is the audience of issued SAMLResponse.", "type": "string" }, "idToken": { "description": "The Identity Platform ID token. It will be verified and then converted to a new SAMLResponse.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1UploadAccountResponse": { "description": "Response message for UploadAccount.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1UploadAccountResponse", "properties": { "kind": { "type": "string", "deprecated": true }, "error": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1ErrorInfo" }, "description": "Detailed error info for accounts that cannot be uploaded.", "type": "array" } } }, "GoogleCloudIdentitytoolkitV1UploadAccountRequest": { "properties": { "users": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1UserInfo" }, "description": "A list of accounts to upload. `local_id` is required for each user; everything else is optional.", "type": "array" }, "argon2Parameters": { "description": "The parameters for Argon2 hashing algorithm.", "$ref": "GoogleCloudIdentitytoolkitV1Argon2Parameters" }, "hashAlgorithm": { "description": "Required. The hashing function used to hash the account passwords. Must be one of the following: * HMAC_SHA256 * HMAC_SHA1 * HMAC_MD5 * SCRYPT * PBKDF_SHA1 * MD5 * HMAC_SHA512 * SHA1 * BCRYPT * PBKDF2_SHA256 * SHA256 * SHA512 * STANDARD_SCRYPT * ARGON2", "type": "string" }, "allowOverwrite": { "description": "Whether to overwrite an existing account in Identity Platform with a matching `local_id` in the request. If true, the existing account will be overwritten. If false, an error will be returned.", "type": "boolean" }, "sanityCheck": { "description": "If true, the service will do the following list of checks before an account is uploaded: * Duplicate emails * Duplicate federated IDs * Federated ID provider validation If the duplication exists within the list of accounts to be uploaded, it will prevent the entire list from being uploaded. If the email or federated ID is a duplicate of a user already within the project/tenant, the account will not be uploaded, but the rest of the accounts will be unaffected. If false, these checks will be skipped.", "type": "boolean" }, "tenantId": { "description": "The ID of the Identity Platform tenant the account belongs to.", "type": "string" }, "rounds": { "description": "The number of rounds used for hash calculation. Only required for the following hashing functions: * MD5 * SHA1 * SHA256 * SHA512 * PBKDF_SHA1 * PBKDF2_SHA256 * SCRYPT", "type": "integer", "format": "int32" }, "memoryCost": { "description": "Memory cost for hash calculation. Only required when the hashing function is SCRYPT.", "type": "integer", "format": "int32" }, "signerKey": { "description": "The signer key used to hash the password. Required for the following hashing functions: * SCRYPT, * HMAC_MD5, * HMAC_SHA1, * HMAC_SHA256, * HMAC_SHA512", "type": "string", "format": "byte" }, "delegatedProjectNumber": { "type": "string", "format": "int64", "deprecated": true }, "passwordHashOrder": { "type": "string", "enum": [ "UNSPECIFIED_ORDER", "SALT_AND_PASSWORD", "PASSWORD_AND_SALT" ], "enumDescriptions": [ "The order is not specified.", "The order is salt first, and then password.", "The order is password first, and then salt." ] }, "cpuMemCost": { "description": "The CPU memory cost parameter to be used by the STANDARD_SCRYPT hashing function. This parameter, along with block_size and cpu_mem_cost help tune the resources needed to hash a password, and should be tuned as processor speeds and memory technologies advance.", "type": "integer", "format": "int32" }, "saltSeparator": { "description": "One or more bytes to be inserted between the salt and plain text password. For stronger security, this should be a single non-printable character.", "type": "string", "format": "byte" }, "parallelization": { "description": "The parallelization cost parameter to be used by the STANDARD_SCRYPT hashing function. This parameter, along with block_size and cpu_mem_cost help tune the resources needed to hash a password, and should be tuned as processor speeds and memory technologies advance.", "type": "integer", "format": "int32" }, "blockSize": { "description": "The block size parameter used by the STANDARD_SCRYPT hashing function. This parameter, along with parallelization and cpu_mem_cost help tune the resources needed to hash a password, and should be tuned as processor speeds and memory technologies advance.", "type": "integer", "format": "int32" }, "dkLen": { "description": "The desired key length for the STANDARD_SCRYPT hashing function. Must be at least 1.", "type": "integer", "format": "int32" } }, "description": "Request message for UploadAccount.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1UploadAccountRequest" }, "GoogleCloudIdentitytoolkitV1MfaInfo": { "properties": { "enrollments": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" }, "description": "The second factors the user has enrolled.", "type": "array" } }, "id": "GoogleCloudIdentitytoolkitV1MfaInfo", "description": "Multi-factor authentication related information.", "type": "object" }, "GoogleCloudIdentitytoolkitV1FederatedUserIdentifier": { "description": "Federated user identifier at an Identity Provider.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1FederatedUserIdentifier", "properties": { "providerId": { "description": "The ID of supported identity providers. This should be a provider ID enabled for sign-in, which is either from the list of [default supported IdPs](https://cloud.google.com/identity-platform/docs/reference/rest/v2/defaultSupportedIdps/list), or of the format `oidc.*` or `saml.*`. Some examples are `google.com`, `facebook.com`, `oidc.testapp`, and `saml.testapp`.", "type": "string" }, "rawId": { "description": "The user ID of the account at the third-party Identity Provider specified by `provider_id`.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SetAccountInfoResponse": { "id": "GoogleCloudIdentitytoolkitV1SetAccountInfoResponse", "description": "Response message for SetAccountInfo", "type": "object", "properties": { "kind": { "deprecated": true, "type": "string" }, "localId": { "description": "The ID of the authenticated user.", "type": "string" }, "passwordHash": { "deprecated": true, "description": "Deprecated. No actual password hash is currently returned.", "type": "string" }, "displayName": { "deprecated": true, "description": "The account's display name.", "type": "string" }, "emailVerified": { "description": "Whether the account's email has been verified.", "type": "boolean" }, "providerUserInfo": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1ProviderUserInfo" }, "description": "The linked Identity Providers on the account.", "type": "array" }, "newEmail": { "description": "The new email that has been set on the user's account attributes.", "type": "string" }, "photoUrl": { "description": "The user's photo URL for the account's profile photo.", "type": "string", "deprecated": true }, "expiresIn": { "description": "The number of seconds until the Identity Platform ID token expires.", "type": "string", "format": "int64" }, "refreshToken": { "description": "A refresh token for the account. This is used for legacy user sign up.", "type": "string" }, "idToken": { "description": "An Identity Platform ID token for the account. This is used for legacy user sign up.", "type": "string" }, "email": { "deprecated": true, "description": "The account's email address.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsResponse": { "properties": { "errors": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1BatchDeleteErrorInfo" }, "description": "Detailed error info for accounts that cannot be deleted.", "type": "array" } }, "description": "Response message to BatchDeleteAccounts.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1BatchDeleteAccountsResponse" }, "GoogleCloudIdentitytoolkitV1QueryUserInfoResponse": { "properties": { "recordsCount": { "description": "If `return_user_info` in the request is true, this is the number of returned accounts in this message. Otherwise, this is the total number of accounts matching the query.", "type": "string", "format": "int64" }, "userInfo": { "description": "If `return_user_info` in the request is true, this is the accounts matching the query.", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1UserInfo" } } }, "description": "Response message for QueryUserInfo.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1QueryUserInfoResponse" }, "GoogleCloudIdentitytoolkitV1DownloadAccountResponse": { "id": "GoogleCloudIdentitytoolkitV1DownloadAccountResponse", "description": "Response message for DownloadAccount.", "type": "object", "properties": { "kind": { "deprecated": true, "type": "string" }, "users": { "description": "All accounts belonging to the project/tenant limited by max_results in the request.", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1UserInfo" } }, "nextPageToken": { "description": "If there are more accounts to be downloaded, a token that can be passed back to DownloadAccount to get more accounts. Otherwise, this is blank.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1ErrorInfo": { "id": "GoogleCloudIdentitytoolkitV1ErrorInfo", "description": "Error information explaining why an account cannot be uploaded. batch upload.", "type": "object", "properties": { "index": { "description": "The index of the item, range is [0, request.size - 1]", "type": "integer", "format": "int32" }, "message": { "description": "Detailed error message", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1CreateSessionCookieRequest": { "properties": { "idToken": { "description": "Required. A valid Identity Platform ID token.", "type": "string" }, "validDuration": { "description": "The number of seconds until the session cookie expires. Specify a duration in seconds, between five minutes and fourteen days, inclusively.", "type": "string", "format": "int64" }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant the account belongs to.", "type": "string" } }, "description": "Request message for CreateSessionCookie.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1CreateSessionCookieRequest" }, "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkResponse": { "properties": { "refreshToken": { "description": "Refresh token for the authenticated user.", "type": "string" }, "email": { "description": "The email the user signed in with. Always present in the response.", "type": "string" }, "idToken": { "description": "An Identity Platform ID token for the authenticated user.", "type": "string" }, "isNewUser": { "description": "Whether the authenticated user was created by this request.", "type": "boolean" }, "expiresIn": { "description": "The number of seconds until the ID token expires.", "type": "string", "format": "int64" }, "mfaPendingCredential": { "description": "An opaque string that functions as proof that the user has successfully passed the first factor check.", "type": "string" }, "kind": { "type": "string", "deprecated": true }, "mfaInfo": { "description": "Info on which multi-factor authentication providers are enabled. Present if the user needs to complete the sign-in using multi-factor authentication.", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" } }, "localId": { "description": "The ID of the authenticated user. Always present in the response.", "type": "string" } }, "description": "Response message for SignInWithEmailLink.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkResponse" }, "GoogleCloudIdentitytoolkitV1ResetPasswordRequest": { "id": "GoogleCloudIdentitytoolkitV1ResetPasswordRequest", "description": "Request message for ResetPassword.", "type": "object", "properties": { "tenantId": { "description": "Optional. The tenant ID of the Identity Platform tenant the account belongs to.", "type": "string" }, "oobCode": { "description": "An out-of-band (OOB) code generated by GetOobCode request. Specify only this parameter (or only this parameter and a tenant ID) to get the out-of-band code's type in the response without mutating the account's state. Only a PASSWORD_RESET out-of-band code can be consumed via this method.", "type": "string" }, "newPassword": { "description": "The new password to be set for this account. Specifying this field will result in a change to the account and consume the out-of-band code if one was specified and it was of type PASSWORD_RESET.", "type": "string" }, "oldPassword": { "description": "The current password of the account to be modified. Specify this and email to change an account's password without using an out-of-band code.", "type": "string" }, "email": { "description": "Optional. The email of the account to be modified. Specify this and the old password in order to change an account's password without using an out-of-band code.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SignUpRequest": { "id": "GoogleCloudIdentitytoolkitV1SignUpRequest", "description": "Request message for SignUp.", "type": "object", "properties": { "captchaResponse": { "description": "The reCAPTCHA token provided by the reCAPTCHA client-side integration. reCAPTCHA Enterprise uses it for assessment. Required when reCAPTCHA enterprise is enabled.", "type": "string" }, "instanceId": { "deprecated": true, "type": "string" }, "clientType": { "description": "The client type: web, Android or iOS. Required when enabling reCAPTCHA enterprise protection.", "type": "string", "enumDescriptions": [ "Client type is not specified.", "Client type is web.", "Client type is android.", "Client type is ios." ], "enum": [ "CLIENT_TYPE_UNSPECIFIED", "CLIENT_TYPE_WEB", "CLIENT_TYPE_ANDROID", "CLIENT_TYPE_IOS" ] }, "emailVerified": { "description": "Whether the user's email is verified. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "boolean" }, "tenantId": { "description": "The ID of the Identity Platform tenant to create a user under. If not set, the user will be created under the default Identity Platform project.", "type": "string" }, "localId": { "description": "The ID of the user to create. The ID must be unique within the project that the user is being created under. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "string" }, "password": { "description": "The password to assign to the created user. The password must be be at least 6 characters long. If set, the `email` field must also be set.", "type": "string" }, "email": { "description": "The email to assign to the created user. The length of the email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production. An anonymous user will be created if not provided.", "type": "string" }, "phoneNumber": { "description": "The phone number of the user to create. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "string" }, "displayName": { "description": "The display name of the user to be created.", "type": "string" }, "captchaChallenge": { "type": "string", "deprecated": true }, "mfaInfo": { "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaFactor" }, "description": "The multi-factor authentication providers for the user to create.", "type": "array" }, "idToken": { "description": "A valid ID token for an Identity Platform user. If set, this request will link the authentication credential to the user represented by this ID token. For a non-admin request, both the `email` and `password` fields must be set. For an admin request, `local_id` must not be set.", "type": "string" }, "targetProjectId": { "description": "The project ID of the project which the user should belong to. Specifying this field requires a Google OAuth 2.0 credential with the proper [permissions](https://cloud.google.com/identity-platform/docs/access-control). If this is not set, the target project is inferred from the scope associated to the Bearer access token.", "type": "string" }, "photoUrl": { "description": "The profile photo url of the user to create.", "type": "string" }, "recaptchaVersion": { "enumDescriptions": [ "The reCAPTCHA version is not specified.", "The reCAPTCHA enterprise." ], "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" ], "description": "The reCAPTCHA version of the reCAPTCHA token in the captcha_response.", "type": "string" }, "disabled": { "description": "Whether the user will be disabled upon creation. Disabled accounts are inaccessible except for requests bearing a Google OAuth2 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "boolean" } } }, "GoogleCloudIdentitytoolkitV1UserInfo": { "properties": { "language": { "description": "Output only. The language preference of the account. This account attribute is not used by Identity Platform. It is available for informational purposes only.", "type": "string", "readOnly": true }, "passwordUpdatedAt": { "description": "The timestamp, in milliseconds from the epoch of 1970-01-01T00:00:00Z, when the account's password was last updated.", "type": "number", "format": "double" }, "mfaInfo": { "description": "Information on which multi-factor authentication providers are enabled for this account.", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1MfaEnrollment" } }, "lastLoginAt": { "description": "The last time, in milliseconds from epoch, this account was logged into.", "type": "string", "format": "int64" }, "photoUrl": { "description": "The URL of the account's profile photo. This account attribute is not used by Identity Platform. It is available for informational purposes only.", "type": "string" }, "localId": { "description": "Immutable. The unique ID of the account.", "type": "string" }, "passwordHash": { "description": "The account's hashed password. Only accessible by requests bearing a Google OAuth2 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "string", "format": "byte" }, "emailVerified": { "description": "Whether the account's email address has been verified.", "type": "boolean" }, "customAttributes": { "description": "Custom claims to be added to any ID tokens minted for the account. Should be at most 1,000 characters in length and in valid JSON format.", "type": "string" }, "initialEmail": { "description": "The first email address associated with this account. The account's initial email cannot be changed once set and is used to recover access to this account if lost via the RECOVER_EMAIL flow in GetOobCode. Should match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec.", "type": "string" }, "dateOfBirth": { "description": "Output only. The date of birth set for the account. This account attribute is not used by Identity Platform. It is available for informational purposes only.", "type": "string", "readOnly": true }, "salt": { "description": "The account's password salt. Only accessible by requests bearing a Google OAuth2 credential with proper permissions.", "type": "string", "format": "byte" }, "customAuth": { "description": "Output only. Whether this account has been authenticated using SignInWithCustomToken.", "type": "boolean", "readOnly": true }, "lastRefreshAt": { "description": "Timestamp when an ID token was last minted for this account.", "type": "string", "format": "google-datetime" }, "displayName": { "description": "The display name of the account. This account attribute is not used by Identity Platform. It is available for informational purposes only.", "type": "string" }, "disabled": { "description": "Whether the account is disabled. Disabled accounts are inaccessible except for requests bearing a Google OAuth2 credential with proper permissions.", "type": "boolean" }, "tenantId": { "description": "ID of the tenant this account belongs to. Only set if this account belongs to a tenant.", "type": "string" }, "timeZone": { "readOnly": true, "description": "Output only. The time zone preference of the account. This account attribute is not used by Identity Platform. It is available for informational purposes only.", "type": "string" }, "providerUserInfo": { "description": "Information about the user as provided by various Identity Providers.", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1ProviderUserInfo" } }, "phoneNumber": { "description": "The account's phone number.", "type": "string" }, "version": { "description": "The version of the account's password. Only accessible by requests bearing a Google OAuth2 credential with proper permissions.", "type": "integer", "format": "int32" }, "validSince": { "description": "Oldest timestamp, in seconds since epoch, that an ID token should be considered valid. All ID tokens issued before this time are considered invalid.", "type": "string", "format": "int64" }, "createdAt": { "description": "The time, in milliseconds from epoch, when the account was created.", "type": "string", "format": "int64" }, "emailLinkSignin": { "description": "Output only. Whether the account can authenticate with email link.", "type": "boolean", "readOnly": true }, "screenName": { "description": "Output only. This account's screen name at Twitter or login name at GitHub.", "type": "string", "readOnly": true }, "email": { "description": "The account's email address. The length of the email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec.", "type": "string" }, "rawPassword": { "description": "Input only. Plain text password used to update a account's password. This field is only ever used as input in a request. Identity Platform uses cryptographically secure hashing when managing passwords and will never store or transmit a user's password in plain text.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1UserInfo", "description": "An Identity Platform account's information.", "type": "object" }, "GoogleCloudIdentitytoolkitV1CreateSessionCookieResponse": { "properties": { "sessionCookie": { "description": "The session cookie that has been created from the Identity Platform ID token specified in the request. It is in the form of a JSON Web Token (JWT). Always present.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1CreateSessionCookieResponse", "description": "Response message for CreateSessionCookie.", "type": "object" }, "GoogleCloudIdentitytoolkitV1GetOobCodeRequest": { "properties": { "iOSAppStoreId": { "description": "If an associated iOS app can handle the OOB code, the App Store id of this app. This will allow App Store to open to the correct app if the app is not yet installed.", "type": "string" }, "androidMinimumVersion": { "description": "If an associated android app can handle the OOB code, the minimum version of the app. If the version on the device is lower than this version then the user is taken to Google Play Store to upgrade the app.", "type": "string" }, "recaptchaVersion": { "description": "The reCAPTCHA version of the reCAPTCHA token in the captcha_response.", "type": "string", "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" ], "enumDescriptions": [ "The reCAPTCHA version is not specified.", "The reCAPTCHA enterprise." ] }, "userIp": { "description": "The IP address of the caller. Required only for PASSWORD_RESET requests.", "type": "string" }, "targetProjectId": { "description": "The Project ID of the Identity Platform project which the account belongs to. To specify this field, it requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control).", "type": "string" }, "canHandleCodeInApp": { "description": "When set to true, the OOB code link will be be sent as a Universal Link or an Android App Link and will be opened by the corresponding app if installed. If not set, or set to false, the OOB code will be sent to the web widget first and then on continue will redirect to the app if installed.", "type": "boolean" }, "androidPackageName": { "description": "If an associated android app can handle the OOB code, the Android package name of the android app that will handle the callback when this OOB code is used. This will allow the correct app to open if it is already installed, or allow Google Play Store to open to the correct app if it is not yet installed.", "type": "string" }, "idToken": { "description": "An ID token for the account. It is required for VERIFY_AND_CHANGE_EMAIL and VERIFY_EMAIL requests unless return_oob_link is set to true.", "type": "string" }, "requestType": { "description": "Required. The type of out-of-band (OOB) code to send. Depending on this value, other fields in this request will be required and/or have different meanings. There are 4 different OOB codes that can be sent: * PASSWORD_RESET * EMAIL_SIGNIN * VERIFY_EMAIL * VERIFY_AND_CHANGE_EMAIL", "enumDeprecated": [ false, false, true, true, false, true, false, false, true ], "enum": [ "OOB_REQ_TYPE_UNSPECIFIED", "PASSWORD_RESET", "OLD_EMAIL_AGREE", "NEW_EMAIL_ACCEPT", "VERIFY_EMAIL", "RECOVER_EMAIL", "EMAIL_SIGNIN", "VERIFY_AND_CHANGE_EMAIL", "REVERT_SECOND_FACTOR_ADDITION" ], "enumDescriptions": [ "Oob code type is not specified.", "reset password", "", "", "verify the account's email address by sending an email", "", "sign in with email only", "This flow sends an email to the specified new email, and when applied by clicking the link in the email changes the account's email to the new email. Used when the account must have verified email at all times, such as MFA accounts.", "" ], "type": "string" }, "continueUrl": { "description": "The Url to continue after user clicks the link sent in email. This is the url that will allow the web widget to handle the OOB code.", "type": "string" }, "returnOobLink": { "description": "Whether the confirmation link containing the OOB code should be returned in the response (no email is sent). Used when a developer wants to construct the email template and send it on their own. By default this is false; to specify this field, and to set it to true, it requires a Google OAuth 2.0 credential with proper [permissions](https://cloud.google.com/identity-platform/docs/access-control)", "type": "boolean" }, "newEmail": { "description": "The email address the account is being updated to. Required only for VERIFY_AND_CHANGE_EMAIL requests.", "type": "string" }, "iOSBundleId": { "description": "If an associated iOS app can handle the OOB code, the iOS bundle id of this app. This will allow the correct app to open if it is already installed.", "type": "string" }, "linkDomain": { "description": "Optional. In order to ensure that the url used can be easily opened in iOS or Android, we create a Hosting link '/__/auth/links'. This optional field contains the domain to use when constructing a Hosting link. If not set, '.firebaseapp.com' domain will be used.", "type": "string" }, "captchaResp": { "description": "For a PASSWORD_RESET request, a reCaptcha response is required when the system detects possible abuse activity. In those cases, this is the response from the reCaptcha challenge used to verify the caller.", "type": "string" }, "email": { "description": "The account's email address to send the OOB code to, and generally the email address of the account that needs to be updated. Required for PASSWORD_RESET, EMAIL_SIGNIN, and VERIFY_EMAIL. Only required for VERIFY_AND_CHANGE_EMAIL requests when return_oob_link is set to true. In this case, it is the original email of the user.", "type": "string" }, "dynamicLinkDomain": { "description": "In order to ensure that the url used can be easily opened up in iOS or android, we create a [Firebase Dynamic Link](https://firebase.google.com/docs/dynamic-links). Most Identity Platform projects will only have one Dynamic Link domain enabled, and can leave this field blank. This field contains a specified Dynamic Link domain for projects that have multiple enabled.", "type": "string" }, "challenge": { "deprecated": true, "type": "string" }, "tenantId": { "description": "The tenant ID of the Identity Platform tenant the account belongs to.", "type": "string" }, "androidInstallApp": { "description": "If an associated android app can handle the OOB code, whether or not to install the android app on the device where the link is opened if the app is not already installed.", "type": "boolean" }, "clientType": { "enumDescriptions": [ "Client type is not specified.", "Client type is web.", "Client type is android.", "Client type is ios." ], "enum": [ "CLIENT_TYPE_UNSPECIFIED", "CLIENT_TYPE_WEB", "CLIENT_TYPE_ANDROID", "CLIENT_TYPE_IOS" ], "description": "The client type: web, Android or iOS. Required when reCAPTCHA Enterprise protection is enabled.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1GetOobCodeRequest", "description": "Request message for GetOobCode.", "type": "object" }, "GoogleCloudIdentitytoolkitV1ProviderUserInfo": { "properties": { "displayName": { "description": "The user's display name at the Identity Provider.", "type": "string" }, "email": { "description": "The user's email address at the Identity Provider.", "type": "string" }, "screenName": { "description": "The user's screen_name at Twitter or login name at GitHub.", "type": "string" }, "federatedId": { "description": "The user's identifier at the Identity Provider.", "type": "string" }, "providerId": { "description": "The ID of the Identity Provider.", "type": "string" }, "photoUrl": { "description": "The user's profile photo URL at the Identity Provider.", "type": "string" }, "rawId": { "description": "The user's raw identifier directly returned from Identity Provider.", "type": "string" }, "phoneNumber": { "description": "The user's phone number at the Identity Provider.", "type": "string" } }, "description": "Information about the user as provided by various Identity Providers.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1ProviderUserInfo" }, "GoogleCloudIdentitytoolkitV1AutoRetrievalInfo": { "properties": { "appSignatureHash": { "description": "The Android app's signature hash for Google Play Service's SMS Retriever API.", "type": "string" } }, "id": "GoogleCloudIdentitytoolkitV1AutoRetrievalInfo", "description": "The information required to auto-retrieve an SMS.", "type": "object" }, "GoogleCloudIdentitytoolkitV1SignInWithGameCenterRequest": { "id": "GoogleCloudIdentitytoolkitV1SignInWithGameCenterRequest", "description": "Request message for SignInWithGameCenter", "type": "object", "properties": { "publicKeyUrl": { "description": "Required. The URL to fetch the Apple public key in order to verify the given signature is signed by Apple.", "type": "string" }, "displayName": { "description": "The user's Game Center display name.", "type": "string" }, "teamPlayerId": { "description": "The user's Game Center team player ID. A unique identifier for a player of all the games that you distribute using your developer account. https://developer.apple.com/documentation/gamekit/gkplayer/3174857-teamplayerid", "type": "string" }, "salt": { "description": "Required. A random string used to generate the given signature.", "type": "string" }, "playerId": { "description": "Required. The user's Game Center player ID. Deprecated by Apple. Pass `playerID` along with `gamePlayerID` and `teamPlayerID` to initiate the migration of a user's Game Center player ID to `gamePlayerID`.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to.", "type": "string" }, "gamePlayerId": { "description": "The user's Game Center game player ID. A unique identifier for a player of the game. https://developer.apple.com/documentation/gamekit/gkplayer/3113960-gameplayerid", "type": "string" }, "idToken": { "description": "A valid ID token for an Identity Platform account. If present, this request will link the Game Center player ID to the account represented by this ID token.", "type": "string" }, "timestamp": { "description": "Required. The time when the signature was created by Apple, in milliseconds since the epoch.", "type": "string", "format": "int64" }, "signature": { "description": "Required. The verification signature data generated by Apple.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkRequest": { "description": "Request message for SignInWithEmailLink", "type": "object", "id": "GoogleCloudIdentitytoolkitV1SignInWithEmailLinkRequest", "properties": { "oobCode": { "description": "Required. The out-of-band code from the email link.", "type": "string" }, "tenantId": { "description": "The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform project.", "type": "string" }, "idToken": { "description": "A valid ID token for an Identity Platform account. If passed, this request will link the email address to the user represented by this ID token and enable sign-in with email link on the account for the future.", "type": "string" }, "email": { "description": "Required. The email address the sign-in link was sent to. The length of email should be less than 256 characters and in the format of `name@domain.tld`. The email should also match the [RFC 822](https://tools.ietf.org/html/rfc822) addr-spec production.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1IdpConfig": { "properties": { "provider": { "enum": [ "PROVIDER_UNSPECIFIED", "MSLIVE", "GOOGLE", "FACEBOOK", "PAYPAL", "TWITTER", "YAHOO", "AOL", "GITHUB", "GOOGLE_PLAY_GAMES", "LINKEDIN", "IOS_GAME_CENTER" ], "enumDescriptions": [ "", "Microsoft Live as identity provider.", "Google as identity provider.", "Facebook as identity provider.", "PayPal as identity provider.", "Twitter as identity provider.", "Yahoo as identity provider.", "AOL as identity provider.", "GitHub as identity provider.", "Google Play Games as identity provider.", "LinkedIn as identity provider.", "iOS Game Center as identity provider." ], "type": "string" }, "clientId": { "description": "OAuth2 client ID.", "type": "string" }, "secret": { "description": "OAuth2 client secret.", "type": "string" }, "whitelistedAudiences": { "items": { "type": "string" }, "description": "Whitelisted client IDs for audience check.", "type": "array" }, "enabled": { "description": "True if allows the user to sign in with the provider.", "type": "boolean" }, "experimentPercent": { "description": "Percent of users who will be prompted/redirected federated login for this IdP", "type": "integer", "format": "int32" } }, "description": "Config of an identity provider.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1IdpConfig" }, "GoogleCloudIdentitytoolkitV1EmailInfo": { "description": "Information about email MFA.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1EmailInfo", "properties": { "emailAddress": { "description": "Email address that a MFA verification should be sent to.", "type": "string" } } }, "GoogleCloudIdentitytoolkitV1IssueSamlResponseResponse": { "properties": { "samlResponse": { "description": "Signed SAMLResponse created for the Relying Party.", "type": "string" }, "isNewUser": { "description": "Whether the logged in user was created by this request.", "type": "boolean" }, "relayState": { "description": "Generated RelayState.", "type": "string" }, "email": { "description": "Email of the user.", "type": "string" }, "acsEndpoint": { "description": "The ACS endpoint which consumes the returned SAMLResponse.", "type": "string" }, "firstName": { "description": "First name of the user.", "type": "string" }, "lastName": { "description": "Last name of the user.", "type": "string" } }, "description": "Response for IssueSamlResponse request.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1IssueSamlResponseResponse" }, "GoogleCloudIdentitytoolkitV1GetSessionCookiePublicKeysResponse": { "description": "Response message for GetSessionCookiePublicKeys.", "type": "object", "id": "GoogleCloudIdentitytoolkitV1GetSessionCookiePublicKeysResponse", "properties": { "keys": { "description": "Public keys of the session cookie signer, formatted as [JSON Web Keys (JWK)](https://tools.ietf.org/html/rfc7517).", "type": "array", "items": { "$ref": "GoogleCloudIdentitytoolkitV1OpenIdConnectKey" } } } } }, "revision": "20260511" }