Sign up for Office 365
Learn more about Office 365
In my previous post, I introduced the Graph API – a new RESTful interface that allows developers to quickly build applications that can access directory data in Azure Active Directory - the core directory for Office 365 customers, and customers of other Microsoft Online Services. If you’re an Office 365, Dynamics CRM, Intune or Windows Azure customer, and don’t plan to develop your own applications - we're also making investments so that ISV's can easily build applications that integrate with your Microsoft Online Services, and offer them to customers. In a future post, I’ll review the infrastructure for developing/testing an application, then making it available to other tenants.
So what is the easiest way to get started with the Graph API? Most people want to see how easy it is to use, but don't want to start coding right away, or maybe you aren't a developer, but still want to understand what our API is all about. The easiest way is to use the Graph Explorer, and the demo company – simply open your browser and go to https://graphExplorer.cloudApp.net – this simple web interface can be used to hand-craft REST queries and see the returned directory data. If you select “Use Demo Company” in the upper right hand menu option, you will see a demo company using the domain “GraphDir1.onMicrosoft.com” auto-populate in the Resource Windows – after doing this just select “Get”. You will now see the top level directory objects, or entities, available to be queried – for example select the first one which has a URL that will retrieve a list of users “…/users” The results are individual users’ objects, and the properties for each such as their names, contact information, assigned licenses, proxy addresses, etc. The user properties include the object type and Id, then the properties are alphabetically ordered starting with “accountEnabled” and ending with “userPrincipalName” – using the GraphExplorer, let’s you try queries against this demo company, and under the covers, it manages authentication, specifying the api version, and required return format for the query. In a later blog, I’ll show you how to do these things using a great tool, Fiddler, then later, how to write code to do the same. But for now, using Graph Explorer is a very good way to get your head around how to construct a query, the formatting and results of the queries – I’ll also cover how to Write to the directory in a later blog post. What are some other example of queries that you try with the Graph Explorer?
Here’s are some examples (note: the entities are case sensitive – “…/Users” will not work, but “…/users” does):
Return data for one user:
See which groups this user is a member of:
See if this user has a manager or has direct reports:
Get company information: https://graph.windows.net/GraphDir1.OnMicrosoft.com/tenantDetails
Get a list of security Groups: https://graph.windows.net/GraphDir1.OnMicrosoft.com/groups
Get a list of members of a particular security group (note: the objectId of the group is specified)
In the next blog, I’ll show how to add some specific Odata parameters that can allow you to do filtering and paging, and how to hand-craft queries using the Fiddler tool. Here’s a quick example (get a list of users who have their “state” property equal to WA (Washington state)):
https://graph.windows.net/GraphDir1.OnMicrosoft.com/users?$filter=state eq 'WA'
Are you going to be at TechEd 2013? I'll be presenting about the Graph API - please drop by my session, or come by the booth (Windows Azure Active Directory) and say hello.
TechEd North America New Orleans 10:15 AM June 6th Graph API
MSDN Graph Documentation: http://msdn.microsoft.com/en-us/library/hh974482.aspx
Sample Apps: http://msdn.microsoft.com/en-us/library/hh974459.aspx
241 Microsoft Team blogs searched, 65 blogs have new articles. 284 new articles found searching from
I introduced the Graph Explorer ( http:// graphExplorer.cloudapp.net ) in my last post , as an easy to
Not sure if this is the correct place to ask this question but we have a recruitment product and want to know if it is possible to develop an API that can launch or open a word document that is stored in the recruitment database in office 365 ?