Продолжаю рассказывать об интересных/полезных вещах из мира XAML/C# приложений UWP. OneDrive API является частью Microsoft Graph. Для работы с OneDrive можно использовать OneDrive REST API, которое использует протокол HTTP и в частности его методы GET, POST, DELETE, PUT…
Кроме того, в соответствии с новыми принципами работы Microsoft, была создана библиотека обертка OneDrive SDK for CSharp, которая облегчает работу и использование сервиса из кода ваших приложений.
OneDrive SDK for CSharp — это Portable Class Library (PCL) которая предназначена для следующих типов проектов:
.NET 4.5.1
.NET for Windows Store apps
Windows Phone 8.1 and higher
Для того чтобы установить SDK можно выполнить команду в консоли диспетчера пакетов NuGet
Install-Package Microsoft.OneDriveSDK
или в VS менеджере NuGet воспользоваться поиском по фразе Microsoft.OneDriveSDK
После создания универсального приложения необходимо его связать с магазином Windows. Таким образом оно автоматически будет зарегистрировано в группе приложений Live SDK. По адресу https://apps.dev.microsoft.com/#/appList можно проверить, что приложение зарегистрировано в группе Live SDK applications. Насколько я понял, все приложения Windows Store по умолчанию попадают в эту группу.
Аутентификация происходит с помощью нескольких строчек кода:
string[] scopes = { "wl.signin", "onedrive.readwrite" };
IOneDriveClient _client = OneDriveClientExtensions.GetClientUsingOnlineIdAuthenticator(scopes);
await _client.AuthenticateAsync();
Все права/разрешения (scopes) доступны по ссылке: Authentication scopes
При аутентификации открывается новое окно, в котором пользователь сможет ввести свои данные:
Выйти можно с помощью следующего кода:
await _client.SignOutAsync();
Приведу самые типичные операции с файлами. Скачать файл можно с помощью вот такого сниппета:
string[] scopes = { "wl.signin", "onedrive.readwrite" };
IOneDriveClient _client = OneDriveClientExtensions.GetClientUsingOnlineIdAuthenticator(scopes);
AccountSession session = await _client.AuthenticateAsync();
if (!_client.IsAuthenticated) return;
Item item = await _client
.Drive
.Root
.ItemWithPath("CodeExamples/MyDemo.zip")
.Request()
.GetAsync();
using (Stream contentStream = await _client
.Drive
.Items[item.Id]
.Content
.Request()
.GetAsync())
{
StorageFile file = await ApplicationData.Current.LocalFolder.
CreateFileAsync("MyDemo.zip", CreationCollisionOption.OpenIfExists);
using (Stream outputstream = await file.OpenStreamForWriteAsync())
{
await contentStream.CopyToAsync(outputstream);
}
}
А загрузить с помощью такого:
string[] scopes = { "wl.signin", "onedrive.readwrite" };
IOneDriveClient _client = OneDriveClientExtensions.GetClientUsingOnlineIdAuthenticator(scopes);
AccountSession acse = await _client.AuthenticateAsync();
if (!_client.IsAuthenticated) return;
FileOpenPicker fileOpenPicker = new FileOpenPicker();
fileOpenPicker.FileTypeFilter.Add(".jpg");
StorageFile file = await fileOpenPicker.PickSingleFileAsync();
if (file != null)
{
using (Stream contentStream = await file.OpenStreamForReadAsync())
{
var uploadedItem = await _client
.Drive
.Root
.ItemWithPath("CodeExamples/" + file.Name)
.Content
.Request()
.PutAsync<Item>(contentStream);
}
}
Описание других операций с файлами доступно по ссылке на GitHub: Items in the OneDrive SDK for C#
А вот таким образом можно получить список элементов в корневой папке:
IChildrenCollectionPage ic= await _client
.Drive
.Root
.Children
.Request()
.GetAsync();
Теперь давайте немного рассмотрим эту же операцию, но уже с помощью REST API. Для этого нам понадобится Access Token, который мы можем получить из объекта активной сессии – AccountSession (используем возможности OneDrive SDK для упрощения работы с REST API). И еще понадобится класс HttpClient из пространства System.Net.Http:
Uri uri = new Uri("https://api.onedrive.com/v1.0/drive/root/children");
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", session.AccessToken);
string jsonstring = await client.GetStringAsync(uri);
В результате получим строку в виде JSON с перечислением всех находящихся на OneDrive в корневой папке элементов.
Вы можете не регистрировать приложение в Store, а получить временный Access Token (действительный в течение часа) для экспериментов. Для этого необходимо на страничке OneDrive authentication and sign-in нажать кнопку Get Token.
Первый способ очевидно проще и короче, но второй тоже может быть полезен. Скажем, можно получить ссылку на файл вот так:
Uri uri = new Uri("https://api.onedrive.com/v1.0/drive/root:/CodeExamples/MyDemo.zip:/action.createLink");
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", session.AccessToken);
var requestJson = JsonConvert.SerializeObject( new RequestLinkInfo { type = "view" });
var content = new StringContent(requestJson,Encoding.UTF8,"application/json");
var response = await client.PostAsync(uri,content);
LinkResponseInfo result = JsonConvert.DeserializeObject<LinkResponseInfo>(
await response.Content.ReadAsStringAsync());
Рассматривая контент, вы можете заметить, что в строке Uri путь к файлу обрамлен двоеточием. Альтернативно можно использовать id файла /drive/items/{item-id}/action.createLink.
Для сериализации и десериализации JSON-а нам понадобятся следующие классы:
public class RequestLinkInfo
{
public string type { get; set; } // возможные значения: view, edit или embed
public string scope { get; set; } // optional - возможные значения: anonymous или organization
}
public class LinkResponseInfo
{
public string id { get; set; }
public string[] roles { get; set; }
public Link link { get; set; }
}
public class Link
{
public string type { get; set; }
public string scope { get; set; }
public string webUrl { get; set; }
public OneDriveApplication application { get; set; }
}
public class OneDriveApplication
{
public string id { get; set; }
public string displayName { get; set; }
}
Сам URL можно будет получить из объекта result:
string fileurl = result.link.webUrl;
Что интересно, так это то, что можно даже использовать старенький Live API и получить доступ к информации о том пользователе, который залогинился:
Uri uri = new Uri("https://apis.live.net/v5.0/me");
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", session.AccessToken);
string jsonstring = await client.GetStringAsync(uri);
Хотя, как долго Live API еще будет доступно сказать сложно.
Официальная документация доступна здесь: Develop with the OneDrive API
Автор: asommer