Gmail

Il connettore Gmail ti consente di eseguire le operazioni di lettura ed eliminazione su Gmail.

Versioni supportate

Questo connettore supporta le API REST di Gmail.

Prima di iniziare

Prima di utilizzare il connettore Gmail, esegui le seguenti operazioni:

  • Nel tuo progetto Google Cloud:
    • 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:

  1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
  3. Nella sezione Località, completa quanto segue:
    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 Gmail dall'elenco dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione. Il nome della connessione può contenere lettere minuscole, numeri o trattini. Il nome deve iniziare con una lettera e terminare con una lettera o un numero e non deve superare i 49 caratteri.
    4. Descrizione: 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. (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.

    8. + AGGIUNGI ETICHETTA: fai clic qui per aggiungere un'etichetta alla connessione sotto forma di coppia chiave-valore.
    9. 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 Gmail supporta i seguenti tipi di autenticazione:

      • Autenticazione service account
      • OAuth 2.0 - Connessione (bearer) JWT
      • OAuth 2.0 - Codice di autorizzazione

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

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

Configura l'autenticazione

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

  • Autenticazione dell'account di servizio: non è necessaria alcuna configurazione aggiuntiva per questo tipo di autenticazione. Il account di servizio selezionato nella sezione Dettagli connessione verrà utilizzato per l'autenticazione.
  • OAuth 2.0 - Connessione (bearer) JWT
    • Certificato JWT: seleziona il certificato da utilizzare per l'autenticazione JWT.
    • Versione del secret: inserisci la versione del secret del certificato JWT.
    • Soggetto JWT: inserisci il soggetto JWT.
    • Enable Authentication Override (Attiva override autenticazione): attiva questa opzione per eseguire l'override dell'autenticazione.
  • OAuth 2.0 - Codice di autorizzazione
    • ID client: inserisci l'ID client da utilizzare per l'autenticazione OAuth.
    • Ambiti: inserisci un elenco degli ambiti che ti interessano.
    • Client secret: il client secret da utilizzare per l'autenticazione OAuth.
    • Versione del secret: inserisci la versione del secret del client secret.
    • Enable Authentication Override (Attiva override autenticazione): attiva questa opzione per eseguire l'override dell'autenticazione.

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 OAuth 2.0 - Connessione (bearer) JWT

Nome campo Dettagli
Località asia-east1
Connettore Gmail
Versione del connettore 1
Nome collegamento gmail-jwt-conn
Abilita Cloud Logging true
Service account my-service-account@my-project.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione OAuth 2.0 - Connessione (bearer) JWT
JWT Cert Certificato JWT
Versione secret 1

OAuth 2.0 - Tipo di connessione con codice di autorizzazione

Nome campo Dettagli
Località us-central1
Connettore Gmail
Versione del connettore 1
Nome collegamento gmail-auth-conn
Abilita Cloud Logging Sì
Service account my-service-account@my-project.iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione OAuth 2.0 - Codice di autorizzazione
ID client 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Ambiti https://mail.google.com/
Client secret ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versione secret 1

Limitazioni di sistema

Il connettore Gmail può elaborare un massimo di una transazione 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.

Utilizzare la connessione Gmail 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, consulta la sezione Attività Connettori.

Azioni

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

Azione SendMailMessages

Questa azione invia un messaggio Gmail.

Parametri di input dell'azione SendMailMessages

Nome parametro Tipo di dati Obbligatorio Descrizione
A Stringa Sì L'indirizzo email del destinatario principale. Per più destinatari, utilizza un elenco separato da virgole.
AttachmentHasBytes Stringa No Imposta questo valore su true se i contenuti dell'allegato sono forniti in AttachmentContentBytes (codificati in base64) o su false se i contenuti sono forniti come stringa in AttachmentContent. Il valore predefinito è false.
AttachmentFileName Stringa No Il nome del file da allegare. Questo parametro viene utilizzato quando AttachmentHasBytes è false o non viene fornito.
Oggetto Stringa Sì La riga dell'oggetto dell'email.
AttachmentContent Stringa No Il contenuto della stringa del file da allegare. Questo parametro viene utilizzato quando AttachmentHasBytes è impostato su false o non viene fornito.
Ccn Stringa No L'indirizzo email del destinatario in Ccn. Per più destinatari, utilizza un elenco separato da virgole.
AttachmentContentBytes Stringa No I contenuti in byte con codifica Base64 del file da allegare. Questo parametro viene utilizzato quando AttachmentHasBytes è impostato su true.
Cc Stringa No L'indirizzo email del destinatario in Cc. Per più destinatari, utilizza un elenco separato da virgole.
Contenuti Stringa Sì Il contenuto principale del messaggio email.
AttachmentPath Stringa No Un elenco separato da virgole di percorsi file locali da allegare all'email.

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

Azione DownloadAttachment

Questa azione scarica un allegato da Gmail.

Parametri di input dell'azione DownloadAttachment

Nome parametro Tipo di dati Obbligatorio Descrizione
MessageId Stringa Sì L'ID dell'email.
DownloadLocation Stringa No La posizione in cui verrà salvato l'allegato.
FileStream Stringa No Un'istanza di un flusso di output in cui vengono scritti i dati dei file.
AttachmentId Stringa No L'ID dell'allegato. Deve essere fornito se è specificato FileStream.

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

Esempi di azioni

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

Esempio: inviare un messaggio di Gmail

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione SendMailMessages, quindi 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: 
    {
  "To": "testbristleconeemail@gmail.com",
  "Subject": "Data MapperCheck",
  "Content": "Gmail",
}

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

    [{
"Id": "199334f660ff462a"
}]

Esempio: inviare un messaggio Gmail con un allegato JPG

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione SendMailMessages, quindi 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: 
     {
"To": "testbristleconeemail@gmail.com",
"Subject": "Data Mapper Email Sep10 JPG",
"Content": "Gmail",
"AttachmentFileName": "TestSep10.jpg",
"AttachmentContentBytes": "/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCANUBdwDAREAAhEBAxEB/8QAHgABAAAGAwEAAAAAAAAAAAAAAAEDBAcICQIFBgr/xABsEAABAwMCBAMFBQQHAwUJACMBAgMEAAURBgcIEiExCRNBChQiUWEVIzJxgUJSkaEWFzNicrHBJEPRNFOCkqIYJTlEY4O14fDxJmRzdXZ3k7PCNTY4haOytLYZN1RVV8NIVmV0eJSWpNLT4v/EAB0BAQABBAMBAAAAAAAAAAAAAAAHAQQFBgIDCAn/xABXEQABAwURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIlESiJREoiURKIv/Z",
"AttachmentHasBytes": true
}

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

    [{
  "Id": "199334f660ff462a"
}]

Esempio: inviare un messaggio Gmail con un allegato PDF

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione SendMailMessages, quindi 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: 
    {
  "To": "testbristleconeemail@gmail.com",
  "Subject": "Data Mapper Email Sep10",
  "Content": "Gmail",
  "AttachmentFileName": "TestSep10.pdf",
  "AttachmentContent": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nD2OywoCMQxF9/mKu3YRk7bptDAIDuh+oOAP+AAXgrOZ37etjmSTe3ISIljpDYGwwrKxRwrKGcsNlx1e31mt5UFTIYucMFiqcrlif1ZobP0do6g48eIPKE+ydk6aM0roJG/RegwcNhDr5tChd+z+miTJnWqoT/3oUabOToVmmvEBy5IoCgplbmRzdHJlYW0KZW5kb2JqCgozIDAgb2JqCjEzNAplbmRvYmoKCjUgMCBvYmoKPDwvTGVuZ3RoIDYgMCBSL0ZpbHRlci9GbGF0ZURlY29kZS9MZW5ndGgxIDIzMTY0Pj4Kc3RyZWFtCnic7Xx5fFvVlf+59z0tdrzIu7xFz1G8Kl7i2HEWE8vxQlI3iRM71A6ksSwrsYptKZYUE9omYStgloZhaSlMMbTsbSPLAZwEGgNlusxQ0mHa0k4Z8muhlJb8ynQoZVpi/b736nkjgWlnfn/8Pp9fpNx3zz33bPecc899T4oVHA55KIEOkUJO96DLvyQxM5WI/omIpbr3BbU/3J61FPBpItOa3f49g1948t/vI4rLIzL8dM/A/t3vn77ZSpT0LlH8e/0eV98jn3k0mSj7bchY2Q/EpdNXm4hyIIOW9g8Gr+gyrq3EeAPGVQM+t+uw5VrQ51yBcc6g6wr/DywvGAHegbE25Br0bFR/ezPGR4kq6/y+QPCnVBYl2ijka/5hjz95S8kmok8kEFl8wDG8xQtjZhRjrqgGo8kcF7+I/r98GY5TnmwPU55aRIhb9PWZNu2Nvi7mRM9/C2flx5r+itA36KeshGk0wf5MWfQ+y2bLaSOp9CdkyxE6S3dSOnXSXSyVllImbaeNTAWNg25m90T3Rd+ii+jv6IHoU+zq6GOY/yL9A70PC/5NZVRHm0G/nTz0lvIGdUe/Qma6nhbRWtrGMslFP8H7j7DhdrqDvs0+F30fWtPpasirp0ZqjD4b/YDK6Gb1sOGVuCfoNjrBjFF31EuLaQmNckf0J9HXqIi66Wv0DdjkYFPqBiqgy+k6+jLLVv4B0J30dZpmCXy",
  "AttachmentHasBytes": true
}

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

    [{
  "Id": "1993341d558d7b07"
}]

Esempio: inviare un messaggio Gmail con un allegato TXT

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione SendMailMessages, quindi 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: 
    {
  "To": "testbristleconeemail@gmail.com",
  "Subject": "Data Mapper Email Sep10",
  "Content": "Gmail",
  "AttachmentFileName": "TestSep10.txt",
  "AttachmentContent": "TestingwithAttachment",
  "AttachmentHasBytes": true
}

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

    [{
    "Id": "1993341d558d7b07"
}]

Esempio: scaricare un allegato da Gmail

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione DownloadAttachment, quindi 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: 
    {
  "MessageId": "198acdcde5c09ce5"
}

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

    [{
    "Success": "true",
    "MessageId": "198acdcde5c09ce5",
    "AttachmentId": "1",
    "Size": "58005",
    "Data": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoYWJvdXQ6YmxhbmspCi9DcmVhdG9yIChNb3ppbGxhLzUuMCBcKFgxMTsgTGludXggeDg2XzY0XCkgQXBwbGVXZWJLaXQvNTM3LjM2IFwoS0hUTUwsIGxpa2UgR2Vja29cKSBIZWFkbGVzc0Nocm9tZS8xMzguMC4wLjAgU2FmYXJpLzUzNy4zNikKL1Byb2R1Y2VyIChTa2lhL1BERiBtMTM4KQovQ3JlYXRpb25EYXRlIChEOjIwMjUwODE1MDgwMDE2KzAwJzAwJykKL01vZERhdGUgKEQ6MjAyNTA4MTUwODAwMTYrMDAnMDAnKT4-CmVuZG9iagozIDAgb2JqCjw8L2NhIDEKL0JNIC9Ob3JtYWw-PgplbmRvYmo",
    "Filename": "My_Store_404672162.pdf",
    "@isoutervalue": null
}]

Esempi di operazioni sulle entità

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

Esempio: elenca tutti i messaggi di Gmail

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

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

Esempio: ottenere i dettagli di un messaggio Gmail dalla posta in arrivo

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

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

    In alcuni casi, il passaggio di un singolo entityId può causare un errore perché l'entità ha due chiavi composite. In questi casi, puoi utilizzare filterClause e passare il valore, ad esempio id='1'.

Esempio: elimina un messaggio di Gmail

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Messages dall'elenco Entity.
  3. Seleziona l'operazione Delete, quindi fai clic su Fine.
  4. Imposta entityId su 1, ovvero la chiave da trasferire.
  5. Per impostare entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci 1 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='1'.

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