Google Agenda

Versões compatíveis

Esse conector é compatível com as APIs REST do Google Agenda.

Antes de começar

No seu projeto do Google Cloud, faça o seguinte:

  • Verifique se a conectividade de rede está configurada. Para mais informações, consulte Conectividade de rede.
  • Conceda o papel do IAM roles/connectors.admin ao usuário que está configurando o conector.
  • Conceda os papéis do IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que você quer usar para o conector.
  • Ative secretmanager.googleapis.com (API Secret Manager) e connectors.googleapis.com (API Connectors). Para mais informações, consulte Como ativar serviços.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + CRIAR NOVO para abrir a página Criar conexão.
  3. Na seção Local, faça o seguinte:
    1. Região: selecione um local na lista suspensa.

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em Próxima.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione Google Agenda na lista de conectores 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 conexão, insira um nome para a instância de conexão. O nome da conexão pode conter letras minúsculas, números ou hifens. O nome precisa começar com uma letra e terminar com uma letra ou um número, e não pode ter mais de 49 caracteres.
    4. Descrição: insira uma descrição para a instância de conexão.
    5. Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    7. Tempo limite de conexão: opcionalmente, insira o tempo limite de conexão em segundos.
    8. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    9. + ADICIONAR RÓTULO: clique aqui para adicionar um rótulo à conexão na forma de um par de chave-valor.
    10. Clique em Próxima.
  5. Na seção Autenticação, insira os detalhes da autenticação.
    1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      Os seguintes tipos de autenticação são compatíveis com a conexão do Google Agenda:

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

      Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

    2. Clique em Next.
  6. Revisão: revise os detalhes de conexão e autenticação.
  7. Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

  • Autenticação de conta de serviço: nenhuma configuração adicional é necessária para esse tipo de autenticação. A conta de serviço selecionada na seção Detalhes da conexão será usada para autenticação.
  • OAuth 2.0 - JWT Bearer
    • Certificado JWT: selecione o certificado a ser usado para autenticação JWT.
    • Versão do secret: insira a versão do secret do certificado JWT.
    • Assunto do JWT: insira o assunto do JWT.
  • Código de autorização OAuth 2.0
    • ID do cliente: insira o ID do cliente a ser usado para autenticação OAuth.
    • Escopos: insira uma lista dos escopos desejados.
    • Chave secreta do cliente: insira a chave secreta a ser usada para autenticação do OAuth.
    • Versão do secret: insira a versão do chave secreta do cliente.

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

Tipo de conexão da conta de serviço

Nome do campo Detalhes
Local us-central1
Conector Google Agenda
Versão do conector 1
Nome da conexão service-account-auth
Ativar 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

Tipo de conexão de portador JWT do OAuth 2.0

Nome do campo Detalhes
Local us-central1
Conector Google Agenda
Versão do conector 1
Nome da conexão jwt-bearer-auth
Ativar 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 conexão de código de autorização

Nome do campo Detalhes
Local us-central1
Conector Google Agenda
Versão do conector 1
Nome da conexão gcpcloud-googlecalendar-rest-conn
Ativar 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
Escopo https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Chave secreta do cliente ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versão do secret 1

Limitações do sistema

O conector do Google Agenda pode processar no máximo duas transações por segundo, por nó, e limita as transações além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

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

Usar a conexão do Google Agenda em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e no Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa de conectores na integração da Apigee, consulte Tarefa de conectores.
  • Para entender como criar e usar a tarefa de conectores na Application Integration, consulte tarefa de conectores.

Exemplos de operações de entidade

Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.

Exemplo: listar todas as agendas

  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 clique em Concluído.
  4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com a exigência do cliente.

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

    Use o filterClause para filtrar registros com base nas colunas.

Exemplo: receber detalhes da agenda

  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 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 seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e insira "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" no campo Input Value e defina o entityId como variável local.

    6. O valor de entityId precisa ser transmitido diretamente, como "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Aqui, "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" é o valor exclusivo da chave primária, que precisa ser transmitido.

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

Exemplo: excluir uma agenda

  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 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 seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e insira "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" no campo Input Value e defina o entityId como variável local.

    Se a entidade tiver duas chaves primárias ou de negócios compostas em vez de especificar o entityId, você também poderá definir a filterClause como id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Exemplo: criar uma agenda

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa calendar terá um valor semelhante a este:

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

Exemplo: criar um evento em uma agenda

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa calendar terá um valor semelhante a este:

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

Exemplo: criar um evento na agenda principal

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione seu ID de e-mail na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa AllCalendars terá um valor semelhante a este:

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

Exemplo: criar um tipo de evento em uma agenda

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa AllCalendars terá um valor semelhante a este:

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

Exemplo: criar um evento recorrente em uma agenda

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa AllCalendars terá um valor semelhante a este:

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

Exemplo: atualizar detalhes da agenda

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 Data Mapper como a entidade da Agenda.
  6. Para definir o entityId, clique em Open Data Mapping Editor, insira um valor semelhante ao seguinte no campo Input Value e defina o entityId como variável local.

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

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

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

Exemplo: atualizar todos os detalhes das agendas

  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 clique em Concluído.
  4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e defina o connectorInputPayload como variável local. 
    {
  "Summary": "Great event"
}
  5. Defina o entityId no Data Mapper como a entidade de AllCalendars.
  6. Para definir o entityId, clique em Open Data Mapping Editor, insira um valor semelhante ao seguinte no campo Input Value e defina o entityId como variável local.

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

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

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

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir