Matter entegrasyonlarını içeren geliştirici projeleri Google Home Developer Console üzerinden yönetilir. Bu sayfada, Developer Console üzerinde yeni bir geliştirici projesinin nasıl oluşturulacağı açıklanmaktadır.
Projeye ad verin
Projenizi adlandırırken aşağıdaki özelliklere sahip bir ad oluşturmanız önerilir:
- Proje hakkında bazı temel bilgileri içerir.
- Başka bir projenin adıyla karıştırılmamalıdır.
- Projedeki tüm integrationöğelerini temsil edebilir.
Anlamlı adlar önemlidir. project-gamma-798 gibi genel bir ad, etkili bir şekilde "kamufle edilir" ve genel adlara sahip diğer projelerin listesinde öne çıkmaz.
Projenizi adlandırırken aşağıdaki yönergeleri göz önünde bulundurun:
- Şirketinizin adını kullanın
- Adında proje veya işlem türünü kullanın.
- Proje adında "test" kelimesini kullanmayın
Örneğin, acme-smarthome ve acme-lighting net ve benzersiz proje adlarıdır.
Projeyi oluşturma
Geliştirici projesi, bir veya daha fazla entegrasyonu temsil eder. Sahip, bir projeyi geliştirme ekibinin üyeleriyle paylaşarak diğer kullanıcıların projedeki tüm entegrasyonları yönetmesine izin verebilir.
Google Akıllı Ev Ekosistemi entegrasyonları Developer Console kullanılarak yönetilir.
Özellikle Matter için test tedarikçi kimlikleri ve ürün kimlikleriyle test yaparken sorun yaşamamak amacıyla, hem test hem de üretim olmak üzere tüm Matter entegrasyonlarınız için tek bir proje oluşturmanızı öneririz.
1. yöntem: Yeni proje oluşturma
Developer Console sayfasına gidin:
- Projeleri yönet sayfasında Proje oluştur'u tıklayın.
- Başlayın sayfasında Proje oluştur'u tıklayın.
- Projenizin adını girin. Bu ad, proje adlandırma kurallarına uygun olmalıdır.
- Yeni proje oluştur'u tıklayın.
Yeni projenin Ana Sayfa'sına yönlendirilirsiniz.
2. yöntem: Actions on Google Console'dan mevcut bir projeyi içe aktarma
Mevcut bir Cloud-to-cloud veya Local Home SDK entegrasyonuna Matter desteği eklemeniz gerekiyorsa mevcut bir Actions on Google projesi yeni Developer Console projesine aktarılabilir.
Bu yöntem için aşağıdaki kısıtlamalar geçerlidir:
- Bu içe aktarma işlemi yalnızca tek yönlüdür. Bu işlem geri alınamaz.
- Mevcut bir Actions on Google projesini yalnızca proje sahibi içe aktarabilir. Sahip, projeyi oluşturan kişidir. Bu bilgi, Üyeler bağlantısı kullanılarak görüntülenebilir.
- İçe aktarılan bir projenin şirket profili yalnızca Actions on Google Console'da düzenlenebilir. Burada yapılan değişiklikler Google Home Developer Console'a yansıtılır.
İçe aktarma işleminden sonra orijinal Actions on Google projesi, mevcut entegrasyonları (ör. Cloud-to-cloud, Local Home, App Discovery) yönetmek için kullanılmaya devam edebilir.
Mevcut bir projeyi Actions on Google Console üzerinden içe aktarmak için Developer Console sayfasına gidin:
- Proje oluştur'u tıklayın.
- Mevcut bir Actions projesinin adını girin veya açılır listeden bir proje seçin (örneğin, aşağıdaki ekran görüntüsünde proje adı "My matter project" şeklindedir).
- Projeyi içe aktar'ı tıklayın.
Developer Console uygulamasındaki mevcut proje ayrıntılarına yönlendirilirsiniz.
Günlük düzeylerini ayarlama
Varsayılan olarak, projenizdeki her entegrasyon için yalnızca hata günlükleri Google Cloud hizmetine kaydedilir.
Her entegrasyon için tüm günlükleri Google Cloud konumuna kaydetmek istiyorsanız Günlük düzeyi kontrolü: Hata günlükleri bölümünde Tüm günlükler'i seçin.
Bu ayar, projenizdeki tüm entegrasyonlar için geçerlidir. Yalnızca Cloud-to-cloud entegrasyonları için geçersiz kılınabilir. Tüm günlükleri Google Cloud konumuna kaydetmek, günlük depolama alanınız aşılırsa ek maliyete neden olabilir.
Günlükler hakkında daha fazla bilgi edinmek için Matter için Cloud Logging başlıklı makaleyi inceleyin.
Geliştirici projesi paylaşma
Önceden tanımlanmış rolleri kullanarak ekibinizdeki kullanıcıların bir projeye erişimini ekleyebilir veya kaldırabilirsiniz.
Developer Console ana sayfasında Üyeler'i tıklayın. Google Cloud Console üzerinde IAM ve Yönetici > IAM sayfasına yönlendirilirsiniz.
Alternatif olarak, Project details'i (Proje ayrıntıları) ve ardından en alttaki Members (Üyeler) bölümünde Manage members in GCP'yi (GCP'de üyeleri yönet) tıklayın.
Google Cloud Console kontrol panelini kullanarak gerekli değişiklikleri yapın.
Bir projeye erişimi değiştirme talimatları için IAM ile projeler için erişim denetimi başlıklı makaleyi inceleyin.
Kullanıcı listesine eklenen kullanıcılar, projeyi ve Developer Console içindeki tüm entegrasyonları görüntüleyebilir.
Kuruluş ayarınıza bağlı olarak, geliştirici projeleri oluşturmaya çalışırken izin hatalarıyla karşılaşabilirsiniz. Bu durumda, Google Cloud yöneticinizle iletişime geçerek hesabınız için Proje Oluşturucu izinleri isteyin.