Entwicklerprojekte, die Matter Integrationen enthalten, werden in der Google Home Developer Console verwaltet. Auf dieser Seite wird beschrieben, wie Sie ein neues Entwicklerprojekt in der Developer Consoleeinrichten.
Projekt benennen
Bei der Benennung Ihres Projekts empfiehlt es sich, einen Namen zu verwenden, der folgende Kriterien erfüllt:
- Er enthält einige grundlegende Informationen zum Projekt.
- Er kann nicht mit dem Namen eines anderen Projekts verwechselt werden.
- Er kann alle integrations im Projekt darstellen.
Aussagekräftige Namen sind wichtig. Ein allgemeiner Name wie project-gamma-798 ist effektiv „getarnt“ und fällt in einer Liste anderer allgemein benannter Projekte nicht auf.
Beachten Sie bei der Benennung Ihres Projekts die folgenden Richtlinien:
- Verwenden Sie den Namen Ihres Unternehmens.
- Verwenden Sie den Projekttyp oder die Aktion im Namen.
- Verwenden Sie nicht „Test“ im Projektnamen.
acme-smarthome und acme-lighting sind beispielsweise eindeutige und klare Projektnamen.
Projekt erstellen
Ein Entwicklerprojekt steht für eine oder mehrere Integrationen. Wenn der Inhaber ein Projekt für die Mitglieder seines Entwicklungsteams freigibt, können andere Nutzer alle Integrationen im Projekt verwalten.
Integrationen des Google Smart Home-Ökosystems werden über die Developer Console verwaltet.
Wir empfehlen, nur ein Projekt für alle Ihre Matter Integrationen zu erstellen, sowohl für Tests als auch für die Produktion. So lassen sich Probleme vermeiden, die beim Testen mit Test-Anbieter-IDs und Produkt-IDs für Matterauftreten können.
Methode 1: Neues Projekt erstellen
Rufen Sie die Developer Console auf:
- Klicken Sie auf der Seite Projekte verwalten auf Projekt erstellen.
- Klicken Sie auf der Seite Erste Schritte auf Projekt erstellen.
- Geben Sie den Namen Ihres Projekts ein. Er muss den Richtlinien für die Benennung von Projekten entsprechen.
- Klicken Sie auf Neues Projekt erstellen.
Sie werden zur Startseite des neuen Projekts weitergeleitet.
Methode 2: Vorhandenes Projekt aus der Actions on Google Console importieren
Ein vorhandenes Actions on Google Projekt kann in die neue Developer Console importiert werden, wenn Sie einer vorhandenen Cloud-to-cloud oder Local Home SDK Integration Matter Unterstützung hinzufügen möchten.
Für diese Methode gelten die folgenden Einschränkungen:
- Dieser Import ist nur in eine Richtung möglich. Er kann nicht rückgängig gemacht werden.
- Nur der Projektinhaber kann ein vorhandenes Actions on Google Projekt importieren. Der Inhaber ist die Person, die das Projekt erstellt hat. Sie können ihn über den Link „Mitglieder“ sehen.
- Das Unternehmensprofil für ein importiertes Projekt kann nur in der Actions on Google Console bearbeitet werden. Änderungen werden in der Google Home Developer Console übernommen.
Nach dem Import kann das ursprüngliche Actions on Google Projekt weiterhin verwendet werden um vorhandene Integrationen zu verwalten (z. B. Cloud-to-cloud, Local Home, App Discovery).
So importieren Sie ein vorhandenes Projekt aus der Actions on Google Console in die Developer Console:
- Klicken Sie auf Projekt erstellen.
- Geben Sie den Namen eines vorhandenen Actions-Projekts ein oder wählen Sie ein Projekt aus der Drop-down-Liste aus. Im folgenden Screenshot lautet der Projektname beispielsweise „My matter project“.
- Klicken Sie auf Projekt importieren.
Sie werden zu den Details des vorhandenen Projekts in Developer Console weitergeleitet.
Logebenen festlegen
Standardmäßig werden nur Fehlerlogs für jede Integration in Ihrem Projekt in Google Cloud gespeichert.
Wenn Sie alle Logs für jede Integration in Google Cloud speichern möchten, wählen Sie im Bereich Log level control: Error logs die Option All logs aus.
Diese Einstellung gilt für alle Integrationen in Ihrem Projekt. Sie kann nur für Cloud-to-cloud Integrationen überschrieben werden. Wenn Sie alle Logs in Google Cloud speichern, können zusätzliche Kosten anfallen, wenn der Speicherplatz für Logs überschritten wird.
Weitere Informationen zu Logs finden Sie unter Cloud Logging für Matter .
Entwicklerprojekt freigeben
Sie können den Zugriff auf ein Projekt für die Nutzer in Ihrem Team mithilfe vordefinierter Rollen hinzufügen oder entfernen.
Klicken Sie auf der Startseite der Developer Console auf Mitglieder. Sie werden zur Seite IAM und Verwaltung > IAM auf der Google Cloud Console weitergeleitet.
Alternativ können Sie auf Projektdetails und dann unten im Bereich Mitglieder auf Mitglieder in GCP verwalten klicken.
Nehmen Sie über das Google Cloud Console Dashboard die gewünschten Änderungen vor.
Eine Anleitung zum Ändern des Zugriffs auf ein Projekt finden Sie unter Zugriffssteuerung für Projekte mit IAM.
Nachdem ein Nutzer der Liste der Nutzer hinzugefügt wurde, kann er das Projekt und alle Integrationen in der Developer Consolesehen.
Je nach Organisationseinstellung können beim Erstellen von Entwicklerprojekten Berechtigungsfehler auftreten. Wenden Sie sich in diesem Fall an Ihren Google Cloud Administrator und bitten Sie ihn, Ihrem Konto die Berechtigung „Projektersteller“ zu gewähren.