API Looker Studio

L'API Looker Studio consente di cercare e gestire gli asset di Looker Studio.

Il caso d'uso principale dell'API è consentire alle organizzazioni Google Workspace o Cloud Identity di automatizzare la gestione e la migrazione degli asset di Looker Studio.

Punto chiave: l'API è disponibile solo per gli utenti che appartengono a un'organizzazione con Google Workspace o Cloud Identity.

Panoramica dei requisiti

Per utilizzare l'API Looker Studio sono necessari i seguenti passaggi:

1. Configura un'app per utilizzare l'API.
2. Utilizza la Console di amministrazione Google per autorizzare l'app.
3. Ottieni i token di accesso OAuth 2.0 e chiama l'API.

I passaggi precedenti possono essere eseguiti dalla stessa organizzazione o da organizzazioni diverse in base ai seguenti scenari comuni:

• App interne sviluppate per un'organizzazione. L'organizzazione configura e autorizza l'app per tutti gli utenti della sua organizzazione.
• App di terze parti sviluppate per utenti/clienti esterni (ovvero sviluppatori e utenti appartengono a organizzazioni diverse). Lo sviluppatore configura l'app, ma l'organizzazione dell'utente autorizza l'app di terze parti.

1. Configurare un'app per l'utilizzo dell'API

Per configurare l'app:

• Abilita l'API
• Creare un client OAuth

Abilita l'API

Per abilitare un'API per il tuo progetto:

1. Apri l'API Looker Studio nella console API di Google.
2. Se richiesto, seleziona un progetto o creane uno nuovo.
3. Fai clic su Abilita.
4. Se richiesto, leggi e accetta i Termini di servizio dell'API.

Creare un client OAuth

I seguenti passaggi per creare un client OAuth sono linee guida generali e devono essere adattati per soddisfare i requisiti della tua app.

Importante: non aggiungere ambiti di Looker Studio al client OAuth. Gli ambiti verranno aggiunti dall'amministratore di Workspace quando autorizza l'app.

1. Vai a Configura schermata per consenso OAuth.
   1. Scegli Interno e fai clic su Crea.
   2. Compila i campi obbligatori e fai clic su Salva.
2. Vai a Credenziali.
   1. Fai clic su CREA CREDENZIALI.
   2. Seleziona ID client OAuth.
   3. Scegli l'Application Type appropriato. (L'applicazione web è la più comune).
   4. Compila i campi obbligatori e fai clic su Crea.
3. Prendi nota dell'ID client, poiché viene utilizzato per autorizzare l'app.

2. Autorizzare l'app per un'organizzazione

Le app che utilizzano l'API Looker Studio possono autenticare e autorizzare solo gli utenti di Google Workspace per i quali l'organizzazione ha autorizzato l'app utilizzando la delega a livello di dominio per controllare l'accesso all'API.

Configura la delega a livello di dominio con l'ID client OAuth dell'app e gli ambiti richiesti dall'app.

Importante: i seguenti passaggi devono essere completati da un amministratore di Workspace. L'amministratore avrà bisogno dell'ID client OAuth dell'app e di un elenco di ambiti OAuth richiesti dall'app.

1. Accedi alla Console di amministrazione Google e vai a delega a livello di dominio.
2. In API clients, fai clic su Aggiungi nuovo.
3. Inserisci l'Client ID dell'app da autorizzare (ovvero l'app che utilizza l'API Looker Studio).
4. Inserisci tutti gli ambiti OAuth richiesti dall'app. I seguenti ambiti sono comunemente richiesti se utilizzi l'API Looker Studio per gestire gli asset:
   • https://www.googleapis.com/auth/datastudio
   • https://www.googleapis.com/auth/userinfo.profile
5. Fai clic su Autorizza.

Nota: se la tua app non deve gestire gli asset di Looker Studio, valuta la possibilità di utilizzare l'ambito https://www.googleapis.com/auth/datastudio.readonly più restrittivo anziché https://www.googleapis.com/auth/datastudio.

Dopo aver autorizzato l'app, qualsiasi utente Workspace appartenente all'organizzazione verrà autorizzato automaticamente a utilizzare l'app con l'API Looker Studio.

3. Ottenere token di accesso OAuth 2.0 e chiamare l'API

Una volta sviluppata e autorizzata l'app, avrai l'accesso necessario per chiamare l'API per gli utenti di Workspace. Per informazioni dettagliate sull'utilizzo delle API di Google con OAuth, vedi Utilizzare OAuth 2.0 per accedere alle API di Google. Per le operazioni disponibili, consulta il riferimento API.

Risoluzione dei problemi

Finestra di dialogo OAuth mancante

Se l'organizzazione di un utente ha autorizzato l'app, gli utenti di questa organizzazione non visualizzeranno la finestra di dialogo OAuth quando autorizzano l'app. L'unica eccezione si verifica se l'app richiede l'autorizzazione per ambiti API di Google aggiuntivi che l'amministratore di Workspace non ha configurato, nel qual caso la finestra di dialogo OAuth verrà mostrata agli utenti.

Errore 400: invalid_scope

Se un utente riceve un messaggio Error 400: invalid_scope quando tenta di autorizzare l'app, significa che la sua organizzazione non ha autorizzato l'app o lo ha fatto in modo errato. Per risolvere il problema, l'utente dovrà richiedere alla sua organizzazione di autorizzare l'app.