Merge pull request #22453 from microsoftgraph/main

Merge to publish.
microsoftgraph · Aug 12, 2023 · b4a8d06 · b4a8d06
2 parents 8f92d57 + 3858aed
commit b4a8d06
Show file tree

Hide file tree

Showing 191 changed files with 4,288 additions and 1,315 deletions.
diff --git a/.acrolinx-config.edn b/.acrolinx-config.edn
@@ -0,0 +1,57 @@
+{
+ ; https://support.acrolinx.com/hc/en-us/articles/10342999034130-Define-What-Acrolinx-for-Git-Hosting-Checks
+ :allowed-branchname-matches ["main" "live"]
+ :allowed-filename-matches ["concepts/" "(?i)(?!(^.*/i|^i)ntune[^/]*$)^(api-reference)/.*$"] ;; Can be overridden in repo-specific edn file. This is an allow list that identifies which folders contain the files Acrolinx will check. Separate multiple folders as follows ["folder/" "folder2"]
+
+ :use-gh-statuses true
+
+ :targets
+   {
+     :counts {
+              ;;:correctness 13
+              ;;:total 15 ;; absolute flag count but i don't know the difference between this and issues
+              ;;:issues 15 ;; coming from the platform, will need to be tested.
+              ;;:correctness 13 ;; combined spelling and grammar
+             }
+     :scores {
+              ;;:terminology 100
+              ;;:qualityscore 20 ;; Confirmed with Hugo that you just comment out the single score and leave the structure in place
+              ;;:correctness 40
+             }
+   }
+
+ :guidance-profile "d2b6c2c8-00ee-47f1-8d10-b280cc3434c1" ;; Profile ID for "M365-specific"
+
+ :template-header
+
+ "
+
+## Acrolinx Scorecards
+
+**The minimum Acrolinx topic score of 20 is required for all Microsoft Graph content merged to the default branch.**
+
+If you need a scoring exception for content in this PR, add the *ready for content review* and the *acrolinx exception* labels to the PR. The content review team will review the exception request and may take one or more of the following actions:
+
+- Work with you to resolve the issues requiring the exception.
+- Escalate the exception request to the Acrolinx Review Team for review.
+- Approve the exception and work with the GitHub Admin Team to merge the PR to the default branch.
+
+For more information about the exception criteria and exception process, see [Acrolinx for Microsoft Graph docs](https://aka.ms/msgo?pagePath=/Document%20APIs/Author%20content/Acrolinx).
+
+Select the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
+
+| Article | Score | Issues | Correctness<br>score | Scorecard | Processed |
+| ------- | ----- | ------ | ------ | --------- | --------- |
+"
+
+ :template-change
+ "| ${s/file} | ${acrolinx/qualityscore} | ${acrolinx/flags/issues} | ${acrolinx/scores/correctness} | [link](${acrolinx/scorecard}) | ${s/status} |
+"
+
+ :template-footer
+ "
+**More info about Acrolinx**
+
+Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see [Use the Visual Studio Code extension to run Acrolinx locally](https://review.docs.microsoft.com/office-authoring-guide/acrolinx-vscode?branch=main).
+"
+}
diff --git a/.github/policies/resourceManagement.yml b/.github/policies/resourceManagement.yml
@@ -204,6 +204,9 @@ configuration:
       - not:
           activitySenderHasAssociation:
             association: MEMBER
+      - not:
+          isActivitySender:
+            user: graph-github-task-automation[bot]
       - isAction:
           action: Opened
       then:

diff --git a/api-reference/beta/api/application-list-federatedidentitycredentials.md b/api-reference/beta/api/application-list-federatedidentitycredentials.md
@@ -1,7 +1,7 @@
 ---
 title: "List federatedIdentityCredentials"
 description: "Get a list of the federatedIdentityCredential objects and their properties."
-author: "shahzad-khalid"
+author: "nickludwig"
 ms.localizationpriority: medium
 ms.prod: "applications"
 doc_type: apiPageType

diff --git a/api-reference/beta/api/application-post-federatedidentitycredentials.md b/api-reference/beta/api/application-post-federatedidentitycredentials.md
@@ -1,7 +1,7 @@
 ---
 title: "Create federatedIdentityCredential"
 description: "Create a new federatedIdentityCredential object for an application."
-author: "shahzad-khalid"
+author: "nickludwig"
 ms.localizationpriority: medium
 ms.prod: "applications"
 doc_type: apiPageType

diff --git a/api-reference/beta/api/application-setverifiedpublisher.md b/api-reference/beta/api/application-setverifiedpublisher.md
@@ -2,7 +2,7 @@
 title: "application: setVerifiedPublisher"
 description: "Set the verified publisher of an application."
 ms.localizationpriority: medium
-author: "jesakowi"
+author: "xurobertMSFT"
 ms.prod: "applications"
 doc_type: "apiPageType"
 ---
@@ -43,7 +43,7 @@ POST /applications(appId='{appId}')/setVerifiedPublisher
 
 In the request body, provide the following required properties.
 
-| Property	   | Type	|Description|
+| Property       | Type    |Description|
 |:---------------|:--------|:----------|
 | verifiedPublisherId | string | The Microsoft Partner Network ID (MPNID) of the verified publisher to be set on the application, from the publisher's Partner Center account. |
 

diff --git a/api-reference/beta/api/application-unsetverifiedpublisher.md b/api-reference/beta/api/application-unsetverifiedpublisher.md
@@ -2,7 +2,7 @@
 title: "application: unsetVerifiedPublisher"
 description: "Unset the verified publisher of an application."
 ms.localizationpriority: medium
-author: "jesakowi"
+author: "xurobertMSFT"
 ms.prod: "applications"
 doc_type: "apiPageType"
 ---

diff --git a/api-reference/beta/api/authenticationcontextclassreference-delete.md b/api-reference/beta/api/authenticationcontextclassreference-delete.md
@@ -1,7 +1,7 @@
 ---
 title: "Delete authenticationContextClassReference"
 description: "Delete an authenticationContextClassReference object."
-author: "bakerCaleb"
+author: "swetha-rai"
 ms.localizationpriority: medium
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType

diff --git a/api-reference/beta/api/authenticationcontextclassreference-get.md b/api-reference/beta/api/authenticationcontextclassreference-get.md
@@ -2,7 +2,7 @@
 title: "Get authenticationContextClassReference"
 description: "Retrieve the properties and relationships of a authenticationContextClassReference object."
 ms.localizationpriority: medium
-author: "bakerCaleb"
+author: "swetha-rai"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/authenticationcontextclassreference-update.md b/api-reference/beta/api/authenticationcontextclassreference-update.md
@@ -2,7 +2,7 @@
 title: "Update authenticationContextClassReference"
 description: "Update the properties of a authenticationContextClassReference object."
 ms.localizationpriority: medium
-author: "bakerCaleb"
+author: "swetha-rai"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/channel-post.md b/api-reference/beta/api/channel-post.md
@@ -204,6 +204,8 @@ Content-type: application/json
 
 ---
 
+> **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+
 #### Response
 
 The following is an example of the response.
@@ -464,6 +466,8 @@ Content-type: application/json
 
 ---
 
+>  **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+
 #### Response
 
 The following is an example of the response.
@@ -556,6 +560,8 @@ Content-type: application/json
 
 ---
 
+>  **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+
 #### Response
 
 The following is an example of the response.

diff --git a/api-reference/beta/api/chat-list.md b/api-reference/beta/api/chat-list.md
@@ -838,3 +838,49 @@ Content-type: application/json
   ]
 }
 -->
+
+### Example 6: List all chats where the app is installed
+
+#### Request
+
+The following is an example of the request.
+
+
+```http
+GET https://graph.microsoft.com/beta/users/e652dd92-dd63-4fcc-b5b2-2005681e8e9f/chats?$filter=installedApps/any(a:a/teamsApp/id eq '608d8644-acb1-4ab0-bca5-66fbb6ed62aa')
+```
+
+---
+
+#### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats",
+    "@odata.count": 1,
+    "value": [
+        {
+            "id": "19:e652dd92-dd63-4fcc-b5b2-2005681e8e9f_734601fc-bbcd-4a30-9092-3c89f8d788cb@unq.gbl.spaces",
+            "topic": null,
+            "createdDateTime": "2023-03-03T11:32:33.631Z",
+            "lastUpdatedDateTime": "2023-06-08T06:02:19.072Z",
+            "chatType": "oneOnOne",
+            "webUrl": "https://teams.microsoft.com/l/chat/19%3Ae652dd92-dd63-4fcc-b5b2-2005681e8e9f_734601fc-bbcd-4a30-9092-3c89f8d788cb%40unq.gbl.spaces/0?tenantId=aa923623-ae61-49ee-b401-81f414b6ad5a",
+            "tenantId": "aa923623-ae61-49ee-b401-81f414b6ad5a",
+            "onlineMeetingInfo": null,
+            "viewpoint": {
+                "isHidden": false,
+                "lastMessageReadDateTime": "2023-06-29T10:22:15.024Z"
+            }
+        }
+    ]
+
+}
+```
diff --git a/api-reference/beta/api/conditionalaccesspolicy-delete.md b/api-reference/beta/api/conditionalaccesspolicy-delete.md
@@ -2,7 +2,7 @@
 title: "Delete conditionalAccessPolicy"
 description: "Delete a conditionalAccessPolicy."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccesspolicy-get.md b/api-reference/beta/api/conditionalaccesspolicy-get.md
@@ -2,7 +2,7 @@
 title: "Get conditionalAccessPolicy"
 description: "Retrieve the properties and relationships of a conditionalAccessPolicy object."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccesspolicy-update.md b/api-reference/beta/api/conditionalaccesspolicy-update.md
@@ -2,7 +2,7 @@
 title: "Update conditionalAccessPolicy"
 description: "Update the properties of a conditionalAccessPolicy object."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/...nce/beta/api/conditionalaccessroot-list-authenticationcontextclassreferences.md b/...nce/beta/api/conditionalaccessroot-list-authenticationcontextclassreferences.md
@@ -2,7 +2,7 @@
 title: "List authenticationContextClassReferences"
 description: "Retrieve a list of authenticationContextClassReference objects."
 ms.localizationpriority: medium
-author: "bakerCaleb"
+author: "swetha-rai"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccessroot-list-namedlocations.md b/api-reference/beta/api/conditionalaccessroot-list-namedlocations.md
@@ -2,7 +2,7 @@
 title: "List namedLocations"
 description: "Get a list of namedLocation objects."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccessroot-list-policies.md b/api-reference/beta/api/conditionalaccessroot-list-policies.md
@@ -2,7 +2,7 @@
 title: "List policies"
 description: "Retrieve a list of conditionalAccessPolicy objects."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/...nce/beta/api/conditionalaccessroot-post-authenticationcontextclassreferences.md b/...nce/beta/api/conditionalaccessroot-post-authenticationcontextclassreferences.md
@@ -2,7 +2,7 @@
 title: "Create authenticationContextClassReference"
 description: "Create a new authenticationContextClassReference."
 ms.localizationpriority: medium
-author: "bakerCaleb"
+author: "swetha-rai"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccessroot-post-namedlocations.md b/api-reference/beta/api/conditionalaccessroot-post-namedlocations.md
@@ -2,7 +2,7 @@
 title: "Create namedLocation"
 description: "Create a new namedLocation."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/conditionalaccessroot-post-policies.md b/api-reference/beta/api/conditionalaccessroot-post-policies.md
@@ -2,7 +2,7 @@
 title: "Create conditionalAccessPolicy"
 description: "Create a new conditionalAccessPolicy."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/countrynamedlocation-delete.md b/api-reference/beta/api/countrynamedlocation-delete.md
@@ -2,7 +2,7 @@
 title: "Delete countryNamedLocation"
 description: "Delete a countryNamedLocation object."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/countrynamedlocation-get.md b/api-reference/beta/api/countrynamedlocation-get.md
@@ -2,7 +2,7 @@
 title: "Get countryNamedLocation"
 description: "Retrieve the properties and relationships of a countryNamedlocation object."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/countrynamedlocation-update.md b/api-reference/beta/api/countrynamedlocation-update.md
@@ -2,7 +2,7 @@
 title: "Update countryNamedlocation"
 description: "Update the properties of a countryNamedLocation object."
 ms.localizationpriority: medium
-author: "davidspooner"
+author: "lisaychuang"
 ms.prod: "identity-and-sign-in"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/directory-list-recommendation.md b/api-reference/beta/api/directory-list-recommendation.md
@@ -1,7 +1,7 @@
 ---
 title: "List recommendations"
 description: "Get a list of the recommendation objects and their properties."
-author: "hafowler"
+author: "ddeeps2610"
 ms.localizationpriority: medium
 ms.prod: "directory-management"
 doc_type: apiPageType

diff --git a/api-reference/beta/api/directoryaudit-get.md b/api-reference/beta/api/directoryaudit-get.md
@@ -2,7 +2,7 @@
 title: "Get directoryAudit"
 description: "Describes the get method of the directoryAudit resource (entity) from the Microsoft Graph API (beta version)."
 ms.localizationpriority: medium
-author: "SarahBar"
+author: "egreenberg14"
 ms.prod: "identity-and-access-reports"
 doc_type: apiPageType
 ---

diff --git a/api-reference/beta/api/directoryaudit-list.md b/api-reference/beta/api/directoryaudit-list.md
@@ -2,7 +2,7 @@
 title: "List directoryAudits"
 description: "Get the list of audit logs generated by Azure Active Directory (Azure AD)."
 ms.localizationpriority: medium
-author: "SarahBar"
+author: "egreenberg14"
 ms.prod: "identity-and-access-reports"
 doc_type: apiPageType
 ---