Consulta i connettori supportati per Application Integration.
Fogli - Attività di recupero in batch
L'attività Fogli - Recupero in batch consente di leggere e recuperare più intervalli di valori discontinui da un foglio di lavoro Google.
Fogli Google è una delle numerose soluzioni di produttività basate su cloud di Google Workspace. Consente di creare e modificare fogli di lavoro online con funzionalità di collaborazione in tempo reale.
Prima di iniziare
Prima di configurare l'attività Fogli - Recupero in batch, assicurati di eseguire le attività seguenti nel progetto Google Cloud:
- Attiva l'API Fogli Google (
sheets.googleapis.com
). -
Crea un profilo di autenticazione. Application Integration utilizza un profilo di autenticazione per connettersi a un endpoint di autenticazione per l'attività Fogli - Recupero in batch.
Per informazioni su come concedere ruoli o autorizzazioni aggiuntivi a un account di servizio, vedi Concessione, modifica e revoca dell'accesso.
- Comprendi e scopri la terminologie più comuni utilizzate in Fogli Google.
Configurare l'attività Fogli - Recupero in batch
- Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
- Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, in cui sono elencate tutte le integrazioni disponibili nel progetto Google Cloud.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nel riquadro Crea integrazione.
- Seleziona una regione per l'integrazione.
- Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli di un account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti di integrazione.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor di integrazione.
- Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività disponibili.
- Fai clic e posiziona l'elemento Fogli - Batch Get nell'editor di integrazione.
- Fai clic sull'elemento Fogli - Acquisizione in batch nel designer per visualizzare il riquadro di configurazione delle attività Fogli - Acquisizione in batch.
- Vai ad Autenticazione e seleziona un profilo di autenticazione esistente che vuoi utilizzare.
Facoltativo. Se non hai creato un profilo di autenticazione prima di configurare l'attività, fai clic su + Nuovo profilo di autenticazione e segui i passaggi descritti in Creare un nuovo profilo di autenticazione.
- Vai a Input attività e configura i campi di input visualizzati utilizzando la seguente tabella Parametri di input attività.
Le modifiche ai campi di immissione vengono salvate automaticamente.
Parametri di input dell'attività
Nella tabella seguente vengono descritti i parametri di input dell'attività Fogli - Recupero in batch:
Proprietà | Tipo di dati | Descrizione |
---|---|---|
SpreadsheetId | Stringa | L'ID del foglio di lavoro. Puoi trovare l'ID del foglio di lavoro nel relativo URL web. Ad esempio, |
MajorDimension | enum (Dimensione) | La categoria o la dimensione principale da applicare. Ad esempio, ROWS o COLUMNS .
Valore predefinito:
|
Intervalli | Stringa | La notazione A1 o R1C1 dell'intervallo da cui recuperare i valori. |
DateTimeRenderOption | enum (DateTimeRenderOption) | Indica il modo in cui i valori relativi a data, ora e durata vengono rappresentati nell'output.
Valore predefinito:
|
ValueRenderOption | enum (ValueRenderOption) | Indica come i valori recuperati sono rappresentati nell'output.
Valore predefinito:
|
Output attività
L'attività Fogli - Recupero in batch restituisce l'output della risposta contenente un oggetto con l'ID del foglio di lavoro e un array di oggetti ValueRange corrispondenti a ciascun intervallo richiesto, elencati nell'ordine richiesto. Di seguito è riportato un output di esempio:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!B1:B1000", "majorDimension": "COLUMNS", "values": [ ["Cost",20.5,15,100,135.5] ] }, { "range": "Sheet1!D1:D1000", "majorDimension": "COLUMNS", "values": [ ["Ship Date",42430,42444,42449,42449] ] } ] }
Strategia di gestione degli errori
Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non riesce a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.
Passaggi successivi
- Aggiungi bordi e condizioni degli spigoli.
- Testa e pubblica l'integrazione.
- Configura un attivatore.
- Aggiungi un'attività di mappatura dei dati.
- Vedi tutte le attività per i servizi Google Cloud.