Benutzerdefinierte Apps

Eine benutzerdefinierte App ist eine App, die von dir oder einem Entwickler ausschließlich für deinen Shopify-Shop entwickelt wird (im Gegensatz zu öffentlichen Apps, die für mehrere Shops entwickelt werden). Du kannst mit benutzerdefinierten Apps Funktionen zum Shopify-Adminbereich hinzufügen, über Shopify-APIs direkt auf Daten aus dem Onlineshop zugreifen oder diesen mit der Storefront-API auf andere Plattformen ausdehnen.

Hinweis

Auf dieser Seite wird erklärt, wie man eine benutzerdefinierte App im Shopify-Adminbereich erstellt und authentifiziert, egal ob du der Shop-Inhaber oder ein Entwickler mit einem Mitarbeiterkonto oder Gastkonto bist. Wenn du Entwickler bist, erhältst du in der Entwicklerdokumentation für benutzerdefinierte Apps mehr Informationen zu benutzerdefinierten Apps.

Das Erstellen einer benutzerdefinierten App setzt Entwicklungskenntnisse voraus und kann schwierig sein. Wenn du beim Erstellen von benutzerdefinierten Apps für deinen Shop Hilfe benötigst, kannst du einen Shopify-Partner engagieren. Erhalte mehr Informationen über das Engagieren von Shopify-Partnern.

Wenn du möchtest, dass ein Gast- oder Mitarbeiterkonto benutzerdefinierte Apps erstellt, bearbeitet oder löscht, kannst du ihnen die Berechtigung Apps entwickeln geben. Das Gast- oder Mitarbeiterkonto muss auch über die relevanten Berechtigungen verfügen, um bestimmte API-Bereiche festzulegen.

Benutzerdefinierte PII-Stufe-2-Apps

Berechtigungen legen fest, auf welche Arten von Informationen aus deinem Shop eine App zugreifen kann oder welche Informationen sie bearbeiten kann, um ihre Funktionen auszuführen.

Personenbezogene Daten (PII) sind Daten, die einzeln oder in Kombination eine Einzelperson eindeutig identifizieren. Apps, die du im Shopify App Store installierst, können auf verschiedene Arten personenbezogener Daten zugreifen, wenn sie Informationen über deinen Shop, deine Kunden, deine Bestellungen oder andere Geschäftsdaten verwenden. Um auf benutzerdefinierte PII-Stufe-2-Apps zuzugreifen, musst du den Shopify-Plan oder einen höheren Plan nutzen.

Achtung

Wenn du dich für einen Plan registrierst oder für deinen Plan ein Downgrade auf den Basic Shopify-Plan oder den Shopify Starter-Plan durchführst, hast du keinen Zugriff auf benutzerdefinierte PII-Stufe-2-Apps.

Entwicklung benutzerdefinierter Apps über den Shopify-Adminbereich aktivieren

Bevor du eine benutzerdefinierte App für deinen Shop erstellen kannst, musst du die Entwicklung benutzerdefinierter Apps aktivieren. Du musst Shop-Inhaber oder Mitarbeiter mit der Berechtigung App-Entwicklung aktivieren sein, um die Entwicklung benutzerdefinierter Apps zu aktivieren.

Schritte:

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf Benutzerdefinierte App-Entwicklung erlauben.

4. Lies die bereitgestellte Warnung und die bereitgestellten Informationen und klicke dann auf Benutzerdefinierte App-Entwicklung erlauben.

Eine benutzerdefinierte App erstellen und installieren

Nachdem du die benutzerdefinierte App-Entwicklung aktiviert hast, kannst du eine benutzerdefinierte App in deinem Shopify-Adminbereich erstellen und installieren. Du musst die API-Bereiche festlegen, um zu bestimmen, auf welche Teile deines Shops die benutzerdefinierte App zugreifen kann. Nachdem die App installiert wurde, erhältst du Zugriffstoken, die von der App verwendet werden, um anhand der APIs von Shopify auf Informationen aus deinem Shop zuzugreifen.

Der Shop-Inhaber sowie Mitarbeiter und Gäste mit den relevanten Berechtigungen können benutzerdefinierte Apps erstellen und installieren.

Tipp

Wenn du beim Erstellen von benutzerdefinierten Apps für deinen Shop Hilfe benötigst, kannst du einen Shopify-Partner engagieren. Erhalte mehr Informationen über das Engagieren von Shopify-Partnern.

App erstellen

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf Benutzerdefinierte App erstellen.

4. Gib im modalen Fenster den App-Namen ein und wähle einen App-Entwickler aus. Der App-Entwickler kann der Shop-Inhaber oder ein beliebiges Mitarbeiter- oder Gastkonto mit der Berechtigung Apps entwickeln sein.

5. Klicke auf App erstellen.

API-Bereiche auswählen

Nachdem du eine benutzerdefinierte App erstellt hast, kannst du ihr API-Bereiche zuweisen. Eine benutzerdefinierte App kann abhängig von den Anforderungen der App Admin-API-Bereiche, Storefront-API-Bereiche oder beides haben. Vor der Installation der App musst du mindestens einen Bereich auswählen.

Achtung

Die Storefront-API ist eine nicht authentifizierte öffentliche API. Dies bedeutet, dass alle Besucher deines Shops Zugriff erhalten können auf alle Daten, die du für die App freigibst.Du solltest die Storefront-API nur verwenden, wenn dir dieses Risiko bewusst ist und du damit kein Problem hast. Außerdem solltest du nur Berechtigungen für die Arten von Daten erteilen, die die private App benötigt.

Schritte:

1. Klicke auf Bereiche auswählen.

2. Wähle im Abschnitt Zugriffsbereiche der Admin-API die API-Bereiche aus, die du der App zuweisen möchtest.

   1. Optional: Lege die API-Version fest, die du für deine Webhook-Abonnements nutzen möchtest.
   2. Optional: Du kannst Google Cloud Pub/Sub so einrichten, dass es Webhook-Abonnements für die App verarbeitet. Kopiere im Abschnitt Google Cloud Pub/Sub die Adresse des Shopify-Servicekontos und verwende sie, um dein Google Cloud Pub/Sub-Konto zu konfigurieren.
   3. Optional: Du kannst Amazon EventBridge so einrichten, dass es Webhook-Abonnements für die App verarbeitet. Klicke im Abschnitt Amazon EventBridge auf Quelle erstellen.

3. Wähle im Abschnitt Zugriffsbereiche der Storefront-API die API-Bereiche aus, die du der App zuweisen möchtest.

4. Klicke auf Speichern.

App installieren und API-Zugriffstoken erhalten

Nachdem du API-Bereiche für deine App festgelegt hast, kannst du die App installieren. Nach der Installation erhältst du deine API-Zugriffstoken. Abhängig davon, welche API-Bereiche du der App zugewiesen hast, erhältst du einen Admin-API-Zugriffstoken, einen Storefront-API-Zugriffstoken oder beide.

Achtung

Der Admin-API-Zugriffstoken wird nur ein Mal angezeigt, da der Token API-Zugriff auf sensible Shop-Daten gewährt. Nachdem der Zugriffstoken eingeblendet wurde, notiere ihn an einem sicheren Ort, sodass nur du auf ihn zugreifen kannst.

Behandle den Token wie ein Passwort. Teile den Zugriffstoken nur mit Entwicklern, denen du vertraust.

Schritte:

1. Klicke auf App installieren.
2. Klicke im modalen Fenster auf App installieren.
3. Abrufen des Zugriffstokens:
   • Wenn du die Admin-API-Bereiche für die App ausgewählt hast, gehe zum Abschnitt Admin-API-Zugriffstoken und klicke auf Token einmalig einblenden. Nachdem der vollständige Zugriffstoken beim ersten Zugriff auf diese Seite eingeblendet wurde, zeigt diese Seite bei allen weiteren Besuchen nur die letzten vier Ziffern des Zugriffstoken zu Referenzzwecken an.
   • Wenn du Storefront-API-Bereiche für die App ausgewählt hast, kannst du zum Bereich Storefront-API-Zugriffstoken gehen und deinen Token kopieren. Im Gegensatz zum Admin-API-Zugriffstoken ist der Storefront-API-Zugriffstoken immer auf dieser Seite verfügbar.

API-Anmeldedaten für benutzerdefinierte App erhalten

Du kannst den Storefront-Zugriffstoken, den API-Schlüssel und das API-Geheimnis einer benutzerdefinierten App auf der Seite API-Anmeldedaten der App überprüfen. Du kannst auch den Admin-API-Zugriffstoken überprüfen, aber nachdem er das erste Mal nach Betreten der Seite eingeblendet wurde, sind nur noch die letzten vier Ziffern des Tokens abrufbar.

Hinweis

Der geheime API-Schlüssel entspricht einem geteilten geheimen Schlüssel. Wenn ein Entwickler nach einem geteilten geheimen Schlüssel fragt, musst du deinen geheimen API-Schlüssel bereitstellen. Denke daran, deinen geheimen API-Schlüssel nur mit Entwicklern zu teilen, denen du vertraust.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf den Namen der App, deren Anmeldedaten du benötigst.

4. Klicke auf API-Anmeldedaten.

Admin-API-Bereiche für benutzerdefinierte App aktualisieren

Wenn du ein Shop-Inhaber oder ein Mitarbeiter oder Gast mit den relevanten Berechtigungen bist, kannst du die Bereiche für eine benutzerdefinierte App aktualisieren.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf den Namen der App, die du aktualisieren möchtest.

4. Klicke auf Konfiguration.

5. Klicke im Abschnitt Admin-API-Integration auf Bearbeiten.

   • Klicke auf Konfigurieren, wenn du vorher keine Admin-API-Bereiche zugewiesen hast.

6. Wähle die Bereiche aus, die du der App zuweisen möchtest.

7. Optional: Lege die API-Version fest, die du für deine Webhook-Abonnements nutzen möchtest.

8. Optional: Du kannst Google Cloud Pub/Sub so einrichten, dass es Webhook-Abonnements für die App verarbeitet. Kopiere im Abschnitt Google Cloud Pub/Sub die Adresse des Shopify-Servicekontos und verwende sie, um dein Google Cloud Pub/Sub-Konto zu konfigurieren.

9. Optional: Du kannst Amazon EventBridge so einrichten, dass es Webhook-Abonnements für die App verarbeitet. Klicke im Abschnitt Amazon EventBridge auf Quelle erstellen.

10. Klicke auf Speichern.

Wenn die App im Shop installiert ist, kannst du nicht auf Speichern klicken, außer es ist mindestens ein Bereich ausgewählt oder wenn der App Storefront-API-Bereiche zugewiesen wurden.

Storefront-API-Zugriffsbereiche für benutzerdefinierte App aktualisieren

Achtung

Die Storefront-API ist eine nicht authentifizierte öffentliche API. Dies bedeutet, dass alle Besucher deines Shops Zugriff erhalten können auf alle Daten, die du für die App freigibst.Du solltest die Storefront-API nur verwenden, wenn dir dieses Risiko bewusst ist und du damit kein Problem hast. Außerdem solltest du nur Berechtigungen für die Arten von Daten erteilen, die die private App benötigt.

Wenn du ein Shop-Inhaber oder ein Mitarbeiter oder Gast mit den relevanten Berechtigungen bist, kannst du die Bereiche für eine benutzerdefinierte App aktualisieren.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf den Namen der App, die du aktualisieren möchtest.

4. Klicke auf Konfiguration.

5. Klicke im Abschnitt Storefront-API-Integration auf Bearbeiten.

   • Klicke auf Konfigurieren, wenn du vorher keine Storefront-API-Bereiche zugewiesen hast.

6. Wähle die Bereiche aus, die du der App zuweisen möchtest.

7. Optional: Wenn deine App im iOS Buy Software Development Kit (SDK) integriert ist, kannst du alle nötigen Änderungen im Abschnitt iOS Buy SDK vornehmen. Du kannst nur Änderungen in diesem Abschnitt vornehmen, wenn die App bereits installiert wurde.

   • Weitere Anweisungen erhältst du in der iOS Buy SDK-Entwicklerdokumentation.

8. Optional: Wenn deine App bei der Android Buy SDK integriert ist, kannst du alle nötigen Änderungen im Abschnitt Android Buy SDK vornehmen. Du kannst nur Änderungen in diesem Abschnitt vornehmen, wenn die App bereits installiert wurde.

   • Weitere Anweisungen erhältst du in der Android Buy SDK-Entwicklerdokumentation.

9. Klicke auf Speichern.

Wenn die App im Shop installiert ist, kannst du nicht auf Speichern klicken, außer es ist mindestens ein Bereich ausgewählt oder wenn der App Storefront-API-Bereiche zugewiesen wurden.

Einstellungen für benutzerdefinierte App aktualisieren

Du kannst den Namen und die Beschreibung der App aktualisieren, sowie den App-Entwickler.

Wenn du den App-Entwickler als Gast- oder Mitarbeiterkonto festlegst und dieses Konto später löscht, wird der Shop-Inhaber standardmäßig als App-Entwickler festgelegt.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf den Namen der App, die du aktualisieren möchtest.

4. Klicke auf App-Einstellungen.

5. Um den Namen oder die Beschreibung zu ändern, gib einen neuen App-Namen oder eine neue App-Beschreibung ein.

6. Um den mit der App assoziierten App-Entwickler zu ändern, wähle einen Haupt-App-Entwickler aus.

7. Optional: Um eine andere E-Mail-Adresse über Entwicklungsaktualisierungen für diese App zu informieren, gib die E-Mail-Adresse unter Kontakt für Entwicklungsaktualisierungen ein.

8. Klicke auf Speichern.

Benutzerdefinierte App deinstallieren

Wenn du eine benutzerdefinierte App deinstallierst, werden die Adminbereich- und Storefront-API-Zugriffstoken widerrufen und alle in der App registrierten Webhooks und Fulfillmentdienste entfernt. Außerdem kann App keine Shop-Daten mehr abrufen. Wenn du die App erneut installierst, erhältst du neue Zugriffstoken.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf den Namen der App, die du deinstallieren möchtest.

4. Klicke auf App deinstallieren.

Benutzerdefinierte App löschen

Wenn du eine benutzerdefinierte App löscht, kann dieser Schritt nicht rückgängig gemacht werden. Wenn du eine App in deinem Shop zeitweise deaktivieren möchtest, ohne sie zu löschen, deinstalliere die App stattdessen.

1. Klicke in deinem Shopify-Adminbereich auf Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Apps erstellen.

3. Klicke auf App-Einstellungen.

4. Klicke auf App löschen.

API-Bereichsberechtigungen für benutzerdefinierte Apps

Gast- und Mitarbeiterkonten können API-Bereiche für benutzerdefinierte Apps nur festlegen, wenn das Konto über die Berechtigung Apps entwickeln verfügt, sowie alle weiteren Mitarbeiterberechtigungen, die mit den API-Bereichen in Verbindung stehen, die sie festlegen.

Du solltest dich mit dem Entwickler deiner App beraten, um festzulegen, welche Kontoberechtigungen und API-Bereiche die benutzerdefinierte App benötigt, um zu funktionieren. Stelle sicher, dass du die Berechtigungen, die du dem Entwickler gewährst, verstehst und mit ihnen umgehen kannst.