전화 인증

전화 인증은 판매자 계정의 전화번호를 추가하고 인증하는 데 사용할 수 있는 두 가지 계정 방법으로 구성됩니다. 전화 인증을 통해 제출된 전화번호는 accounts.AccountBusinessInformation를 통해 제출한 전화번호를 대체합니다.

전화 인증은 모든 신규 및 기존 판매자에게 적극 권장됩니다. 그렇게 하지 않으면 전화번호를 확인할 때까지 계정 상태 문제 PENDING_PHONE_VERIFICATION로 인해 계정이 정지될 수 있습니다.

전화번호를 인증하려면 두 가지 단계를 거쳐야 합니다.

  1. accounts.requestphoneverification를 호출하여 전화 인증 요청을 시작합니다.
    두 글자로 된 지역 코드를 입력합니다.
    전화번호를 입력합니다.
    확인 방법 (SMS 또는 PHONE_CALL)을 선택합니다.
  2. accounts.verifyphonenumber번으로 전화를 걸어 전화번호를 확인합니다.
    1단계의 verificationId을 입력합니다.
    휴대전화로 전송된 6자리 verificationCode을(를) 입력하세요.
    사용한 phoneVerificationMethod를 입력합니다.
    이 호출은 verifiedPhoneNumber를 반환합니다. 이제 이 전화번호가 확인되었습니다.

AccountBusinessInformation.phoneVerificationStatus에서 계정의 전화 인증 상태를 확인할 수 있습니다.

accounts.requestphoneverification

phoneRegionCode, phoneNumber, phoneVerificationMethod를 accounts.requestphoneverification에 전달하여 전화번호 인증 프로세스를 시작합니다. 이 호출은 verificationId을 반환합니다.

선택사항인 languageCode 필드를 사용하여 기본 언어 (미국 영어)가 아닌 다른 언어로 확인할 수 있습니다.

4시간마다 최대 5회 동일한 전화번호를 인증할 수 있습니다.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

다음은 샘플 호출입니다.

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

다음은 샘플 응답입니다.

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

accounts.requestphoneverification의 verificationId, 휴대전화로 전송된 6자리 verificationCode, 사용한 phoneVerificationMethod(예: SMS)을 accounts.verifyphonenumber에 전달하여 계정의 전화번호를 확인합니다. 이 전화를 받으면 거주 지역의 표준 형식으로 확인된 전화번호가 반환됩니다.

최초 인증 요청은 15분 후에 만료됩니다. 이후에는 accounts.verifyphonenumber를 호출하기 전에 새 전화 인증 요청을 시작해야 합니다.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

다음은 샘플 호출입니다.

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

다음은 샘플 응답입니다.

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

AccountBusinessInformation.phoneVerificationStatus 필드에서 계정의 전화 인증 상태를 확인할 수 있습니다.

accounts.get 메서드를 accountId 및 merchantId와 함께 호출하여 계정의 비즈니스 정보를 확인합니다.

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId