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) weist mehrere funktionsgefährdende und ergänzende Änderungen auf und fördert mehrere Endpunkte von der Betaversion auf die stabile Version. Die ausführlichen Spezifikationen für API 4.0 finden Sie in unserer API-Referenz. Wir haben unsere von Looker und von der Community unterstützten SDKs aktualisiert, um Looker API 4.0 GA-Endpunkte zu unterstützen. Weitere Informationen finden Sie unter API- und SDK-Supportrichtlinien und API-Versionsverwaltung. Im weiteren Verlauf dieses Artikels werden die funktionsgefährdenden Änderungen, Abhilfemaßnahmen und Funktionen beschrieben, auf die Sie sich bei der Migration zu API 4.0 GA freuen können.
Wer sollte dies lesen?
Dieses Dokument richtet sich an Sie, 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 zugeordnet ist.
Nutzer der Pre-GA API 4.0
Wenn Sie API 4.0 verwenden, lesen Sie diesen Abschnitt. Darin werden die funktionsgefährdenden Änderungen und verfügbaren Abhilfemaßnahmen bei der Migration zu API 4.0 GA behandelt.
In API 4.0 GA werden alle Entitäts-ID-Felder vom numerischen Typ „integer
“ in „string
“ geändert. Beispielsweise gibt GET /groups/{group_id}
endpoint id
als Typ string
statt int64
zurück.
In der folgenden Tabelle finden Sie Informationen zu den Auswirkungen und Maßnahmen zur Schadensbegrenzung für die Nutzung Ihres API 4.0-Endpunkts:
Nutzung | Mögliche Auswirkungen1 | vermeiden |
Mobile Looker-Apps | Veraltete Installationen mobiler Looker-Apps funktionieren nicht mehr | Lassen Sie die Benutzer auf die neueste Version der mobilen Looker-App(s) aktualisieren |
Von Looker unterstützte2 SDKs | ||
TypeScript SDK (4.0 API) | Keine Auswirkungen | Keine Aktion erforderlich |
Python SDK (4.0 API) | Keine Auswirkungen | Keine Aktion erforderlich |
Ruby SDK (4.0 API) | Keine Auswirkungen | Keine Aktion erforderlich |
Von der Community unterstützte SDKs2 | ||
Swift-SDK | Laufzeitausnahmen | Aktualisieren Sie das SDK auf Version 22.0 oder höher und beheben Sie gegebenenfalls eventuell auftretende Typfehler. |
Kotlin SDK | Keine Auswirkungen | Keine Aktion erforderlich |
LookR SDK | Keine Auswirkungen | Keine Aktion erforderlich |
C# SDK | Keine Auswirkungen | Keine Aktion erforderlich |
Go SDK | Laufzeitausnahmen | Aktualisieren Sie das SDK auf Version 22.0 oder höher und beheben Sie gegebenenfalls eventuell auftretende Typfehler. |
Andere | ||
Verwendung der API 4.0 ohne SDK (oder mit extern bereitgestellten Bibliotheken) | Mögliche Laufzeitfehler, je nach Vertraulichkeit des Typs der Sprache | Prüfen Sie den Code auf Abhängigkeiten vom Typ eines ID-Felds und fügen Sie Unterstützung für ID-Felder vom Typ „String“ hinzu. Lesen Sie auch diese zusätzliche Anleitung. |
1: Annahme gängiger Nutzungsmuster, die die Verwendung der ID-Felder von Looker umfassen können, aber keine ungewöhnlichen Nutzungsmuster wie das Anwenden numerischer Vorgänge auf IDs.
2: Unterstützung für Looker API und SDK Von der Community unterstützte Bibliotheken werden von Looker nicht offiziell unterstützt.
API 3.1-Nutzer
Wenn Sie API 3.1 verwenden, lesen Sie diesen Abschnitt. Darin werden die zusätzlichen Funktionen und Änderungen beschrieben, die Ihnen durch API 4.0 zur Verfügung gestellt werden. Beachten Sie, dass alle unsere von Looker und von der Community unterstützten SDKs hauptsächlich API 4.0 unterstützen. Weitere Informationen finden Sie unter SDK- und API-Supportrichtlinien.
Zusätzliche GA-Funktionen in API 4.0
Im Folgenden haben wir die wichtigsten und nützlichsten additiven API 4.0-Änderungen für Sie aufgelistet:
- Erstellen und Verwalten von Board-, Board-Elementen und Board-Abschnitten. Weitere Informationen zu Boards finden Sie auf der Board-Dokumentationsseite.
- Fragen Sie zusätzliche Verbindungsinformationen wie Datenbanken, Schemas, Spalten und Tabellen ab. Legen Sie zusätzliche Verbindungsfelder fest und aktualisieren Sie sie.
- Erstellung und Verwaltung von OAuth-Apps und -Nutzern Weitere Informationen zu OAuth finden Sie auf der OAuth-Dokumentationsseite.
- Nach Gruppen mit Hierarchie und Rollen suchen.
- Rollen mit Nutzeranzahl suchen
- Einstellungen für Looker-Instanzen abrufen und festlegen Weitere Informationen finden Sie auf der Dokumentationsseite zu Einstellungen.
- Benachrichtigungen erstellen und verwalten Weitere Informationen zu Benachrichtigungen finden Sie auf der Dokumentationsseite zu Benachrichtigungen.
- SSH-Tunnel und SSH-Server erstellen, verwalten und testen Weitere Informationen zu SSH finden Sie auf der SSH-Dokumentationsseite.
- Dashboards verschieben und kopieren.
- Relative URLs für neue Dashboards abrufen
- Looks verschieben und kopieren:
- Signierte Einbettung und nicht signierte Einbettungs-Secrets, URLs sowie Nutzererstellung und ‐verwaltung
- Rufen Sie ein Aktualisierungstoken ab, um das Zugriffstoken für die Anmeldung zu aktualisieren.
- Begrenzen und verschieben Sie die Ergebnisse aus dem Abrufen von allen LookML-Modellen und allen Nutzern.
- Beschränken und verschieben Sie die Ergebnisse von suchenden Nutzern.
- API-Spezifikation für Looker-Instanz in Swagger 2.x JSON abrufen
Änderungen bei der Einstellung von API 4.0 GA
API 4.0 GA ersetzt mehrere eingestellte API 3.1-Endpunkte durch verbesserte Funktionen. Die folgenden Endpunkte sind betroffen:
- Eingestellte Startseiten-Endpunkte wurden entfernt. Verwende Board-Endpunkte anstelle von Startseiten. Weitere Informationen finden Sie unter Inhalte mit Boards präsentieren.
- Veraltete Space-Endpunkte wurden entfernt. Verwenden Sie Ordnerendpunkte anstelle von Leerzeichen. Weitere Informationen finden Sie unter Zugriff auf Inhalte organisieren und verwalten.
API 3.0-Nutzer
API 3.0 wurde eingestellt. Es wird empfohlen, zu API 4.0 zu migrieren.
- Nur API 4.0 unterstützt alle von Looker und von der Community unterstützten SDKs, um Ihnen die Entwicklung zu erleichtern. Dann sehen Sie sich unser SDK-Repository an.
- Mit API 4.0 werden mehrere neue Funktionen und Verbesserungen eingeführt, die im Abschnitt Zusätzliche GA-Funktionen für API 4.0 auf dieser Seite aufgeführt sind.
Zusammenfassung
Freuen Sie sich auf neue Funktionen und additive Änderungen, die zu API 4.0 hinzugefügt werden. Die neuesten Änderungen finden Sie jederzeit in unserer API-Referenz. Weitere Informationen finden Sie unter API- und SDK-Supportrichtlinien und API-Versionsverwaltung. Wir wissen, dass funktionsgefährdende Änderungen nicht ideal sind. Sofern kein extremes Problem auftritt, werden wir keine funktionsgefährdenden Ä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.