Notice : 20.328 이후에 작성되는 Google 마이 비즈니스 API 관련글들은 Google Developers 사이트 https://developers.google.com/my-business/content/prereqs#get-account 의 안내 순서에 따라 작성합니다. 

전제 조건

첫 번째 클라이언트 애플리케이션을 작성하려면 다음 전제 조건을 완료해야합니다.

1. Google 계정을 만드십시오 .
2. Google 마이 비즈니스를 사용해보십시오 .
3. Google API Console에서 프로젝트를 만듭니다 .
4. API에 대한 액세스 권한을 요청하십시오 .

Google 계정 얻기

Google API Console에서 프로젝트를 만들려면 Google 계정 이 필요합니다 . 이미 계정이 있다면 모든 준비가 완료된 것입니다.

Google 마이 비즈니스 사용해보기

이 API 설명서에서는 이전에 Google 마이 비즈니스를 사용해 왔으며 웹 프로그래밍 개념 및 웹 데이터 형식에 익숙하다고 가정합니다.

Google 마이 비즈니스를 사용하지 않은 경우 코딩을 시작하기 전에 사용자 인터페이스 를 사용해보십시오 . 

저희는 구글 지역 정보 대행사를 하고 있으므로 사용자 인터페이스는 눈을 감고도 할 수 있으므로 패스하겠습니다. 

Google API Console에서 프로젝트 만들기

Google My Business API로 요청을 보내려면 Google API Console을 사용하여 프로젝트를 만든 다음 해당 프로젝트의 Google My Business API에 대한 액세스 권한을 요청해야합니다. 

구글 API 사용법은 다음과 같은 절차로 진행이 됩니다.( 구글 API 사용법, 키 발급, OAuth 인증 방법 정리 ). Google API Console에서 프로젝트 만들기는 “1. 구글 API 콘솔에서 프로젝트 생성”에 해당합니다. 

새 프로젝트를 만들려면 Google API 콘솔 로 이동하십시오 . 프로젝트 생성을 클릭 하고 이름을 입력한 후 생성을 클릭 하십시오 .

이 부분은 아래의 게시글을 참조하시면서 같이 정리해 주세요. 

Google Apps 로그인 플러그인( Google Apps Login plugin) : [기초]구글 API 사용법

새 프로젝트 만들기

Google Developers Console 의 맨 위에 있는 프로젝트 선택 드롭 다운 상자 (이 드롭 다운에 기존 프로젝트의 이름이 표시 될 수 있음)를 클릭하시고 프로젝트 만들기 … 또는 표시된 항목에 따라 ‘새 프로젝트‘을 클릭합니다.

최상위 조직의 조직 드롭 다운 메뉴를 그대로 둘 수 있습니다.(위치를 조직 없음으로 해도 됩니다. )

표시되는 상자에 원하는 이름 (예 : 프로젝트명, 웹 사이트 이름)을 입력 한 다음 [만들기] 에 동의하기 전에 [동의] 함 확인란을 선택 하십시오 .( Google에서 확인 전화 또는 SMS를 받아야 할 수도 있습니다. )

• • 그런 다음 새로 만든 프로젝트를 클릭하면 새로 만든 프로젝트 세부 정보가 표시됩니다.( Then click on the Newly Created Project and you will find your newly created project details there.)

•  
  • 왼쪽 메뉴에서 사용자 인증 정보 단추를 클릭하고 [사용자 인증 정보 만들기]-> API 키 옵션을 클릭하십시오 . API 키 가 있는 모달 이 나타납니다. 해당 API 키를 복사하여 XeroBizz Application의 Google App 통합 양식의 API 키 필드 에 붙여 넣습니다 .( Now click on the Credentials button from the left-side menus and click on the Create Credentials -> API key option. A modal with API Key will appear. Copy that API Key and paste it on XeroBizz Application’s Google App integration form’s API key field.)
  • 
     

• • 이제 [사용자 인증 정보 만들기] -> OAuth 클라이언트 ID 옵션을 클릭하십시오 . ( Now click on Credentials -> OAuth client ID option. )

• [동의 화면 구성]을 클릭하시고  , 버튼 선택 외부를 사용자 유형으로와 충돌 만들기 버튼을 클릭합니다. (Click on the Configure Consent screen button, select External as User Type and hit Create button. ) 

API에 대한 액세스 요청

How to Submit Google My Business API Approval Request(8:18)

저희의 이미지 위주의 설명보다 영어가 가능하신 분들은 아래의 동영상으로 보아주세요. 

프로젝트를 사용 가능하게하고 API에 액세스하려면 다음 단계를 완료해야합니다.

1. Google API Console로 이동하여 Google 마이 비즈니스에 사용하기 위해 생성한 프로젝트를 선택합니다. 저는 “My Business API”로 프로젝트를 만들었습니다. 

2. 프로젝트 ID를 확인하려면 프로젝트 ID 열 을 확인하십시오 .

프로젝트를 누루시면 아래와 같이 기존에 만들었던 프로젝트 이름들이 보이고 그 우측에 있는 ID가 프로젝트 ID입니다. 이 ID는 아래의 “3. 액세스 요청 양식“에서 사용되므로 복사해두세요.

3. 액세스 요청 양식을 작성하여 제출하십시오 .

Google 마이 비즈니스 API를 사용하면 이름, 주소, 전화 번호, 시간, 사진 등과 같은 비즈니스 정보를 프로그래밍 방식으로 관리할 수 ​​있습니다. 이 API에 대한 액세스는 허용 목록을 통해 제공되며 API를 사용하여 Google 마이 비즈니스의 위치를 ​​관리하려는 회사에 부여됩니다.

회사에서 이 API에 액세스하는 데 관심이 있는 경우 회사에 대한 세부 사항을 아래 양식에 작성하십시오. 모든 질문에 최대한 정확하고 자세하게 답변하십시오. 부정확한 정보는 회사의 API 액세스에 영향을 줄 수 있습니다.

신청서에 제공된 정보가 확인되면 Google 마이 비즈니스 API 팀에서 다음 단계로이 양식에 제공된 비즈니스 담당자에게 연락합니다.

회사에이 양식을 한 번만 제출하십시오. 요청을 처리하는 데 최대 2 주가 소요될 수 있습니다.

Google 마이 비즈니스 API 프로젝트 세부 정보

GMB API 액세스를 사용하려는 프로젝트에 대해 다음 정보를 입력하십시오.

프로젝트가 없습니까? https://console.developers.google.com/ 을 만들려면 Google 개발자 콘솔을 방문 하십시오.

프로젝트 ID *

상단의 필터를 사용하여 생성 한 프로젝트를 선택하십시오. 그리고 프로젝트 이름을 입력하십시오. 자세한 정보 : https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects

 

https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects 로 접속 및 로그인하시면 프로젝트 이름, ID, 번호를 확인할 수 있습니다. 

 

프로젝트 번호 *

“프로젝트 번호”를 찾으려면 다음 지시 사항을 따르십시오. https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects

 

 

 

위에 입력 한 프로젝트 ID를 관리 할 Google 계정의 이메일 주소 목록을 쉼표로 구분하여 입력하십시오 (귀하 / 귀하의 팀이 Google Cloud Platform에 로그인 한 계정) *

참고 : API에 액세스하려면 Google Developers Console에 로그인 할 개발자의 Google 계정 이메일 주소 만 제출하십시오. API로 편집 할 Google 마이 비즈니스 위치가있는 Google 마이 비즈니스 계정의 이메일 주소를 제공해서는 안됩니다.

 

 

 

비즈니스 및 고객 정보

회사를 가장 잘 분류하는 방법 *

 

Local Business(지역 사업체)

 

Third-party / Reseller / Agency(타사 / 리셀러 / 대행사)

 

 

** Local Business(지역 사업체)를 선택한 경우 ** :  Local Business(지역 사업체)로 양식을 제출하시면 현재는 서비스가 안되나 가이드 라인이 변경되면 다시 제출하지 않아도 반영해 주겠다고 합니다. 어쨋거나 2020-05-20 기준으로 Local Business로는 양식을 제출하시면 안됩니다. 아래의 Third-party / Reseller / Agency(타사 / 리셀러 / 대행사)로 요청 양식을 제출해주세요.

[expand title=”상세 내용 보기” swaptitle=”상세 내용 접기”]

We’re currently only granting API access to companies in good standing who work with clients to manage their business location data. Applicants must also meet minimum feature requirements and product guidelines. You haven’t met our requirements at this time.

However, we’ll retain your application in the event our guidelines change so there’s no need to resubmit.

Thank you and please stay tuned to our Geo Developers blog for the latest updates.

Thanks, 

The Google My Business API team

반송이 됩닏. 였는데, 고 결과를 기다리고 있습니다.

How would you describe your business? *

 

• Small or Medium Business (business with < 10 locations)

 

 

 

• Chain (business with > 10 locations)

 

Do you currently manage locations in Google My Business? *

• Yes

• No

 

예인 경우 : 해당 지역과 관련된 인증 된 Google 계정을 제공하십시오.(If Yes: Please provide the verified Google account(s) associated with your locations)

 

 

Briefly describe how you plan to use the GMB API *

 

 

 

 

 

 

 

Product / Technical Information( 제품 / 기술 정보 )

What type of location management application do you have? *(어떤 유형의 위치 관리 애플리케이션이 있습니까? *)

• Desktop(데스크탑)

• Mobile(모바일)

• Both(양자 모두)

 

 

 

What features of the Google My Business API do you plan to use? *(Google 마이 비즈니스 API의 어떤 기능을 사용 하시겠습니까? *)

• Location Management(위치 관리)

• Reviews Management(리뷰 관리)

• Both(양자 모두)

 

 

What programming language do you plan on using to develop your application? *(어플리케이션을 개발하기 위해 어떤 프로그래밍 언어를 사용할 계획입니까? *)

 

 

Which other networks does your platform publish location information to? *  If none, select N/A

(플랫폼이 위치 정보를 게시하는 다른 네트워크는 무엇입니까? * 없는 경우 N / A를 선택하십시오.)

• Facebook
• Yelp
• Bing
• Foursquare
• Apple Maps
• N/A
• 기타:

 

 

 

How is your location management application used? *(위치 관리 응용 프로그램은 어떻게 사용됩니까? *)

• The application is only used internally by employees within my company to manage locations응용 프로그램은 회사 내 직원이 내부적으로 만 위치를 관리하는 데 사용됩니다

• End-customers (business owners or chains) log into the application directly to manage locations. Please confirm that you have read and agree to the GMB API policies. * https://developers.google.com/my-business/content/policies * ( 최종 고객 (사업자 또는 체인)은 위치를 관리하기 위해 응용 프로그램에 직접 로그인. GMB API 정책을 읽고 동의했는지 확인하십시오. * https://developers.google.com/my-business/content/policies  )

          Yes(예)

 

[/expand]

 

 

[sta_anchor id=”third_party” /]** Third-party / Reseller / Agency(타사 / 리셀러 / 대행사)를 선택한 경우 **

 

How do you work with clients to manage their locations?(고객과 함께 위치를 관리하는 방법은 무엇입니까?)

• Clients log in to our location management application and make updates(고객이 위치 관리 애플리케이션에 로그인하여 업데이트)

• We make the updates but work with our clients to get data(업데이트하지만 고객과 협력하여 데이터를 얻습니다.)

 

Do you resell your application to other agencies? *

Note that for data quality and spam purposes we may ask you to provide a list of all agencies using your application along with the GMB accounts they manage.

( 신청서를 다른 대행사에 재판매합니까? *

  데이터 품질 및 스팸 목적을 위해 관리하는 GMB 계정과 함께 애플리케이션을 사용하는 모든 대행사 목록을 제공하도록 요청할 수 있습니다. )

• Yes(예)

• No(아니오)

 

What functionality does your application provide to end-users? *(최종 사용자에게 응용 프로그램이 제공하는 기능은 무엇입니까? *) : 이 설문은 복수 선택이 가능합니다. 

• Individual location management(개별 위치 관리)

• Bulk location management(대량 위치 관리)

• Local Insights analytics and reporting(지역 통계 분석 및 보고)

• Local review / reputation management(지역 검토 / 평판 관리)

• 기타:

 

 

Briefly describe your company’s business model and how you plan to use the GMB API *(회사의 비즈니스 모델과 GMB API 사용 방법을 간략하게 설명하십시오. *)

Please be as descriptive as possible to help us evaluate whether you will be a good fit for the API(API에 적합한지 여부를 평가하는 데 도움이되도록 최대한 설명해주세요.)

내 답변

저는 이렇게 답변하였습니다. “Our company is a SEO company. We want to develop a Google Map SEO business and make a franchise company our customer. To do that, we need your google my business API.”

 

 

What type of customers do you manage? *(어떤 유형의 고객을 관리합니까? *)

• Chains / Franchises (multi-location business)(체인 / 프랜차이즈 (다중 사업))

• Small to Mid Size Businesses (<10 locations per business)(중소 기업 (비즈니스 당 <10 개소))

• Both(양자 모두)

 

Approximately how many locations do you manage using Google My Business today? *(오늘날 Google 마이 비즈니스를 사용하여 대략 몇 곳을 관리하십니까? *)

내 답변

저는 이렇게 답변하였습니다.”We are managing 39 locations, and more than 540 will be added when the current contract is completed.”

 

Product / Technical Information(제품 / 기술 정보)

 

What type of location management application do you have? *(어떤 유형의 위치 관리 애플리케이션이 있습니까? *)

 

• Desktop(데스크탑)
• Mobile(모바일)
• Both(양자 모두)

 

What features of the Google My Business API do you plan to use? *(Google 마이 비즈니스 API의 어떤 기능을 사용 하시겠습니까? *)

• Location Management(위치 관리)

• Reviews Management(리뷰 관리)

• Both(양자 모두)

 

 

What programming language do you plan on using to develop your application? *(어플리케이션을 개발하기 위해 어떤 프로그래밍 언어를 사용할 계획입니까? *)

내 답변

저는 "I will use JAVA."라고 답변하였습니다. 

 

 

Which other networks does your platform publish location information to? *(플랫폼이 위치 정보를 게시하는 다른 네트워크는 무엇입니까? *)

If none, select N/A(없는 경우 N / A를 선택하십시오.)

• Facebook(페이스 북)

• Yelp

• Bing(빙)

• Foursquare

• Apple Maps(애플 맵)

• N/A(해당 없음)

• 기타:

 

 

 

How is your location management application used? *(위치 관리 응용 프로그램은 어떻게 사용됩니까? *)

 

• The application is only used internally by employees within my company to manage locations(응용 프로그램은 회사 내 직원이 내부적으로 만 위치를 관리하는 데 사용됩니다)

 

• End-customers (business owners or chains) log into the application directly to manage locations(최종 고객 (사업자 또는 체인)은 위치를 관리하기 위해 응용 프로그램에 직접 로그인)

         

Please confirm that you have read and agree to the GMB API policies. *(GMB API 정책을 읽고 동의했는지 확인하십시오. *)

         

          https://developers.google.com/my-business/content/policies

 

          Yes(예)

 

양식을 제출하니 아래와 같은 메세지가 나옵니다. 2주 안에 결과를 알려주겠다고 하는데 너무 오래 걸리는 것 아닌가요 ? 2020-03-28 제출하였으니 4.11까지는 가다려 보아야겠습니다. 

4. 요청이 검토 된 후 후속 이메일이 발송됩니다.

기본 설정 페이지로 클릭후 이동하시여 [Enable the Google My Business API(Google 마이 비즈니스 API 사용) ] 버튼을 클릭하시면 실시간으로 확인할 수 있습니다. 

5. 승인 후 프로젝트에 Google My Business API를 사용하려면 기본 설정 을 참조하십시오 .

기본설정은 아래의 게시글에서 이어집니다. 

구글 마이비즈니스 api 시작하기(Get started) : 1. 기본설정(Basic setup)

Trouble shooting

Third-party / Reseller / Agency(타사 / 리셀러 / 대행사)로 신청서를 제출하고 3~4일뒤에 아래와 같은 이메일을 받았습니다. 

 

Hi Sangheu,

The company website domain that you submitted in your whitelist request form doesn’t match the domain of your email address.(whitelist request form에서 제출한 회사 웹사이트 도메인이 이메일 주소의 도메인과 일치하지 않습니다.) -> Company Information(회사 정보) 중, Your Email *( 귀하의 이메일 * ) 부분의 이메일에 회사 도메인을 사용하는 이메일을 입력하지 않았다는 의미입니다.  

If you’re working with a third party who will be using the Google My Business API to manage listings on behalf of your company, then please have your third party partner submit the whitelist application form with the Project ID that they created.( 회사를 대신하여 업체 정보를 관리하기 위해 Google 마이 비즈니스 API를 사용하는 타사와 협력중인 경우, 타사 파트너가 허용 한 프로젝트 ID와 함께 화이트리스트 신청서를 제출하도록하세요 . ) -> Third-party / Reseller / Agency(타사 / 리셀러 / 대행사)를 선택한 경우, 신청하는 회사의 계정으로 만든  Project ID 를 사용하지 말고 타사의 계정으로 만든 Project ID 를 입력해 달라는 내용입니다. 

If your company is planning on using the Google My Business API directly, please re-submit the whitelist application form and be sure to provide a requester with email address within your company. When submitting your new request, please answer all questions accurately and with as much detail as possible.( 회사에서 Google 마이 비즈니스 API를 직접 사용하려는 경우 허용 목록 신청서 를 다시 제출하고 회사 내부에 이메일 주소를 요청자에게 제공하십시오. 새 요청을 제출할 때는 모든 질문에 최대한 정확하고 자세하게 답변하십시오.)  ->  이경우, 회사메일을 메일을 기재하시는 것을 잊지말아주세요. 

Thanks, 

The Google My Business API team

 

 

Google My Business API Support( https://developers.google.com/my-business/content/support ) 을 통해 문제를 해결할 수 있습니다.  

 

내 비즈니스 API 팀( My Business API team )

기술 지원에 대해서는 Google 마이 비즈니스 지원팀에 문의하십시오.( Contact the Google My Business support team for technical support. )

지원 연락처( Contact support )

Google 마이 비즈니스에 대한 API관련되지 않은 질문에 대한 답변은 Google 마이 비즈니스 도움말 센터 에서 찾을 수 있습니다.( Answers to non-API questions about Google My Business can be found in the Google My Business Help Center. )

 

내 비즈니스 커뮤니티( My Business community )

My Business 포럼을 방문하여 My Business 커뮤니티의 개발자 및 회원과 토론하십시오. 궁금한 사항을 신속하게 해결하려면 “\ [API \]”로 게시물 제목을 시작하십시오.( Visit the My Business forum for discussions with developers and members of the My Business community. To ensure that your questions are quickly addressed, preface the title of your post with “\[API\]”. )

포럼 방문( Visit forum )

 

튜토리얼 및 FAQ( Tutorials and FAQ )

Google 마이 비즈니스 사용 방법에 대한 자습서 및 자주 묻는 질문에 대한 답변을 보려면 Google 마이 비즈니스 도움말 센터를 방문하십시오.( Visit the Google My Business Help Center for tutorials on how to use Google My Business and answers to frequently asked questions. )

도움말 센터 방문( Visit help center )

 

알려진 문제( Known issues )

My Business API의 알려진 문제를 살펴 보고 버그를 여는 예제를 추가하십시오.( See known issues with the My Business API, and add examples to open bugs. )

이슈 트래커 방문( Visit issue tracker)

 

액세스 요청 양식에 대한 confirmation mail = return e-mail 을 못받을때의 해결책

2020-04-29 현재에도 return e-mail 이 오고 있지 않습니다. 

대안1. Google My Business API Support( https://developers.google.com/my-business/content/support ) 을 통해 해결

바로 위에 My Business API Support 을 통해 해결하세요.

대안2. 위에 Trouble shooting 에서 언급했던 e-mail 의 발신자인  <[email protected]> 에게  다시 문의 메일을 보내보세요. 

대안3. 아래의 sharethis 저자에게 문의해 보세요. 

대안4. API 수동 활성화( Manually enable the API )

아래의 게시글 1. 기본설정(Basic setup) 에 API 수동 활성화 방법이 있습니다. 

구글 마이비즈니스 api 시작하기(Get started) : 1. 기본설정(Basic setup)

그런데

참고자료 : 1 구글 API 사용법, 키 발급, OAuth 인증 방법 정리