Calendário Google

Versões suportadas

Este conetor suporta as APIs REST do Calendário Google.

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

  • Certifique-se de que a conetividade de rede está configurada. Para mais informações, consulte o artigo Conetividade de rede.
  • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
  • Conceda funções de IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que quer usar para o conector
  • Ative a secretmanager.googleapis.com (API Secret Manager) e a connectors.googleapis.com (API Connectors). Para mais informações, consulte o artigo Ativar serviços.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + CRIAR NOVO para abrir a página Criar associação.
  3. Na secção Localização, conclua o seguinte:
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clicar em Seguinte.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conetor: selecione Google Calendar na lista de conetores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista de versões disponíveis.
    3. No campo Nome da associação, introduza um nome para a instância da associação. O nome da associação pode conter letras minúsculas, números ou hífens. O nome tem de começar com uma letra e terminar com uma letra ou um número, e não pode exceder 49 carateres.
    4. Descrição: introduza uma descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Limite de tempo da ligação: opcionalmente, introduza o limite de tempo da ligação em segundos.
    8. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    9. + ADICIONAR ETIQUETA: clique nesta opção para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    10. Clicar em Seguinte.
  5. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação ao Calendário Google:

      • Autenticação da conta de serviço
      • OAuth 2.0 – Portador de JWT
      • OAuth 2.0 – Código de autorização

      Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

    2. Clicar em Seguinte.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

  • Autenticação da conta de serviço: não é necessária nenhuma configuração adicional para este tipo de autenticação. A conta de serviço que selecionou na secção Detalhes da ligação vai ser usada para a autenticação.
  • OAuth 2.0 – JWT Bearer
    • Certificado JWT: selecione o certificado a usar para a autenticação JWT.
    • Versão do Secret: introduza a versão do Secret do certificado JWT.
    • Assunto do JWT: introduza o assunto do JWT.
  • OAuth 2.0 – Código de autorização
    • ID do cliente: introduza o ID do cliente a usar para a autenticação OAuth.
    • Âmbitos: introduza uma lista dos âmbitos pretendidos.
    • Segredo do cliente: introduza o segredo do cliente a usar para a autenticação OAuth.
    • Versão do Secret: introduza a versão do Secret do segredo do cliente.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo dos vários campos que configura quando cria a associação.

Tipo de ligação da conta de serviço

Nome do campo Detalhes
Localização us-central1
Conetor Calendário Google
Versão do conetor 1
Nome da ligação service-account-auth
Ative o Cloud Logging Sim
Conta de serviço iam.gserviceaccount.com
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
Autenticação da conta de serviço Sim

OAuth 2.0 – Tipo de ligação de portador JWT

Nome do campo Detalhes
Localização us-central1
Conetor Calendário Google
Versão do conetor 1
Nome da ligação jwt-bearer-auth
Ative o Cloud Logging Sim
Conta de serviço iam.gserviceaccount.com
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
OAuth 2.0 – JWT bearer Sim
Certificado JWT projects/google-cloud-project/secrets/jwt-cert/versions/1
Versão do Secret 1

OAuth 2.0 – Tipo de ligação de código de autorização

Nome do campo Detalhes
Localização us-central1
Conetor Calendário Google
Versão do conetor 1
Nome da ligação gcpcloud-googlecalendar-rest-conn
Ative o Cloud Logging Sim
Conta de serviço iam.gserviceaccount.com
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
ID do cliente 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Âmbito https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Segredo do cliente ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versão do Secret 1

Limitações do sistema

O conector do Calendário Google pode processar um máximo de 2 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Use a ligação do Calendário Google numa integração

Depois de criar a associação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa de conetores na Apigee Integration, consulte o artigo Tarefa de conetores.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: liste todos os calendários

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calendars na lista Entity.
  3. Selecione a operação List e, de seguida, clique em Concluído.
  4. Na secção Entrada de tarefas da tarefa Conetores, pode definir a filterClause de acordo com o requisito do cliente.

    5. Tem de usar aspas simples (') para incluir o valor de uma filterClause.

    Pode usar o filterClause para filtrar registos com base nas colunas.

Exemplo: obter detalhes do calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calendars na lista Entity.
  3. Selecione a operação Get e, de seguida, clique em Concluído.
  4. Defina o entityId como "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", que é a chave a ser transmitida.
  5. Para definir o entityId, na secção Mapeamento de dados do Mapeador de dados, clique em Abrir editor de mapeamento de dados e, de seguida, introduza "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" no campo Valor de entrada e defina o entityId como variável local.

    6. O valor de entityId deve ser transmitido diretamente, como "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Aqui, "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" é o valor da chave principal exclusivo, que tem de ser transmitido.

    Em determinados casos, a transmissão de um entityId pode gerar um erro se a entidade usar duas chaves compostas. Nesses casos, pode usar o filterClause para transmitir o valor, como id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Exemplo: elimine um calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calendars na lista Entity.
  3. Selecione a operação Delete e, de seguida, clique em Concluído.
  4. Defina o entityId como "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", que é a chave a ser transmitida. Para definir o entityId, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, de seguida, introduza "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" no campo Valor de entrada e defina o entityId como variável local.

    Se a entidade tiver duas chaves empresariais ou principais compostas em vez de especificar o entityId, também pode definir o filterClause como id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Exemplo: criar um calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calendars na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "Summary": "New calendar"
}

    Se a integração for bem-sucedida, o parâmetro de resposta da tarefa calendarconnectorOutputPayload terá um valor semelhante ao seguinte:

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

Exemplo: crie um evento num calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione AllCalendars na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Se a integração for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:calendarconnectorOutputPayload

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

Exemplo: crie um evento no seu calendário principal

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione o seu ID de email na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Se a integração for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AllCalendarsconnectorOutputPayload

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

Exemplo: crie um tipo de evento num calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione AllCalendars na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}

    Se a integração for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AllCalendarsconnectorOutputPayload

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

Exemplo: crie um evento recorrente num calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione AllCalendars na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "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 a integração for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AllCalendarsconnectorOutputPayload

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

Exemplo: atualizar detalhes do calendário

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calendars na lista Entity.
  3. Selecione a operação Update e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "Summary": "Updated from Google Cloud"
}
  5. Defina o entityId no mapeador de dados para a entidade do Calendário.
  6. Para definir o entityId, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina o entityId como variável local.

    Em vez de especificar o entityId, também pode definir a filterClause como id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

    A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída da tarefa do conetor connectorOutputPayload:

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

Exemplo: atualize todos os detalhes dos calendários

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione AllCalendars na lista Entity.
  3. Selecione a operação Update e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina connectorInputPayload como variável local. 
    {
  "Summary": "Great event"
}
  5. Defina o entityId no mapeador de dados para a entidade de AllCalendars.
  6. Para definir o entityId, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e defina o entityId como variável local.

    Em vez de especificar o entityId, também pode definir a filterClause como Summary='New sep event'.

    A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída da tarefa do conetor connectorOutputPayload:

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

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?