Questa pagina è stata tradotta dall'API Cloud Translation.

Smartsheet

Il connettore Smartsheet ti consente di eseguire operazioni di inserimento, eliminazione, aggiornamento e lettura sui dati di Smartsheet.

Versioni supportate

Questo connettore supporta Smartsheet versione 25.2.0.246.

Prima di iniziare

Prima di utilizzare il connettore Smartsheet, esegui le seguenti attività:

Nel tuo progetto Google Cloud:
- Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, vedi Connettività di rete.
- Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
- Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente non umano che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per ulteriori informazioni, vedi Creazione di un service account.
- Attiva i seguenti servizi:
  - secretmanager.googleapis.com (API Secret Manager)
  - connectors.googleapis.com (API Connectors)
  Per capire come abilitare i servizi, consulta Abilitazione dei servizi.
Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti viene chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione separata per ciascuna. Per creare una connessione:

Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.
Vai alla pagina Connessioni
Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
Nella sezione Posizione, scegli la posizione per la connessione.
1. Regione: seleziona una località dall'elenco a discesa.
  Per l'elenco di tutte le regioni supportate, consulta Località.
2. Fai clic su AVANTI.
Nella sezione Dettagli connessione, completa quanto segue:
1. Connettore: seleziona Smartsheet dall'elenco a discesa dei connettori disponibili.
2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.
  I nomi delle connessioni devono soddisfare i seguenti criteri:
  - I nomi delle connessioni possono contenere lettere, numeri o trattini.
  - Le lettere devono essere minuscole.
  - I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
  - I nomi delle connessioni non possono superare i 49 caratteri.
4. (Facoltativo) Inserisci una descrizione per l'istanza di connessione.
5. (Facoltativo) Abilita Cloud Logging, quindi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
6. Service Account: seleziona un account di servizio con i ruoli richiesti.
7. Intestazione: se vuoi, specifica questo campo per rilevare i nomi delle colonne dalla prima riga.
8. Nascondi caratteri di formattazione: se vuoi, specifica questo campo per nascondere i simboli di valuta e i segni di percentuale nei valori numerici. In questo modo, queste colonne verranno convertite da varchar a double.
9. Ignora righe non trovate: se questo campo non è selezionato e non viene trovato nessuno degli ID riga specificati, non verranno eliminate righe e verrà restituito un errore "non trovato".
10. Livello di compatibilità del report: (facoltativo) specifica il livello di compatibilità per i dati restituiti.
11. Utilizza i percorsi completi dei file come nomi delle tabelle: se vuoi, specifica questo campo per includere il percorso completo del file nel nome di una tabella o di una vista esposta, corrispondente a un foglio o a un report.
12. Origine valore: indica facoltativamente se la cella utilizzerà i campi Valore come valore o il campo DisplayValue.
13. (Facoltativo) Configura le impostazioni del nodo di connessione:
  - Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
  - Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.
  Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, viceversa, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta la sezione Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una migliore disponibilità) e i nodi massimi sono impostati su 50.
14. (Facoltativo) Fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
15. Fai clic su AVANTI.
Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
  La connessione Smartsheet supporta i seguenti tipi di autenticazione:
  - OAuth2.0 - Authorization Code
  - Token di accesso personale
2. Fai clic su AVANTI.
Rivedi: rivedi i dettagli di connessione e autenticazione.
Fai clic su Crea.

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

Tipo di connessione di autenticazione OAuth 2.0

Nome campo	Dettagli
Località	us-central1
Connettore	smartsheet
Versione del connettore	1
Nome collegamento	smartsheet-oauth-connection
Service account	my-service-account@my-project.iam.gserviceaccount.com
Numero minimo di nodi	2
ID client	CLIENT_ID
Ambiti	ADMIN_SHEETS, ADMIN_SIGHTS, ADMIN_USERS, ADMIN_WEBHOOKS, ADMIN_WORKSPACES, CREATE_SHEETS, CREATE_SIGHTS, DELETE_SHEETS, DELETE_SIGHTS, READ_CONTACTS, READ_EVENTS, READ_SHEETS, READ_SIGHTS, READ_USERS, SHARE_SHEETS, SHARE_SIGHTS, WRITE_SHEETS
Client secret	CLIENT_SECRET
Versione secret	1
URL di autorizzazione	https://app.smartsheet.com/b/authorize

Tipo di connessione di autenticazione del token di accesso personale

Nome campo	Dettagli
Località	us-central1
Connettore	smartsheet
Versione del connettore	1
Nome collegamento	smartsheet-accesstoken-connection
Service account	my-service-account@my-project.iam.gserviceaccount.com
Numero minimo di nodi	2
Numero massimo di nodi	50
Token di accesso personale	PERSONAL_ACCESS_TOKEN
Versione secret	3

Puoi creare un account Smartsheet utilizzando il link Accesso a Smartsheet.

Per saperne di più sull'API Smartsheet, consulta il riferimento API Smartsheet.

Limitazioni di sistema

Il connettore Smartsheet può elaborare un massimo di 10 transazioni al secondo per nodo e limita le transazioni che superano questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Nota:il numero di nodi di Integration Connectors verrà scalato automaticamente in modo dinamico in base al tuo utilizzo. Tuttavia, se vuoi riservare capacità per volumi elevati senza attendere la scalabilità automatica, puoi modificare il valore minimo dei nodi per una connessione. Sono necessari più nodi per elaborare più transazioni per una connessione. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori del nodo, procedi nel seguente modo:

Se sei un cliente con pagamento a consumo, configura il valore minimo e massimo dei nodi nella pagina di modifica della connessione.
Se sei un cliente con abbonamento, contatta l'assistenza.

Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare i nodi minimi per migliorare il throughput, ti consigliamo di verificare che i sistemi di backend siano configurati in modo ottimale per gestire il traffico richiesto.

Utilizzare la connessione Smartsheet in un'integrazione

Una volta creata la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
Per capire come creare e utilizzare l'attività Connettori in Application Integration, vedi Attività Connettori.

Azioni

Questa sezione mostra come eseguire alcune delle azioni in questo connettore.

Azione DownloadAttachment

Questa azione scarica un allegato da un foglio.

Parametri di input dell'azione DownloadAttachment

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio.
AttachmentID	Stringa	Vero	L'identificatore univoco dell'allegato.

Per un esempio su come configurare l'azione DownloadAttachment, consulta Esempi.

Azione DeleteAttachment

Questa azione elimina un allegato specificato da un foglio.

Parametri di input dell'azione DeleteAttachment

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio.
AttachmentID	Stringa	Vero	L'identificatore univoco dell'allegato.

Per un esempio di come configurare l'azione DeleteAttachment, consulta Esempi.

Azione CopyRowsToAnotherSheet

Questa azione copia le righe da un foglio a un altro.

Parametri di input dell'azione CopyRowsToAnotherSheet

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio da cui verranno copiate le righe.
RowIds	Stringa	Vero	Un elenco separato da virgole di ID riga da copiare dal foglio.
DestinationSheetId	Stringa	Vero	L'identificatore univoco del foglio di destinazione in cui verranno copiate le righe.

Per un esempio di come configurare l'azione CopyRowsToAnotherSheet, consulta Esempi.

Azione CopySheet

Questa azione copia un foglio in una cartella, nella home directory o in uno spazio di lavoro.

Parametri di input dell'azione CopySheet

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio da copiare.
DestinationType	Stringa	Vero	Il tipo di destinazione in cui verrà copiata la scheda. I valori accettati sono cartella, casa o spazio di lavoro.
DestinationId	Stringa	Vero	L'identificatore univoco della destinazione in cui verrà copiata la scheda. Questo campo è obbligatorio quando DestinationType è cartella o spazio di lavoro e deve essere nullo quando è home.
NewName	Stringa	Vero	Il nome che vuoi assegnare al foglio copiato.
Includi	Stringa	Falso	Un elenco separato da virgole di elementi del foglio aggiuntivi da includere nell'operazione di copia. I valori accettati sono allegati, cellLinks, dati, discussioni, filtri, moduli, ruleRecipients, regole e condivisioni.

Per un esempio di come configurare l'azione CopySheet, consulta Esempi.

Azione MoveRowsToAnotherSheet

Questa azione sposta le righe da un foglio a un altro.

Parametri di input dell'azione Sposta righe in un altro foglio

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio da cui verranno spostate le righe.
RowIds	Stringa	Vero	Un elenco separato da virgole degli ID riga da spostare dal foglio.
DestinationSheetId	Stringa	Vero	L'identificatore univoco del foglio di destinazione in cui verranno spostate le righe.

Per un esempio di come configurare l'azione MoveRowsToAnotherSheet, consulta Esempi.

Azione MoveSheet

Questa azione sposta un foglio in una cartella, nella home directory o in uno spazio di lavoro.

Parametri di input dell'azione MoveSheet

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
SheetId	Stringa	Vero	L'identificatore univoco del foglio da spostare.
DestinationType	Stringa	Vero	Il tipo di destinazione in cui verrà spostato il foglio. I valori accettati sono cartella, casa o spazio di lavoro.
DestinationId	Stringa	Vero	L'identificatore univoco della destinazione in cui verrà spostato il foglio. Questo campo è obbligatorio quando DestinationType è cartella o spazio di lavoro e deve essere nullo quando è home.

Per un esempio di come configurare l'azione MoveSheet, consulta Esempi.

Esempi di azioni

Questa sezione mostra come eseguire alcuni degli esempi di azioni in questo connettore.

Esempio: scaricare un allegato

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione DownloadAttachment, quindi fai clic su Fine.
Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:
```
{
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}
```

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

 [
  {
    "Success": "true",
    "URL": "https://s3.amazonaws.com/SmartsheetB1/37540b4438a6466a973d678484c1fac8?response-content-disposition=attachment%3Bfilename%3D%22TestGOOGLE3.txt%22%3Bfilename*%3DUTF-8%27%27TestGOOGLE3.txt&Signature=rVHv4loce%2BrL4lYPlteTgAmkB%2Bk%3D&Expires=1744826533&AWSAccessKeyId=11950YFEZZJFSSKKB3G2",
    "Content": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
  }
]

Esempio: eliminare un allegato

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione DeleteAttachment, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e inserisci un valore simile al seguente nel campo Default Value:
```
{
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

[
  {
    "Success": "true",
  }
]

Esempio: copia le righe in un altro foglio

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione CopyRowsToAnotherSheet, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Default Value:
```
  {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

 [
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Esempio: copia un foglio

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione CopySheet, quindi fai clic su Fine.

Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Default Value:

{
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252",
  "NewName": "Copied sheet appears",
  "Include": "comments"
}

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

[
  {
    "Success": "true",
  }
]

Esempio: spostare le righe in un altro foglio

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione MoveRowsToAnotherSheet, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Default Value:
```
{
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

[
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Esempio: spostare un foglio

Nella finestra di dialogo Configure connector task, fai clic su Actions.
Seleziona l'azione MoveSheet, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Default Value:
```
{
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252"
}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

[
  {
    "Success": "true",
  }
]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutte le colonne di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Columns dall'elenco Entity.
Seleziona l'operazione List, poi fai clic su Fine.
Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Devi utilizzare gli apici singoli ("'") per racchiudere il valore di una clausola di filtro. Puoi utilizzare filterClause per filtrare i record in base alle colonne.

Esempio: recuperare i dettagli delle colonne di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Columns dall'elenco Entity.
Seleziona l'operazione Get, poi fai clic su Fine.
Imposta entityId su "849633317179268", ovvero la chiave da trasferire. Per impostare l'entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, inserisci "849633317179268" nel campo Input Value e scegli entityId come variabile locale.

Il valore di entityId deve essere passato direttamente, ad esempio "849633317179268". In questo caso, "849633317179268" è il valore univoco della chiave primaria, che deve essere trasmesso

In alcuni casi, il passaggio di entityId potrebbe generare un errore a causa di due chiavi composite. In questi casi, puoi utilizzare filterClause e trasmettere il valore, ad esempio id='849633317179268'.

Esempio: eliminare una riga da un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Team_Task_List_by_Priority dall'elenco Entity.
Seleziona l'operazione Delete, poi fai clic su Fine.
Imposta entityId su "849633317179268", ovvero la chiave da trasmettere. Per impostare l'entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, inserisci "849633317179268" nel campo Input Value e scegli entityId come variabile locale.

Se l'entità ha due chiavi aziendali o primarie composite anziché specificare entityId, puoi anche impostare filterClause su id='849633317179268'.

Esempio: creare un allegato a un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Attachments dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{
  "SheetId": "5141926996037508",
  "RowId": "8196592918597508",
  "Name": "Random.txt",
  "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"Id": "7144235189178244" }
```

Esempio: crea un progetto in una riga con scadenze fisse utilizzando un layout in stile Gantt

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Gantt_Project_with_Hard_Deadline dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660"}
```

Esempio: crea un'attività di gruppo in una riga di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Team_Task_List_by_Priority dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660"}
```

Esempio: crea un'attività di vendita in una riga di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Sales_Activity_Tracking_by_Rep_Month dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660"}
```

Esempio: crea un'opportunità di vendita in una riga di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Simple_Sales_Pipeline dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660" }
```

Esempio: crea un report sulle vendite in una riga di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Report_Sales_Activity_And_Team_Objectives dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660" }
```

Esempio: creare un ordine in una riga di un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Customer_Order_Tracking_History dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "Created from googlecloud"}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{"RowId": "7860088629366660" }
```

Esempio: creare una nuova colonna in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Columns dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{
  "SheetId": "3315287605596036",
  "Title": "newexposedcolumn",
  "Index": 2,
  "Type": "DATE"
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:
```
{
  "Id": "550917885349764"
}
```

Esempio: creare una nuova cartella in uno spazio di lavoro

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Folders dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{
  "ParentFolderId": "8716915511191428",
  "Name": "sub-folder-p2"
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{
  "Id": "550917885349764"
}
```

Esempio: creare un nuovo spazio di lavoro in un account

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Workspaces dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{
  "Name": "new workspace (newly exposed)"
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:
```
{
  "Id": "550917885349764"
}
```

Esempio: crea un nuovo utente in un account

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Info_Users dall'elenco Entity.
Seleziona l'operazione Create, quindi fai clic su Fine.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{
  "FirstName": "charlie",
  "Email": "charlie@altostrat.com",
  "LastName": "c",
  "Admin": true,
  "LicensedSheetCreator": true
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:
```
{
  "Id": "550917885349764"
}
```

Esempio: aggiornare i dettagli del progetto in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Gantt_Project_with_Hard_Deadline dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
 {"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Esempio: aggiornare un'attività del team in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Team_Task_List_by_Priority dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Esempio: aggiornare un'attività di vendita in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Sales_Activity_Tracking_by_Rep_Month dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
 {"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Esempio: aggiornare un'opportunità di vendita in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Simple_Sales_Pipeline dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Esempio: aggiornare un report sulle vendite in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Report_Sales_Activity_And_Team_Objectives dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Esempio: aggiornare un ordine in un foglio

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Sheet_Customer_Order_Tracking_History dall'elenco Entity.
Seleziona l'operazione Update, quindi fai clic su Fine.
Imposta entityId nella sezione Data mapper di Tasks (Attività), fai clic su entityId e poi inserisci 849633317179268 nel campo specificato.
Nella sezione Data Mapper dell'editor Attività, fai clic su Open Data Mapping e poi inserisci un valore simile al seguente nel campo Input Value:
```
{"Task Name": "updated from googlecloud"}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

{
  "RowId": null
}

Ricevere assistenza dalla community di Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

Passaggi successivi

Scopri come sospendere e ripristinare una connessione.
Scopri come monitorare l'utilizzo dei connettori.
Scopri come visualizzare i log dei connettori.