Matter 통합을 포함한 개발자 프로젝트는 Google Home Developer Console에서 관리됩니다. 이 페이지에서는 Developer Console에서 새 개발자 프로젝트를 설정하는 방법을 설명합니다.
제한사항
Cloud-to-cloud 또는 Local Home SDK 기능은 Developer Console의 프로젝트에 추가할 수 없습니다. Matter 기능을 기존 Cloud-to-cloud 또는 Local Home 통합에 추가하려면 먼저 기존 Actions on Google 프로젝트를 가져와야 합니다.
프로젝트 이름 지정
프로젝트 이름을 지정할 때 다음과 같은 이름을 작성하는 것이 좋습니다.
- 프로젝트에 대한 몇 가지 기본 정보를 포함합니다.
- 다른 프로젝트의 내용과 쉽게 혼동하지 않을 것입니다.
- 프로젝트 내의 모든 integration를 나타낼 수 있습니다.
의미 있는 이름이 중요합니다. project-gamma-798와 같은 일반적인 이름은 사실상 '위장' 처리되어 일반적으로 이름이 지정된 다른 프로젝트 목록에서 눈에 띄지 않습니다.
프로젝트 이름을 지정할 때 다음 안내를 고려하세요.
- 회사 이름 사용
- 이름에 프로젝트 또는 작업 유형 사용
- 프로젝트 이름에 'test'를 사용하지 마세요.
예를 들어 acme-smarthome 및 acme-lighting는 명확하고 고유한 프로젝트 이름입니다.
프로젝트 만들기
개발자 프로젝트는 하나 이상의 integration를 나타냅니다. 소유자는 개발팀 구성원과 프로젝트를 공유하여 다른 사용자가 프로젝트의 모든 integration를 관리하도록 허용할 수 있습니다.
Google 스마트 홈 생태계 integration는 새로운 Developer Console를 통해 관리됩니다. Developer Console에서 프로젝트를 설정하는 방법에는 두 가지가 있습니다.
특히 Matter의 테스트 공급업체 ID와 제품 ID로 테스트할 때 문제를 방지하려면 테스트와 프로덕션 모두에서 모든 Matter 통합에 하나의 프로젝트만 만드는 것이 좋습니다.
방법 1: 새 프로젝트 만들기
Developer Console로 이동합니다.
- 프로젝트 관리 페이지에서 프로젝트 만들기를 클릭합니다.
- 시작하기 페이지에서 프로젝트 만들기를 클릭합니다.
- 프로젝트 이름 지정 가이드라인을 준수하여 프로젝트 이름을 입력합니다.
- 새 프로젝트 만들기를 클릭합니다.
리디렉션되어 새 프로젝트의 홈 페이지로 돌아갑니다.
방법 2: Actions on Google 콘솔에서 기존 프로젝트 가져오기
기존 Cloud-to-cloud 또는 Local Home 통합에 Matter 지원을 추가해야 하는 경우 기존 Actions on Google 프로젝트를 새 Developer Console로 가져올 수 있습니다.
이 메서드에는 다음과 같은 제한사항이 적용됩니다.
- 이 가져오기는 단방향입니다. 이 작업은 취소할 수 없습니다.
- 프로젝트 소유자만 기존 Actions on Google 프로젝트를 가져올 수 있습니다. 소유자는 프로젝트를 만든 사람이며 구성원 링크를 통해 볼 수 있습니다.
- 가져온 프로젝트의 회사 프로필은 Actions on Google 콘솔에서만 수정할 수 있습니다. 변경사항이 Google Home 개발자 콘솔에 반영됩니다.
가져온 후에도 원래 Actions on Google 프로젝트를 사용하여 기존 통합 (예: Cloud-to-cloud, Local Home, App Discovery)을 관리할 수 있습니다.
Actions on Google Console에서 기존 프로젝트를 가져오려면 Developer Console로 이동합니다.
- 프로젝트 만들기를 클릭합니다.
- 기존 작업 프로젝트 이름을 입력하거나 드롭다운 목록에서 프로젝트를 선택합니다. 예를 들어 다음 스크린샷에서 프로젝트 이름은 'My Matter project'입니다.
- 프로젝트 가져오기를 클릭합니다.
Developer Console의 기존 프로젝트 세부정보로 다시 리디렉션됩니다.
로그 수준 설정
기본적으로 프로젝트의 각 통합에 대해 오류 로그만 Google Cloud에 저장됩니다.
각 통합의 모든 로그를 Google Cloud에 저장하려면 로그 수준 제어: 오류 로그 섹션에서 모든 로그를 선택합니다.
이 설정은 프로젝트의 모든 통합에 적용됩니다. 통합별로 설정할 수 없습니다. 모든 로그를 Google Cloud에 저장하면 로그 저장공간이 초과될 경우 추가 비용이 발생할 수 있습니다.
로그에 대한 자세한 내용은 Matter용 Cloud Logging을 참조하세요.
개발자 프로젝트 공유
사전 정의된 역할을 사용하여 팀의 사용자 간에 프로젝트 액세스 권한을 추가하거나 삭제할 수 있습니다.
Developer Console의 홈 페이지에서 구성원을 클릭하면 Google Cloud Console의 IAM 및 관리자 > IAM 페이지로 이동합니다.
또는 프로젝트 세부정보를 클릭한 후 하단의 구성원 섹션에서 GCP의 구성원 관리를 클릭합니다.
필요에 따라 Google Cloud Console 대시보드를 사용하여 변경합니다.
프로젝트에 대한 액세스 권한을 수정하는 방법은 IAM으로 프로젝트 액세스 제어를 참조하세요.
사용자 목록에 추가되면 사용자는 Developer Console에서 프로젝트와 모든 통합을 볼 수 있습니다.
조직 설정에 따라 개발자 프로젝트를 만들려고 할 때 권한 오류가 발생할 수 있습니다. 이러한 경우에는 Google Cloud 관리자에게 연락하여 계정의 프로젝트 생성자 권한을 요청하세요.