wir freuen uns, Ihnen mitteilen zu können, dass die Looker API 4.0 allgemein in Looker 22.4 verfügbar ist. Die allgemein verfügbaren API-Versionen von API 4.0 (API 4.0) haben mehrere funktionsgefährdende und zusätzliche Änderungen. Außerdem werden damit mehrere Endpunkte von der Betaversion zur stabilen Version hochgestuft. API 3.1 und 3.0 sind davon nicht betroffen. Detaillierte Informationen zu API 4.0 finden Sie in der API-Referenz. Wir haben unsere von Looker unterstützten und von der Community unterstützten SDKs aktualisiert, um die Looker API 4.0 GA-Endpunkte zu unterstützen. Weitere Informationen finden Sie in unseren Supportrichtlinien für APIs und SDKs und zur Versionsverwaltung unserer APIs. Im Rest dieses Artikels werden die funktionsgefährdenden Änderungen, Risikominderungen und Funktionen beschrieben, auf die Sie sich bei der Migration zu API 4.0 GA freuen können.
Wer soll das 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 aktuell verwendeten Looker API-Version entspricht.
Nutzer der Pre-GA API 4.0
Wenn Sie API 4.0 verwenden, lesen Sie diesen Abschnitt. Sie enthält die funktionsgefährdenden Änderungen und Möglichkeiten zur Risikominderung bei der Migration zu API 4.0 GA in Looker 22.4.
In API 4.0 sind alle Entitäts-ID-Felder vom numerischen Typ integer
in den Typ string
geändert. Beispiel: GET /groups/{group_id}
Endpunkt gibt id
als Typ string
und nicht int64
zurück.
In der folgenden Tabelle finden Sie Informationen zu den Auswirkungen und Maßnahmen zur Risikominimierung für Ihre API 4.0-Endpunktnutzung:
Nutzung | Potenzielle Auswirkungen1 | Prävention |
Looker-Apps | Veraltete Installation von mobilen Looker-Apps funktioniert nicht mehr | Nutzer auf die neueste Version der mobilen Looker App aktualisieren |
Looker-unterstützt2 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ützte2 SDKs | ||
Swift SDK | Laufzeitausnahmen | Aktualisieren Sie das SDK auf Version 22.0 oder höher und beheben Sie gegebenenfalls Fehler des entsprechenden Typs. |
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 Fehler des entsprechenden Typs. |
Andere | ||
4.0 API ohne SDK oder mit extern bereitgestellten Bibliotheken verwenden | Mögliche Laufzeitfehler, abhängig von der Sprachempfindlichkeit der Sprache | Überprüfen Sie den Code auf Abhängigkeiten vom Typ eines ID-Felds und fügen Sie Unterstützung für String-Typ-ID-Felder hinzu. Weitere Informationen finden Sie in diesem Hilfeartikel. |
1: Annahme gängiger Nutzungsmuster, die unter Umständen die Verwendung der ID-Felder von Looker, jedoch keine ungewöhnlichen Nutzungsmuster wie das Anwenden numerischer Vorgänge auf IDs enthalten.
2: Unterstützung für Looker API und SDK. Von der Community unterstützte Bibliotheken werden in Looker nicht offiziell unterstützt.
API 3.1-Nutzer
Wenn Sie API 3.1 verwenden, lesen Sie diesen Abschnitt. Sie enthält Informationen zu den zusätzlichen Funktionen und Änderungen von API 4.0. Beachten Sie, dass alle von Looker unterstützten und von der Community unterstützten SDKs hauptsächlich API 4.0 unterstützen. Weitere Informationen finden Sie in unseren Supportrichtlinien für SDKs und APIs.
Zusätzliche GA 4.0-GA-Funktionen
Hier sind die wichtigsten und nützlichsten Änderungen an API 4.0 für Sie:
- Erstellen und Verwalten eines Boards, Board-Elements und Boardabschnitts. Die Dokumentation zum Board finden Sie hier.
- Zusätzliche Verbindungsinformationen wie Datenbanken, Schemas, Spalten und Tabellen abfragen. Zusätzliche Verbindungsfelder festlegen und aktualisieren.
- OAuth-Apps und -Nutzer erstellen und verwalten Die OAuth-Dokumentation finden Sie hier.
- Gruppen mit Hierarchie und Rollen suchen
- Suchrollen mit Nutzeranzahl:
- Rufen Sie die Looker-Instanzeinstellungen ab und legen Sie sie fest. Die Dokumentation zu den Einstellungen finden Sie hier.
- Benachrichtigungen erstellen und verwalten Die Dokumentation zu Benachrichtigungen finden Sie hier.
- SSH-Tunnel und SSH-Server erstellen, verwalten und testen Die SSH-Dokumentation finden Sie hier.
- Dashboards verschieben und kopieren
- Relative URLs für neue Dashboards abrufen
- Looks verschieben und kopieren
- SSO und Nicht-SSO-Einbettungsgeheimnis, URL sowie Nutzererstellung und -verwaltung.
- Aktualisieren Sie das Token, um das Zugriffstoken zu aktualisieren.
- Schränken Sie die Ergebnisse beim Abrufen aller LookML-Modelle und aller Nutzer ein und vergleichen Sie sie.
- Grenzen Sie die Ergebnisse der suchenden Nutzer ein und verschieben Sie sie.
- Rufen Sie die Looker Instanz-API-Spezifikation in Swagger 2.x JSON ab.
Änderungen an GA 4.0 und GA werden eingestellt
API 4.0 GA ersetzt mehrere eingestellte API 3.1-Endpunkte durch verbesserte Funktionen. Die Endpunkte sind betroffen:
- Eingestellte Endpunkte auf der Startseite wurden entfernt. Verwenden Sie anstelle von Startseiten Board-Endpunkte. Die Dokumentation zu den Board-Funktionen finden Sie hier.
- Verworfene Space-Endpunkte wurden entfernt. Bitte verwenden Sie Ordnerendpunkte anstelle von Leerzeichen. Die Dokumentation zu den Ordnerfunktionen finden Sie hier.
API 3.0-Nutzer
Wenn Sie API 3.0 verwenden, lesen Sie diesen Abschnitt. API 3.0 gilt als alt, eingestellt und wird nicht empfohlen. Wir empfehlen Ihnen, auf API 4.0 umzustellen.
- Nur von API 4.0 werden alle von Looker unterstützten und von der Community unterstützten SDKs unterstützt, um die Entwicklung zu vereinfachen. Sehen Sie sich unser SDK-Repository an.
- Mit API 4.0 werden wie oben beschrieben mehrere neue Funktionen und Verbesserungen eingeführt.
Zusammenfassung
Sie können sich auf neue Funktionen und zusätzliche Änderungen freuen, die API 4.0 hinzugefügt werden, und immer die neuesten Änderungen in unserer API-Referenz finden. Weitere Informationen finden Sie in unseren Supportrichtlinien für APIs und SDKs und in den Versionen unserer APIs. Wir wissen, dass funktionsgefährdende Änderungen nicht ideal sind. Sofern kein extremes Problem auftritt, werden wir keine funktionsgefährdenden Änderungen an der allgemein verfügbaren API 4.0 vornehmen. Wir hoffen, dass unsere allgemein verfügbare Looker API 4.0 Ihnen hilft, auf der Looker-Plattform produktiver und einfacher zu entwickeln.