GBP API란 무엇인가요?
Business Profile API는 개발자가 비즈니스 프로필 계정 및 위치 데이터를 관리하는 애플리케이션을 작성할 수 있는 프로그래밍 인터페이스입니다. 이 API를 사용하면 판매자 또는 대리인이 판매자의 데이터를 Google 전반에 표시하는 방법과 데이터를 공동으로 관리하는 사용자를 관리할 수 있습니다. API를 통해 사진, 게시물, 리뷰와 같은 사용자 생성 데이터를 관리할 수도 있습니다.
Business Profile API는 비즈니스 프로필 사용자 인터페이스와 거의 동일한 기능에 더해 API만의 몇 가지 추가 기능을 제공합니다. API 사용자에게는 사용자 인터페이스 사용자와 마찬가지로 Google 업데이트가 제공될 수 있습니다.
누가 GBP API에 대한 액세스 권한을 얻을 수 있나요?
모든 사용자가 GBP API를 사용할 수 있지는 않습니다. GBP API를 사용하려면 사용자가 GBP API에 대한 액세스 권한을 요청해야 합니다. GBP API에 액세스해야 하는 법적 비즈니스 이유를 입증할 수 있는 개인 또는 회사의 경우 액세스가 승인됩니다. 비즈니스로서 합법성을 입증하기 위한 요건은 다음과 같습니다.
- 비즈니스 도메인에 연결된 유효한 비즈니스 이메일 주소 사용
- 비즈니스 웹사이트가 업데이트되고 운영 중임
GBP API에 대한 액세스 권한이 있으면 사용자가 모든 Google 비즈니스 프로필 데이터를 쿼리할 수 있나요?
아니요. GBP API에 대한 액세스 권한이 있어도 특정 Google 비즈니스 프로필에 대한 액세스 권한이 없으면 해당 Google 비즈니스 프로필 데이터를 쿼리할 수 없습니다.
GBP API 사용자와 관련된 정책은 무엇인가요?
파트너는 Google 비즈니스 프로필 정책 및 모든 API 정책과 이용약관을 준수해야 합니다.
사용자가 GBP API에 대한 액세스 권한을 얻으려면 어떻게 해야 하나요?
첫 번째 클라이언트 애플리케이션을 만들려면 다음 기본 요건을 충족해야 합니다.
- Google 계정 만들기
- 비즈니스 프로필 사용하기
- Google API 콘솔에서 프로젝트 만들기
- API에 대한 액세스 권한 요청: 요청은 14일 이내에 검토됩니다.
사용자가 GBP API 내의 특정 API에 대한 액세스 권한을 얻으려면 어떻게 해야 하나요?
Google API 콘솔에서 사용 설정해야 하는 비즈니스 프로필과 연결된 여덟 개의 API는 다음과 같습니다.
- 다음과 같은 중요한 기능 API 호출을 포함하는 Google My Business API 4.9:
FoodMenusMediaReviewsLocalPosts
- My Business Account Management API
- My Business Lodging API
- My Business Place Actions API
- My Business Notifications API
- My Business Verifications API
- My Business Business Information API
- My Business Q&A API
- Business Profile Performance API
사용자의 액세스 요청 신청이 승인되면 표준 기본 할당량과 함께 여덟 개 API 모두에 대한 액세스가 부여됩니다.
GBP API에 대한 액세스 권한은 어떻게 작동하나요?
GBP API 액세스 권한은 Google Cloud 프로젝트 수준에서 부여됩니다. 사용자 A가 프로젝트 # - 12345678에 대한 Google Business Profile API 액세스 권한을 신청한 경우 프로젝트 # - 12345678에 대한 액세스 권한이 부여됩니다. 이에 따라 사용자 A를 포함하여 해당 Google Cloud 프로젝트에 대한 액세스 권한이 있는 모든 사용자가 Google Business Profile API를 호출할 수 있습니다. 파트너는 악용을 방지하기 위해 Google Cloud 프로젝트에 대한 액세스 권한을 액세스 필요에 따라 관리해야 합니다.
API의 요약 및 기능 예가 있나요?
여러 API 및 그 기능에 대해 알아보려면 다음 표를 참고하세요.
| API | 참고 문서 | 기능 예 |
|---|---|---|
| Account Management API | 문서 |
|
| Business Information API | 문서 |
|
| Lodging API | 문서 |
|
| Place Actions API | 문서 |
|
| Notifications API | 문서 |
|
| Verifications API | 문서 |
|
| Q&A API | 문서 |
|
| Business Profile Performance API | 문서 |
|
| Media API | 문서 |
|
| Reviews API | 문서 |
|
| Local Posts API | 문서 |
|
| FoodMenus API | 문서 |
|
파트너가 GBP API를 사용하기 위해 계정 구조를 설정하려면 어떻게 해야 하나요?
비즈니스 정보를 관리하는 서드 파티 파트너의 경우:
- 대행사로 GBP 조직 계정을 등록합니다.
- 사용자 그룹과 비즈니스 위치 그룹의 개념을 숙지합니다.
- 비즈니스를 대신하여 위치를 관리하는 방법을 알아보려면 이 가이드를 참고하세요.
비즈니스에서 GBP API 파트너가 비즈니스 정보를 관리할 수 있도록 승인하려면 어떻게 해야 하나요?
비즈니스에서는 두 가지 방법으로 서드 파티 파트너에게 액세스 권한을 부여합니다.
- OAuth 설정: 서드 파티 파트너 플랫폼에서 판매자 인증 정보를 사용하여 판매자 또는 비즈니스 대신 Google 비즈니스 프로필 데이터를 수정하고 이에 액세스하는 방법을 알아보려면 이 가이드를 참고하세요.
소유자 또는 관리자 액세스 권한: Google 비즈니스 프로필의 기본 소유자인 판매자가 서드 파티 파트너를 Google 비즈니스 프로필의 관리자로 추가한 경우 서드 파티 파트너는 Google Business Profile API를 사용하여 Google 비즈니스 프로필 데이터를 수정하고 이에 액세스하기 위해 판매자 인증 정보를 사용하지 않아도 됩니다.
참고: 서드 파티 파트너는 자신을 Google 비즈니스 프로필의 소유자로 추가하지 말고 관리자로만 추가하는 것이 좋습니다.
비즈니스에 위치가 10개 이상 있는 경우 일괄 인증하는 방법이 있나요?
예. 프로필 10개 이상의 일괄 인증을 요청할 수 있습니다. 인증 후에는 Business Profile API를 이용해 게시된 체인 위치를 다른 위치를 관리하는 것과 동일한 방식으로 관리할 수 있으나 일부 예외는 있습니다. 예를 들어 사이트 관리자는 다르게 취급되며 프랜차이즈 위치에 본인을 추가할 수 있습니다.
다양한 API의 할당량 한도는 무엇인가요?
표준 할당량 한도는 사용량 한도에 나열되어 있습니다. 한도를 늘려야 하는 경우 표준 할당량 요청을 제출하세요.
할당량을 얼마나 요청할 수 있나요?
할당량은 한정된 리소스입니다. GBP API 지원팀이 이전 할당량 사용량을 확인하여 할당량 증가 요청 자격 요건을 판단합니다. 평균 할당량 사용량이 현재 할당량 한도의 70% 미만이면 할당량 한도의 추가 증가가 거부될 수 있습니다.
GBP API 파트너가 프로덕션용 테스트 계정을 만들 수 있나요?
아니요. 유감스럽게도 프로덕션에서 GBP UI 또는 API를 통해 허위 GBP 등록정보를 만들고 이를 대상으로 테스트할 수 있는 직접적인 방법은 없습니다.
생성된 허위 등록정보 대부분이 검토팀에 의해 신고되고 정지됩니다. 클라이언트 등록정보를 사용하고 시간 외에 이를 사용하거나(이름, 주소, 카테고리와 같은 기본 등록정보를 변경하지 않은 경우) 회사 본부에 대한 등록정보를 만드는 것이 좋습니다. 등록정보 또는 프로덕션 등록정보가 필요한 기타 액션을 확인하기 위해 API 응답을 테스트하려면 가상 API 응답을 사용하세요.