L'attività Fogli - Aggiungi ti consente di aggiungere dati dopo una tabella specificata in un foglio di lavoro Google. I nuovi valori vengono aggiunti alla nuova riga creata dopo la tabella specificata, a partire dalla prima colonna della tabella.
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 - Aggiungi, assicurati di eseguire le attività seguenti nel progetto Google Cloud:
- Attiva l'API Fogli Google (
sheets.googleapis.com
). -
Crea un profilo di autenticazione. L'Apigee Integration utilizza un profilo di autenticazione per connettersi a un endpoint di autenticazione per l'attività Fogli - Aggiungi.
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.
Configura l'attività Fogli - Aggiungi
- Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
- Fai clic su Sviluppa > Integrazioni.
- Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
- Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
- Fai clic su Crea.
In questo modo viene aperta l'integrazione nel designer dell'integrazione.
- Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un trigger > Tasks per visualizzare l'elenco delle attività disponibili.
- Fai clic sull'elemento Fogli - Aggiungi e posizionalo nel designer dell'integrazione.
- Fai clic sull'elemento Fogli - Aggiungi nel designer per visualizzare il riquadro di configurazione delle attività Fogli - Aggiungi.
- 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à
La tabella seguente descrive i parametri di input dell'attività Fogli - Aggiungi:
Proprietà | Tipo di dati | Descrizione |
---|---|---|
SpreadsheetId | String | L'ID del foglio di lavoro. Puoi trovare l'ID del foglio di lavoro nel relativo URL web. Ad esempio, |
chiavi | String | La notazione A1 di un intervallo per cercare la tabella desiderata nel foglio. |
IncludeValuesInResponse | Booleano | Indica se l'oggetto restituito deve includere i valori delle celle a cui sono stati aggiunti i valori. |
InsertDataOption | enum (InsertDataOption) | Indica in che modo i dati esistenti verranno modificati quando verranno aggiunti i nuovi dati. |
ValueInputOption | enum (ValueInputOption) | Indica come vengono interpretati i dati.
Valore predefinito:
|
ResponseDateTimeRenderOption | enum (DateTimeRenderOption) | Indica il modo in cui i valori relativi a data, ora e durata vengono rappresentati nell'output.
Valore predefinito:
|
ResponseValueRenderOption | enum (ValueRenderOption) | Indica come i valori recuperati sono rappresentati nell'output.
Valore predefinito:
|
Richiesta | JSON | Il corpo della richiesta è un oggetto ValueRange che descrive i valori di intervallo da scrivere. Vedi Struttura JSON della richiesta. |
Output attività
L'attività Fogli - Aggiungi restituisce l'output della risposta contenente un oggetto AppendValuesResponse simile al seguente output di esempio:
{ "spreadsheetId": SPREADSHEET_ID, "tableRange": "Sheet1!A1:D2", "updates": { "spreadsheetId": SPREADSHEET_ID, "updatedRange": "Sheet1!A3:D4", "updatedRows": 2, "updatedColumns": 4, "updatedCells": 8, } }
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.