Google Calendar

Versioni supportate

Questo connettore supporta le API REST di Google Calendar.

Prima di iniziare

Nel tuo progetto Google Cloud, esegui le seguenti attività:

  • Assicurati che la connettività di rete sia configurata. Per informazioni, consulta 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.
  • Abilita secretmanager.googleapis.com (API Secret Manager) e connectors.googleapis.com (API Connectors). Per saperne di più, consulta Attivazione dei servizi.

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 Google Calendar 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. Timeout connessione: (facoltativo) inserisci il timeout della connessione in secondi.
    8. (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.

    9. + AGGIUNGI ETICHETTA: fai clic qui per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    10. 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 Google Calendar 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.
  • 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: inserisci il client secret da utilizzare per l'autenticazione OAuth.
    • Versione del secret: inserisci la versione del secret del client secret.

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 del service account

Nome campo Dettagli
Località us-central1
Connettore Google Calendar
Versione del connettore 1
Nome collegamento service-account-auth
Abilita Cloud Logging Sì
Service account iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione Sì
Autenticazione service account Sì

Tipo di connessione OAuth 2.0 - Connessione (bearer) JWT

Nome campo Dettagli
Località us-central1
Connettore Google Calendar
Versione del connettore 1
Nome collegamento jwt-bearer-auth
Abilita Cloud Logging Sì
Service account iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione Sì
OAuth 2.0 - Connessione (bearer) JWT Sì
JWT Cert projects/google-cloud-project/secrets/jwt-cert/versions/1
Versione secret 1

OAuth 2.0 - Tipo di connessione con codice di autorizzazione

Nome campo Dettagli
Località us-central1
Connettore Google Calendar
Versione del connettore 1
Nome collegamento gcpcloud-googlecalendar-rest-conn
Abilita Cloud Logging Sì
Service account iam.gserviceaccount.com
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione Sì
ID client 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Ambito https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Client secret ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versione secret 1

Limitazioni di sistema

Il connettore Google Calendar può elaborare un massimo di 2 transazioni 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 Google Calendar 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.

Esempi di operazioni sulle entità

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

Esempio: elenca tutti i calendari

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Calendars 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: recuperare i dettagli del calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Calendars dall'elenco Entity.
  3. Seleziona l'operazione Get, quindi fai clic su Fine.
  4. Imposta entityId su "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", 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 "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" nel campo Input Value e imposta entityId come variabile locale.

    6. Il valore di entityId deve essere passato direttamente, ad esempio "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Qui "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" è il valore univoco della chiave primaria, che deve essere passato.

    In alcuni casi, il passaggio di un entityId potrebbe generare un errore se l'entità utilizza due chiavi composite. In questi casi, puoi utilizzare filterClause per passare il valore, ad esempio id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Esempio: eliminare un calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Calendars dall'elenco Entity.
  3. Seleziona l'operazione Delete, quindi fai clic su Fine.
  4. Imposta entityId su "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", ovvero la chiave da trasferire. Per impostare entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, inserisci "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" nel campo Input Value e imposta entityId come variabile locale.

    Se l'entità ha due chiavi aziendali o primarie composite anziché specificare entityId, puoi anche impostare filterClause su id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Esempio: creare un calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Calendars dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "New calendar"
}

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

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Esempio: creare un evento in un calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona AllCalendars dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

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

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Esempio: crea un evento nel calendario principale

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona il tuo ID email dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

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

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Esempio: creare un tipo di evento in un calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona AllCalendars dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}

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

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Esempio: creare un evento ricorrente in un calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona AllCalendars dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "Google Cloud Recurring event",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-11-2 14:00:00",
  "EndDateTime": "2025-11-2 14:30:00",
  "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
  "StartDateTimeZone": "America/Los_Angeles",
  "EndDateTimeZone": "America/Los_Angeles"
}

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

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Esempio: aggiornare i dettagli del calendario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Calendars dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Data Mapping, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "Updated from Google Cloud"
}
  5. Imposta entityId in Data Mapper sull'entità del calendario.
  6. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e imposta entityId come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

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

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Esempio: aggiornare tutti i dettagli dei calendari

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona AllCalendars 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, quindi inserisci un valore simile al seguente nel campo Input Value e imposta connectorInputPayload come variabile locale. 
    {
  "Summary": "Great event"
}
  5. Imposta entityId in Data Mapper sull'entità di AllCalendars.
  6. Per impostare entityId, fai clic su Open Data Mapping Editor, inserisci un valore simile al seguente nel campo Input Value e imposta entityId come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su Summary='New sep event'.

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

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": 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