색인
Verifications(인터페이스)VoiceOfMerchant(인터페이스)CompleteVerificationRequest(메시지)CompleteVerificationResponse(메시지)ComplyWithGuidelines(메시지)ComplyWithGuidelines.RecommendationReason(열거형)FetchVerificationOptionsRequest(메시지)FetchVerificationOptionsResponse(메시지)GetVoiceOfMerchantStateRequest(메시지)ListVerificationsRequest(메시지)ListVerificationsResponse(메시지)ResolveOwnershipConflict(메시지)ServiceBusinessContext(메시지)Verification(메시지)Verification.State(열거형)VerificationMethod(열거형)VerificationOption(메시지)VerificationOption.AddressVerificationData(메시지)VerificationOption.EmailVerificationData(메시지)VerificationToken(메시지)Verify(메시지)VerifyLocationRequest(메시지)VerifyLocationResponse(메시지)VoiceOfMerchantState(메시지)WaitForVoiceOfMerchant(메시지)
인증
이 API를 사용하면 Google에서의 위치 인증을 관리할 수 있습니다. 이를 통해 [Verification] [google.mybusiness.v1.Verification] 리소스를 관리할 수 있습니다.
각 [Location] [google.mybusiness.businessinformation.locations.v1.Location] 에는 locations/*/verifications/*라는 [인증] [google.mybusiness.verifications] 리소스 컬렉션이 있습니다.
| CompleteVerification |
|---|
|
|
| FetchVerificationOptions |
|---|
|
특정 언어로 된 위치에 대해 요건을 충족하는 모든 인증 옵션을 보고합니다.
|
| ListVerifications |
|---|
|
위치 인증을 생성 시간순으로 나열합니다.
|
| VerifyLocation |
|---|
|
위치 인증 절차를 시작합니다.
|
VoiceOfMerchant
이 서비스를 통해 서드 파티 사용자가 판매자 상태의 음성에 관한 세부정보를 요청할 수 있습니다.
| GetVoiceOfMerchantState |
|---|
|
VoiceOfMerchant 상태를 가져옵니다.
|
CompleteVerificationRequest
Verifications.CompleteVerificationAction 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 완료할 인증의 리소스 이름입니다. |
pin |
필수 항목입니다. 인증을 완료하기 위해 판매자가 받은 PIN 코드입니다. |
CompleteVerificationResponse
Verifications.CompleteVerificationAction의 응답 메시지입니다.
| 필드 | |
|---|---|
verification |
완료된 인증 |
ComplyWithGuidelines
위치가 Google의 가이드라인을 준수하지 않음을 나타냅니다.
| 필드 | |
|---|---|
recommendation_reason |
위치가 가이드라인을 준수하기 위해 추천된 이유입니다. |
RecommendationReason
위치가 ComplyWithGuidelines에 추천된 이유를 나타냅니다.
| 열거형 | |
|---|---|
RECOMMENDATION_REASON_UNSPECIFIED |
지정되지 않음 |
BUSINESS_LOCATION_SUSPENDED |
비즈니스 위치가 정지되었습니다. 이 문제를 해결하려면 고객센터 도움말을 참고하세요. |
BUSINESS_LOCATION_DISABLED |
비즈니스 위치가 사용 중지되었습니다. 이 문제를 해결하려면 고객센터 도움말을 참고하세요. |
FetchVerificationOptionsRequest
Verifications.FetchVerificationOptions 요청 메시지입니다.
| 필드 | |
|---|---|
location |
필수 항목입니다. 인증할 위치입니다. |
language_code |
필수 항목입니다. 인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다. 사용 가능한 옵션은 언어에 따라 다릅니다. |
context |
선택사항입니다. 서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에만 적용할 수 있습니다. 정확한 주소를 지정하면 더 많은 옵션을 사용할 수 있습니다. 다른 비즈니스 유형의 위치에 설정된 경우 INVALID_이(가) 발생합니다. |
FetchVerificationOptionsResponse
Verifications.FetchVerificationOptions의 응답 메시지입니다.
| 필드 | |
|---|---|
options[] |
사용 가능한 인증 옵션입니다. |
GetVoiceOfMerchantStateRequest
VoiceOfMerchant.GetVoiceOfMerchantState 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 위치의 리소스 이름입니다. |
ListVerificationsRequest
Verifications.ListVerifications 요청 메시지입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 인증 요청이 속한 위치의 리소스 이름입니다. |
page_size |
페이지당 포함할 인증 수입니다. 최소는 1, 기본 및 최대 페이지 크기는 100입니다. |
page_token |
지정하면 다음 인증 페이지가 반환됩니다. |
ListVerificationsResponse
Verifications.ListVerifications의 응답 메시지입니다.
| 필드 | |
|---|---|
verifications[] |
인증 목록입니다. |
next_page_token |
인증 수가 요청된 페이지 크기를 초과하면 이 필드는 후속 호출에서 다음 인증 페이지를 가져오는 토큰으로 채워집니다. 속성이 더 이상 없으면 이 필드는 응답에 표시되지 않습니다. |
ResolveOwnershipConflict
이 유형에는 필드가 없습니다.
위치가 양호한 상태인 다른 위치와 중복됨을 나타냅니다.
ServiceBusinessContext
서비스 비즈니스 인증을 위한 추가 데이터입니다.
| 필드 | |
|---|---|
address |
위치의 인증 주소입니다. 인증 옵션을 더 사용하거나 엽서를 보내는 데 사용됩니다. |
인증
인증은 위치에 대한 인증 시도를 나타냅니다.
| 필드 | |
|---|---|
name |
인증의 리소스 이름입니다. |
method |
확인 방법입니다. |
state |
인증 상태입니다. |
create_time |
인증이 요청된 시점의 타임스탬프입니다. |
announcement |
선택사항입니다. 응답 공지는 메서드가 VETTED_PARTNER인 경우에만 설정됩니다. |
상태
가능한 모든 확인 상태입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
기본값으로 사용하면 오류가 발생합니다. |
PENDING |
인증이 대기 중입니다. |
COMPLETED |
인증이 완료되었습니다. |
FAILED |
인증에 실패했습니다. |
VerificationMethod
Google에서 위치를 인증하는 데 사용하는 프로세스를 지정합니다.
| 열거형 | |
|---|---|
VERIFICATION_METHOD_UNSPECIFIED |
기본값으로 사용하면 오류가 발생합니다. |
ADDRESS |
인증 PIN이 포함된 엽서를 특정 우편 주소로 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
EMAIL |
특정 이메일 주소로 인증 PIN이 포함된 이메일을 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
PHONE_CALL |
특정 전화번호로 인증 PIN을 사용하여 전화를 겁니다. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
SMS |
특정 전화번호로 인증 PIN이 포함된 SMS를 보내세요. PIN은 Google에서 인증을 완료하는 데 사용됩니다. |
AUTO |
추가적인 사용자 작업 없이 위치를 인증합니다. 일부 지역에서는 이 옵션을 사용하지 못할 수도 있습니다. |
VETTED_PARTNER |
일부 지역에서는 이 옵션을 사용하지 못할 수도 있습니다. |
VerificationOption
인증 옵션은 위치를 확인하는 방법 (인증 방법으로 표시) 및 인증이 전송될 위치 (표시 데이터로 표시)를 나타냅니다.
| 필드 | |
|---|---|
verification_method |
위치를 확인하는 메서드입니다. |
통합 필드 DisplayData. 디스플레이 데이터 중 하나입니다. 데이터가 메서드와 일치해야 합니다. 상응하는 메서드에 표시 데이터가 없으면 비어 있습니다. DisplayData은 다음 중 하나여야 합니다. |
|
phone_number |
메서드가 PHONE_CALL 또는 SMS인 경우에만 설정합니다. PIN을 받을 전화번호입니다. |
address_data |
메서드가 메일인 경우에만 설정합니다. |
email_data |
메서드가 EMAIL인 경우에만 설정합니다. |
announcement |
메서드가 VETTED_PARTNER인 경우에만 설정됩니다. |
AddressVerificationData
엽서를 통해 인증을 위한 데이터를 표시합니다.
| 필드 | |
|---|---|
business |
판매자의 업체 이름입니다. |
address |
엽서를 받을 수 있는 주소입니다. |
expected_delivery_days_region |
주소의 지역으로 엽서가 배달되기까지 걸리는 예상 기간(일)입니다. |
EmailVerificationData
이메일을 통한 인증을 위한 데이터를 표시합니다.
| 필드 | |
|---|---|
domain |
이메일 주소에 도메인 이름(예: foo@gmail.com의 'gmail.com') |
user |
이메일 주소의 사용자 이름(예: foo@gmail.com의 'foo') |
is_user_name_editable |
클라이언트가 다른 사용자 이름을 제공할 수 있는지 여부입니다. |
VerificationToken
심사를 마친 파트너가 생성한 토큰입니다.
| 필드 | |
|---|---|
token_string |
토큰 문자열입니다. |
확인
위치가 인증이 필요함을 나타냅니다. 현재 위치에서 수행된 인증 작업에 대한 정보가 포함됩니다.
| 필드 | |
|---|---|
has_pending_verification |
인증 절차가 이미 시작되었는지, 위치별로 완료할 수 있는지를 나타냅니다. |
VerifyLocationRequest
Verifications.VerifyLocation 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 확인할 위치의 리소스 이름입니다. |
method |
필수 항목입니다. 확인 방법입니다. |
language_code |
선택사항입니다. 인증 절차에 사용될 언어를 나타내는 BCP 47 언어 코드입니다. |
context |
선택사항입니다. 서비스 비즈니스 인증을 위한 추가 컨텍스트 정보입니다. 비즈니스 유형이 CUSTOMER_LOCATION_ONLY인 위치에만 필요합니다. ADDRESS 인증의 경우 엽서를 발송할 때 주소가 사용됩니다. 다른 메서드의 경우 GetVerificationOptions에 전달되는 것과 동일해야 합니다. INVALID_ 이는 다른 유형의 업체 위치에 대해 설정된 경우 발생합니다. |
통합 필드 RequestData. 표시 데이터 외에 특정 방식에 대한 사용자 입력 데이터입니다. 데이터가 요청된 메서드와 일치해야 합니다. 데이터가 필요하지 않으면 비워 둡니다. RequestData은 다음 중 하나여야 합니다. |
|
email_address |
선택사항입니다. EMAIL 방법에 대한 입력입니다. PIN을 받을 이메일 주소입니다. 이메일 주소는 FetchVerificationOptions에서 제공한 주소 중 하나인 경우에만 허용됩니다. [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] 의 is_user_name_edit이 true로 설정된 경우 클라이언트에서 다른 사용자 이름 (로컬 부분)을 지정할 수 있지만 도메인 이름과 일치해야 합니다. |
mailer_contact |
선택사항입니다. ADDRESS 메서드의 입력입니다. 메일을 받을 연락처 이름입니다. |
phone_number |
선택사항입니다. PHONE_CALL/SMS 메서드에 대한 입력입니다. 전화를 걸거나 SMS를 보낼 전화번호입니다. 지원되는 옵션에 있는 전화번호 중 하나여야 합니다. |
token |
선택사항입니다. 일부 partners.가 사용할 수 있는 VETTED_PARTNER 메서드의 입력입니다. 검증된 계정에는 입력할 필요가 없습니다. 위치에 연결된 토큰입니다. 위치에 연결된 토큰입니다. |
VerifyLocationResponse
Verifications.VerifyLocation의 응답 메시지입니다.
| 필드 | |
|---|---|
verification |
생성된 인증 요청 |
VoiceOfMerchantState
VoiceOfMerchant.GetVoiceOfMerchantState 응답 메시지입니다.
| 필드 | |
|---|---|
has_voice_of_merchant |
위치가 양호한 상태이며 Google에서 비즈니스를 관리하는지 여부를 나타냅니다. 위치에 대한 모든 수정사항은 검토 단계를 통과한 후 지도에 적용됩니다. |
has_business_authority |
위치에 Google에서 비즈니스에 대한 권한 (소유권)이 있는지 여부를 나타냅니다. true인 경우 다른 위치가 인계받아 지도에서 가장 중요한 등록정보가 될 수 없습니다. 하지만 수정사항은 판매자 목소리를 얻지 못한 경우 (즉, has_voice_of_merchant가 true인 경우) 게시되지 않습니다. |
통합 필드 gain_voice_of_merchant_action. Google에서 비즈니스를 관리할 수 있도록 위치에 권장되는 작업입니다. gain_voice_of_merchant_action은 다음 중 하나여야 합니다. |
|
wait_for_voice_of_merchant |
판매자 목소리를 받을 때까지 기다리세요. 품질 관리를 위해 위치를 검토 중입니다. |
verify |
인증 절차를 시작하거나 계속합니다. |
resolve_ownership_conflict |
이 위치는 상태가 양호한 다른 위치와 중복됩니다. 양호한 상태의 위치에 액세스할 수 있는 경우 해당 위치의 ID를 사용하여 작업을 수행합니다. 또는 현재 소유자에게 액세스 권한을 요청하세요. |
comply_with_guidelines |
위치가 Google의 가이드라인을 준수하지 않으며 복구하려면 추가 단계가 필요합니다. 이 문제를 해결하려면 고객센터 도움말을 참고하세요. |
WaitForVoiceOfMerchant
이 유형에는 필드가 없습니다.
검토를 통과한 후 위치가 판매자의 목소리를 얻게 됨을 나타냅니다.