Merge branch 'main' into live

Author: github-actions

.github/workflows/auto-publish.yml

@@ -2,8 +2,8 @@ name: auto-publish
 run-name: Automatically publish documentation
 on:
   schedule:
-    - cron: '00 22 * * TUE'
-    - cron: '00 22 * * THU'
+    # Run at 2:00 AM UTC on Wednesday and Friday
+    - cron: '0 2 * * WED,FRI'
 jobs:
   auto-publish:
     runs-on: ubuntu-latest

docs/code-snippets/outlook-snippets.yaml

@@ -289,13 +289,18 @@ methods:
       This method must be called at the end of a function which was invoked by the following:
 
 
-      - A function command button (that is, an add-in command defined with an **<!-- -->&lt;<!-- -->Action<!--
-      -->&gt;<!-- -->** element, where the `xsi:type` attribute is set to `ExecuteFunction`<!-- -->).
+      - A [function command](https://learn.microsoft.com/office/dev/add-ins/design/add-in-commands) button.
 
 
-      - An [event](https://learn.microsoft.com/javascript/api/manifest/event) defined in the [Events extension
-      point](https://learn.microsoft.com/javascript/api/manifest/extensionpoint#events) of an on-send add-in in Outlook.
-      For example, an `ItemSend` event.
+      - An [on-send add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins) in Outlook.
+
+
+      - An [online-meeting provider add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting) in
+      Outlook.
+
+
+      - A [note-logging add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments) in
+      Outlook on mobile devices.
     remarks: >-
       The following outlines support information for Outlook.
 
@@ -313,9 +318,11 @@ methods:
       -->**: Compose or Read
 
 
-      **Important**: The `options` parameter only applies to Outlook add-ins that implement the [on-send
-      feature](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!-- -->. It was introduced
-      in Mailbox 1.8.
+      **Important**: The `options` parameter only applies to Outlook add-ins. It was introduced in Mailbox 1.8.
+      Although Outlook on Android and on iOS support up to Mailbox 1.5, the `options` parameter is supported in
+      online-meeting provider and note-logging mobile add-ins. For more information on API support in Outlook on mobile
+      devices, see [Outlook JavaScript APIs supported in Outlook on mobile
+      devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
 
 
       #### Examples
@@ -363,8 +370,8 @@ methods:
       parameters:
         - id: options
           description: >-
-            Optional. An object that specifies the behavior of an on-send add-in in Outlook when it completes processing
-            an `ItemSend` event.
+            Optional. In Outlook, an object that specifies the behavior of an on-send add-in, online-meeting provider
+            add-in, or note-logging mobile add-in when it completes processing an event.
           type: '<xref uid="office!Office.AddinCommands.EventCompletedOptions:interface" />'
       return:
         type: void

docs/docs-ref-autogen/office/office/office.addincommands.event.yml

@@ -4,8 +4,11 @@ uid: 'office!Office.AddinCommands.EventCompletedOptions:interface'
 package: office!
 fullName: Office.AddinCommands.EventCompletedOptions
 summary: >-
-  Specifies the behavior of an [on-send](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)
-  add-in in Outlook when it completes processing an `ItemSend` event.
+  Specifies the behavior of an [on-send
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!-- -->, [online-meeting
+  provider add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting)<!-- -->, or [note-logging
+  mobile add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments) when it completes
+  processing an event in Outlook.
 remarks: >-
   \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/javascript-api-for-office) \]
 
@@ -18,6 +21,12 @@ remarks: >-
   **[Applicable Outlook
   mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
   Compose
+
+
+  **Important**: Although Outlook on Android and on iOS support up to Mailbox 1.5, the `EventCompletedOptions`
+  object is supported in online-meeting provider and note-logging mobile add-ins. For more information on API support in
+  Outlook on mobile devices, see [Outlook JavaScript APIs supported in Outlook on mobile
+  devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/office/office/office.addincommands.eventcompletedoptions.yml

@@ -284,13 +284,18 @@ methods:
       This method must be called at the end of a function which was invoked by the following:
 
 
-      - A function command button (that is, an add-in command defined with an **<!-- -->&lt;<!-- -->Action<!--
-      -->&gt;<!-- -->** element, where the `xsi:type` attribute is set to `ExecuteFunction`<!-- -->).
+      - A [function command](https://learn.microsoft.com/office/dev/add-ins/design/add-in-commands) button.
 
 
-      - An [event](https://learn.microsoft.com/javascript/api/manifest/event) defined in the [Events extension
-      point](https://learn.microsoft.com/javascript/api/manifest/extensionpoint#events) of an on-send add-in in Outlook.
-      For example, an `ItemSend` event.
+      - An [on-send add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins) in Outlook.
+
+
+      - An [online-meeting provider add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting) in
+      Outlook.
+
+
+      - A [note-logging add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments) in
+      Outlook on mobile devices.
     remarks: >-
       The following outlines support information for Outlook.
 
@@ -308,9 +313,11 @@ methods:
       -->**: Compose or Read
 
 
-      **Important**: The `options` parameter only applies to Outlook add-ins that implement the [on-send
-      feature](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!-- -->. It was introduced
-      in Mailbox 1.8.
+      **Important**: The `options` parameter only applies to Outlook add-ins. It was introduced in Mailbox 1.8.
+      Although Outlook on Android and on iOS support up to Mailbox 1.5, the `options` parameter is supported in
+      online-meeting provider and note-logging mobile add-ins. For more information on API support in Outlook on mobile
+      devices, see [Outlook JavaScript APIs supported in Outlook on mobile
+      devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
 
 
       #### Examples
@@ -358,8 +365,8 @@ methods:
       parameters:
         - id: options
           description: >-
-            Optional. An object that specifies the behavior of an on-send add-in in Outlook when it completes processing
-            an `ItemSend` event.
+            Optional. In Outlook, an object that specifies the behavior of an on-send add-in, online-meeting provider
+            add-in, or note-logging mobile add-in when it completes processing an event.
           type: '<xref uid="office!Office.AddinCommands.EventCompletedOptions:interface" />'
       return:
         type: void

docs/docs-ref-autogen/office_release/office/office.addincommands.event.yml

@@ -4,8 +4,11 @@ uid: 'office!Office.AddinCommands.EventCompletedOptions:interface'
 package: office!
 fullName: Office.AddinCommands.EventCompletedOptions
 summary: >-
-  Specifies the behavior of an [on-send](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)
-  add-in in Outlook when it completes processing an `ItemSend` event.
+  Specifies the behavior of an [on-send
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-on-send-addins)<!-- -->, [online-meeting
+  provider add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/online-meeting)<!-- -->, or [note-logging
+  mobile add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-log-appointments) when it completes
+  processing an event in Outlook.
 remarks: >-
   \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/javascript-api-for-office) \]
 
@@ -18,6 +21,12 @@ remarks: >-
   **[Applicable Outlook
   mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
   Compose
+
+
+  **Important**: Although Outlook on Android and on iOS support up to Mailbox 1.5, the `EventCompletedOptions`
+  object is supported in online-meeting provider and note-logging mobile add-ins. For more information on API support in
+  Outlook on mobile devices, see [Outlook JavaScript APIs supported in Outlook on mobile
+  devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/office_release/office/office.addincommands.eventcompletedoptions.yml

@@ -209,30 +209,6 @@ properties:
       #### Examples
 
 
-      ```TypeScript
-
-      // The following example sets the end time of an appointment in compose mode by
-
-      // using the `setAsync` method of the `Time` object.
-
-      const endTime = new Date("3/14/2015");
-
-      const options = {
-          // Pass information that can be used in the callback.
-          asyncContext: {verb: "Set"}
-      };
-
-      Office.context.mailbox.item.end.setAsync(endTime, options, function(result) {
-          if (result.error) {
-              console.debug(result.error);
-          } else {
-              // Access the asyncContext that was passed to the setAsync method.
-              console.debug("End Time " + result.asyncContext.verb);
-          }
-      });
-
-      ```
-
       ```TypeScript
 
       // Link to full sample:
@@ -502,20 +478,6 @@ properties:
       #### Examples
 
 
-      ```TypeScript
-
-      const userContext = { value : 1 };
-
-      Office.context.mailbox.item.location.getAsync( { context: userContext}, callback);
-
-
-      function callback(asyncResult) {
-          const context = asyncResult.context;
-          const location = asyncResult.value;
-      }
-
-      ```
-
       ```TypeScript
 
       // Link to full sample:
@@ -700,21 +662,6 @@ properties:
       #### Examples
 
 
-      ```TypeScript
-
-      Office.context.mailbox.item.optionalAttendees.setAsync( ['[email protected]', '[email protected]'] );
-
-      Office.context.mailbox.item.optionalAttendees.addAsync( ['[email protected]'] );
-
-      Office.context.mailbox.item.optionalAttendees.getAsync(callback);
-
-
-      function callback(asyncResult) {
-          const arrayOfOptionalAttendeesRecipients = asyncResult.value;
-      }
-
-      ```
-
       ```TypeScript
 
       // Link to full sample:
@@ -949,22 +896,6 @@ properties:
       #### Examples
 
 
-      ```TypeScript
-
-      Office.context.mailbox.item.requiredAttendees.setAsync( ['[email protected]', '[email protected]'] );
-
-      Office.context.mailbox.item.requiredAttendees.addAsync( ['[email protected]'] );
-
-      Office.context.mailbox.item.requiredAttendees.getAsync(callback);
-
-
-      function callback(asyncResult) {
-          const arrayOfRequiredAttendeesRecipients = asyncResult.value;
-          console.log(JSON.stringify(arrayOfRequiredAttendeesRecipients));
-      }
-
-      ```
-
       ```TypeScript
 
       // Link to full sample:
@@ -3824,6 +3755,27 @@ methods:
 
       - Any code included after the `sendAsync` call isn't guaranteed to run since the add-in completes processing after
       the `sendAsync` call.
+
+
+      #### Examples
+
+
+      ```TypeScript
+
+      // Link to full sample:
+      https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/send-async.yaml
+
+
+      // This snippet sends the current message or appointment being composed.
+
+      Office.context.mailbox.item.sendAsync((asyncResult) => {
+        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
+          console.log("Action failed with error: " + asyncResult.error.message);
+          return;
+        }
+      });
+
+      ```
     isPreview: false
     isDeprecated: false
     syntax: