Microsoft 365 Community SharePoint, 23 May 2023

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Multi-geo support for site discovery with Microsoft Graph

Description

In this 8-minute developer focused demo, Diksha Upadhyay shares a new Microsoft Graph API that will help you discover and fetch all sites across a geo for a particular tenant with a single Graph API call! Review existing Sites API then see live demo of the new multi-geo site discovery API. Similar experience to using Sites API, but with expanded scope. Supports OData query parameters. What do you think? Please let us know.

This PnP Community demo is taken from the weekly Microsoft 365 Platform Community call recorded on May 23, 2023.

Demo Presenter
• Diksha Upadhyay (Microsoft)

Supporting materials
• Documentation - sites: getAllSites | aka.ms/GraphGetAllSitesApi

Learn more
• Microsoft 365 Unified Sample gallery - https://aka.ms/community/samples
• Microsoft 365 Platform Community in YouTube - https://aka.ms/community/videos
• Microsoft 365 Platform Community - http://aka.ms/community/home

A

Foreign before we dive into and talk about this feature and giving a demo of it, which we are going to do a lot by the way I just want to take a moment to introduce myself and the team here, um I work as a product manager in one right, one SharePoint team with me I have to share working on the engineering side. Who will be helping me with the demo.

A

uh Our team basically works with the developers and isps to help them adopt and migrate to Ms growth by building new feature and optimizing the performance, and here with we are with the core of it that we are releasing a new API in Microsoft graph they'll help you uh discover all the sites across a jio uh for a particular tenant.

A

So with that, here's the agenda of what we will be discussing today, I will begin with giving a brief overview of sites API, as we have it now followed by what the feedback we have received from the developer Community. uh The next two section would be all about talking about this new feature which we have released and a live demo of it.

A

So without any further Ado I'll just quickly get started for discovering any document. Library list list, item, Drive item and even fetching metadata and permission. The first step is to know what all Sites you have in your tenants. As the current support goes, you can list all the sites in a particular default Geo or for tenant. You can also fetch the site collections uh using the current endpoint. We have uh that will only help you to get the host names for a multi Geo tenant. What it doesn't.

A

Support is being able to get the root sites for all those hosts name, as a fallback developers need to rely on Direct, SharePoint API call to fetch those root sites.

A

No, it's not something new that we got to know right. You have been telling us since various Forum that how confusing it is, how big of this Gap in the overall user experience and Can Microsoft do anything about it. That's why we heard that feedback, and here we are announcing our new API, which is get sites. Slash, get all sites to be able to discover and fetch root sites across the geographies in a tenant.

A

With just one single API call now it would be a lot of work right to you know adopt this in the API. This is a basic question that pops up. The answer is no. We made sure that the experience remains as similar to as the sites API. You are currently using so basically similar experience with an expanded scope of it and a single call experience the odata query: parameters Remains the Same. We still uh support the sites, a resource type with the properties and parameters remaining.

A

Exactly the same, uh you can try out this new API and, let us know your feedback by visiting AK dot, Ms, slash graph, get all sides. I know you are excited about the demo, so I won't take much of your time and I'll just hand it over to Tushar for demo.

B

Thank you rickshaw.

B

So, let's start with the live demo, so I already have one tenant and in this particular tenant I have enabled the multi-geo feature, as you can see that there are two tenants, Canada APAC and one email, this one it hasn't been provisioned, yet it failed due to some reasons. So that's why it's grayed out now.

B

Moving back first question is that you know how do I fetch all the Geo instances of my tenant. The answer is this particular API call it's already publicly available and once you fire it you'll see that it will list you down. All the Geo information, Canada Apec, What You Won't See is the email Geo which, like I, said it's not provisioned due to some reasons, and you shouldn't expect any failed provision. Geos in this particular API call The Next Step as it comes out.

B

What are the sites in this particular cheers right now, moving to the get sites API, if I find this particular call you'll see that what today it supports us all, these host names are same for all. The sites that are listed. The host name will be the same and that host name will be for your Canada Geo.

B

The problem is that how do I fetch the sites from the apexio and as you can see, there is no odata next link present as well. The solution is what we've worked on and it's the new feature get all Sites API. If you find this particular query, you'll see that it first lets you down all the sites from the apacheo. As you can see, the host name becomes different here right and it even provides you with the next link. What this next link will help you with this.

B

It will help you enumerate sites from your next year.

B

There it is, and, as you can see this respond, this response is exactly the same as you got using your get sites API and okay, one more thing to point out that there's no data next link. That means that you have traversed all the sites across all geographies in your tenant and that's it you're done with the enumeration two things to highlight. We have maintained the site resource exactly the same as it's used today. So therefore you don't need to make any changes to that.

B

Secondly, since this feature we are talking about uh mult using with the multi Geo tenant, but you don't need to worry. You can use this particular get all Sites API, even with your regular tenant, and it will work seamlessly as it does today, as the get site's API works today.

B

So since this is a publicly available API, let me also share public talks quickly. There you go so, as you can see, we have listed on the permissions that are needed to call this API with today's support. Only application, Level permissions- and this is the same permit set of permissions- that you call your get sites API.

B

Today with, and we have also included a sample request and response in addition to that, if you want to discover what are the best practices for discovering sites files and detecting changes at scale, we've also attached a reference link over here. That being said, that's the end of the demo and handing it over back to your picture. Thank you.

A

Thanks for that amazing presentation, Tushar I am pretty much as excited as everyone here uh and moving on to the end of the slide and I promised this. The last slide I have uh before that. I just want to list out what scenarios you can use it and how it differs and in terms of what you earlier had and now you are having. So let's say you are an app developer and you are creating a page where you need to have a site picker.

A

uh For any reason, maybe you just want to select sites, or maybe you want to select a site and assign some policies in the current scenario, using the apis, you have the site: picker will just give you uh sites in a default Geo.

A

uh That creates an illusion that oh, my tenant just has this much sight, but that is not the complete picture with many companies, Going Global and becoming multi-geo I think it becomes the need of the r for us to support the sites access across the Geo and drawing the parallel. With that scenario, with the new API, you get all the sites in a tenant no cafets there. So the call to action to all of you is go ahead. Try try the apis out and do let us know your feedback.

A

Microsoft loves feedback, we love feedback, there are Microsoft Tech, Community GitHub community and uh there is a feedback portal which we keep on hearing and updating. So please, let us know your feedback looking forward to that with that we come to the end of the demo and if there is any question we'll, let us know.

C

Awesome stuff uh super excitement again in the chat. People are excited asking questions so definitely take a look at that chat even see the the claps there by the avatars so exciting stuff. Thank you both for that excellent demo. We got. We got just stuff just dropping today, excellent, very exciting.

B