Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Questa pagina è stata tradotta dall'API Cloud Translation.

API Looker 4.0 in disponibilità generale

Siamo lieti di annunciare che l'API Looker 4.0 è disponibile a livello generale in Looker 22.4. L'API 4.0 disponibile a livello generale (API 4.0 GA) presenta più modifiche che richiedono l'interruzione del servizio e aggiuntive e promuove più endpoint dalla versione beta a quella stabile. Consulta il nostro riferimento API per le specifiche dettagliate dell'API 4.0. Abbiamo aggiornato i nostri SDK supportati da Looker e dalla community per supportare gli endpoint GA dell'API Looker 4.0. Per saperne di più, consulta le norme relative all'assistenza per API e SDK e la pagina Versionamento API. Il resto di questo articolo illustra le modifiche che provocano un errore, le mitigazioni e le funzionalità che puoi aspettarti quando esegui la migrazione all'API 4.0 GA.

Per chi è pensata questa pagina?

Questo documento è rivolto a te se utilizzi l'API Looker tramite SDK supportati da Looker, SDK supportati dalla community o l'API stessa. Leggi la sezione seguente relativa alla versione dell'API Looker che utilizzi.

Utenti dell'API 4.0 pre-GA

Se utilizzi l'API 4.0, leggi questa sezione. Descrive le modifiche che provocano un errore e le mitigazioni disponibili quando esegui la migrazione all'API 4.0 GA.

L'API 4.0 GA include la modifica di tutti i campi dell'ID entità dal tipo numerico integer al tipo string. Ad esempio, GET /groups/{group_id} endpoint restituisce id come tipo string anziché come tipo int64.

Leggi la tabella seguente per conoscere l'impatto e le mitigazioni specifiche per l'utilizzo dell'endpoint API 4.0:

Utilizzo	Impatto potenziale¹	Prevenzione

App mobile Looker	Le installazioni obsolete delle app mobile di Looker smettono di funzionare	Chiedi agli utenti di eseguire l'aggiornamento alla versione più recente delle app mobile di Looker
SDK supportati da² Looker
SDK TypeScript (API 4.0)	Nessun impatto	Nessuna azione necessaria
SDK Python (API 4.0)	Nessun impatto	Nessuna azione necessaria
SDK Ruby (API 4.0)	Nessun impatto	Nessuna azione necessaria
SDK supportati dalla community²
SDK Swift	Eccezioni di runtime	Aggiornamento dell'SDK alla versione 22.0 o successiva; quindi risolvere eventuali errori di tipo risultanti
SDK Kotlin	Nessun impatto	Nessuna azione necessaria
SDK LookR	Nessun impatto	Nessuna azione necessaria
SDK C#	Nessun impatto	Nessuna azione necessaria
SDK Go	Eccezioni di runtime	Aggiorna l'SDK alla versione 22.0 o successive, quindi risolvi gli eventuali errori di tipo risultanti
Altro
Utilizzare l'API 4.0 senza un SDK (o con librerie fornite esternamente)	Possibili errori di runtime, a seconda della sensibilità del tipo di lingua	Esamina il codice per individuare le dipendenze relative al tipo di campi ID e aggiungi il supporto per i campi ID di tipo stringa. Consulta anche queste informazioni aggiuntive.

1: si presumeno modelli di utilizzo comuni che possono includere l'utilizzo dei campi ID di Looker, ma non modelli di utilizzo insoliti come l'applicazione di operazioni numeriche agli ID.

2: API Looker e Supporto SDK. Le librerie supportate dalla community non sono supportate ufficialmente da Looker.

Utenti dell'API 3.1

Se utilizzi l'API 3.1, leggi questa sezione. Descrive le funzionalità aggiuntive e le modifiche che l'API 4.0 mette a tua disposizione. Tieni presente che tutti gli SDK supportati da Looker e dalla community supportano principalmente l'API 4.0. Per ulteriori informazioni, consulta le norme relative all'assistenza per SDK e API.

Ulteriori funzionalità GA dell'API 4.0

Per comodità, di seguito sono elencate le modifiche più importanti e utili dell'API 4.0 additiva:

Creazione e gestione delle sezioni del tabellone, degli elementi e delle sezioni del tabellone. Per ulteriori informazioni sulle bacheche, consulta la pagina della documentazione relativa alle bacheche.
Esegui query su ulteriori informazioni di connessione, ad esempio database, schemi, colonne e tabelle. Imposta e aggiorna altri campi di connessione.
Creazione e gestione di app e utenti OAuth. Per saperne di più su OAuth, consulta la pagina della documentazione relativa a OAuth.
Cerca gruppi con gerarchia e ruoli.
Cerca i ruoli con il numero di utenti.
Ottieni e configura le impostazioni dell'istanza di Looker. Per ulteriori informazioni sulle impostazioni, consulta la pagina della documentazione relativa alle impostazioni.
Creazione e gestione degli avvisi. Per ulteriori informazioni sugli avvisi, consulta la pagina della documentazione relativa agli avvisi.
Creazione, gestione e test di tunnel SSH e server SSH. Per ulteriori informazioni su SSH, consulta la pagina della documentazione SSH.
Sposta e copia le dashboard.
Ottieni gli URL relativi per le nuove dashboard.
Sposta e copia i Look.
Creazione e gestione di utenti e secret di incorporamento incorporati e non firmati.
Ottieni il token di aggiornamento per aggiornare il token di accesso.
Limita e compensa i risultati derivanti dal recupero di tutti i modelli LookML e di tutti gli utenti.
Limita e compensa i risultati della ricerca di utenti.
Ottieni le specifiche dell'API istanza Looker in JSON Swagger 2.x.

Modifiche relative al ritiro di GA API 4.0

L'API 4.0 GA sostituisce diversi endpoint deprecati dell'API 3.1 con funzionalità migliorate. Sono interessati i seguenti endpoint:

Gli endpoint della home page obsoleti sono stati rimossi. Usa gli endpoint della scheda invece delle home page. Consulta l'articolo Presentare i contenuti con le bacheche.
Gli endpoint dello spazio deprecati sono stati rimossi. Utilizza gli endpoint delle cartelle anziché Spazio. Consulta Organizzazione e gestione dell'accesso ai contenuti.

Utenti dell'API 3.0

L'API 3.0 è obsoleta e ti consigliamo di eseguire la migrazione all'API 4.0.

Solo l'API 4.0 supporta tutti gli SDK supportati da Looker e dalla community per semplificare lo sviluppo. Consulta il nostro repository SDK.
L'API 4.0 introduce diversi nuovi miglioramenti e funzioni, come elencato nella sezione Funzionalità GA aggiuntive dell'API 4.0 di questa pagina.

Conclusione

Puoi aspettarti l'aggiunta di nuove funzionalità e modifiche aggiuntive all'API 4.0 e puoi sempre trovare le modifiche più recenti nel nostro Riferimento API. Per ulteriori informazioni, consulta le norme di supporto di API e SDK e il controllo delle versioni delle API. Sappiamo che le modifiche che provocano un errore non sono l'ideale. A meno che non si verifichi un problema estremo, non apporteremo modifiche che provocano un errore all'API 4.0, in disponibilità generale. Ci auguriamo che la nostra API Looker 4.0, in disponibilità generale, ti aiuti a sviluppare in modo più produttivo e semplice sulla piattaforma Looker.