비즈니스 프로필은 비즈니스 및 조직이 Google 검색 및 지도 등에서 온라인 활동을 간편하게 관리할 수 있는 무료 도구입니다.
Google 비즈니스 프로필 API는 Google에서 비즈니스 위치 정보를 관리하기 위한 인터페이스를 제공합니다. 비즈니스는 OAuth 동의를 통해 다른 비즈니스에 액세스 권한을 부여하여 대신 프로필을 관리하도록 할 수 있습니다.
비즈니스 프로필에서 관리하는 비즈니스는 이미 비즈니스 프로필 인증 절차를 통해 인증되었습니다. 비즈니스 프로필 OAuth 동의 흐름을 확장하여 이러한 비즈니스를 Business Messages에 온보딩하고 Business Messages에서 출시할 수 있도록 자동으로 인증할 수 있습니다.
이는 확장성이 높고 더 빠르게 Business Messages를 실행하는 방법으로, 비즈니스 프로필 위치에 메시지를 사용 설정할 때 권장되는 흐름입니다.
기본 요건
Google Business Profile API에 액세스할 수 있는 기존 비즈니스 프로필 파트너여야 합니다. 액세스 권한이 없는 경우 비즈니스 프로필 기본 요건에 따라 액세스 권한을 신청하세요.
Google 비즈니스 프로필 API에 대한 액세스 권한을 부여받은 후에는 기본 설정 및 OAuth 설정 가이드를 따르세요.
인증된 비즈니스 프로필 위치에 비즈니스 메시지 사용 설정
다음 다이어그램은 웹 서비스에서 비즈니스 메시지 상담사를 위해 브랜드의 비즈니스 프로필 위치 인증을 활용하는 방법을 보여줍니다. 자세한 내용은 아래를 참고하세요.
비즈니스 프로필 계정 소유자가 대신 Google 비즈니스 프로필 API를 호출할 수 있는 액세스 권한을 부여하는 기존 OAuth 동의 흐름에서 다음을 포함하도록 API 범위를 업데이트합니다.
- https://www.googleapis.com/auth/business.manage
- https://www.googleapis.com/auth/businesscommunications
상담사 및 비즈니스 위치를 자동으로 인증하려면 두 범위가 모두 필요합니다.
이전 단계에서 가져온 OAuth 사용자 인증 정보가 소유한 Google 비즈니스 프로필 등록정보 중 하나 이상의 이름과 일치하는
displayName로 상담사를 만듭니다. Google 비즈니스 프로필 API를 사용하여 위치를 조회하여 비즈니스 이름을 찾습니다.이름 일치의 경우
- 문자 대소문자는 구분되지 않습니다.
- 상담사의 성명은 비즈니스 프로필 위치 이름의 첫 단어와 정확하게 일치해야 합니다. 예를 들어 'GBP Bakery'라는 상담사는 'Gbp Bakery Mountain View', 'Gbp Bakery', 'gbp bakery sunnyvale'과 일치하지만 'Bakery San Francisco'와는 일치하지 않습니다.
비즈니스 프로필의 각 위치에 대해 동일한
placeId로 위치를 만듭니다. 비즈니스 프로필 위치의placeId는 Google 비즈니스 프로필 API에서 위치를 검색할 때LocationKey객체 내에 포함됩니다.만든 에이전트와 획득한 OAuth 토큰을 사용하여 에이전트 인증을 요청합니다.
인증 요청에는 브랜드 연락처 정보가 필요합니다. 하지만 에이전트 이름이 비즈니스 프로필 이름과 일치하고 올바른 범위로 OAuth 토큰을 획득한 경우 인증 절차에서 브랜드에 이메일을 보내지 않습니다.
올바르게 수행했다면 인증 요청의 출력이 즉시
VERIFICATION_STATE_VERIFIED의verificationState를 반환해야 합니다.verificationState가 다른 값을 반환하면 요청할 때 올바른 OAuth 토큰을 사용하지 않았거나 상담사를 비즈니스 프로필 위치에 일치시킬 수 없는 것입니다.동일한 OAuth 토큰을 사용하여 비즈니스 프로필에서 비즈니스가 소유한 모든 위치에 대해 위치 인증을 요청합니다.
상담사 인증과 마찬가지로 올바르게 수행하면 인증 요청의 출력은 즉시
VERIFICATION_STATE_VERIFIED의verificationState를 반환해야 합니다.verificationState가 다른 값을 반환하면 요청할 때 올바른 OAuth 토큰을 사용하지 않았거나 비즈니스 프로필 위치가 소유권이 주장되고 인증된 비즈니스가 아닐 가능성이 큽니다.진입점
LOCATION를 사용하여 에이전트를 실행합니다.검색 및 지도에서 사용할 위치를 실행하여 특정 위치에 대해 메시지 기능을 사용 설정합니다. 출시 프로세스가 시작되면 출시된 각 위치에 대한 메시지가 몇 시간 이내에 사용자에게 제공됩니다.
이 단계를 완료하면 모든 소비자 메시지가 등록된 Business Messages webhook에 게시되며 Business Messages API를 사용하여 소비자에게 응답을 전송해야 합니다.