Matter entegrasyonları içeren geliştirici projeleri, Google Home Developer Console üzerinde yönetilir. Bu sayfada, Developer Console aracında yeni bir geliştirici projesinin nasıl oluşturulacağı açıklanmaktadır.
Kısıtlamalar
Cloud-to-cloud veya Local Home SDK işlevi 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
Projenizi adlandırırken aşağıdaki özelliklere sahip bir ad vermeniz önerilir:
- Proje hakkında bazı temel bilgileri içerir.
- Başka bir projenin projesiyle karıştırılması kolay değildir.
- Projedeki tüm integration'leri temsil edebilir.
Anlamlı adlar önemlidir. project-gamma-798 gibi genel bir ad etkili bir şekilde "kamufle edilir" ve adı verilen diğer projeler listesinde öne çıkmaz.
Projenizi adlandırırken aşağıdaki yönergeleri göz önünde bulundurun:
- Şirketinizin adını kullanın
- Adda proje veya eylem 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'leri yönetmesine izin verebilir.
Google Akıllı Ev Ekosistemleri integration, yeni Developer Console ile yönetilir. Developer Console aracında proje oluşturmak için iki yöntem vardır:
Hem test hem de üretim olmak üzere tüm Matter entegrasyonlarınız için yalnızca bir proje oluşturmanızı öneririz. Bu sayede özellikle Matter için test tedarikçisi kimlikleri ve ürün kimlikleriyle test yaparken sorun yaşamazsınız.
1. Yöntem: Yeni proje oluşturma
Developer Console sayfasına gidin:
- Projeleri yönetin 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: 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 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 ve Üyeler bağlantısı kullanılarak görüntülenebilir.
- İçe aktarılan bir projenin Şirket Profili yalnızca Actions on Google Console'dan düzenlenebilir. Oradaki değişiklikler Google Home Geliştirici Konsolu'na 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.
Actions on Google Console hizmetinden mevcut bir projeyi içe aktarmak için şuraya gidin: Developer Console:
- Create a Project'i (Proje Oluştur) tıklayın.
- Mevcut bir Actions proje adı 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"dir).
- Projeyi içe aktar'ı tıklayın.
Developer Console platformundaki mevcut proje ayrıntılarına yönlendirilirsiniz.
Günlük düzeylerini ayarlama
Varsayılan olarak, projenizdeki her entegrasyon için Google Cloud uygulamasına yalnızca hata günlükleri kaydedilir.
Her entegrasyonda tüm günlükleri Google Cloud konumuna kaydetmek için 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. Entegrasyon başına ayarlanamaz. Günlük depolama alanınızın aşılması durumunda tüm günlükleri Google Cloud ürününe kaydetmek ek ücret gerektirebilir.
Günlükler hakkında daha fazla bilgi edinmek için Matter için Cloud Logging'e bakın.
Geliştirici projelerini paylaşma
Önceden tanımlanmış rolleri kullanarak ekibinizdeki kullanıcılar arasından bir projeye erişim ekleyebilir veya mevcut erişim iznini kaldırabilirsiniz.
Developer Console öğesinin ana sayfasında Üyeler'i tıklayın. Bu işlem sizi Google Cloud Console üzerindeki IAM ve Yönetici > IAM sayfasına yönlendirir.
Alternatif olarak, Proje ayrıntıları'nı ve ardından en alttaki Üyeler bölümünden GCP'de üyeleri yönet'i tıklayın.
Google Cloud Console kontrol panelini kullanarak gerekli değişiklikleri yapın.
Projeye erişimi değiştirme talimatları için IAM içeren projeler için erişim denetimi bölümüne bakın.
Kullanıcı listesine eklenen kullanıcılar, projeyi ve tüm entegrasyonları Developer Console üzerinde görüntüleyebilir.
Kuruluş ayarları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.