Zugriff auf die Apple Business‑API für Unternehmen
Du kannst Drittanbieter‑Partnern erlauben, Unternehmen in Apple Business zu verwalten, indem du eine von Apple bereitgestellte API verwendest.
Apple Business-API mit Logos und Titelbildern verwenden
Das Anwenden von Titelbildern und Logos mithilfe der Apple Business-API erfordert, dass die Organisation und die Drittanbieter‑Partner bei Apple Business registriert sind und dass die Organisation die Befugnis erfolgreich an den Drittanbieter‑Partner delegiert hat. Siehe Verwende eine Organisations-ID, um deine Inhalte mit Drittanbieter‑Partnern zu teilen.
Die Apple Business-API für Präsentationen verwenden
Das Erstellen von Schaukästen mithilfe der Apple Business‑API erfordert, dass die Organisation und der Drittanbieter‑Partner bei Apple Business registriert sind und dass die Organisation die Befugnis erfolgreich an den Drittanbieter‑Partner delegiert. Siehe Verwende eine Organisations-ID, um deine Inhalte mit Drittanbieter‑Partnern zu teilen.
Um die visuellen Elemente und Einstellungen von Schaukästen – z. B. Call-to-Action, Überschrift- und Textkörperinhalte, Foto und alternativen Text für Sehbehinderte – anzuzeigen, melde dich an und überprüfe „Schaukasten-Creative“. Um den Veröffentlichungsstatus anzuzeigen und den Zeitrahmen, Ressourcendetails und IDs zu definieren, melde dich an und überprüfe den Schaukasten.
Dienstaccounts
Ein Dienstaccount ist ein spezieller Accounttyp, der ein System repräsentiert, das sich authentifizieren muss und für den Zugriff auf die Apple Business-API autorisiert werden muss.
Du kannst Entwickler:innen erlauben, sich über eine von Apple bereitgestellte API mit Apple Business zu verbinden. Um den Zugriff für einen Dienstaccount zu beantragen, musst du Administrator:in der Organisation oder Marketing-Administrator:in eines von Apple genehmigten Drittanbieter‑Partners sein.
Den „API Onboarding Guide“ (Leitfaden zur API‑Einführung) überprüfen
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle neben „API‑Zugriff“ die Option „API Onboarding Guide" (Leitfaden zur API‑Einführung) aus.
Du kannst jetzt API‑Zugriff beantragen und dich an deine:n Apple-Ansprechpartner:in wenden.
API-Zugriff anfordern
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle „API‑ Zugriff anfordern“ aus und wähle dann eine der folgenden Optionen aus:
Objektverwaltung
Point of Sale-Software
Verwaltung von Rezensionen
Marketing
Redaktionelle Inhalte
Andere
Wähle „Weiter“ aus und beantworte dann die Fragen:
Arbeitest du direkt mit den Eigentümer:innen eines physischen Standorts zusammen?
Wer sind deine größten Kund:innen?
Wähle „Weiter“ aus, dann wähle den Datentyp aus und gib die Gesamtzahl ein.
Wähle „Anfrage senden“ aus.
Apple wird die Anfrage prüfen. Du erhältst eine E‑Mail, wenn die Prüfung abgeschlossen ist.
Dienstaccount erstellen
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle
neben „API‑Integrator“ aus.Füge bei Bedarf manuell einen neuen Benutzeraccount hinzu, der die Rolle „Dienstaccount“ übernimmt. Siehe Neue Benutzer:innen manuell hinzufügen.
Wähle „Dienstaccount hinzufügen“ aus.
Gib einen Dienstnamen und eine:n Ansprechpartner:in des Teams ein und lege die Rollenzugriffsrechte für den Dienstaccount fest – entweder „Lesen und Schreiben“ oder „Nur lesen“.
Wähle „Hinzufügen“ aus.
Die Client-ID und der geheime Schlüssel (Secret Key) des Clients werden für dieses Service-Account angezeigt.
Kopiere diese Informationen an einen sicheren Standort.
Wichtig: Wenn du dieses Fenster abbrichst, ohne den geheimen Schlüssel (Secret Key) des Clients zu kopieren, musst du einen neuen Schlüssel erstellen.
Wähle „Fertig“ aus.
Du hast erfolgreich einen Dienstaccount erstellt.
Die API‑Integration bestätigen
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle „API‑Integration“ aus, wähle „API‑Integration bestätigen“ und dann „Senden“ aus.
Benutzer:innen: innen mit den folgenden Rollen erhalten eine E‑Mail, wenn die Prüfung abgeschlossen ist:
Administrator:innen der Organisation
Marketing-Administrator:innen
Dienstaccounts
API‑Daten qualifizieren
Nachdem du die API‑Integration bestätigt hast, kannst du die Daten qualifizieren.
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle
neben „Datenqualifizierung“ aus.Führe einen der folgenden Schritte aus:
Wähle einen bestehenden Dienstaccount aus.
Wähle „Dienstaccount hinzufügen“ aus. Siehe Dienstaccount erstellen.
Wähle „Datenqualität bestätigen“ und dann „Senden“ aus.
Benutzer:innen: innen mit den folgenden Rollen erhalten eine E‑Mail, wenn die Prüfung abgeschlossen ist:
Administrator:innen der Organisation
Marketing-Administrator:innen
Dienstaccounts
Veröffentliche deine Inhalte für die Produktion
Nutze die API für Unternehmen und Standort, um deine Daten zur Anzeige in Karten und auf Apple an die Produktion zu übermitteln.
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle
neben „Produktion“ aus.Führe einen der folgenden Schritte aus:
Wähle einen bestehenden Dienstaccount aus.
Wähle „Dienstaccount hinzufügen“ aus. Siehe Dienstaccount erstellen.
Wähle deine API aus.
Einen Dienstaccount entfernen
Melde dich in Apple Business mit einem Benutzeraccount an, der über die Rolle „Administrator:in der Organisation“ oder „Marketing-Administrator:in“ verfügt.
Informationen zu Rollen und Zugriffsrechten findest du unter Einführung in Rollen und Zugriffsrechte.
Wähle in deinem Browser „Einstellungen“ > „Integrationen“ > „API“ aus.
Wähle „API‑Integration“ aus.
Wähle „Bearbeiten“ neben dem Dienstaccount, den du entfernen möchtest, aus.
Wähle „Entfernen“ und dann „Entfernen“ aus.
Der Dienstaccount wird entfernt und alle damit verbundenen API‑Verbindungen zu Apple Business werden ebenfalls widerrufen.