use Microsoft Graph SDK in code snippets

Author: DominikMe

articles/communication-services/concepts/includes/identifiers/identifiers-android.md

@@ -35,16 +35,18 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
+The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```java
-// get the Teams user's ID if only the email is known, assuming a helper method
-String userId = getUserIdFromGraph("[email protected]");
+// get the Teams user's ID from Graph APIs if only the email is known
+var user = await graphClient.users("[email protected]")
+    .buildRequest()
+    .get();
 
 // create an identifier
-var teamsUser = new MicrosoftTeamsUserIdentifier(userId);
+var teamsUser = new MicrosoftTeamsUserIdentifier(user.id);
 
 // if you're not operating in the public cloud, you must also set the right Cloud type.
 var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment(CommunicationCloudEnvironment.GCCH);

articles/communication-services/concepts/includes/identifiers/identifiers-ios.md

@@ -33,12 +33,12 @@ let user = CommunicationUserIdentifier(newUserId)
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
+The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```swift
-// get the Teams user's ID if only the email is known, assuming a helper method
+// get the Teams user's ID if only the email is known, assuming a helper method for the Graph API
 let userId = await getUserIdFromGraph("[email protected]")
 
 // create an identifier
@@ -121,13 +121,4 @@ let rawId = communicationIdentifier.rawId;
 let identifier = createCommunicationIdentifier(fromRawId: rawId);
 ```
 
-*ObjC*
-```swift
-// get an identifier's raw Id
-NSString *rawId = communicationIdentifier.rawId;
-
-// create an identifier from a given raw Id
-id<CommunicationIdentifier> identifier = [CommunicationIdentifierFactory createCommunicationIdentifier:rawId];
-```
-
 An invalid raw ID will just convert to an `UnknownIdentifier` in the SDK and any validation only happens service-side.

articles/communication-services/concepts/includes/identifiers/identifiers-java.md

@@ -35,16 +35,18 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
+The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```java
-// get the Teams user's ID if only the email is known, assuming a helper method
-String userId = getUserIdFromGraph("[email protected]");
+// get the Teams user's ID from Graph APIs if only the email is known
+var user = await graphClient.users("[email protected]")
+    .buildRequest()
+    .get();
 
 // create an identifier
-var teamsUser = new MicrosoftTeamsUserIdentifier(userId);
+var teamsUser = new MicrosoftTeamsUserIdentifier(user.id);
 
 // if you're not operating in the public cloud, you must also set the right Cloud type.
 var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment(CommunicationCloudEnvironment.GCCH);

articles/communication-services/concepts/includes/identifiers/identifiers-js.md

@@ -35,16 +35,16 @@ const sameUser = { communicationUserId: newUserId };
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` interface represents a Teams user. You need to know the Teams user's ID that you can retrieve via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint.
+The `MicrosoftTeamsUserIdentifier` interface represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```javascript
-// get the Teams user's ID if only the email is known, assuming a helper method
-const userId = await getUserIdFromGraph("[email protected]");
+// get the Teams user's ID from Graph APIs if only the email is known
+const user = await graphClient.api("/users/[email protected]").get();
 
 // create an identifier
-const teamsUser = { microsoftTeamsUserId: userId };
+const teamsUser = { microsoftTeamsUserId: user.id };
 
 // if you're not operating in the public cloud, you must also pass the right Cloud type.
 const gcchTeamsUser = { microsoftTeamsUserId: userId, cloud: "gcch" };

articles/communication-services/concepts/includes/identifiers/identifiers-net.md

@@ -35,16 +35,18 @@ var sameUser = new CommunicationUserIdentifier(newUserId);
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
+The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```csharp
-// get the Teams user's ID if only the email is known, assuming a helper method
-string userId = await GetUserIdFromGraph("[email protected]");
+// get the Teams user's ID from Graph APIs if only the email is known
+var user = await graphClient.Users["[email protected]"]
+    .Request()
+    .GetAsync();
 
 // create an identifier
-var teamsUser = new MicrosoftTeamsUserIdentifier(userId);
+var teamsUser = new MicrosoftTeamsUserIdentifier(user.Id);
 
 // if you're not operating in the public cloud, you must also pass the right Cloud type.
 var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId: userId, cloud: CommunicationCloudEnvironment.Gcch);

articles/communication-services/concepts/includes/identifiers/identifiers-python.md

@@ -35,13 +35,13 @@ same_user = CommunicationUserIdentifier(new_user_id)
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response. Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
+The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
 ```python
-# get the Teams user's ID if only the email is known, assuming a helper method
-user_id = get_userid_from_graph("[email protected]")
+# get the Teams user's ID from Graph APIs if only the email is known
+user_id = graph_client.get("/users/[email protected]").json().get("id");
 
 # create an identifier
 teams_user = MicrosoftTeamsUserIdentifier(user_id)

articles/communication-services/concepts/includes/identifiers/identifiers-rest.md

@@ -50,7 +50,7 @@ You can find an example for a request that includes an identifier in Chat's REST
 
 ### Microsoft Teams User identifier
 
-The `MicrosoftTeamsUserIdentifierModel` represents a Teams user. You need to know the Teams user's ID that you can retrieve via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint.
+The `MicrosoftTeamsUserIdentifierModel` represents a Teams user with its Azure AD user object ID. You can retrieve the Azure AD user object ID via the [Microsoft Graph REST API /users](/graph/api/user-get) endpoint from the `id` property in the response . For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview). Alternatively, you can find the ID as the `oid` claim in an [Azure AD ID token](/azure/active-directory/develop/id-tokens#payload-claims) or [Azure AD access token](/azure/active-directory/develop/access-tokens#payload-claims) after your user has signed in and acquired a token.
 
 #### Basic usage
 
@@ -113,7 +113,7 @@ The `PhoneNumberIdentifierModel` represents a phone number. The service assumes
 // response
 {
     "kind": "phoneNumber",
-    "rawId": "4:112345556789",
+    "rawId": "4:+112345556789",
     "phoneNumber": {
         "value": "+112345556789"
     }
@@ -269,7 +269,7 @@ The raw ID is the Teams visitor ID prefixed with `8:teamsvisitor:`. The Teams vi
 ```
 *Raw ID:*
 
-`4:1123455567`
+`4:+1123455567`
 
 The raw ID is the E.164 formatted phone number without the leading `+` and prefixed with `4:`.