Calendário Zoho
O Zoho Calendar é um calendário de negócios online que facilita o agendamento para você. Você pode usá-lo para ficar por dentro da sua agenda e também compartilhar calendários com sua equipe para manter todos na mesma página.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Calendário Zoho |
| URL | https://www.zoho.com/calendar/contact.html |
| zmintegration@zohomail.com |
| Metadados do conector | |
|---|---|
| Editora | Zoho Mail |
| Sítio Web | https://www.zoho.com/calendar/ |
| Política de privacidade | https://www.zoho.com/privacy.html |
| Categorias | Colaboração; Produtividade |
Calendário Zoho
O Zoho Calendar é um calendário de negócios online que facilita o seu agendamento. O conector Zoho Calendar oferece o poder de gerenciar seu calendário e executar ações repetitivas, como criar, editar, excluir eventos criando fluxos de trabalho usando o modelo de gatilho de ação.
Pré-requisitos
Uma conta verificada do Zoho Calendar. Clique aqui para criar a sua primeira conta.
Como obter credenciais
Quando você cria uma nova conexão,
- Selecione o domínio onde sua conta Zoho reside.
- Insira suas credenciais do Zoho Calendar.
- Mesmo que o aplicativo de energia seja compartilhado com outro usuário, ele deve criar uma nova conexão para começar a usá-lo.
A API do Zoho Calendar usa OAuth2.0 para autenticar e, portanto, nenhuma autenticação secundária é necessária depois que a conta é configurada.
Introdução ao conector
Siga as etapas abaixo para se conectar ao Zoho Calendar :
- Inicie sessão na sua conta Power Automate e clique em Criar no menu esquerdo.
- Você pode optar por criar um fluxo de nuvem, fluxo de área de trabalho ou fluxo de negócios. Para se conectar ao Zoho Calendar, escolha o fluxo de nuvem automatizado.
- Você pode criar um fluxo/modelo.
- Insira os valores desejados para a respetiva ação.
Problemas conhecidos e limitações
- Atualmente, não há suporte para eventos recorrentes no conector.
Erros e soluções comuns
- Para evitar erros de autenticação, escolha o domínio onde sua conta do Zoho Calendar está hospedada.
FAQ
https://www.zoho.com/calendar/help/getting-started.html
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Selecione a região onde residem os dados da sua conta Zoho. | cadeia (de caracteres) | Selecione o domínio. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Criar novo evento |
Adiciona um novo evento ao calendário do usuário. |
| Evento de atualização |
Atualiza um evento existente no calendário de um usuário. |
| Excluir evento |
Exclui um evento do calendário do usuário. |
| Obter detalhes do calendário |
recupera os detalhes de um calendário específico usando o UID do calendário. |
| Obter evento |
Obtém os detalhes de um evento específico, como o título do evento, data de início, data de término, etc., do calendário especificado de um usuário. |
| Obter lista de calendários |
Obtém a lista de todos os calendários com o UID, o nome e o fuso horário do calendário. |
| Obter lista de eventos |
Obtém a lista de todos os eventos entre o intervalo de datas especificado no formato aaaa-MM-ddTHH:mm:sszzz. |
| Pesquisar Eventos |
Obtém a lista de eventos em todos os calendários. |
Criar novo evento
Adiciona um novo evento ao calendário do usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Title
|
title | True | string |
Especificar o título do evento |
|
Hora de início
|
start | True | string |
Especifique a hora de início do evento no formato aaaa-MM-ddTHH:mm:sszzz |
|
Hora de fim
|
end | True | string |
Especifique a hora de término do evento no formato aaaa-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar o fuso horário do evento |
|
|
Cor
|
color | string |
Escolha a cor do evento ou especifique o valor hexdecimal da cor |
|
|
Description
|
description | string |
Especificar a descrição do evento |
|
|
Localização
|
location | string |
Especificar o local do evento |
|
|
URL
|
url | string |
Especifique o URL do evento |
|
|
Privado
|
isprivate | boolean |
Especificar se o evento é privado ou não |
|
|
É o dia todo
|
isallday | boolean |
Especifique se o evento é um evento de dia inteiro. |
|
|
ID de e-mail
|
string |
Especifique os endereços de e-mail dos participantes |
||
|
Transparência
|
transparency | integer |
Especifique se o evento deve ser adicionado à sua agenda de disponibilidade. |
|
|
Permitir Avançar
|
allowForwarding | boolean |
Especificar se o evento pode ser encaminhado ou não |
|
|
tipo
|
action | string |
Especifique o tipo de lembrete de evento (e-mail, notificações, etc.) |
|
|
em minutos
|
minutes | integer |
Especifique o tempo para lembrá-lo antes ou depois do evento (por exemplo: - 5 para antes, 5 para depois) |
Devoluções
- Body
- SingleEventRes
Evento de atualização
Atualiza um evento existente no calendário de um usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Event
|
euid | True | string |
Insira o ID exclusivo do evento. |
|
Title
|
title | True | string |
Especificar o título do evento |
|
Hora de início
|
start | True | string |
Especifique a hora de início do evento no formato aaaa-MM-ddTHH:mm:sszzz |
|
Hora de fim
|
end | True | string |
Especifique a hora de término do evento no formato aaaa-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar o fuso horário do evento |
|
|
Cor
|
color | string |
Escolha a cor do evento ou especifique o valor hexdecimal da cor |
|
|
Description
|
description | string |
Especificar a descrição do evento |
|
|
Localização
|
location | string |
Especificar o local do evento |
|
|
URL
|
url | string |
Especifique o URL do evento |
|
|
Privado
|
isprivate | boolean |
Especificar se o evento é privado ou não |
|
|
É o dia todo
|
isallday | boolean |
Especifique se o evento é um evento de dia inteiro. |
|
|
ID de e-mail
|
string |
Especifique os endereços de e-mail dos participantes |
||
|
Transparência
|
transparency | integer |
Especifique se o evento deve ser adicionado à sua agenda de disponibilidade. |
|
|
Permitir Avançar
|
allowForwarding | boolean |
Especificar se o evento pode ser encaminhado ou não |
|
|
tipo
|
action | string |
Especifique o tipo de lembrete de evento (e-mail, notificações, etc.) |
|
|
em minutos
|
minutes | integer |
Especifique o tempo para lembrá-lo antes ou depois do evento (por exemplo: - 5 para antes, 5 para depois) |
Devoluções
- Body
- SingleEventRes
Excluir evento
Exclui um evento do calendário do usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Event
|
euid | True | string |
Insira o ID exclusivo do evento. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
Recorrência
|
events.recurrenceid | string |
Recorrência |
Obter detalhes do calendário
recupera os detalhes de um calendário específico usando o UID do calendário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
Devoluções
- Body
- SingleCalendarRes
Obter evento
Obtém os detalhes de um evento específico, como o título do evento, data de início, data de término, etc., do calendário especificado de um usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Event
|
euid | True | string |
Insira o ID exclusivo do evento. |
Devoluções
- Body
- SingleEventRes
Obter lista de calendários
Obtém a lista de todos os calendários com o UID, o nome e o fuso horário do calendário.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
calendários
|
calendars | array of SingleCalendarRes |
calendários |
Obter lista de eventos
Obtém a lista de todos os eventos entre o intervalo de datas especificado no formato aaaa-MM-ddTHH:mm:sszzz.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Por instância
|
byinstance | True | boolean |
Recupera todas as instâncias de eventos repetidos como um evento separado quando é definido como true. O intervalo de datas não deve exceder 31 dias. |
|
Hora de início
|
start | True | string |
Especifique a hora de início no formato aaaa-MM-ddThh:mm:sszzz |
|
Hora de fim
|
end | True | string |
Especifique a hora de término no formato aaaa-MM-ddThh:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar o fuso horário do evento |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
Pesquisar Eventos
Obtém a lista de eventos em todos os calendários.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Calendário
|
cuid | True | string |
Especifique o calendário ou insira a ID exclusiva do calendário. |
|
Hora de início
|
start | True | string |
Especifique a hora de início do evento no formato aaaa-MM-ddTHH:mm:sszzz. |
|
Hora de fim
|
end | string |
Especifique a hora de término do evento no formato aaaa-MM-ddTHH:mm:sszzz. |
|
|
Pesquisar texto
|
searchtext | string |
Especificar deve ser pesquisado no título |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
pesquisa
|
search | array of object |
pesquisa |
|
ID exclusivo do evento
|
search.uid | string |
Identificador exclusivo do evento |
|
É evento durante todo o dia
|
search.isallday | boolean |
Se o evento é um evento de dia inteiro |
|
ID exclusivo do calendário
|
search.caluid | string |
Identificador único do calendário |
|
Title
|
search.title | string |
Título do evento |
|
tipo
|
search.type | integer |
tipo |
|
Timezone
|
search.dateandtime.timezone | string |
Fuso horário do evento |
|
hora de início
|
search.dateandtime.start | string |
Hora de início do evento |
|
hora de fim
|
search.dateandtime.end | string |
Hora de fim do evento |
Acionadores
| Editar notificação de evento |
Quando um evento é atualizado para um calendário |
| Excluir notificação de evento |
Quando um evento é excluído em um calendário |
| Notificação de novo evento |
Quando um evento é adicionado a um calendário |
Editar notificação de evento
Excluir notificação de evento
Quando um evento é excluído em um calendário
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID exclusivo do evento
|
zc_data.uid | string |
Identificador exclusivo do evento |
|
ID exclusivo do calendário
|
zc_data.caluid | string |
Identificador único do calendário |
Notificação de novo evento
Definições
SingleEventRes
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Cor
|
color | string |
Valor da cor do evento em hexadecimal |
|
Title
|
title | string |
Título do evento |
|
Duração
|
duration | string |
Duração do evento |
|
ID exclusivo do evento
|
uid | string |
Identificador exclusivo do evento |
|
Evento criado por
|
createdby | string |
O usuário que criou o evento |
|
É aprovado
|
isApproved | boolean |
Se o evento criado é aprovado. |
|
Localização
|
location | string |
O local do evento |
|
URL
|
url | string |
O URL do evento |
|
URL da Vista do Evento
|
viewEventURL | string |
O URL exclusivo do evento. |
|
timezone
|
dateandtime.timezone | string |
Fuso horário do evento |
|
hora de início
|
dateandtime.start | string |
Hora de início do evento |
|
hora de fim
|
dateandtime.end | string |
Hora de fim do evento |
|
Última modificação do evento em
|
lastmodifiedtime | string |
A data e a hora em que o evento foi modificado pela última vez |
|
É privado
|
isprivate | boolean |
Se o evento é privado ou não |
|
Participantes
|
attendees | array of object |
Participantes do evento |
|
nome a apresentar
|
attendees.dName | string |
Exibir nomes dos participantes |
|
ID de e-mail
|
attendees.email | string |
Os endereços de e-mail dos participantes. |
|
assiduidade
|
attendees.attendance | integer |
Se a presença é obrigatória, opcional ou não obrigatória. |
|
estado
|
attendees.status | string |
Refere-se ao status dos participantes (Aceito/Recusado/Tentativa/Precisa de ação) |
|
Criado a
|
createdtime_millis | string |
O tempo de criação do evento em GMT |
|
Tipo de notificação
|
notifyType | integer |
Notifica os participantes sobre o evento com base em sua preferência de notificação padrão. |
|
Organizador
|
organizer | string |
Detalhes do organizador do evento. |
|
É evento durante todo o dia
|
isallday | boolean |
Se o evento é um evento de dia inteiro |
|
Transparência
|
transparency | integer |
Se o evento deve ser adicionado à agenda de disponibilidade |
|
Modificado por
|
modifiedby | string |
Refere-se ao usuário que modificou o evento. |
|
Tag de evento
|
etag | string |
Refere-se à marca de evento para identificar o modo no qual o evento foi criado/modificado. |
|
ID exclusivo do calendário
|
caluid | string |
Identificador único do calendário |
|
Permitir encaminhamento
|
allowForwarding | boolean |
Se o evento pode ser encaminhado ou não. |
|
Lembretes
|
reminders | array of object | |
|
Tipo de lembrete
|
reminders.action | string |
Refere-se ao tipo de lembrete de evento (email, notificação, pop-up.) |
|
Lembre-me em
|
reminders.minutes | string |
Refere-se ao tempo de lembrete em minutos. |
SingleCalendarRes
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Cor
|
color | string |
Valor da cor do calendário em hexadecimal |
|
Timezone
|
timezone | string |
Fuso horário do calendário |
|
Cor do texto
|
textcolor | string |
Cor do texto do calendário em hexadecimal |
|
Description
|
description | string |
a descrição do calendário |
|
ID exclusivo do calendário
|
uid | string |
Identificador único do calendário |
|
É padrão
|
isdefault | boolean |
Se o calendário é um calendário padrão |
|
Incluir disponibilidade
|
include_infreebusy | boolean |
Estado de disponibilidade do calendário |
|
Nome
|
name | string |
Nome do calendário |
|
Situação
|
status | boolean |
Estado do calendário |
EventNotifyRes
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Cor
|
zc_data.color | string |
Valor da cor do evento em hexadecimal |
|
Title
|
zc_data.title | string |
Título do evento |
|
Criado a
|
zc_data.createdtime | string |
tempo de evento criado |
|
Fuso horário do usuário
|
zc_data.user_timezone | string |
Fuso horário do usuário |
|
Duração do evento
|
zc_data.duration | string |
Duração do evento |
|
ID exclusivo do evento
|
zc_data.uid | string |
Identificador exclusivo do evento |
|
É evento durante todo o dia
|
zc_data.isallday | boolean |
Se o evento é um evento de dia inteiro |
|
Localização
|
zc_data.location | string |
Local do evento |
|
etag
|
zc_data.etag | string |
Refere-se à marca de evento para identificar o modo no qual o evento foi criado/modificado. |
|
Id exclusivo do calendário
|
zc_data.caluid | string |
Identificador único do calendário |
|
timezone
|
zc_data.dateandtime.timezone | string |
Fuso horário do evento |
|
hora de início
|
zc_data.dateandtime.start | string |
Hora de início do formato do evento aaaaMMddTHHmmss |
|
hora de fim
|
zc_data.dateandtime.end | string |
Hora de término do formato de evento aaaaMMddTHHmmss |
|
Última modificação do evento em
|
zc_data.lastmodifiedtime | string |
A data e a hora em que o evento foi modificado pela última vez |