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