Crea e configura una connessione a Google Drive

La pagina descrive come creare e configurare una connessione Google Drive in Integration Connectors. Per ulteriori informazioni sul connettore Google Drive, consulta Panoramica del connettore Google Drive.

Prima di iniziare

Nel tuo progetto Google Cloud, esegui le seguenti operazioni:

  • 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 ruoli IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor al service account che vuoi utilizzare per il connettore.
  • 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 queste autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti viene chiesto di attivarli quando configuri il connettore.

Creare una connessione Google Drive

Per creare una connessione Google Drive:

  1. Nella console Google Cloud , vai alla pagina Integration Connectors > Connessioni.

    Vai a Connessioni

  2. Fai clic su Crea connessione.

    Viene visualizzata la pagina Crea connessione.

  3. Nella sezione Località:
    1. Fai clic su Regione e poi seleziona una località per la connessione.

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, fornisci i seguenti dettagli:
    1. Connettore: seleziona Google Drive.
    2. Versione del connettore: seleziona la versione del connettore che vuoi utilizzare.

      La versione del connettore che selezioni dipende dalla versione dell'API Google Drive che vuoi utilizzare. Per saperne di più, vedi Versioni della connessione a Google Drive.

    3. Nome connessione: inserisci un nome per la connessione.
    4. Descrizione: (facoltativo) inserisci una descrizione della 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 il account di servizio che vuoi utilizzare per la connessione. Assicurati che il account di servizio disponga dei ruoli e delle autorizzazioni IAM pertinenti richiesti.
    7. Supporta tutti i Drive: seleziona questa casella di controllo per attivare l'accesso ai Drive condivisi. Questa opzione è disponibile solo per Google Drive v2.
    8. Impostazioni del nodo di connessione: (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 del connettore, consulta 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.

    9. Fai clic su Avanti.
  5. Nella sezione Autenticazione, seleziona e configura il tipo di autenticazione per la connessione:

    Service account

    Seleziona questa opzione se la tua applicazione viene eseguita su una macchina virtuale Google Cloud e deve utilizzare il account di servizio collegato alla VM per l'autenticazione.

    Per utilizzare questo tipo di autenticazione, devi disporre di un account di servizio con i ruoli e le autorizzazioni IAM pertinenti richiesti per l'autenticazione.

    Per informazioni sulla creazione di un account di servizio, vedi Creazione e gestione dei service account. Per informazioni sulla concessione dei ruoli a un account di servizio, consulta Concessione, modifica e revoca dell'accesso alle risorse.

    Dettagli di connessione di esempio per il tipo di autenticazione del account di servizio

    Nome campo Dettagli
    Località us-central1
    Connettore Google Drive
    Versione del connettore 2
    Nome collegamento googledrive-ws-gcpaccount
    Abilita Cloud Logging Sì
    Service account 123456789012-compute@developer.gserviceaccount.com
    Numero minimo di nodi 2
    Numero massimo di nodi 50
    Autenticazione Autenticazione service account

    OAuth 2.0 - Connessione (bearer) JWT

    Per configurare il tipo di autenticazione di connessione (bearer) JWT OAuth 2.0, procedi nel seguente modo:

    1. Crea una chiave JSON del service account e scarica il file della chiave JSON. Questo file di chiavi viene utilizzato come certificato JWT per la connessione.
    2. Crea un secret per archiviare il file della chiave JSON o il certificato JWT.
    3. Fornisci i dettagli del secret quando crei la connessione in Integration Connectors:
      • JWT Cert (Certificato JWT): scegli il secret contenente il certificato JWT.
      • Versione del secret: seleziona la versione del secret per il secret selezionato.
      • Soggetto JWT: (facoltativo) inserisci il soggetto JWT da utilizzare per la connessione. Questo viene utilizzato come campo sub nel token JWT.

    Dettagli di connessione di esempio per il tipo di autenticazione OAuth 2.0 - Connessione (bearer) JWT

    Nome campo Dettagli
    Località us-central1
    Connettore Google Drive
    Versione del connettore 2
    Nome collegamento googledrivejwt
    Abilita Cloud Logging Sì
    Service account 123456789012-compute@developer.gserviceaccount.com
    Numero minimo di nodi 2
    Numero massimo di nodi 50
    Autenticazione OAuth 2.0 - Connessione (bearer) JWT
    JWT Cert 
    {
  "type": "service_account",
  "project_id": "sm****-****-******",
  "private_key_id": "0b***************************",
  "private_key": "-----BEGIN PRIVATE KEY-----\nO********************************************=\n-----END PRIVATE KEY-----\n",
  "client_email": "go**********************************8",
  "client_id": "10**********************",
  "auth_uri": "https:***********************",
  "token_uri": "https:************************",
  "auth_provider_x509_cert_url": "https:*********************",
  "client_x509_cert_url": "https:****************************************************",
  "universe_domain": "go********"
}
    Versione secret 2

    Codice di autorizzazione OAuth 2.0

    Utilizza questo metodo se la tua applicazione richiede l'interazione dell'utente finale tramite un accesso basato sul browser.

    Per configurare il tipo di autenticazione Codice di autorizzazione OAuth 2.0, procedi nel seguente modo:

    1. Crea le credenziali OAuth 2.0 per la tua applicazione web. Questo processo crea un ID client e il file JSON del client secret.
    2. Identifica gli ambiti di accesso che vuoi concedere alla tua applicazione.
    3. Crea un secret per archiviare le credenziali OAuth 2.0 (client_secret.json).
    4. Fornisci l'ID client, gli ambiti e i dettagli del secret quando crei la connessione in Integration Connectors:
      • ID client: inserisci l'ID client creato per la tua applicazione web.
      • Ambiti: inserisci un elenco separato da virgole degli ambiti desiderati.
      • Client secret: scegli il secret contenente le credenziali OAuth 2.0.
      • Versione del secret: seleziona la versione del secret per il secret selezionato.

    Dettagli di connessione di esempio per il tipo di autenticazione con codice di autorizzazione OAuth 2.0

    Nome campo Dettagli
    Località europe-west1
    Connettore Google Drive
    Versione del connettore 2
    Nome collegamento googledrive-wsconn-code
    Abilita Cloud Logging Sì
    Service account 123456789012-compute@developer.gserviceaccount.com
    Numero minimo di nodi 2
    Numero massimo di nodi 50
    Autenticazione OAuth 2.0 - Codice di autorizzazione
    ID client CLIENT_ID
    Ambiti https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/drive.appfolder, https://www.googleapis.com/auth/drive.install, https://www.googleapis.com/auth/drive.metadata, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.activity, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.apps.readonly, https://www.googleapis.com/auth/drive.scripts e https://www.googleapis.com/auth/drive.meet.readonly
    Client secret CLIENT_SECRET
    Versione secret 2
  6. Attiva override autenticazione: (facoltativo) seleziona questa casella di controllo per consentire alla connessione di accettare dinamicamente un'autenticazione diversa durante l'esecuzione.
  7. Fai clic su Avanti.
  8. Nella sezione Revisione, esamina i dettagli della connessione e dell'autenticazione. Puoi sempre fare clic su una delle sezioni precedenti per apportare le modifiche necessarie.
  9. Fai clic su Crea.

    Integration Connectors inizia a creare la connessione per la configurazione fornita. Il completamento della procedura richiede alcuni minuti. Una volta creata la connessione, viene visualizzata la pagina Connessioni.

Utilizzare la connessione Google Drive 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.

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.

Esempi di casi d'uso in Application Integration

Gli esempi seguenti mostrano come utilizzare l'attività Connettori in Application Integration per eseguire operazioni utilizzando la connessione a Google Drive configurata.

Esempio: elenca tutti i file

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

    5. Il valore di filterClause deve essere sempre passato tra virgolette singole ("'") in questo formato.

    Puoi utilizzare filterClause per filtrare un determinato insieme di record in base a qualsiasi colonna.

Esempio: recuperare i dettagli di un file

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Files dall'elenco Entity.
  3. Seleziona l'operazione Get, quindi fai clic su Fine.
  4. Imposta entityId su "1wsHFAusizqFe5O2", ovvero la chiave da trasmettere. Per impostare entityId, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor mappatura dei dati, poi inserisci "1wsHFAusizqFe5O2" nel campo Valore di input e scegli entityId come variabile locale.

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

Esempio: eliminare un file

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Files dall'elenco Entity.
  3. Seleziona l'operazione Delete, quindi fai clic su Fine.
  4. Imposta entityId su "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L", ovvero la chiave da trasferire. Per impostare entityId, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor mappatura dei dati, poi inserisci "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L" nel campo Valore di input e scegli entityId come variabile locale.

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

Esempio: creare un file

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Files dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload come variabile locale.
    5.   { "FileData": " ",
  "Name": "creategcpshareddrivedocxfile.docx", 
  "MIMEType": "application/vnd.google-apps.document",
  "Encoding": "BASE64"}

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

    { "Id": "1C48uLda6lyeakx2hOUdwnib-qtFOAhlpR_Ja2AmPvTU"}

Esempio: creare un Drive condiviso

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Drives dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload come variabile locale.
    5.   {"Name": "SharedDrive7"}

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

      {"Id": "0AN6y5wEvVrmPUk9PVA"}

Esempio: creare un'autorizzazione per un file, una cartella o un Drive condiviso

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Permissions dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload come variabile locale.
    5.   {"ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L",
  "Role": "COMMENTER",
  "Type": "USER",
  "EmailAddress": "charlie@altostrat.com"}

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

      { "PermissionId": "10596783046483894074",
  "ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L"}

Esempio: aggiornare i dettagli di un file

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Files dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload/filterClause come variabile locale. 
      {"Name": "New Updated file"}
  5. Imposta l'entityId del file. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload/filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su 1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm.

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

    {"Id": "1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm">}

Esempio: aggiornare un'autorizzazione per un file, una cartella o un Drive condiviso

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Permissions dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload/filterClause come variabile locale.
    5. (PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA')
{ "Role": "READER"}
  5. Imposta l'entityId dell'autorizzazione. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e scegli entityId/connectorInputPayload/filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA'.

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

      {"PermissionId": "10596783046483894074",
  "ResourceId": "0AKfRSSy6kZbfUk9PVA"}