Office365

O conetor do Office365 permite-lhe estabelecer ligação a uma instância do Office365 e realizar as operações suportadas.

Antes de começar

Antes de usar o conector do Office365, faça as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

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, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      As regiões suportadas para conetores incluem:

      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. Conector: selecione Office365 na lista pendente de conectores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista pendente de versões disponíveis.
    3. No campo Nome da associação, introduza um nome para a instância da associação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.

    4. Opcionalmente, 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. 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.

    8. Inquilino do Azure: o inquilino online da Microsoft que está a ser usado para aceder aos dados. Se não for especificado, é usado o seu inquilino predefinido.
    9. Opcionalmente, clique em + Adicionar etiqueta 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 do Office 365:

      • Concessão de código de autorização do OAuth 2.0
    2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

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

Configure a autenticação

Para gerar credenciais de cliente e autorizar a associação, tem de concluir os seguintes passos:
  1. Registe a sua app e obtenha o ID de cliente e o segredo do cliente.
  2. Especifique as credenciais em Google Cloud.
  3. Autorize a associação em Google Cloud.
  4. Adicione o URL de redirecionamento à sua app.

Registe a sua app e obtenha o clientId e o segredo do cliente

  1. Inicie sessão no portal do Azure.
  2. Em Serviços Azure, selecione Registos de apps e, de seguida, Novo registo.
  3. Introduza um nome da aplicação.
  4. Especifique quem pode usar a aplicação ou aceder à API.
  5. Defina o URL de redirecionamento como http://localhost:33333 ou especifique uma porta diferente e defina CallbackURL como o URL de resposta que definiu.
  6. Clique em Registar.
  7. Guarde o ID (de cliente) da aplicação e o ID (do inquilino) do diretório para utilização posterior.
  8. Navegue para a secção Certificados e segredos e defina o tipo de autenticação da aplicação.
    • Para a autenticação de certificados, selecione Carregar certificado e, em seguida, carregue o certificado a partir do seu computador local.
    • Para a autenticação de segredo do cliente, selecione Novo segredo do cliente e especifique a respetiva duração. Depois de guardar o segredo do cliente, copie o valor da chave, que vai usar como segredo do cliente.
  9. Em Autorizações da API, selecione API Microsoft Graph e, de seguida, selecione as autorizações da aplicação e as autorizações delegadas necessárias.

  10. Clique em Guardar.

Conceda acesso de proprietário à aplicação

Se a chave de acesso expirar com frequência, pode conceder acesso de proprietário à aplicação. Isto permite-lhe atualizar a chave de acesso sem ter de autorizar novamente a associação.

  1. Inicie sessão no portal do Azure.
  2. No Azure Active Directory, selecione Registos de apps.
  3. Clique no nome da aplicação.
  4. Navegue para a secção Proprietários.
  5. Clique em Adicionar proprietários e selecione o proprietário a adicionar.

Especifique as credenciais em Google Cloud

Quando cria a ligação nos Integration Connectors , tem de especificar os seguintes detalhes:

Na secção Autenticação, introduza os seguintes detalhes:

  • ID de cliente: introduza o ID de cliente usado para pedir tokens de acesso.
  • Âmbitos: introduza uma lista de âmbitos desejados separada por vírgulas.
  • Segredo do cliente: introduza o segredo que contém o segredo do cliente para a app associada que criou.
  • Versão do Secret: versão do Secret para o Secret selecionado.
  • URL de autorização: o URL de autorização que gera quando cria um cliente OAuth. Introduza o URL no seguinte formato: https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. Por exemplo, https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent.

Autorize a associação em Google Cloud

  1. Na página Ligações, encontre a ligação criada recentemente.

    O Estado do novo conector é Autorização necessária.

  2. Clique em Autorização obrigatória.

    É apresentado o painel Editar autorização.

  3. Copie o valor do URI de redirecionamento para a sua aplicação externa. Para mais informações, consulte o artigo Adicione o URL de redirecionamento à sua app.
  4. Valide os detalhes da autorização.
  5. Clique em Autorizar.

    Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Adicione o URL de redirecionamento à sua app

  1. No portal do Azure, clique em Serviços do Azure > Registos de apps.
  2. Clique no nome da app.
  3. Clique em Adicionar URI de redirecionamento.
  4. Clique em Adicionar uma plataforma.
  5. Na caixa de diálogo Web, cole o URI de redirecionamento que copiou quando autorizou a ligação em Google Cloud.

Exemplo de associação

A tabela seguinte indica os valores de configuração de exemplo para a ligação do Office365:

Nome do campo Detalhes
Região us-central1
Conetor Office 365
Versão do conetor 1
Nome da ligação office365-google-cloud-con
Conta de serviço SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
AzureTenant AZURE_TENANTID
Número mínimo de nós 2
Número máximo de nós 2
ID do cliente CLIENT_ID
Âmbitos offline_access
https://graph.microsoft.com/Group.Read.All
https://graph.microsoft.com/Group.ReadWrite.All
https://graph.microsoft.com/user.read
https://graph.microsoft.com/user.readwrite.all
https://graph.microsoft.com/calendars.readwrite
https://graph.microsoft.com/contacts.readwrite
https://graph.microsoft.com/mail.readwrite
https://graph.microsoft.com/Files.ReadWrite.All
Segredo do cliente CLIENT_SECRET
Versão do secret 1
URL de autorização https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

  • Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

    No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.

  • Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

  • Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Limitações do sistema

O conector do Office365 pode processar 1 transação por segundo, por , 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.

Ações

Esta secção apresenta as ações suportadas pelo conetor. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação CancelEvent

Esta ação permite-lhe cancelar um evento.

Parâmetros de entrada da ação CancelEvent

Nome do parâmetro Tipo de dados Obrigatória Descrição
EventId String Sim ID do evento.
Id do utilizador String Não ID do utilizador.
UserPrincipalName String Não O nome de utilizador ao qual a licença tem de ser atribuída.
Comentário String Não Um comentário a incluir.

Por exemplo, para saber como configurar a ação CancelEvent, consulte os exemplos de ações.

Ação MoveMail

Esta ação permite-lhe mover um email.

Introduza os parâmetros da ação MoveMail

Nome do parâmetro Tipo de dados Obrigatória Descrição
MessageId String Sim O ID do email.
DestinationId String Sim ID da pasta de destino para a qual o email vai ser movido.

Por exemplo, para saber como configurar a ação MoveMail, consulte os exemplos de ações.

Ação AssignLicense

Esta ação permite-lhe atribuir uma licença.

Parâmetros de entrada da ação AssignLicense

Nome do parâmetro Tipo de dados Obrigatória Descrição
Id do utilizador String Não O ID do utilizador ao qual é preciso atribuir a licença.
UserPrincipalName String Não O nome de utilizador ao qual a licença tem de ser atribuída.
AddLicenseSkuId String Não O identificador exclusivo do SKU.
DisabledPlans String Não Uma coleção dos identificadores exclusivos separados por vírgulas dos planos que foram desativados.
RemoveLicenses String Não Uma coleção de IDs separados por vírgulas que identificam as licenças a remover.

Por exemplo, para saber como configurar a ação AssignLicense, consulte os exemplos de ações.

Ação ForwardEvent

Esta ação permite-lhe encaminhar um evento.

Parâmetros de entrada da ação ForwardEvent

Nome do parâmetro Tipo de dados Obrigatória Descrição
EventId String Sim O ID do evento.
Id do utilizador String Não ID do utilizador.
UserPrincipalName String Não O nome de utilizador ao qual é preciso atribuir a licença.
Comentário String Não Um comentário a incluir.
ToRecipients String Sim Uma lista de emails de destinatários separados por pontos e vírgulas.

Por exemplo, para saber como configurar a ação ForwardEvent, consulte os exemplos de ações.

Ação UploadFile

Esta ação permite-lhe carregar um ficheiro.

Parâmetros de entrada da ação UploadFile

Nome do parâmetro Tipo de dados Obrigatória Descrição
FileName String Não Nome do ficheiro para o qual tem de carregar conteúdo.
LocalFile String Não Ficheiro local com o conteúdo a carregar.
ContentStream String Não O conteúdo como stream de entrada a ser carregado quando localpath ou folderpath não é especificado.
ParentId String Sim ID da pasta onde o item atual se encontra.
Conteúdo String Não Conteúdo do ficheiro a carregar.

Por exemplo, para saber como configurar a ação UploadFile, consulte os exemplos de ações.

Ação DownloadFile

Esta ação permite-lhe transferir um ficheiro.

Introduza os parâmetros da ação DownloadFile

Nome do parâmetro Tipo de dados Obrigatória Descrição
FileId String Sim O ID do ficheiro que quer transferir.
DownloadTo String Não Onde guardar o ficheiro.
Codificação String Não O tipo de codificação de entrada FileData. Os valores permitidos são NONE, BASE64 e o valor predefinido é BASE64.
FileStream String Não Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Usado apenas se DownloadTo não estiver especificado.

Por exemplo, para saber como configurar a ação DownloadFile, consulte os exemplos de ações.

Ação CreateFolder

Esta ação permite-lhe criar uma pasta.

Parâmetros de entrada da ação CreateFolder

Nome do parâmetro Tipo de dados Obrigatória Descrição
ParentId String Não O ID da pasta onde o item atual se encontra.
FolderName String Sim Nome da pasta a criar.

Por exemplo, para saber como configurar a ação CreateFolder, consulte os exemplos de ações.

Ação SendMail

Esta ação permite-lhe enviar um email.

Introduza os parâmetros da ação SendMail

Nome do parâmetro Tipo de dados Obrigatória Descrição
ToRecipients String Não Os destinatários para os quais o email deve ser enviado.
Conteúdo String Não Conteúdo do email.
Assunto String Não O assunto do email.
ID String Não O ID da mensagem a enviar (opcional). O utilizador pode usar um ID de email existente ou enviar um novo email preenchendo opcionalmente os outros campos.
Anexos String Não Os anexos de ficheiros. Especifique anexos de ficheiros no seguinte formato:

filename1,filecontent1;filename2,filecontent2. O conteúdo de cada ficheiro pode ser dados BASE64 ou o caminho de um ficheiro local com o caráter @ antes.

FileName String Não Os destinatários especificam os destinatários pela seguinte ordem.
LocalFile String Não O ficheiro que contém o conteúdo do anexo.
ContentBytes String Não Conteúdo do anexo codificado em BASE64.
CCRecipients String Não Valores separados por ponto e vírgula dos destinatários em CC.
SenderEmail String Não O endereço de email em nome de quem o email tem de ser enviado. Defina esta opção se quiser enviar emails em nome da conta de outro utilizador.
FromEmail String Não O endereço de email do utilizador a partir do qual o email tem de ser enviado. Defina esta opção se quiser enviar emails a partir da conta de outro utilizador.
ContentType String Não O tipo de conteúdo do corpo do email.Os valores permitidos são text e html. O valor predefinido é text.

Por exemplo, para saber como configurar a ação SendMail, consulte os exemplos de ações.

Ação ForwardMail

Esta ação permite-lhe encaminhar um email.

Introduza os parâmetros da ação ForwardMail

Nome do parâmetro Tipo de dados Obrigatória Descrição
MessageId String Sim ID do email.
ToRecipients String Sim Uma lista de emails de destinatários separados por pontos e vírgulas.
Comentário String Não Conteúdo além da mensagem original.

Por exemplo, para saber como configurar a ação ForwardMail, consulte os exemplos de ações.

Ação DownloadEmail

Esta ação permite-lhe transferir um email.

Introduza os parâmetros da ação DownloadEmail

Nome do parâmetro Tipo de dados Obrigatória Descrição
MessageId String Sim ID da mensagem que quer transferir.
Codificação String Não O tipo de codificação de entrada de dados do ficheiro.
DownloadTo String Não Onde guardar o ficheiro.
FileStream String Não Uma instância de uma stream de saída na qual os dados de ficheiros devem ser escritos. Este valor é usado apenas se DownloadTo não for indicado.

Por exemplo, para saber como configurar a ação DownloadMail, consulte os exemplos de ações.

Ação DownloadAttachments

Esta ação permite-lhe transferir os anexos de um email.

Parâmetros de entrada da ação DownloadAttachments

Nome do parâmetro Tipo de dados Obrigatória Descrição
MessageId String Sim ID do email do qual quer obter os anexos.
Codificação String Não O tipo de codificação de entrada FileData. Os valores permitidos são NONE e BASE64.
DownloadTo String Não Onde armazenar os anexos. Se não for especificado, devolve os bytes de conteúdo do anexo. Este valor é obrigatório se MessageId for especificado.
AttachmentId String Não ID do anexo que quer transferir. Devolve todos os anexos do email, se não forem especificados.
Id do utilizador String Não ID do utilizador. Isto só funciona se o utilizador autenticado tiver autorizações de administrador.
FileStream String Não Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Usado apenas se DownloadTo não for fornecido.

Por exemplo, para saber como configurar a ação DownloadAttachments, consulte os exemplos de ações.

Exemplos de ações

Esta secção descreve como realizar algumas das ações neste conector.

Exemplo: cancele um evento

Este exemplo cancela um evento com o ID especificado.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CancelEvent e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
    "Comment": "Canceled due to rain"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CancelEventconnectorOutputPayload

    [{
    "Status": "Success"
    }]

Exemplo: atribua e remova uma licença

Este exemplo atribui e remove licenças para o utilizador especificado.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AssignLicense e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
    "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
    "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta AssignLicenseconnectorOutputPayload da tarefa terá um valor semelhante ao seguinte:

    [{
    "Status": "Success"
    }]

Exemplo: encaminhe um evento

Este exemplo encaminha um evento.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ForwardEvent e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
    "Comment": "forwarded due to rain",   
    "ToRecipients": "test99@example.com"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ForwardEventconnectorOutputPayload

    [{
    "Status": "Success"
    }]

Exemplo: carregar um ficheiro

Este exemplo carrega um ficheiro.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UploadFile e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "FileName": "Document1234.docx",   
    "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
    "Content": "test"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UploadFileconnectorOutputPayload

     [{
    "Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
    "@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
    "@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
    "Status": "Success"
    }] 

Exemplo: transferir um ficheiro

Este exemplo transfere um ficheiro.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadFile e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:DownloadFileconnectorOutputPayload

    [{
    "Status": "Success",
    "FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
    }]

Exemplo: crie uma pasta

Este exemplo cria uma pasta.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateFolder e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
    "FolderName": "outbox1234"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CreateFolderconnectorOutputPayload

    [{
    "Status": "Success"
    }]

Exemplo: enviar um email

Este exemplo envia um email para os destinatários especificados.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação SendMail e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "ToRecipients": "test097@example.com",   
    "Content": "Testing",   
    "Subject": "Test subject",   
    "FileName": "Google"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:SendMailconnectorOutputPayload

    [{
    "Status": "Success"
    }]

Exemplo: encaminhe um email

Este exemplo encaminha um email.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ForwardMail e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
    "ToRecipients": "test097@example.com",   
    "Comment": "forwarded message"
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ForwardMailconnectorOutputPayload

    [{
    "Status": "Success"
    }]

Exemplo: transfira um email

Este exemplo transfere um email.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadEmail e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:DownloadEmailconnectorOutputPayload

    [{
    "Status": "Success",   
    "FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
    }]

Exemplo: transferir anexos

Este exemplo transfere anexos.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadAttachments e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
    {
    {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
    "DownloadTo": "My files/Office355/reports/"}
    }
  4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:DownloadAttachmentsconnectorOutputPayload

    [{
    "Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
    "Name": "demoattachment.docx",
    "ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
    "LastmodifiedDatetime": "2023-11-21T10:09:09Z",
    "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    "FileData": null,
    "json:repeatelementorder#": null,
    "size": "23575",
    "isinline": "false
    }]

Use a ligação do Office 365 numa integração

Depois de criar a ligaçã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 Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

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?