Wir freuen uns, Ihnen mitteilen zu können, dass die Looker API 4.0 in Looker 22.4 allgemein verfügbar ist. Die allgemein verfügbare API 4.0 (API 4.0 GA) enthält mehrere grundlegende und ergänzende Änderungen und stuft mehrere Endpunkte von Beta auf stabil hoch. In unserer API-Referenz finden Sie detaillierte Spezifikationen zur API 4.0. Wir haben unsere von Looker unterstützten und von der Community unterstützten SDKs aktualisiert, um die Endpunkte der Looker API 4.0 GA zu unterstützen. Weitere Informationen finden Sie unter Richtlinien für API- und SDK-Support und API-Versionierung. Im Rest dieses Artikels werden die grundlegenden Änderungen, Abhilfemaßnahmen und Funktionen beschrieben, auf die Sie sich bei der Migration zur API 4.0 GA freuen können.
Für wen ist dieser Artikel gedacht?
Dieser Artikel ist für Sie relevant, wenn Sie die Looker API über von Looker unterstützte SDKs, von der Community unterstützte SDKs oder die API selbst verwenden. Lesen Sie den folgenden Abschnitt, der der von Ihnen verwendeten Looker API-Version entspricht.
Nutzer der API 4.0 vor der allgemeinen Verfügbarkeit
Wenn Sie die API 4.0 verwenden, lesen Sie diesen Abschnitt. Darin werden die grundlegenden Änderungen und verfügbaren Abhilfemaßnahmen bei der Migration zur API 4.0 GA beschrieben.
Bei der API 4.0 GA werden alle Felder für Entitäts-IDs vom numerischen Typ integer in den Typ string geändert. Beispielsweise gibt GET /groups/{group_id} Endpunkt id als Typ string anstelle von Typ int64 zurück.
In der folgenden Tabelle finden Sie Informationen zu den Auswirkungen und Abhilfemaßnahmen für die spezifische Verwendung von API 4.0-Endpunkten:
| Nutzung | Mögliche Auswirkungen1 | Vermeidung |
| Mobile Looker-Apps | Veraltete Installationen mobiler Looker-Apps funktionieren nicht mehr | Nutzer müssen auf die neueste Version der mobilen Looker-App(s) aktualisieren |
| Von Looker unterstützte2 SDKs | ||
| TypeScript SDK (API 4.0) | Keine Auswirkungen | Keine Maßnahme erforderlich |
| Python SDK (API 4.0) | Keine Auswirkungen | Keine Maßnahme erforderlich |
| Ruby SDK (API 4.0) | Keine Auswirkungen | Keine Maßnahme erforderlich |
| Von der Community unterstützte2 SDKs | ||
| Swift SDK | Laufzeitausnahmen | Aktualisieren Sie das SDK auf Version 22.0 oder höher und beheben Sie dann alle daraus resultierenden Typfehler. |
| Kotlin SDK | Keine Auswirkungen | Keine Maßnahme erforderlich |
| LookR SDK | Keine Auswirkungen | Keine Maßnahme erforderlich |
| C# SDK | Keine Auswirkungen | Keine Maßnahme erforderlich |
| Go SDK | Laufzeitausnahmen | Aktualisieren Sie das SDK auf Version 22.0 oder höher und beheben Sie dann alle daraus resultierenden Typfehler. |
| Sonstiges | ||
| Verwendung der API 4.0 ohne SDK (oder mit extern bereitgestellten Bibliotheken) | Mögliche Laufzeitfehler, je nach Typempfindlichkeit der Sprache | Prüfen Sie den Code auf Abhängigkeiten vom Typ der ID-Felder und fügen Sie Unterstützung für ID-Felder vom Typ „string“ hinzu. Lesen Sie auch diese zusätzlichen Hinweise. |
1: Unter Annahme gängiger Nutzungsmuster, die die Verwendung von Looker-ID-Feldern umfassen können, aber keine ungewöhnlichen Nutzungsmuster wie das Anwenden numerischer Operationen auf IDs.
2: Looker API- und SDK-Support. Von der Community unterstützte Bibliotheken werden von Looker nicht offiziell unterstützt.
Nutzer der API 3.1
Wenn Sie die API 3.1 verwenden, lesen Sie diesen Abschnitt. Darin werden die zusätzlichen Funktionen und Änderungen beschrieben, die Ihnen mit der API 4.0 zur Verfügung stehen. Alle von Looker unterstützten und von der Community unterstützten SDKs unterstützen hauptsächlich die API 4.0. Weitere Informationen finden Sie unter Richtlinien für SDK- und API-Support.
Zusätzliche Funktionen der API 4.0 GA
Zur Vereinfachung haben wir die wichtigsten und nützlichsten ergänzenden Änderungen der API 4.0 für Sie aufgelistet:
- Erstellung und Verwaltung von Boards, Boardelementen und Boardabschnitten. Weitere Informationen zu Boards finden Sie auf der Dokumentationsseite zu Boards.
- Zusätzliche Verbindungsinformationen wie Datenbanken, Schemas, Spalten und Tabellen abfragen. Zusätzliche Verbindungsfelder festlegen und aktualisieren.
- Erstellung und Verwaltung von OAuth-Apps und ‑Nutzern. Weitere Informationen zu OAuth finden Sie auf der Dokumentationsseite zu OAuth.
- Gruppen mit Hierarchie und Rollen suchen.
- Rollen mit Nutzeranzahl suchen.
- Looker-Instanzeinstellungen abrufen und festlegen. Weitere Informationen zu Einstellungen finden Sie auf der Dokumentationsseite zu Einstellungen.
- Erstellung und Verwaltung von Benachrichtigungen. Weitere Informationen zu Benachrichtigungen finden Sie auf der Dokumentationsseite zu Benachrichtigungen.
- Erstellung, Verwaltung und Tests von SSH-Tunneln und ‑Servern. Weitere Informationen zu SSH finden Sie auf der Dokumentationsseite zu SSH.
- Dashboards verschieben und kopieren.
- Relative URLs für neue Dashboards abrufen.
- Looks verschieben und kopieren.
- Erstellung und Verwaltung von signierten und nicht signierten Einbettungs-Secrets, ‑URLs und ‑Nutzern.
- Aktualisierungstoken abrufen, um das Zugriffstoken für die Anmeldung zu aktualisieren.
- Ergebnisse beim Abrufen von allen LookML-Modellen und allen Nutzern begrenzen und versetzen.
- Ergebnisse bei der Suche nach Nutzern begrenzen und versetzen.
- API-Spezifikation der Looker-Instanz in Swagger 2.x JSON abrufen.
Änderungen bei der Einstellung der API 4.0 GA
Die API 4.0 GA ersetzt mehrere eingestellte API 3.1-Endpunkte durch verbesserte Funktionen. Die folgenden Endpunkte sind betroffen:
- Eingestellte Homepage-Endpunkte wurden entfernt. Verwenden Sie anstelle von Homepages Board-Endpunkte. Weitere Informationen finden Sie unter Inhalte mit Boards präsentieren.
- Eingestellte Endpunkte für Gruppenbereiche wurden entfernt. Verwenden Sie anstelle von Gruppenbereichen Ordner-Endpunkte. Weitere Informationen finden Sie unter Zugriff auf Inhalte organisieren und verwalten.
Nutzer der API 3.0
Die API 3.0 ist eingestellt. Wir empfehlen, zur API 4.0 zu migrieren.
- Nur die API 4.0 unterstützt alle von Looker unterstützten und von der Community unterstützten SDKs, um die Entwicklung zu erleichtern. Weitere Informationen finden Sie in unserem SDK-Repository.
- Die API 4.0 bietet mehrere neue Funktionen und Verbesserungen, die im Abschnitt Zusätzliche Funktionen der API 4.0 GA auf dieser Seite aufgeführt sind.
Zusammenfassung
Sie können sich auf neue Funktionen und ergänzende Änderungen freuen, die der API 4.0 hinzugefügt werden. Die neuesten Änderungen finden Sie immer in unserer API-Referenz. Weitere Informationen finden Sie unter Richtlinien für API- und SDK-Support und API-Versionierung. Wir wissen, dass grundlegende Änderungen nicht ideal sind. Sofern kein extremes Problem auftritt, werden wir keine grundlegenden Änderungen an unserer allgemein verfügbaren API 4.0 vornehmen. Wir hoffen, dass unsere allgemein verfügbare Looker API 4.0 Ihnen hilft, produktiver und einfacher auf der Looker-Plattform zu entwickeln.