Office365
The Office365 connector lets you connect to a Office365 instance and perform the supported operations.
Before you begin
Before using the Office365 connector, do the following tasks:
- In your Google Cloud project:
- Ensure that network connectivity is set up. For information about network patterns, see Network connectivity.
- Enable the following services:
secretmanager.googleapis.com
(Secret Manager API)connectors.googleapis.com
(Connectors API)
To understand how to enable services, see Enabling services.
If these services or permissions have not been enabled for your project previously, you are prompted to enable them when configuring the connector.
Configure the connector
Configuring the connector requires you to create a connection to your data source (backend system). A connection is specific to a data source. It means that if you have many data sources, you must create a separate connection for each data source. To create a connection, do the following steps:
- In the Cloud console, go to the Integration Connectors > Connections page and then select or create a Google Cloud project.
- Click + Create new to open the Create Connection page.
- In the Location section, choose the location for the connection.
- Region: Select a location from the drop-down list.
Supported regions for connectors include:
For the list of all the supported regions, see Locations.
- Click Next.
- Region: Select a location from the drop-down list.
- In the Connection Details section, complete the following:
- Connector: Select Office365 from the drop down list of available Connectors.
- Connector version: Select the Connector version from the drop down list of available versions.
- In the Connection Name field, enter a name for the Connection instance.
Connection names must meet the following criteria:
- Connection names can use letters, numbers, or hyphens.
- Letters must be lower-case.
- Connection names must begin with a letter and end with a letter or number.
- Connection names cannot exceed 49 characters.
- Optionally, enter a Description for the connection instance.
- Optionally, enable Cloud logging,
and then select a log level. By default, the log level is set to
Error
. - Service Account: Select a service account that has the required roles.
- Optionally, configure the Connection node settings:
- Minimum number of nodes: Enter the minimum number of connection nodes.
- Maximum number of nodes: Enter the maximum number of connection nodes.
A node is a unit (or replica) of a connection that processes transactions. More nodes are required to process more transactions for a connection and conversely, fewer nodes are required to process fewer transactions. To understand how the nodes affect your connector pricing, see Pricing for connection nodes. If you don't enter any values, by default the minimum nodes are set to 2 (for better availability) and the maximum nodes are set to 50.
- Azure Tenant: The Microsoft Online tenant being used to access data. If not specified, your default tentant will be used.
- Optionally, click + Add label to add a label to the Connection in the form of a key/value pair.
- Click Next.
-
In the Authentication section, enter the authentication details.
- Select an Authentication type and enter the relevant details.
The following authentication types are supported by the Office365 connection:
- OAuth 2.0 Auth Code Grant
- Click Next.
To understand how to configure these authentication types, see Configure authentication.
- Select an Authentication type and enter the relevant details.
- Review: Review your connection and authentication details.
- Click Create.
Configure authentication
Enter the details based on the authentication you want to use.
-
OAuth 2.0 Auth Code Grant
- Access token: The access token used for authenticating requests with auth-code-flow-based connections.
- Client ID: The client ID used for requesting access tokens.
- Client secret: The client secret used for requesting access tokens.
Entities, operations, and actions
All the Integration Connectors provide a layer of abstraction for the objects of the connected application. You can access an application's objects only through this abstraction. The abstraction is exposed to you as entities, operations, and actions.
- Entity: An entity can be thought of as an object, or a collection of properties, in the
connected application or service. The definition of an entity differs from a connector to a
connector. For example, in a database connector, tables are the entities, in a
file server connector, folders are the entities, and in a messaging system connector,
queues are the entities.
However, it is possible that a connector doesn't support or have any entities, in which case the
Entities
list will be empty. - Operation: An operation is the activity that you can perform on an entity. You can perform
any of the following operations on an entity:
Selecting an entity from the available list, generates a list of operations available for the entity. For a detailed description of the operations, see the Connectors task's entity operations. However, if a connector doesn't support any of the entity operations, such unsupported operations aren't listed in the
Operations
list. - Action: An action is a first class function that is made available to the integration
through the connector interface. An action lets you make changes to an entity or entities, and
vary from connector to connector. Normally, an action will have some input parameters, and an output
parameter. However, it is possible
that a connector doesn't support any action, in which case the
Actions
list will be empty.
System limitations
The Office365 connector can process 1 transaction per second, per node, and throttles any transactions beyond this limit. By default, Integration Connectors allocates 2 nodes (for better availability) for a connection.
For information on the limits applicable to Integration Connectors, see Limits.
Actions
This section lists the actions supported by the connector. To understand how to configure the actions, see Action examples.
CancelEvent action
This action lets you cancel an event.
Input parameters of the CancelEvent action
Parameter name | Data type | Required | Description |
---|---|---|---|
EventId | String | Yes | ID of the event. |
UserId | String | No | ID of the user. |
UserPrincipalName | String | No | The username for which the license needs to be assigned. |
Comment | String | No | A comment to include. |
For example on how to configure the CancelEvent
action,
see Action examples.
MoveMail action
This action lets you move an email.
Input parameters of the MoveMail action
Parameter name | Data type | Required | Description |
---|---|---|---|
MessageId | String | Yes | The Email Id. |
DestinationId | String | Yes | ID of the destination folder where the email will be moved to. |
For example on how to configure the MoveMail
action,
see Action examples.
AssignLicense action
This action lets you assign a license.
Input parameters of the AssignLicense action
Parameter name | Data type | Required | Description |
---|---|---|---|
UserId | String | No | The ID of the user for which license need to be assigned. |
UserPrincipalName | String | No | The username for which the license needs to be assigned. |
AddLicenseSkuId | String | No | The unique identifier for the SKU. |
DisabledPlans | String | No | A collection of the comma separated unique identifiers for plans that have been disabled. |
RemoveLicenses | String | No | A collection of comma separated IDs that identify the licenses to remove. |
For example on how to configure the AssignLicense
action,
see Action examples.
ForwardEvent action
This action lets you forward an event.
Input parameters of the ForwardEvent action
Parameter name | Data type | Required | Description |
---|---|---|---|
EventId | String | Yes | The ID of the event. |
UserId | String | No | ID of the user. |
UserPrincipalName | String | No | The username for which license needs to be assigned. |
Comment | String | No | A comment to include. |
ToRecipients | String | Yes | A semicolon separated list of recipient emails. |
For example on how to configure the ForwardEvent
action,
see Action examples.
UploadFile action
This action lets you upload a file.
Input parameters of the UploadFile action
Parameter name | Data type | Required | Description | |
---|---|---|---|---|
FileName | String | No | Name of the file you need to upload content to. | |
LocalFile | String | No | Local file containing the content to be uploaded. | |
ContentStream | String | No | The content as input stream to be uploaded when localpath or folderpath isn't specified. | |
ParentId | String | Yes | ID of the folder where the current item is. | |
Content | String | No | File content to be uploaded. |
For example on how to configure the UploadFile
action,
see Action examples.
DownloadFile action
This action lets you download a file.
Input parameters of the DownloadFile action
Parameter name | Data type | Required | Description |
---|---|---|---|
FileId | String | Yes | The ID of the file which you want to download. |
DownloadTo | String | No | Where to store the file. |
Encoding | String | No | The FileData input encoding type. The allowed values are NONE, BASE64, and the default value is BASE64. |
FileStream | String | No | An instance of an output stream where file data is written to. Only used if DownloadTo isn't specified. |
For example on how to configure the DownloadFile
action,
see Action examples.
CreateFolder action
This action lets you create a folder.
Input parameters of the CreateFolder action
Parameter name | Data type | Required | Description |
---|---|---|---|
ParentId | String | No | The ID of the folder where the current item is. |
FolderName | String | Yes | Name of the folder to be created. |
For example on how to configure the
CreateFolder
action, see Action examples.
SendMail action
This action lets you send an email.
Input parameters of the SendMail action
Parameter name | Data type | Required | Description |
---|---|---|---|
ToRecipients | String | No | The recipients for whom the email should be sent. |
Content | String | No | Email Content. |
Subject | String | No | The Email subject. |
Id | String | No | The ID of the message to be sent (this is optional). The user can either use an existing email ID or send a new email by optionally filling the other fields. |
Attachments | String | No | The file attachments. Specify file attachments in the following format:
|
FileName | String | No | The Recipients Specify recipients in the following order. |
LocalFile | String | No | The file containing the content of the attachment. |
ContentBytes | String | No | Content of the attachment encoded to BASE64. |
CCRecipients | String | No | A semicolon separated values of the recipients in CC. |
SenderEmail | String | No | The email address on who's behalf email needs to be sent. Set this if you want to send email on behalf of another user's account. |
FromEmail | String | No | The email address of the User from which email needs to be sent. Set this if you want to send email from other user's account. |
ContentType | String | No | The content type of the email body.The allowed values are text, html. The default value is text. |
For example on how to configure the
SendMail
action, see Action examples.
ForwardMail action
This action lets you forward an email.
Input parameters of the ForwardMail action
Parameter name | Data type | Required | Description |
---|---|---|---|
MessageId | String | Yes | ID of the email. |
ToRecipients | String | Yes | A semicolon separated list of recipients emails. |
Comment | String | No | Content in addition to the original message. |
For example on how to configure the
ForwardMail
action, see Action examples.
DownloadEmail action
This action lets you download an email.
Input parameters of the DownloadEmail action
Parameter name | Data type | Required | Description |
---|---|---|---|
MessageId | String | Yes | Id of the message which you want to download. |
Encoding | String | No | The file data input encoding type. |
DownloadTo | String | No | Where to store the file. | FileStream | String | No | An instance of an output stream where file data should be written to. This value is
used only if DownloadTo isn't provided. |
For example on how to configure the
DownloadMail
action, see Action examples.
DownloadAttachments action
This action lets you download the attachments of an email.
Input parameters of the DownloadAttachments action
Parameter name | Data type | Required | Description |
---|---|---|---|
MessageId | String | Yes | Id of the email from which you want to get the attachments. |
Encoding | String | No | The FileData input encoding type. The allowed values are NONE, BASE64. |
DownloadTo | String | No | Where to store the attachments. If not specified, it returns the content bytes of the attachment. This value is required if MessageId is specified. |
AttachmentId | String | No | Id of the attachment you want to download. Returns all the attachments of the email if not specified. |
UserId | String | No | Id of the User. This will work only if the authenticated user has Admin permissions. |
FileStream | String | No | An instance of an output stream where file data is written to. Only used if DownloadTo isn't provided. |
For example on how to configure the
DownloadAttachments
action, see Action examples.
Action examples
This section describes how to perform some of the actions in this connector.
Example - Cancel an event
This example cancels an event with the specified ID.
- In the
Configure connector task
dialog, clickActions
. - Select the
CancelEvent
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=", "Comment": "Canceled due to rain" }
If the action is successful, the
CancelEvent
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Assign and remove a license
This example assigns and removes licenses for the specified user.
- In the
Configure connector task
dialog, clickActions
. - Select the
AssignLicense
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b", "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac", "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac" }
If the action is successful, the AssignLicense
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Forward an event
This example forwards an event.
- In the
Configure connector task
dialog, clickActions
. - Select the
ForwardEvent
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=", "Comment": "forwarded due to rain", "ToRecipients": "test99@example.com" }
If the action is successful, the
ForwardEvent
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Upload a file
This example uploads a file.
- In the
Configure connector task
dialog, clickActions
. - Select the
UploadFile
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "FileName": "Document1234.docx", "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ", "Content": "test" }
If the action is successful, the
UploadFile
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "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" }]
Example - Download a file
This example downloads a file.
- In the
Configure connector task
dialog, clickActions
. - Select the
DownloadFile
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP" }
If the action is successful, the
DownloadFile
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success", "FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J" }]
Example - Create a folder
This example creates a folder.
- In the
Configure connector task
dialog, clickActions
. - Select the
CreateFolder
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ", "FolderName": "outbox1234" }
If the action is successful, the
CreateFolder
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Send an email
This example sends an email to the specified recipients.
- In the
Configure connector task
dialog, clickActions
. - Select the
SendMail
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "ToRecipients": "test097@example.com", "Content": "Testing", "Subject": "Test subject", "FileName": "Google" }
If the action is successful, the
SendMail
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Forward an email
This example forwards an email.
- In the
Configure connector task
dialog, clickActions
. - Select the
ForwardMail
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=", "ToRecipients": "test097@example.com", "Comment": "forwarded message" }
If the action is successful, the
ForwardMail
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success" }]
Example - Download an email
This example downloads an email.
- In the
Configure connector task
dialog, clickActions
. - Select the
DownloadEmail
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA=" }
If the action is successful, the
DownloadEmail
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "Status": "Success", "FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0....... }]
Example - Download attachments
This example downloads attachments.
- In the
Configure connector task
dialog, clickActions
. - Select the
DownloadAttachments
action, and then click Done. - In the Task Input section of the Connectors task, click
connectorInputPayload
and then enter a value similar to the following in theDefault Value
field:{ {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=", "DownloadTo": "My files/Office355/reports/"} }
If the action is successful, the
DownloadAttachments
task's connectorOutputPayload
response
parameter will have a value similar to the following:
[{ "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 the Office365 connection in an integration
After you create the connection, it becomes available in both Apigee Integration and Application Integration. You can use the connection in an integration through the Connectors task.
- To understand how to create and use the Connectors task in Apigee Integration, see Connectors task.
- To understand how to create and use the Connectors task in Application Integration, see Connectors task.
Get help from the Google Cloud community
You can post your questions and discuss this connector in the Google Cloud community at Cloud Forums.What's next
- Understand how to suspend and resume a connection.
- Understand how to monitor connector usage.
- Understand how to view connector logs.