[Admin] Get latest changes (#934)

Author: ElizabethSamuel-MSFT

docs/docs-ref-autogen/outlook/outlook/office.appointmentcompose.yml

@@ -95,16 +95,16 @@ methods:
     isDeprecated: false
     syntax:
       content: >-
-        addAsync(categories: string[], options?: Office.AsyncContextOptions, callback?: (asyncResult:
+        addAsync(categories: string[], options: Office.AsyncContextOptions, callback?: (asyncResult:
         Office.AsyncResult<void>) => void): void;
       parameters:
         - id: categories
           description: The categories to be added to the item.
           type: 'string[]'
         - id: options
           description: >-
-            Optional. An object literal that contains one or more of the following properties. `asyncContext`<!-- -->:
-            Developers can provide any object they wish to access in the callback method.
+            An object literal that contains one or more of the following properties. `asyncContext`<!-- -->: Developers
+            can provide any object they wish to access in the callback method.
           type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
         - id: callback
           description: >-
@@ -114,6 +114,47 @@ methods:
       return:
         type: void
         description: ''
+  - name: 'addAsync(categories, callback)'
+    uid: 'outlook!Office.Categories#addAsync:member(2)'
+    package: outlook!
+    fullName: 'addAsync(categories, callback)'
+    summary: >-
+      Adds categories to an item. Each category must be in the categories master list on that mailbox and so must have a
+      unique name but multiple categories can use the same color.
+
+
+      \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/requirement-sets/outlook-api-requirement-sets) \]
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadWriteItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose or Read
+
+
+      **Errors**:
+
+
+      - `InvalidCategory`<!-- -->: Invalid categories were provided.
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'addAsync(categories: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;'
+      parameters:
+        - id: categories
+          description: The categories to be added to the item.
+          type: 'string[]'
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter of type `Office.AsyncResult`<!-- -->.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''
   - name: 'getAsync(options, callback)'
     uid: 'outlook!Office.Categories#getAsync:member(1)'
     package: outlook!
@@ -275,16 +316,16 @@ methods:
     isDeprecated: false
     syntax:
       content: >-
-        removeAsync(categories: string[], options?: Office.AsyncContextOptions, callback?: (asyncResult:
+        removeAsync(categories: string[], options: Office.AsyncContextOptions, callback?: (asyncResult:
         Office.AsyncResult<void>) => void): void;
       parameters:
         - id: categories
           description: The categories to be removed from the item.
           type: 'string[]'
         - id: options
           description: >-
-            Optional. An object literal that contains one or more of the following properties. `asyncContext`<!-- -->:
-            Developers can provide any object they wish to access in the callback method.
+            An object literal that contains one or more of the following properties. `asyncContext`<!-- -->: Developers
+            can provide any object they wish to access in the callback method.
           type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
         - id: callback
           description: >-
@@ -295,3 +336,37 @@ methods:
       return:
         type: void
         description: ''
+  - name: 'removeAsync(categories, callback)'
+    uid: 'outlook!Office.Categories#removeAsync:member(2)'
+    package: outlook!
+    fullName: 'removeAsync(categories, callback)'
+    summary: |-
+      Removes categories from an item.
+
+      \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/requirement-sets/outlook-api-requirement-sets) \]
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadWriteItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose or Read
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'removeAsync(categories: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;'
+      parameters:
+        - id: categories
+          description: The categories to be removed from the item.
+          type: 'string[]'
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter of type `Office.AsyncResult`<!-- -->. If removing categories fails, the `asyncResult.error`
+            property will contain an error code.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''

docs/docs-ref-autogen/outlook/outlook/office.appointmentread.yml

@@ -231,19 +231,55 @@ methods:
     isPreview: false
     isDeprecated: false
     syntax:
-      content: 'saveAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void, asyncContext?: any): void;'
+      content: 'saveAsync(callback: (asyncResult: Office.AsyncResult<void>) => void, asyncContext?: any): void;'
       parameters:
         - id: callback
           description: >-
-            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
-            parameter of type `Office.AsyncResult`<!-- -->.
+            When the method completes, the function passed in the `callback` parameter is called with a single parameter
+            of type `Office.AsyncResult`<!-- -->.
           type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
         - id: asyncContext
           description: Optional. Any state data that is passed to the callback method.
           type: any
       return:
         type: void
         description: ''
+  - name: saveAsync(asyncContext)
+    uid: 'outlook!Office.CustomProperties#saveAsync:member(2)'
+    package: outlook!
+    fullName: saveAsync(asyncContext)
+    summary: >-
+      Saves item-specific custom properties to the server.
+
+
+      You must call the `saveAsync` method to persist any changes made with the `set` method or the `remove` method of
+      the `CustomProperties` object. The saving action is asynchronous.
+
+
+      It's a good practice to have your callback function check for and handle errors from `saveAsync`<!-- -->. In
+      particular, a read add-in can be activated while the user is in a connected state in a read form, and subsequently
+      the user becomes disconnected. If the add-in calls `saveAsync` while in the disconnected state, `saveAsync` would
+      return an error. Your callback method should handle this error accordingly.
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose or Read
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'saveAsync(asyncContext?: any): void;'
+      parameters:
+        - id: asyncContext
+          description: Optional. Any state data that is passed to the callback method.
+          type: any
+      return:
+        type: void
+        description: ''
   - name: 'set(name, value)'
     uid: 'outlook!Office.CustomProperties#set:member(1)'
     package: outlook!

docs/docs-ref-autogen/outlook/outlook/office.body.yml

@@ -77,16 +77,16 @@ methods:
     isDeprecated: false
     syntax:
       content: >-
-        addAsync(locationIdentifiers: LocationIdentifier[], options?: Office.AsyncContextOptions, callback?:
+        addAsync(locationIdentifiers: LocationIdentifier[], options: Office.AsyncContextOptions, callback?:
         (asyncResult: Office.AsyncResult<void>) => void): void;
       parameters:
         - id: locationIdentifiers
           description: The locations to be added to the current list of locations.
           type: '<xref uid="outlook!Office.LocationIdentifier:interface" />[]'
         - id: options
           description: >-
-            Optional. An object literal that contains one or more of the following properties. `asyncContext`<!-- -->:
-            Developers can provide any object they wish to access in the callback method.
+            An object literal that contains one or more of the following properties. `asyncContext`<!-- -->: Developers
+            can provide any object they wish to access in the callback method.
           type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
         - id: callback
           description: >-
@@ -97,6 +97,48 @@ methods:
       return:
         type: void
         description: ''
+  - name: 'addAsync(locationIdentifiers, callback)'
+    uid: 'outlook!Office.EnhancedLocation#addAsync:member(2)'
+    package: outlook!
+    fullName: 'addAsync(locationIdentifiers, callback)'
+    summary: |-
+      Adds to the set of locations associated with the appointment.
+
+      \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/requirement-sets/outlook-api-requirement-sets) \]
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadWriteItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose
+
+
+      **Errors**:
+
+
+      - `InvalidFormatError`<!-- -->: The format of the specified data object is not valid.
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: >-
+        addAsync(locationIdentifiers: LocationIdentifier[], callback?: (asyncResult: Office.AsyncResult<void>) =>
+        void): void;
+      parameters:
+        - id: locationIdentifiers
+          description: The locations to be added to the current list of locations.
+          type: '<xref uid="outlook!Office.LocationIdentifier:interface" />[]'
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. Check the `status` property of
+            `asyncResult` to determine if the call succeeded.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''
   - name: 'getAsync(options, callback)'
     uid: 'outlook!Office.EnhancedLocation#getAsync:member(1)'
     package: outlook!
@@ -147,13 +189,13 @@ methods:
     isDeprecated: false
     syntax:
       content: >-
-        getAsync(options?: Office.AsyncContextOptions, callback?: (asyncResult:
+        getAsync(options: Office.AsyncContextOptions, callback?: (asyncResult:
         Office.AsyncResult<LocationDetails[]>) => void): void;
       parameters:
         - id: options
           description: >-
-            Optional. An object literal that contains one or more of the following properties. `asyncContext`<!-- -->:
-            Developers can provide any object they wish to access in the callback method.
+            An object literal that contains one or more of the following properties. `asyncContext`<!-- -->: Developers
+            can provide any object they wish to access in the callback method.
           type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
         - id: callback
           description: >-
@@ -165,6 +207,38 @@ methods:
       return:
         type: void
         description: ''
+  - name: getAsync(callback)
+    uid: 'outlook!Office.EnhancedLocation#getAsync:member(2)'
+    package: outlook!
+    fullName: getAsync(callback)
+    summary: |-
+      Gets the set of locations associated with the appointment.
+
+      \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/requirement-sets/outlook-api-requirement-sets) \]
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose or Read
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'getAsync(callback?: (asyncResult: Office.AsyncResult<LocationDetails[]>) => void): void;'
+      parameters:
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object.
+          type: >-
+            (asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;<xref
+            uid="outlook!Office.LocationDetails:interface" />[]&gt;) =&gt; void
+      return:
+        type: void
+        description: ''
   - name: 'removeAsync(locationIdentifiers, options, callback)'
     uid: 'outlook!Office.EnhancedLocation#removeAsync:member(1)'
     package: outlook!
@@ -221,16 +295,16 @@ methods:
     isDeprecated: false
     syntax:
       content: >-
-        removeAsync(locationIdentifiers: LocationIdentifier[], options?: Office.AsyncContextOptions, callback?:
+        removeAsync(locationIdentifiers: LocationIdentifier[], options: Office.AsyncContextOptions, callback?:
         (asyncResult: Office.AsyncResult<void>) => void): void;
       parameters:
         - id: locationIdentifiers
           description: The locations to be removed from the current list of locations.
           type: '<xref uid="outlook!Office.LocationIdentifier:interface" />[]'
         - id: options
           description: >-
-            Optional. An object literal that contains one or more of the following properties. `asyncContext`<!-- -->:
-            Developers can provide any object they wish to access in the callback method.
+            An object literal that contains one or more of the following properties. `asyncContext`<!-- -->: Developers
+            can provide any object they wish to access in the callback method.
           type: '<xref uid="office!Office.AsyncContextOptions:interface" />'
         - id: callback
           description: >-
@@ -241,3 +315,44 @@ methods:
       return:
         type: void
         description: ''
+  - name: 'removeAsync(locationIdentifiers, callback)'
+    uid: 'outlook!Office.EnhancedLocation#removeAsync:member(2)'
+    package: outlook!
+    fullName: 'removeAsync(locationIdentifiers, callback)'
+    summary: >-
+      Removes the set of locations associated with the appointment.
+
+
+      If there are multiple locations with the same name, all matching locations will be removed even if only one was
+      specified in `locationIdentifiers`<!-- -->.
+
+
+      \[ [API set: Mailbox 1.8](/office/dev/add-ins/reference/requirement-sets/outlook-api-requirement-sets) \]
+    remarks: >-
+      **[Minimum permission
+      level](https://docs.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!-- -->**:
+      `ReadWriteItem`
+
+
+      **[Applicable Outlook
+      mode](https://docs.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!-- -->**:
+      Compose
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: >-
+        removeAsync(locationIdentifiers: LocationIdentifier[], callback?: (asyncResult: Office.AsyncResult<void>) =>
+        void): void;
+      parameters:
+        - id: locationIdentifiers
+          description: The locations to be removed from the current list of locations.
+          type: '<xref uid="outlook!Office.LocationIdentifier:interface" />[]'
+        - id: callback
+          description: >-
+            Optional. When the method completes, the function passed in the `callback` parameter is called with a single
+            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. Check the `status` property of
+            `asyncResult` to determine if the call succeeded.
+          type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;void&gt;) =&gt; void'
+      return:
+        type: void
+        description: ''