Looker API 4.0 allgemein verfügbar

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:

Ä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.