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