Matter entegrasyonları içeren geliştirici projeleri Google Home Developer Console üzerinde yönetilir. Bu sayfada, Developer Console uygulamasında yeni bir geliştirici projesinin nasıl oluşturulacağı açıklanmaktadır.
Kısıtlamalar
Cloud-to-cloud veya Local Home SDK işlevleri Developer Console içindeki bir projeye eklenemez. Mevcut bir Cloud-to-cloud veya Local Home entegrasyonuna Matter işlevi eklemek istiyorsanız önce mevcut bir Actions on Google projesini içe aktarmanız gerekir.
Projeye ad verin
Projenize ad verirken şu özelliklere sahip bir ad yazmanız önerilir:
- Proje hakkında bazı temel bilgileri içerir.
- Başka bir projenin ürünüyle kolayca karıştırılamaz.
- Projedeki tüm integrationöğelerini temsil edebilir.
Anlamlı adlar önemlidir. project-gamma-798
gibi genel bir ad, etkili bir şekilde "Kamufle edilmiştir" ve genel olarak adlandırılmış diğer projeler listesinde öne çıkmaz.
Projenizi adlandırırken aşağıdaki kılavuzu göz önünde bulundurun:
- Şirketinizin adını kullanın
- Adda proje veya işlem türünü kullanın
- Proje adında "test" kelimesini kullanmayın
Örneğin acme-smarthome
ve acme-lighting
, açık ve benzersiz proje adlarıdır.
Projeyi oluşturma
Geliştirici projesi bir veya daha fazla integrationöğesini temsil eder. Proje sahibi, bir projeyi geliştirme ekibinin üyeleriyle paylaşarak diğer kullanıcıların projedeki tüm integrationöğeleri yönetmesine izin verebilir.
Google Akıllı Ev Ekosistemleri integrationyeni Developer Console ile yönetiliyor. Developer Console'da proje oluşturmak için iki yöntem vardır:
Özellikle Matter için test Tedarikçi Kimlikleri ve Ürün Kimlikleri ile test yaparken sorun yaşamamak üzere hem test hem de üretim dahil tüm Matter entegrasyonlarınız için yalnızca bir proje oluşturmanızı öneririz.
1. Yöntem: Yeni proje oluşturma
Developer Console uygulaması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 yönergelerine uygun olmalıdır.
- Yeni proje oluştur'u tıklayın.
Yeni projenin Ana Sayfa'ya tekrar yönlendirilirsiniz.
2. Yöntem: Mevcut bir projeyi Actions on Google konsolundan içe aktarma
Mevcut bir Cloud-to-cloud veya Local Home entegrasyonuna Matter desteği eklemeniz gerekirse mevcut 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.
- Yalnızca proje sahibi mevcut bir Actions on Google projesini içe aktarabilir. Sahip, projeyi oluşturan kişidir ve Ü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. Buradaki değişiklikler Google Home Geliştirici Konsolu'na yansıtılacaktır.
İçe aktarma işleminden sonra, mevcut entegrasyonları (ör. Cloud-to-cloud, Local Home, App Discovery) yönetmek için orijinal Actions on Google projesi kullanılmaya devam edebilir.
Mevcut bir projeyi Actions on Google Console hizmetinden içe aktarmak için Developer Console sayfasına gidin:
- Create a project'i (Proje oluştur) 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ı "Konu projem" şeklindedir).
- Projeyi içe aktar'ı tıklayın.
Developer Console sayfasındaki mevcut proje ayrıntılarına yönlendirilirsiniz.
Günlük düzeylerini ayarlama
Varsayılan olarak, projenizdeki her entegrasyon için Google Cloud bölümüne yalnızca hata günlükleri kaydedilir.
Her entegrasyonda tüm günlükleri Google Cloud hedefine kaydetmek için Günlük düzeyi denetimi: 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. Entegrasyon başına ayarlanamaz. Günlük depolama alanınızın aşılması durumunda tüm günlüklerin Google Cloud hedefine kaydedilmesi ek ücret ödenmesine neden olabilir.
Günlükler hakkında daha fazla bilgi edinmek için Matter için Cloud Logging bölümüne bakın.
Geliştirici projesini paylaşma
Önceden tanımlanmış rolleri kullanarak, ekibinizdeki kullanıcılar arasında bir projeye erişim izni ekleyebilir veya erişimi kaldırabilirsiniz.
Developer Console sayfasının Ana Sayfası'nda Members'ı (Üyeler) tıklayın. Bu adımda Google Cloud Console üzerindeki IAM ve Yönetici > IAM sayfasına yönlendirilirsiniz.
Alternatif olarak Proje ayrıntıları'nı, ardından en alttaki Üyeler bölümünden GCP'deki üyeleri yönet'i tıklayın.
Google Cloud Console kontrol panelini kullanarak gerekli değişiklikleri yapın.
Projeye erişimi değiştirmeyle ilgili talimatlar için IAM ile projeler için erişim denetimi bölümünü inceleyin.
Kullanıcı listesine eklenen kullanıcılar, projeyi ve Developer Console entegrasyonlarını görüntüleyebilir.
Kuruluş ayarınıza göre, geliştirici projeleri oluşturmaya çalışırken izin hatalarıyla karşılaşabilirsiniz. Böyle bir durumda Google Cloud yöneticinizle iletişime geçerek hesabınız için Proje Oluşturucu izinleri isteyin.