Questa pagina è stata tradotta dall'API Cloud Translation.

Connettore Google Drive

Il connettore Google Drive consente di creare e configurare una connessione Google Drive in Integration Connectors. Puoi utilizzare questa connessione nelle tue applicazioni aziendali per scambiare dati in modo sicuro ed eseguire operazioni con Google Drive.

Per l'elenco delle entità e delle operazioni supportate, consulta Entità e operazioni supportate. Per informazioni sulle azioni specifiche del connettore supportate, vedi Azioni supportate.

Versioni del connettore Google Drive

Il connettore Google Drive supporta due versioni:

Google Drive v1: utilizza questa versione del connettore per accedere all'API Google Drive v3.
Google Drive v2: utilizza questa versione del connettore per accedere all'API Google Drive v2.

Per informazioni sulla creazione di una connessione Google Drive, vedi Creare e configurare un connettore Google Drive.

Entità e operazioni supportate

Il connettore Google Drive supporta le seguenti entità e operazioni:

Entità	Descrizione	Operazioni
`File`	Rappresenta un file in Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Folder`	Rappresenta una cartella in Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Permission`	Rappresenta un'autorizzazione per un file o una cartella in Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Drive`	Rappresenta un drive su Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`

Per esempi di casi d'uso di Application Integration, consulta Esempi di casi d'uso in Application Integration.

Azioni supportate

Il connettore Google Drive supporta le seguenti azioni:

CopyResource

Descrizione: crea una copia di una risorsa specificata in Google Drive. Puoi definire un nuovo nome per il file copiato e specificare la cartella di destinazione fornendo un elenco di ID cartella principale .

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID della risorsa da copiare.
`NewName`	Stringa	Sì	Il nuovo nome del file copiato.
`ParentIDs`	Stringa	No	Un elenco separato da virgole degli ID delle cartelle principali in cui verrà inserito il file copiato. Se non specificato, il file verrà copiato nella stessa cartella in cui si trovava.
`IgnoreDefaultVisibility`	Booleano	No	Determina se ignorare le impostazioni di visibilità predefinite per il file appena creato. Se il dominio è configurato in modo da rendere visibili per impostazione predefinita tutti i file caricati, l'impostazione di questo parametro su true esegue l'override di questo comportamento per questa richiesta specifica. Il valore predefinito è false.
`IncludeLabels`	Stringa	No	Un elenco separato da virgole di ID delle etichette da includere nella parte labelInfo della risposta.
`IncludePermissionsForView`	Stringa	Sì	Questo campo specifica quali autorizzazioni di visualizzazione aggiuntive includere nella risposta. Il valore supportato viene pubblicato.
`KeepRevisionForever`	Booleano	No	Indica se conservare per sempre le revisioni del file. Questa funzionalità si applica solo ai file con contenuti binari su Google Drive. Per ogni file è possibile conservare per sempre un massimo di 200 revisioni. Se viene raggiunto il limite, devi eliminare le revisioni esistenti per aggiungerne di nuove. Il valore predefinito è false.
`OCRLanguage`	Stringa	No	Questo campo fornisce un suggerimento sulla lingua per l'OCR (Optical Character Recognition) durante l'importazione di file immagine. Specifica la lingua utilizzando un codice lingua ISO 639-1 di due lettere, ad esempio `en` per l'inglese o `de` per il tedesco.
`SupportsAllDrives`	Booleano	Sì	Questo parametro indica se tenere traccia delle modifiche in Il mio Drive e nei Drive condivisi. Imposta questo parametro su true per attivare l'accesso ai Drive condivisi. Il valore predefinito è false.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`CopiedFileID`	Stringa	L'ID del file copiato.
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione CopyResource in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione CopyResource, 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:

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}

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

        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]

CreateFolder

Descrizione: crea una nuova cartella in Google Drive. Devi fornire un nome per la nuova cartella e specificarne la posizione fornendo gli ID delle cartelle principali. Puoi anche aggiungere una descrizione facoltativa e contrassegnare la cartella come preferita.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Name`	Stringa	Sì	Il titolo della cartella.
`Description`	Stringa	No	La descrizione della cartella.
`Starred`	Booleano	No	Questo parametro indica se la cartella è stata aggiunta ai preferiti. Il valore predefinito è false.
`ParentIds`	Stringa	Sì	Un elenco separato da virgole degli ID delle cartelle principali in cui verrà creata la nuova cartella.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.
`Id`	Stringa	L'ID della nuova cartella.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione CreateFolder in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione CreateFolder, 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:
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Descrizione: rimuove definitivamente un file o una cartella da Google Drive. Per utilizzare questa azione, devi fornire l'ID univoco della risorsa che vuoi eliminare.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID della risorsa da eliminare.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione DeleteResource in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione DeleteResource, 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:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Descrizione: scarica un file da Google Drive

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID del file da scaricare.
`LocalFile`	Stringa	No	Il percorso e il nome del file in cui verrà salvato. Lascia vuoto per memorizzare il file nella memoria.
`Encoding`	Stringa	No	Il tipo di codifica per i dati del file. Se LocalFile è vuoto, i dati del file verranno restituiti nella codifica specificata. I valori consentiti sono NONE e BASE64. Il valore predefinito è BASE64.
`Overwrite`	Booleano	No	Questo parametro determina se sovrascrivere il file se esiste già durante il download. Il valore predefinito è false. Imposta il parametro su TRUE per sovrascrivere il file.
`FileFormat`	Stringa	No	Il formato in cui è possibile scaricare il file. La dimensione massima del file può essere di 10 MB. Lascia vuoto questo parametro per scaricare il file nel formato originale. I formati supportati sono DOCX, ODT, RTF, HTML, TXT e PDF.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`FileData`	Stringa	Se LocalFile non viene fornito, i dati del file verranno restituiti utilizzando la codifica specificata.
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione DownloadFile in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione DownloadFile, 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:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

Descrizione: sposta un file o una cartella in una posizione diversa all'interno di Google Drive. Devi fornire l'ID della risorsa da spostare e gli ID delle nuove cartelle padre.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID della risorsa da spostare.
`ParentIDs`	Stringa	Sì	Un elenco separato da virgole di ID da utilizzare come cartelle principali. Una risorsa all'interno di un Drive condiviso deve avere esattamente una cartella principale e solo gli utenti con il ruolo "Organizzatore di file" o "Organizzatore" possono spostare file e cartelle all'interno di un Drive condiviso.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione MoveResource in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione MoveResource, 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:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Descrizione: aggiorna i metadati di un file o di una cartella in Google Drive. Puoi modificarne il nome, la descrizione, il tipo MIME e se è stato aggiunto ai preferiti.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID della risorsa da aggiornare.
`Name`	Stringa	Sì	Il nuovo nome del file aggiornato.
`Description`	Stringa	No	Una descrizione del file o della cartella.
`MIMEType`	Stringa	No	Il tipo MIME del file.
`Starred`	Stringa	No	Questo parametro indica se la risorsa è speciale. Il valore predefinito è false.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione UpdateResource in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione UpdateResource, 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:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Descrizione: carica un file su Google Drive. Devi fornire i dati del file e il relativo tipo MIME. Puoi anche specificare la cartella principale in cui verrà inserito il file e un nome per il file caricato.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID del file da caricare.
`FileData`	Stringa	Sì	I dati del file da caricare.
`MIMEType`	Stringa	Sì	Il tipo MIME del file.
`ParentIDs`	Stringa	No	Un elenco separato da virgole degli ID delle cartelle principali in cui verrà inserito il file caricato. Se non specificato, il file verrà caricato nella cartella principale di Il mio Drive dell'utente.
`Filename`	Stringa	No	Il nome del file da caricare.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione UploadFile in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione UploadFile, 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:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

Descrizione: iscrizione alle notifiche relative alle modifiche a un file specifico in Google Drive.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID del file a cui abbonarsi.
`Token`	Stringa	Sì	Il token da utilizzare per l'iscrizione alle modifiche ai file.

Parametri di output

Nome parametro	Tipo di dati	Descrizione
`Success`	Stringa	Questo parametro indica se l'operazione è stata eseguita correttamente o meno.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione SubscribeToFileChanges in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione SubscribeToFileChanges, 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:

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

Descrizione: si iscrive alle notifiche per le modifiche apportate da un utente specifico in Google Drive.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID dell'utente a cui abbonarsi.
`Token`	Stringa	Sì	Il token da utilizzare per l'iscrizione alle modifiche apportate dall'utente.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione SubscribeToUserChanges in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione SubscribeToUserChanges, 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:

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

Descrizione: annulla l'iscrizione alla ricezione di notifiche per una risorsa visualizzata in precedenza.

Parametri di input

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
`Id`	Stringa	Sì	L'ID della risorsa da cui interrompere la visualizzazione.
`Token`	Stringa	Sì	Il token da utilizzare per interrompere la visualizzazione delle risorse.

Esempio di caso d'uso

Il seguente esempio mostra come configurare l'azione StopWatchingResources in Application Integration:

Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
Seleziona l'azione StopWatchingResources, 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:

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

Limitazioni di sistema

Il connettore Google Drive può elaborare un massimo di 2 QPS al secondo, per nodo e limita le transazioni oltre 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.

Passaggi successivi

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

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.