Dropbox

Il connettore Dropbox ti consente di connetterti a un'istanza Dropbox ed eseguire le operazioni supportate.

Prima di iniziare

Prima di utilizzare il connettore Dropbox, svolgi le seguenti attività:

  • Nel tuo progetto Google Cloud:
    • Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
    • Concedi i seguenti ruoli IAM all'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 Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, consulta Creare un account di servizio.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per scoprire come attivare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Per configurare il connettore devi creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
  3. Nella sezione Località, scegli la località della 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.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Dropbox 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 contenere più di 49 caratteri.
    4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
    5. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    6. (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, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

    7. ID utente da rubare:facoltativo per specificare l'ID utente da rubare.
    8. Modalità di rappresentazione dell'utente:facoltativamente, per specificare il tipo di rappresentazione dell'utente. Deve essere la modalità Utente o la modalità Amministratore.
    9. Includi sottodirectory:se vuoi includere sottodirectory durante l'elenco di file e cartelle.
    10. Includi risorse di gruppo:se vuoi includere file e cartelle di gruppo.
    11. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    12. Fai clic su Avanti.
  5. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione a Dropbox supporta i seguenti tipi di autenticazione:

      • Concessione del codice di autorizzazione OAuth 2.0

      2. Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

    2. Fai clic su Avanti.
  6. Rivedi: controlla i dettagli di connessione e autenticazione.
  7. Fai clic su Crea.

Configura autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

  • Concessione del codice di autenticazione OAuth 2.0
    • ID client: l'ID client utilizzato per richiedere i token di accesso.
    • Ambiti: un elenco separato da virgole degli ambiti desiderati dal portale delle autorizzazioni di Dropbox.
    • Client secret: il client secret utilizzato per richiedere i token di accesso.

Entità, operazioni e azioni

Tutti gli Integration Connectors forniscono un livello di astrazione per gli oggetti dell'applicazione collegata. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione viene mostrata come entità, operazioni e azioni.

  • Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio collegato. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database le tabelle sono le entità, in un connettore di file server le cartelle sono le entità e in un connettore di sistema di messaggistica le code sono le entità.

    Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

  • Operazione: un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire su un'entità una delle seguenti operazioni:

    La selezione di un'entità dall'elenco disponibile genera un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta nessuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

  • Azione : un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da un connettore all'altro. In genere, un'azione avrà alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Limitazioni del sistema

Il connettore Dropbox può elaborare 18 transazioni al secondo per nodo e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

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

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CopyResource

Questa azione consente di copiare un file o una cartella in una posizione diversa in Dropbox dell'utente.

Parametri di input dell'azione CopyResource

Nome parametro Tipo di dati Obbligatorio Descrizione
From_Path Stringa Sì Percorso in Dropbox dell'utente da copiare o spostare.
To_Path Stringa Sì Percorso di destinazione in Dropbox dell'utente per la risorsa copiata.
Autorename Stringa No Se si verifica un conflitto, chiedi al server Dropbox di provare a rinominare automaticamente il file per evitarlo. Il valore predefinito per questo campo è False.
Allow_Ownership_Transfer Stringa No Consentire i trasferimenti da parte del proprietario anche se ciò comporta il trasferimento della proprietà dei contenuti spostati. Questo non vale per le copie. Il valore predefinito per questo campo è False.
ObjectPathsAggregate Stringa No Un aggregato che rappresenta il percorso dell'oggetto. Può anche essere il nome di una tabella #TEMP.

Ad esempio, per scoprire come configurare l'azione CopyResource, consulta Esempi di azioni.

Azione CreateFolder

Questa azione ti consente di creare una cartella in un determinato percorso.

Parametri di input dell'azione CreateFolder

Nome parametro Tipo di dati Obbligatorio Descrizione
Percorso Stringa Sì Percorso da creare in Dropbox dell'utente.
AutoRename Booleano No Se esiste un conflitto, chiedi al server Dropbox di provare a rinominare automaticamente la cartella per evitarlo. Il valore predefinito è false.
ForceAsync Booleano No Se forzare la creazione in modo asincrono. Disponibile solo quando si utilizza ObjectPathsAggregate. Il valore predefinito è false.
ObjectPathsAggregate Stringa No Un aggregato JSON che rappresenta i percorsi. Può anche essere il nome di una tabella #TEMP.

Ad esempio, per scoprire come configurare l'azione CreateFolder, consulta Esempi di azioni.

Azione DeleteResource

Questa azione ti consente di eliminare il file o la cartella in un determinato percorso. Se il percorso è una cartella, verranno eliminati anche tutti i relativi contenuti.

Parametri di input dell'azione DeleteResource

Nome parametro Tipo di dati Obbligatorio Descrizione
Percorso Stringa Sì Un identificatore univoco per il file o la cartella.
ObjectPathsAggregate Stringa No Un aggregato che rappresenta il percorso dell'oggetto. Può anche essere il nome di una tabella #TEMP.

Ad esempio, per scoprire come configurare l'azione DeleteResource, consulta Esempi di azioni.

Azione MoveResource

Spostare un file o una cartella in una posizione diversa in Dropbox dell'utente. Se il percorso di origine è una cartella, verranno spostati tutti i relativi contenuti. Tieni presente che al momento non supportiamo la ridenominazione solo per le maiuscole.

Parametri di input dell'azione MoveResource

Nome parametro Tipo di dati Obbligatorio Descrizione
From_Path Stringa Sì Percorso in Dropbox dell'utente da copiare o spostare.
To_Path Stringa Sì Percorso in Dropbox dell'utente che rappresenta la destinazione.
Autorename Stringa No Se si verifica un conflitto, chiedi al server Dropbox di provare a rinominare automaticamente il file per evitarlo. Il valore predefinito per questo campo è False.
Allow_Ownership_Transfer Stringa No Consentire i trasferimenti da parte del proprietario anche se ciò comporta il trasferimento della proprietà dei contenuti spostati. Questo non vale per le copie. Il valore predefinito per questo campo è False.
ObjectPathsAggregate Stringa No Un aggregato che rappresenta il percorso dell'oggetto. Può anche essere il nome di una tabella #TEMP.

Ad esempio, per scoprire come configurare l'azione MoveResource, consulta Esempi di azioni.

Azione RenameResource

Questa azione ti consente di rinominare una risorsa specificando un percorso e un nuovo nome.

Parametri di input dell'azione RenameResource

Nome parametro Tipo di dati Obbligatorio Descrizione
Percorso Stringa Sì Il percorso della risorsa da rinominare. Es. /myFolder/sample.txt
NewName Stringa Sì Il nuovo nome della risorsa. Es. sampleDocument.txt

Ad esempio, per scoprire come configurare l'azione RenameResource, consulta Esempi di azioni.

Azione AnnullaCondivisioneCartella

Questa azione ti consente di annullare la condivisione di una cartella. Richiede l'ambito sharing.write.

Parametri di input dell'azione UnshareFolder

Nome parametro Tipo di dati Obbligatorio Descrizione
FolderId Stringa Sì L'ID della cartella condivisa di cui annullare la condivisione.
LeaveCopy Stringa No Se true, i membri di questa cartella condivisa riceveranno una copia della cartella dopo la sua disattivazione. Il valore predefinito è false.

Ad esempio, per scoprire come configurare l'azione UnshareFolder, consulta Esempi di azioni.

Azione DownloadFile

Questa azione ti consente di scaricare un file. Richiede l'ambito files.content.read.

Parametri di input dell'azione DownloadFile

Nome parametro Tipo di dati Obbligatorio Descrizione
ID Stringa Sì L'ID del documento da scaricare.
Revisione Stringa No La revisione del documento da scaricare, ad esempio "rev:a1c10ce0dd78".
Percorso Stringa No Il percorso del file o della cartella da scaricare.
AsZip Booleano No Scaricare una cartella in formato ZIP. Deve essere impostato su true per scaricare una cartella.
FileStream Stringa No Un'istanza di uno stream di output in cui vengono scritti i dati del file. Viene utilizzato solo se DownloadTo non è impostato.
DownloadTo Stringa No Il percorso della cartella in cui scaricare il file.
FileType Stringa Sì Il tipo di file(file o carta)

Ad esempio, per scoprire come configurare l'azioneDownloadFile, consulta Esempi di azioni.

Esempi di azioni

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

Esempio: copiare una risorsa

L'esempio seguente mostra come copiare una risorsa con un percorso specificato in un altro percorso:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CopyResource e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "From_Path": "/DropboxFolder/pptxFile.pptx",
  "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CopyResource avrà un valore simile al seguente:

    [ { "Success": "true", "metadata_.tag": "file", 
  "metadata_name": "pptxFile.pptx", 
  "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", 
  "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", 
  "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w",
  "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z",
  "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", 
  "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267",
  "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", 
  "metadata_is_downloadable": "true", 
  "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]

Esempio: creare una cartella

L'esempio seguente mostra come creare una cartella in un determinato percorso:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CreateFolder e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "Path": "/TestDrobBoxFolder/newFolder"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task CreateFolder avrà un valore simile al seguente:

    [ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]

Esempio: elimina una risorsa

L'esempio seguente mostra come eliminare una risorsa:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DeleteResource e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "Path": "/TestingDropBox/FolderToBeDeletedName"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DeleteResource avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: spostare una risorsa

L'esempio seguente mostra come spostare una risorsa:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione MoveResource e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf",
  "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task MoveResource avrà un valore simile al seguente:

    [{
  "Status": "Success"
  }]

Esempio: rinomina una risorsa

L'esempio seguente mostra come rinominare una risorsa:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione RenameResource e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "Path": "/TestDropBox/abcd",
  "NewName": "abcded"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task RenameResource avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: annullare la condivisione di una cartella

L'esempio seguente mostra come annullare la condivisione di una cartella:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione UnshareFolder e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "FolderId": "3336772979"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnshareFolder avrà un valore simile al seguente:

    [{
"Status": "Success"
}]

Esempio: scarica un file

L'esempio seguente mostra come scaricare un file:

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadFile e poi fai clic su Fine.
  3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "Id": "id:8-07A6kHAoIAAAAAAAABcg",
  "FileType": "file"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DownloadFile avrà un valore simile al seguente:

    [ { "Success": "true", "Name": "license.txt", 
  "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", 
  "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", 
  "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt",
   "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt",
    "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, 
  "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null,
  "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067",
  "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", 
  "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]

Utilizzare il collegamento a Dropbox in un'integrazione

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

  • Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
  • Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Ricevere assistenza dalla community Google Cloud

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

Passaggi successivi