|
| 1 | +# Office 365 SDKs for Java |
| 2 | + |
| 3 | +Easily integrate services and data from Office 365 into Java apps using these libraries. |
| 4 | + |
| 5 | +[](https://travis-ci.org/OfficeDev/Office-365-SDK-for-Java) |
| 6 | +[](https://bintray.com/msopentech/Maven/Office-365-SDK-for-Java/_latestVersion) |
| 7 | + |
| 8 | +--- |
| 9 | + |
| 10 | +:exclamation:**NOTE**: You are free to use this code and library according to the terms of its included [LICENSE](/LICENSE) and to open issues in this repo for unofficial support. |
| 11 | + |
| 12 | +Information about official Microsoft support is available [here][support-placeholder]. |
| 13 | + |
| 14 | +[support-placeholder]: https://support.microsoft.com/ |
| 15 | + |
| 16 | +--- |
| 17 | + |
| 18 | +These libraries are generated from API metadata using [Vipr] and [Vipr-T4TemplateWriter] and use a shared client stack provided by [orc-for-java]. |
| 19 | + |
| 20 | +For information on release cadence and how to access built binaries before release, see [Releases](https://github.com/OfficeDev/Office-365-SDK-for-Java/wiki/Releases). |
| 21 | + |
| 22 | +Current services, service versions, and SDK versions: |
| 23 | + |
| 24 | +|API|Service Version|SDK Version|Artifact Id| |
| 25 | +|---|---------------|-----------|-----------| |
| 26 | +|Mail/Calendar/Contacts|1.0|1.0.0|outlook-services-java| |
| 27 | +|Files|1.0|1.0.0|files-services-java| |
| 28 | +|Discovery|1.0|1.0.0|discovery-services-java| |
| 29 | +|AAD Graph|1.5|0.15.0|directory-services-java| |
| 30 | +|OneNote|1.0|0.15.0|onenote-services-java| |
| 31 | +|Unified API|beta|0.2.2|graph-services-java| |
| 32 | +|SharePoint Lists|1.0|1.0.0|sharepoint-services-java| |
| 33 | + |
| 34 | +[Vipr]: https://github.com/microsoft/vipr |
| 35 | +[Vipr-T4TemplateWriter]: https://github.com/msopentech/vipr-t4templatewriter |
| 36 | +[orc-for-java]: https://github.com/msopentech/orc-for-java |
| 37 | + |
| 38 | +## Quick Start |
| 39 | + |
| 40 | +To use these libraries in your project, follow these general steps, as described further below: |
| 41 | + |
| 42 | +1. Configure dependencies in build.gradle. |
| 43 | +2. Set up authentication. |
| 44 | +3. Construct an API client. |
| 45 | +4. Call methods to make REST calls and receive results. |
| 46 | + |
| 47 | +### Authenticate and construct client |
| 48 | +With your project prepared, the next step is to initialize the dependency manager and an API client. |
| 49 | + |
| 50 | +:exclamation: If you haven't yet registered your app in Azure AD, you'll need to do so before completing this step by following [these instructions][MSDN Add Common Consent]. |
| 51 | + |
| 52 | +[MSDN Add Common Consent]: https://msdn.microsoft.com/en-us/office/office365/howto/add-common-consent-manually |
| 53 | + |
| 54 | +## Contributing |
| 55 | +You will need to sign a [Contributor License Agreement](https://cla.msopentech.com/) before submitting your pull request. To complete the Contributor License Agreement (CLA), you will need to submit a request via the form and then electronically sign the Contributor License Agreement when you receive the email containing the link to the document. This needs to only be done once for any Microsoft Open Technologies OSS project. |
| 56 | + |
| 57 | +## License |
| 58 | +Copyright (c) Microsoft Open Technologies, Inc. All rights reserved. Licensed under the Apache License, Version 2.0. |
0 commit comments