Entwicklerprojekt erstellen

Entwicklerprojekte, die Matter-Integrationen enthalten, werden in Google Home Developer Console verwaltet. Auf dieser Seite wird erläutert, wie Sie ein neues Entwicklerprojekt im Developer Console einrichten.

Einschränkungen

Die Funktionen Cloud-to-cloud oder Local Home SDK können einem Projekt im Developer Console nicht hinzugefügt werden. Wenn Sie einer vorhandenen Cloud-to-cloud- oder Local Home-Integration die Funktion Matter hinzufügen möchten, müssen Sie zuerst ein vorhandenes Actions on Google-Projekt importieren.

Projekt benennen

Beim Benennen Ihres Projekts empfiehlt es sich, einen Namen zu wählen, der:

  • Enthält einige grundlegende Informationen über das Projekt.
  • ist nicht leicht mit dem eines anderen Projekts zu verwechseln.
  • Kann alle integrations innerhalb des Projekts repräsentieren.

Aussagekräftige Namen sind wichtig. Ein generischer Name wie project-gamma-798 ist im Grunde „tarniert“ und hebt sich in einer Liste mit anderen benannten Projekten nicht von der Masse ab.

Beachten Sie bei der Benennung Ihres Projekts die folgende Anleitung:

  • Name Ihres Unternehmens verwenden
  • Verwenden Sie im Namen den Projekt- oder Aktionstyp
  • Verwenden Sie nicht „test“ im Projektnamen

Zum Beispiel sind acme-smarthome und acme-lighting eindeutige und eindeutige Projektnamen.

Projekt erstellen

Ein Entwicklerprojekt repräsentiert ein oder mehrere integrations. Durch die Freigabe eines Projekts für die Mitglieder seines Entwicklungsteams kann der Inhaber anderen Nutzern erlauben, alle integrations im Projekt zu verwalten.

Smart-Home-Geräte von Google integrationwerden mit dem neuen Developer Console verwaltet. Es gibt zwei Methoden zum Einrichten von Projekten im Developer Console:

  1. Erstellen Sie ein neues Projekt.
  2. Importieren Sie ein vorhandenes Projekt aus der Actions on Google-Konsole.

Wir empfehlen, nur ein Projekt für alle Matter-Integrationen (Test und Produktion) zu erstellen, um Probleme beim Testen mit Testanbieter-IDs und Produkt-IDs für Matter zu vermeiden.

Methode 1: Neues Projekt erstellen

Rufen Sie Developer Console auf:

Zur Developer Console

  1. Klicken Sie auf der Seite Projekte verwalten auf Projekt erstellen.
  2. Klicken Sie auf der Seite Jetzt starten auf Projekt erstellen.
  3. Geben Sie den Namen Ihres Projekts ein. Dieser sollte den Richtlinien für Projektnamen entsprechen.
  4. Klicken Sie auf Neues Projekt erstellen.

Sie werden zur Startseite des neuen Projekts zurückgeleitet.

Methode 2: Vorhandenes Projekt aus der Actions on Google-Konsole importieren

Ein vorhandenes Actions on Google-Projekt kann in das neue Developer Console importiert werden, wenn Sie einer vorhandenen Cloud-to-cloud- oder Local Home-Integration die Matter-Unterstützung hinzufügen müssen.

Für diese Methode gelten die folgenden Einschränkungen:

  • Dieser Import ist nur in eine Richtung möglich. Dies kann nicht rückgängig gemacht werden.
  • Nur der Projektinhaber kann ein vorhandenes Actions on Google-Projekt importieren. Der Inhaber ist derjenige, der das Projekt erstellt hat. Das Projekt kann über den Link „Mitglieder“ eingesehen werden.
  • Das Unternehmensprofil für ein importiertes Projekt kann nur in der Actions on Google-Konsole bearbeitet werden. Die Änderungen werden in der Google Home Developer Console angezeigt.

Nach dem Import kann das ursprüngliche Actions on Google-Projekt weiterhin zur Verwaltung vorhandener Integrationen (z. B. Cloud-to-cloud, Local Home, App Discovery) verwendet werden.

Rufen Sie Developer Console auf, um ein vorhandenes Projekt aus Actions on Google Console zu importieren:

Zur Developer Console

  1. Klicken Sie auf Projekt erstellen.
  2. Geben Sie einen vorhandenen Actions-Projektnamen ein oder wählen Sie ein Projekt aus der Drop-down-Liste aus. Im folgenden Screenshot lautet der Projektname beispielsweise „Mein Rechtsangelegenheitsprojekt“.
  3. Klicken Sie auf Projekt importieren.

Sie werden zu den vorhandenen Projektdetails in Developer Console zurückgeleitet.

Google Home Developer Center – Erste Schritte

Logebenen festlegen

Standardmäßig werden für jede Integration in Ihrem Projekt nur Fehlerlogs in Google Cloud gespeichert.

Wenn Sie alle Logs für jede Integration in Google Cloud speichern möchten, wählen Sie im Bereich Steuerung auf Logebene: Fehlerlogs die Option Alle Logs aus.

Projektprotokollebenen im Google Home Developer Center

Diese Einstellung gilt für alle Integrationen in Ihrem Projekt. Es kann nicht pro Integration festgelegt werden. Das Speichern aller Logs in Google Cloud kann zusätzliche Kosten verursachen, wenn der Speicherplatz für die Logs überschritten wird.

Weitere Informationen zu Logs finden Sie unter Cloud Logging für Matter.

Entwicklerprojekt freigeben

Mithilfe von vordefinierten Rollen können Sie den Nutzern in Ihrem Team den Zugriff auf ein Projekt hinzufügen oder entfernen.

  1. Klicken Sie auf der Startseite von 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 auf Mitglieder in GCP verwalten unten im Abschnitt Mitglieder klicken.

  2. Nehmen Sie bei Bedarf Änderungen über das Google Cloud Console-Dashboard vor.

Eine Anleitung zum Ändern des Zugriffs auf ein Projekt finden Sie unter Zugriffssteuerung für Projekte mit IAM.

Nachdem sie der Nutzerliste hinzugefügt wurden, können sie das Projekt und alle Integrationen im Developer Console ansehen.

Je nach Organisationseinstellung können beim Erstellen von Entwicklerprojekten Berechtigungsfehler auftreten. Wenden Sie sich in diesem Fall an Ihren Google Cloud-Administrator und fordern Sie Berechtigungen für Projektersteller für Ihr Konto an.