Method: accounts.update

특정 필드를 설정하거나 작업 코드를 적용하여 지정된 사용자의 계정 관련 정보를 업데이트합니다. 관리자 및 최종 사용자의 요청이 지원됩니다.

HTTP 요청

POST https://identitytoolkit.googleapis.com/v1/accounts:update

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "idToken": string,
  "localId": string,
  "displayName": string,
  "email": string,
  "password": string,
  "provider": [
    string
  ],
  "oobCode": string,
  "emailVerified": boolean,
  "upgradeToFederatedLogin": boolean,
  "captchaChallenge": string,
  "captchaResponse": string,
  "validSince": string,
  "disableUser": boolean,
  "instanceId": string,
  "delegatedProjectNumber": string,
  "photoUrl": string,
  "deleteAttribute": [
    enum (UserAttributeName)
  ],
  "returnSecureToken": boolean,
  "deleteProvider": [
    string
  ],
  "lastLoginAt": string,
  "createdAt": string,
  "phoneNumber": string,
  "customAttributes": string,
  "tenantId": string,
  "targetProjectId": string,
  "mfa": {
    object (MfaInfo)
  },
  "linkProviderUserInfo": {
    object (ProviderUserInfo)
  }
}
필드
idToken

string

유효한 Identity Platform ID 토큰 사용자 관련 정보를 변경하려고 할 때 필요합니다.

localId

string

사용자의 ID입니다. 이 필드를 지정하려면 적절한 권한이 있는 Google OAuth 2.0 사용자 인증 정보가 필요합니다. 최종 사용자의 요청의 경우 ID 토큰을 대신 전달해야 합니다.

displayName

string

계정의 속성에서 업데이트할 사용자의 새 표시 이름입니다. 표시 이름의 길이는 256자(영문 기준) 이하여야 합니다.

email

string

계정의 속성에서 업데이트할 사용자의 새 이메일입니다. 이메일 길이는 256자(영문 기준) 미만이어야 하며 name@domain.tld 형식이어야 합니다. 이메일은 RFC 822 addr-spec 프로덕션과도 일치해야 합니다. 이메일 열거 보호가 사용 설정된 경우 사용자는 먼저 이메일을 인증하지 않고는 이메일을 변경할 수 없지만 관리자는 변경할 수 있습니다.

password

string

계정의 속성에서 업데이트할 사용자의 새 비밀번호입니다. 비밀번호는 6자(영문 기준) 이상이어야 합니다.

provider[]

string

계정을 연결해야 하는 ID 제공업체입니다.

oobCode

string

사용자 계정에 적용할 비표준 코드입니다. 다음의 비표준 코드 유형이 지원됩니다. * VERIFY_EMAIL * RECOVER_EMAIL * REVERT_SECOND_FACTOR_ADDITION * VERIFY_AND_CHANGE_EMAIL

emailVerified

boolean

사용자의 이메일이 확인되었는지 여부입니다. 이 필드를 지정하려면 적절한 권한이 있는 Google OAuth 2.0 사용자 인증 정보가 필요합니다.

upgradeToFederatedLogin

boolean

계정이 제휴 로그인만 사용하도록 제한해야 하는지 여부입니다.

captchaChallenge
(deprecated)

string

captchaResponse

string

reCAPTCHA 테스트의 응답입니다. 시스템에서 악용 가능성이 있는 활동을 감지하는 경우 필요합니다.

validSince

string (int64 format)

Identity Platform ID 토큰이 유효한 것으로 간주되는 최소 타임스탬프(초)를 지정합니다.

disableUser

boolean

true인 경우 계정이 사용 중지된 것으로 표시되므로 사용자는 더 이상 로그인할 수 없습니다.

instanceId
(deprecated)

string

delegatedProjectNumber
(deprecated)

string (int64 format)

photoUrl

string

계정의 속성에서 계정 프로필 사진을 업데이트할 사용자의 새 사진 URL입니다. URL 길이는 2,048자(영문 기준) 이하여야 합니다.

deleteAttribute[]

enum (UserAttributeName)

returnSecureToken

boolean

ID 및 갱신 토큰 반환 여부입니다. 항상 참이어야 합니다.

deleteProvider[]

string

사용자 계정에서 연결 해제할 ID 공급자입니다.

lastLoginAt

string (int64 format)

계정이 마지막으로 로그인한 타임스탬프(밀리초)입니다.

createdAt

string (int64 format)

계정이 생성된 타임스탬프(밀리초)입니다.

phoneNumber

string

계정의 속성에서 업데이트할 전화번호입니다.

customAttributes

string

Identity Platform ID 토큰에 저장할 JSON 형식의 맞춤 속성입니다. 이 필드를 지정하려면 적절한 권한이 있는 Google OAuth 2.0 사용자 인증 정보가 필요합니다.

tenantId

string

계정이 속한 Identity Platform 테넌트의 테넌트 ID입니다. 최종 사용자의 요청은 이 필드를 설정하는 대신 Identity Platform ID 토큰을 전달해야 합니다.

targetProjectId

string

계정이 속한 프로젝트의 프로젝트 ID입니다. 이 필드를 지정하려면 적절한 권한이 있는 Google OAuth 2.0 사용자 인증 정보가 필요합니다. 최종 사용자의 요청은 대신 Identity Platform ID 토큰을 전달해야 합니다.

승인을 처리하려면 지정된 리소스 targetProjectId에 대해 다음과 같은 IAM 권한이 필요합니다.

  • firebaseauth.users.update
mfa

object (MfaInfo)

사용자 계정에 설정할 다중 인증 관련 정보입니다. 이렇게 하면 계정의 이전 다단계 인증 관련 정보가 덮어쓰기됩니다. 이 필드를 지정하려면 적절한 권한이 있는 Google OAuth 2.0 사용자 인증 정보가 필요합니다.

응답 본문

성공한 경우 응답 본문에 SetAccountInfoResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.