-
Notifications
You must be signed in to change notification settings - Fork 1
Function index
ronan edited this page Aug 11, 2021
·
3 revisions
The below operations have been implemented as individual functions in the Linx sample.
If there are specific Microsoft Graph API operations that you would like to see in the sample, contact [email protected].
The index below is organized according to the Microsoft Graph REST API v1.0 reference documentation. This structure matches that of the Linx Solution, for more information about the specific organizing of functions and the general Solution Explorer structure, take a look at the wiki page.
The index table below contains the name of the request/function in readable format with a link to the Microsoft Graph REST API reference page for each request. A description as well as the permission scopes required to perform each request is also included. For a full list of permission scopes, see the Microsoft Graph permissions reference.
| Operation | Description | Permissions (Work account) | Permissions (Personal account) |
|---|---|---|---|
| Application | |||
| List applications | Get the list of applications in this organization. | Application.Read.All | Application.Read.All , User.Read |
The SharePoint API in Microsoft Graph supports the following core scenarios:
Access to SharePoint sites, lists, and drives (document libraries) Read-only support for site resources (no ability to create new sites) Read-write support for lists, listItems, and driveItems Address resources by SharePoint ID, URL, or relative path.
The SharePoint API exposes three major resource types:
- Site (top-level object)
- List
- ListItem
| Operation | Description | Permissions (Work account) | Permissions (Personal account) |
|---|---|---|---|
| Sites | |||
| Get a root site | To access the root SharePoint site within a tenant. | Sites.ReadWrite.All | Not supported |
| Get a site | To access a site for a a SiteId. | Sites.ReadWrite.All | Not supported |
| Get a group team site | To access the team site for a group. | Sites.ReadWrite.All | Not supported |
| List subsites | Get a collection of subsites defined for a site. | Sites.ReadWrite.All | Not supported |
| List followed sites | List the sites that have been followed by the signed in user. | Sites.ReadWrite.All | Not supported |
| Lists | |||
| Get list by Id | Returns the metadata for a list. | Sites.ReadWrite.All | Not supported |
| Get list by Title | Returns the metadata for a list. | Sites.ReadWrite.All | Not supported |
| Get lists | Returns the metadata for a list. | Sites.ReadWrite.All | Not supported |
| Create list | Create a new list in a site. | Sites.Manage.All | Not supported |
| List Items | |||
| Get list items | Get the collection of items in a list. | Sites.ReadWrite.All | Not supported |
| Get list item | Returns the metadata for an item in a list. | Sites.ReadWrite.All | Not supported |
You can use Microsoft Graph to build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files.
You can access users through Microsoft Graph in two ways:
- By their ID, /users/{id | userPrincipalName}
- By using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}
| Operation | Description | Permissions (Work account) | Permissions (Personal account) |
|---|---|---|---|
| Calendar | |||
| Create calendar | Creates a new calendar for a user. | Calendars.ReadWrite | Calendars.ReadWrite |
| Create calendar group | Creates a new calendar group. | Calendars.ReadWrite | Calendars.ReadWrite |
| Create event | Create an event in the user's default calendar or specified calendar. | Calendars.ReadWrite | Calendars.ReadWrite |
| Find meeting times | Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints specified as parameters. | Calendars.ReadWrite.Shared | Not supported |
| Get free/busy schedule | Get the free/busy availability information for a collection of users, distributions lists, or resources (rooms or equipment) for a specified time period. | Calendars.ReadWrite | Not supported |
| List calendars | Get all the user's calendars. | Calendars.ReadWrite | Calendars.ReadWrite |
| List calendar groups | Get the user's calendar groups. | Calendars.ReadWrite | Calendars.ReadWrite |
| List calendar view | Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user's. | Calendars.ReadWrite | Calendars.ReadWrite |
| List events | Get a list of event objects in the user's mailbox. | Calendars.ReadWrite | Calendars.ReadWrite |
| Reminder view | Return a list of event reminders in a user calendar within the specified start and end times. | #Scope# | Calendars.ReadWrite |
| Contacts | |||
| Create contact | Add a contact to the root Contacts folder. | Contacts.ReadWrite | Contacts.ReadWrite |
| List contacts | Get a contact collection from the default contacts folder of the signed-in user | Contacts.ReadWrite | Contacts.ReadWrite |
| Drive | |||
| Get drive for user | Retrieve the properties and relationships of a Drive resource for the user. | Files.Read | Files.Read |
| Groups | |||
| List joined teams | Get the teams in Microsoft Teams that the user is a direct member of. | Team.ReadBasic.All | Not supported |
| List member of | Get groups, directory roles, and administrative units that the user is a direct member of. | User.Read | Not supported |
| Insights | |||
| List shared | Calculated insight that includes the list of documents shared with a user. | Sites.Read.All | Not supported |
| List trending | Calculated insight that includes a list of documents trending around the user. | Sites.Read.All | Not supported |
| Create mail folder | Create a new mail folder in the root folder of the user's mailbox. | Mail.ReadWrite | Mail.ReadWrite |
| Create message | Create a draft of a new message in either JSON or MIME format. | Mail.ReadWrite | Mail.ReadWrite |
| Create message rule | Create a message filter rule by specifying a set of conditions and actions. | MailboxSettings.ReadWrite | MailboxSettings.ReadWrite |
| Get mail tips | Get the mail tips of one or more recipients as available to the signed-in user. | Mail.Read | Mail.Read |
| List mail folders | Get the mail folder collection directly under the root folder of the signed-in user. | Mail.ReadWrite | Mail.ReadWrite |
| List messages | Get the messages in the signed-in user's mailbox. | Mail.ReadWrite | Mail.ReadWrite |
| List message rules | Get all the messageRule objects defined for the user's Inbox. | MailboxSettings.Read | MailboxSettings.Read |
| Send mail | Send an email from the signed-in user's account. | Mail.Send | Mail.Send |
| Notes | |||
| Create notebook | Create a new OneNote notebook. | Notes.ReadWrite | Notes.ReadWrite |
| List notebooks | Retrieve a list of notebook objects. | Notes.ReadWrite | Notes.ReadWrite |
| Outlook settings | |||
| Get mailbox settings | Get the user's Outlook mailbox settings. | MailboxSettings.Read | MailboxSettings.Read |
| Update mailbox settings | Enable, configure, or disable one or more of the user's mailbox setting. | MailboxSettings.ReadWrite | MailboxSettings.ReadWrite |
| Create outlook category | Create an outlookCategory object in the user's master list of categories. | MailboxSettings.ReadWrite | MailboxSettings.ReadWrite |
| List outlook categories | Get all the categories that have been defined for the user. | MailboxSettings.Read | MailboxSettings.Read |
| Get language choices | Get the list of locales and languages that are supported for the user. | User.Read | User.Read |
| Get time zone choices | Get the list of time zones that are supported for the user. | User.Read | User.Read |
| People | |||
| List people | Retrieve a collection of person objects ordered by their relevance to the user. | People.Read | People.Read |
| To-do Tasks | |||
| Create task | Create a new task object in a specified todoTaskList. | Tasks.ReadWrite | Tasks.ReadWrite |
| Create task list | Create a new task lists object. | Tasks.ReadWrite | Tasks.ReadWrite |
| List tasks | Get the todoTask resources from the tasks navigation property of a specified todoTaskList. | Tasks.ReadWrite | Tasks.ReadWrite |
| List tasks lists | Get a list of the todoTaskList objects and their properties. | Tasks.ReadWrite | Tasks.ReadWrite |
| User | |||
| List users | Retrieve a list of user objects. | User.ReadBasic.All | Not supported |
| Create user | Create a new user. | User.ReadWrite.All | Not supported |
| Get signed in user | Retrieve the properties and relationships of the signed in user. | User.Read | User.Read |
| Get user | Retrieve the properties and relationships of user object. | User.Read | User.Read |
| Update user | Update the properties of a user object. | User.ReadWrite | User.ReadWrite |
| Delete user | Delete user. | Directory.AccessAsUser.All | Not supported |