diff --git a/README-Localized/README-es-es.md b/README-Localized/README-es-es.md new file mode 100644 index 00000000000..fc7d9647a3d --- /dev/null +++ b/README-Localized/README-es-es.md @@ -0,0 +1,115 @@ +# Biblioteca cliente .NET de Microsoft Graph + +[![Estado de la compilación](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![Versión de NuGet](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +¡Integre la [API de Microsoft Graph](https://graph.microsoft.io) en su +proyecto de .NET! + +La biblioteca cliente .NET de Microsoft Graph se dirige a .NetStandard 1.1 y .NET Framework 4.5. + +## Instalación mediante NuGet + +Para instalar la biblioteca cliente a través de NuGet: + +* Busque `Microsoft.Graph` en la biblioteca NuGet o +* Escriba `Install-Package Microsoft.Graph` en la Consola del Administrador de paquetes. + +## Introducción + +### 1. Registrar la aplicación + +Registre su aplicación para usar la API de Microsoft Graph con el [Portal de registro de aplicaciones de Microsoft](https://aka.ms/appregistrations). + +### 2. Autenticarse para el servicio de Microsoft Graph + +La Biblioteca cliente .NET de Microsoft Graph no incluye actualmente ninguna implementación de autenticación predeterminada. +Hay un conjunto de proveedores de autenticación preliminar disponibles en el repositorio [msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth). Como alternativa, puede usar la clase integrada **DelegateAuthenticationProvider** para autenticar cada solicitud. +Para obtener más información sobre `DelegateAuthenticationProvider`, vea la [información general de la biblioteca](docs/overview.md). + +La biblioteca recomendada para autenticar la Identidad de Microsoft (Azure AD) es [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet). + +Para ver un ejemplo de cómo autenticar una aplicación para UWP con el extremo de autenticación V2, vea la [Biblioteca de conexión UWP de Microsoft Graph](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library). + +### 3. Crear un objeto de cliente de Microsoft Graph con un proveedor de autenticación + +Una instancia de la clase **GraphServiceClient** controla las solicitudes de creación, su envío a la API de Microsoft Graph y el procesamiento de las respuestas. +Para crear una nueva instancia de esta clase, +tiene que proporcionar una instancia de +`IAuthenticationProvider` que pueda autenticar solicitudes en Microsoft Graph. + +Para obtener más información sobre la inicialización de una instancia de cliente, vea la [información general de la biblioteca](docs/overview.md) + +### 4. Realizar solicitudes a Graph + +Una vez que haya completado la autenticación y tenga un GraphServiceClient, puede empezar a realizar llamadas al servicio. +Las solicitudes en el SDK siguen +el formato de la sintaxis RESTful de la API de Microsoft Graph. + +Por ejemplo, para recuperar la unidad predeterminada de un usuario: + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` devolverá un objeto `Drive` en caso de éxito y +producirá un `ServiceException` en caso de error. + +Para obtener la carpeta raíz del usuario actual de la unidad predeterminada: + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` devolverá un `DriveItem` en caso de éxito y producirá un +`ServiceException` en caso de error. + +Para obtener información general sobre cómo está diseñado el SDK, vea [información general](docs/overview.md). + +Las aplicaciones de ejemplo siguientes también están disponibles: +* [Ejemplo de conexión UWP de Microsoft Graph](https://github.com/microsoftgraph/uwp-csharp-connect-sample) +* [Ejemplo de fragmentos de código UWP para Microsoft Graph](https://github.com/microsoftgraph/uwp-csharp-snippets-sample) +* [Ejemplo de MeetingBot de Microsoft Graph para UWP ](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample) +* [Ejemplo de conexión de Microsoft Graph para ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-connect-sample) +* [Ejemplo de fragmentos de Microsoft Graph para ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-snippets-sample) +* [Biblioteca de fragmentos de Microsoft Graph SDK para Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample) +* [Ejemplo de conexión de Microsoft Graph para Xamarin Forms](https://github.com/microsoftgraph/xamarin-csharp-connect-sample) +* [Ejemplo del Administrador de reuniones de Microsoft Graph para Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample) +* [Ejemplo del Administrador de propiedad de Microsoft Graph para Xamarin Native](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample) + +## Documentación y recursos + +* [Información general](docs/overview.md) +* [Colecciones](docs/collections.md) +* [Errores](docs/errors.md) +* [Encabezados](docs/headers.md) +* [API de Microsoft Graph](https://graph.microsoft.io) +* [Notas de la versión](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## Notas + +Si desea usar una versión mayor que NewtonSoft.Json 6.0.1, instale primero NewtonSoft.Json. Por ejemplo, primero tendrá que instalar NewtonSoft.Json 9.0.1, si desea usar esto en la biblioteca mientras dirige .Net Core con standard1.0. + +Instale System.Runtime.InteropServices.RuntimeInformation antes de instalar Microsoft Graph >= 1.3, si tiene un problema al actualizar el paquete para una solución Xamarin. Es posible que también tenga que actualizar las referencias a Microsoft.NETCore.UniversalWindowsPlatform para >=5.2.2. + +## Problemas + +Para ver o registrar problemas, consulte [problemas](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues). + +Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, vea [Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios. + +## Otros recursos + +* Paquete NuGet: [https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## Creación local de la biblioteca + +Si está pensando en crear la biblioteca de forma local con el fin de contribuir al código o ejecutar pruebas, tendrá que: + +- Tener instalado el SDK de .NET Core (> 1.0) +- Ejecutar `dotnet restore` desde la línea de comandos en el directorio de paquetes +- Ejecutar `nuget restore` y `msbuild` desde CLI o ejecutar Crear desde Visual Studio para restaurar paquetes de Nuget y crear el proyecto + +## Licencia + +Copyright (c) Microsoft Corporation. Reservados todos los derechos. Publicado bajo la [licencia](LICENSE.txt) MIT. Consulte [Avisos de terceros](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES) para obtener información sobre los paquetes a los que se hace referencia mediante NuGet. diff --git a/README-Localized/README-fr-fr.md b/README-Localized/README-fr-fr.md new file mode 100644 index 00000000000..e6f72a50a70 --- /dev/null +++ b/README-Localized/README-fr-fr.md @@ -0,0 +1,115 @@ +# Bibliothèque cliente .NET Microsoft Graph + +[![État de la build](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![version NuGet](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +Intégrez l'[API Microsoft Graph](https://graph.microsoft.io) +dans votre projet .NET ! + +Cibles de la bibliothèque cliente Microsoft Graph .NET. NetStandard 1.1 et .NET Framework 4.5. + +## Installation via NuGet + +Installation de la bibliothèque cliente via NuGet : + +* Recherchez `Microsoft.Graph` dans la bibliothèque NuGet, ou +* Tapez `Installe-package Microsoft.Graph` dans la console du Gestionnaire de package. + +## Prise en main + +### 1. Inscription de votre application + +Vous devez inscrire votre application dans le [Portail d’inscription des applications de Microsoft](https://aka.ms/appregistrations) pour utiliser l'API Microsoft Graph. + +### 2. S'authentifier au service de Microsoft Graph + +La bibliothèque client Microsoft Graph .NET n'inclut pas actuellement les implémentations d'authentification par défaut. +Une liste de fournisseurs d'authentification en préversion est disponible dans le référentiel [msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth). +Vous pouvez également utiliser la classe intégrée **DelegateAuthenticationProvider** pour authentifier chaque demande. Pour plus d’informations sur `DelegateAuthenticationProvider`, consultez la [présentation de la bibliothèque](docs/overview.md). + +La bibliothèque recommandée pour l’authentification auprès de Microsoft Identity (Azure AD) est [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet). + +Pour obtenir un exemple d’authentification d’une application UWP utilisant le point de terminaison d’authentification V2, voir la [Bibliothèque de connexion Microsoft Graph UWP](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library). + +### 3. Créer un objet client Microsoft Graph avec un fournisseur d’authentification + +Une instance de la classe **GraphServiceClient** gère la création de demandes en les envoyant vers l’API Microsoft Graph et en traitant les réponses. +Pour créer une nouvelle instance de cette classe, +vous devez fournir une instance +`IAuthenticationProvider` pouvant authentifier les demandes adressées à Microsoft Graph. + +Pour plus d’informations sur l’initialisation d’une instance client, voir la [présentation de la bibliothèque](docs/overview.md) + +### 4. Formuler des demandes auprès du Graph + +Lorsque vous avez terminé l'authentification et que vous disposez de GraphServiceClient, vous pouvez effectuer des appels vers le service. +Les demandes dans le kit de développement logiciel +respectent le format de la syntaxe RESTful de l’API Microsoft Graph. + +Par exemple, pour récupérer le lecteur par défaut d’un utilisateur : + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` renvoie un objet `Drive` en cas de réussite, +et lève une `ServiceException` en cas d’erreur. + +Obtenir le dossier racine du lecteur par défaut de l’utilisateur actuel : + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` renvoie un objet `DriveItem` en cas de réussite, +et lève une `ServiceException` en cas d’erreur. + +Pour obtenir une vue générale sur la conception du kit de développement logiciel, voir [vue d’ensemble](docs/overview.md). + +Les exemples d’applications suivantes sont également disponibles : +* [Exemple de connexion Microsoft Graph UWP](https://github.com/microsoftgraph/uwp-csharp-connect-sample) +* [Petits exemples Microsoft Graph UWP](https://github.com/microsoftgraph/uwp-csharp-snippets-sample) +* [Exemple Microsoft Graph MeetingBot pour UWP](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample) +* [Exemple de connexion Microsoft Graph pour ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-connect-sample) +* [Petits exemples Microsoft Graph pour ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-snippets-sample) +* [Bibliothèque d’extraits Microsoft Graph SDK pour Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample) +* [Exemple de connexion Microsoft Graph pour Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-connect-sample) +* [Exemple de gestionnaire de réunions Microsoft Graph pour Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample) +* [Exemple de gestionnaire de propriétés Microsoft Graph pour Xamarin Native](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample) + +## Documentation et ressources + +* [Vue d'ensemble](docs/overview.md) +* [Collections](docs/collections.md) +* [Erreurs](docs/errors.md) +* [En-têtes](docs/headers.md) +* [API Microsoft Graph](https://graph.microsoft.io) +* [Notes de publication](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## Remarques + +Installez NewtonSoft.Json tout d’abord si vous voulez utiliser une version ultérieure à NewtonSoft.json 6.0.1. Par exemple, vous devez installer NewtonSoft.json 9.0.1 au préalable si vous voulez l'utiliser pour la bibliothèque tout en ciblant .Net Core avec standard1.0. + +Installez System.Runtime.InteropServices.RuntimeInformation avant d'installer Microsoft.Graph >=1.3 si vous rencontrez un problème lors de la mise à jour de package d'une solution Xamarin. Vous devrez peut-être également mettre à jour les références sur Microsoft.NETCore.UniversalWindowsPlatform vers > = 5.2.2. + +## Problèmes + +Pour afficher ou enregistrer des problèmes, voir [problèmes](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues). + +Ce projet a adopté le [Code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire. + +## Autres ressources + +* Package NuGet : [https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## Création d’une bibliothèque locale + +Si vous envisagez de créer la bibliothèque localement à des fins de codes de contribution ou d’exécution de tests, vous devez : + +- Installer le .NET Core SDK (> 1.0) +- Exécuter `dotnet restore` à partir de la ligne de commande dans le répertoire de votre package +- Exécuter `nuget restore` et `msbuild` à partir de l'interface de ligne de commande (CLI) ou exécutez la Build à partir de Visual Studio pour restaurer les packages Nuget et créer le projet + +## Licence + +Copyright (c) Microsoft Corporation. Tous droits réservés. Sous [licence MIT](LICENSE.txt). Pour plus d'informations sur les packages référencés via NuGet, voir les [Notifications tierces](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES). diff --git a/README-Localized/README-ja-jp.md b/README-Localized/README-ja-jp.md new file mode 100644 index 00000000000..536996aed24 --- /dev/null +++ b/README-Localized/README-ja-jp.md @@ -0,0 +1,115 @@ +# Microsoft Graph .NET クライアント ライブラリ + +[![ビルドの状態](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![NuGet Version](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +[Microsoft Graph API](https://graph.microsoft.io) を +.NET プロジェクトに統合する。 + +Microsoft Graph .NET クライアント ライブラリは、NetStandard 1.1 および .Net Framework 4.5 を対象としています。 + +## NuGet 経由のインストール + +NuGet 経由でクライアント ライブラリをインストールするには、 + +* NuGet ライブラリで `Microsoft.Graph` を検索するか、 +* パッケージ マネージャー コンソールに `Install-Package Microsoft.Graph` と入力します。 + +## はじめに + +### 1.アプリケーションを登録する + +[Microsoft アプリケーション登録ポータル](https://aka.ms/appregistrations)を使用して、Microsoft Graph API を使用するアプリケーションを登録します。 + +### 2.Microsoft Graph サービスの認証 + +Microsoft Graph .NET クライアント ライブラリには現在、既定の認証の実装は含まれていません。[msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth) +リポジトリには、いくつかのプレビュー認証プロバイダーが用意されています。または、組み込みの +**DelegateAuthenticationProvider** クラスを使用して、各要求を認証できます。`DelegateAuthenticationProvider` の詳細については、「[ライブラリの概要](docs/overview.md)」を参照してください。 + +Microsoft Identity (Azure AD) に対する認証での推奨ライブラリは、[MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet)です。 + +V2 認証エンドポイントを使用して UWP アプリを認証する例については、「[Microsoft Graph UWP Connect Library (Microsoft Graph UWP Connect ライブラリ)](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library)」を参照してください。 + +### 3.認証プロバイダーで Microsoft Graph クライアント オブジェクトを作成する + +**GraphServiceClient** クラスのインスタンスは、要求を作成し、Microsoft Graph API にそれらを送信し、応答を処理します。 +このクラスの新しいインスタンスを作成するには、 +Microsoft Graph への要求を認証できる、 +`IAuthenticationProvider` のインスタンスを提供する必要があります。 + +クライアント インスタンスの初期化の詳細については、「[ライブラリの概要](docs/overview.md)」を参照してください + +### 4.Graph への要求を実行する + +認証を完了して GraphServiceClient を取得したら、サービスの呼び出しを開始できます。 +SDKの要求は、Microsoft Graph API の RESTful +構文の形式に従います。 + +たとえば、ユーザーの既定のドライブを取得するには、次の操作を行います。 + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` は、成功時には `Drive` オブジェクトを返し、エラー時には +`ServiceException` をスローします。 + +現在のユーザーの既定のドライブのルート フォルダを取得するには、次の操作を行います。 + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` は、成功時には `DriveItem` オブジェクトを返し、エラー時には +`ServiceException` をスローします。 + +SDK の設計方法に関する一般的な概要については、「[概要](docs/overview.md)」を参照してください。 + +以下のサンプル アプリケーションも利用できます: +* 「[Microsoft Graph UWP Connect Sample (Microsoft Graph UWP Connect のサンプル)](https://github.com/microsoftgraph/uwp-csharp-connect-sample)」 +* 「[Microsoft Graph UWP スニペット サンプル](https://github.com/microsoftgraph/uwp-csharp-snippets-sample)」 +* 「[UWP 用 Microsoft Graph MeetingBot サンプル](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample)」 +* 「[ASP.NET 4.6 用 Microsoft Graph Connect のサンプル](https://github.com/microsoftgraph/aspnet-connect-sample)」 +* 「[ASP.NET 4.6 用 Microsoft Graph スニペットのサンプル](https://github.com/microsoftgraph/aspnet-snippets-sample)」 +* 「[Xamarin.Forms 用 Microsoft Graph SDK スニペット ライブラリ](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample)」 +* 「[Xamarin Forms 用 Microsoft Graph Connect のサンプル](https://github.com/microsoftgraph/xamarin-csharp-connect-sample)」 +* 「[Microsoft Graph Meeting Manager Sample for Xamarin.Forms (Xamarin.Forms 用 Microsoft Graph Meeting Manager サンプル)](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample)」 +* 「[Xamarin Native 用の Microsoft Graph Property Manager のサンプル](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample)」 + +## ドキュメントとリソース + +* [概要](docs/overview.md) +* [コレクション](docs/collections.md) +* [エラー](docs/errors.md) +* [ヘッダー](docs/headers.md) +* [Microsoft Graph API](https://graph.microsoft.io) +* [リリース ノート](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## メモ + +NewtonSoft.Json 6.0.1 より後のバージョンを使用する場合は、最初に NewtonSoft.Json をインストールしてください。たとえば、.Net Core with standard1.0 を対象にしてライブラリにこれを使用する場合は、最初に NewtonSoft.Json 9.0.1 をインストールする必要があります。 + +Xamarin ソリューションのパッケージを更新するときに問題が発生した場合は、Microsoft.Graph >=1.3 をインストールする前に、System.Runtime.InteropServices.RuntimeInformation をインストールしてください。Microsoft.NETCore.UniversalWindowsPlatform to >=5.2.2 への参照の更新が必要な場合があります。 + +## 問題 + +問題を表示、記録するには、「[問題](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues)」 を参照してください。 + +このプロジェクトでは、[Microsoft Open Source Code of Conduct (Microsoft オープン ソース倫理規定)](https://opensource.microsoft.com/codeofconduct/) が採用されています。詳細については、「[Code of Conduct の FAQ (倫理規定の FAQ)](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。また、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までお問い合わせください。 + +## その他のリソース + +* NuGet パッケージ: [https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## ローカルでライブラリを作成する + +コードの投稿やテストの実行を目的としてローカルでライブラリを作成する場合は、次のものが必要です。 + +- .NET Core SDK (> 1.0) をインストールする +- パッケージ ディレクトリ内のコマンド ラインから `dotnet restore` を実行する +- CLI から `NuGet の復元` および `MSBuild` を実行するか、Visual Studio からビルドを実行し、NuGet パッケージを復元して、プロジェクトをビルドする + +## ライセンス + +Copyright (c) Microsoft Corporation.All Rights Reserved.MIT [ライセンス](LICENSE.txt)に基づきライセンスされています。NuGet 経由で参照されたパッケージの詳細については、「[サード パーティについての通知](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES)」 を参照してください。 diff --git a/README-Localized/README-pt-br.md b/README-Localized/README-pt-br.md new file mode 100644 index 00000000000..798f423096b --- /dev/null +++ b/README-Localized/README-pt-br.md @@ -0,0 +1,115 @@ +# Biblioteca de Clientes do .NET do Microsoft Graph + +[![Status de criação](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![Versão do NuGet](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +Integre a [API do Microsoft Graph](https://graph.microsoft.io) ao seu +projeto .NET! + +A Biblioteca de Clientes do .NET do Microsoft Graph se destina ao .NetStandard 1.1 e ao .Net Framework 4.5. + +## Instalação via NuGet + +Para instalar a biblioteca de cliente por meio do NuGet: + +* Pesquise `Microsoft. Graph` na biblioteca do NuGet ou +* Digite `Install-Package Microsoft.Graph` no Console do Gerenciador de Pacotes. + +## Introdução + +### 1. Registre seu aplicativo + +Registre seu aplicativo na API do Microsoft Graph usando o [Portal de Registro de Aplicativos da Microsoft](https://aka.ms/appregistrations). + +### 2. Autentique o serviço do Microsoft Graph + +Atualmente a biblioteca de clientes do Microsoft Graph .NET não inclui nenhuma implementação de autenticação padrão. +Há um conjunto de provedores de autenticação prévia disponível no repositório [msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth). +Como alternativa, você pode usar a classe interna **DelegateAuthenticationProvider** para autenticar cada solicitação. Confira mais informações sobre `DelegateAuthenticationProvider` na [visão geral da biblioteca](docs/overview.md). + +A biblioteca recomendada para autenticação no Microsoft Identidade (Azure AD) é [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet). + +Para acessar um exemplo de autenticação de um aplicativo UWP usando o Ponto de Extremidade de Autenticação V2, confira a [Biblioteca de Conexão do UWP ao Microsoft Graph](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library). + +### 3. Criar um objeto cliente do Microsoft Graph com um provedor de autenticação + +Uma instância da classe **GraphServiceClient** manipula solicitações de criação, enviando-as à API do Microsoft Graph e processando as respostas. +Para criar uma nova instância dessa classe, +você precisa fornecer uma instância de +`IAuthenticationProvider` que possa autenticar solicitações para o Microsoft Graph. + +Confira mais informações sobre a inicialização de uma instância de cliente na [visão geral da biblioteca](docs/overview.md) + +### 4. Fazer solicitações ao Graph + +Depois de concluir a autenticação e ter um GraphServiceClient, você pode começar a fazer chamadas para o serviço. +As solicitações no SDK seguem o formato da sintaxe RESTful +da API do Microsoft Graph. + +Por exemplo, para recuperar a unidade padrão de um usuário: + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` retornará o objeto `Drive` em caso de êxito e emitirá uma +`ServiceException` em caso de erro. + +Para obter a pasta raiz das unidades padrão do usuário atual: + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` retornará o objeto `DriveItem` em caso de êxito e emitirá uma +`ServiceException` em caso de erro. + +Confira como o SDK foi desenvolvido na [visão geral](docs/overview.md). + +Os seguintes aplicativos de exemplo também estão disponíveis: +* [Exemplo de Conexão do UWP com o Microsoft Graph,](https://github.com/microsoftgraph/uwp-csharp-connect-sample) +* [Exemplo de Trechos de Códigos do UXP no Microsoft Graph](https://github.com/microsoftgraph/uwp-csharp-snippets-sample) +* [Exemplo do MeetingBot para UWP no Microsoft Graph](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample) +* [Exemplo de Conexão do ASP.NET 4.6 com o Microsoft Graph](https://github.com/microsoftgraph/aspnet-connect-sample) +* [Exemplo de Trechos de Códigos do ASP.NET 4.6 no Microsoft Graph](https://github.com/microsoftgraph/aspnet-snippets-sample) +* [Biblioteca de Trechos de Códigos do SDK do Xamarin.Forms no Microsoft Graph](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample) +* [Exemplo de Conexão do Microsoft Graph com o Xamarin Forms](https://github.com/microsoftgraph/xamarin-csharp-connect-sample) +* [Exemplo de Gerenciador de Reuniões do Microsoft Graph para Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample) +* [Exemplo de Gerenciador de Propriedades do Microsoft Graph para Xamarin Nativo](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample) + +## Documentação e recursos + +* [Visão Geral](docs/overview.md) +* [Coleções](docs/collections.md) +* [Erros](docs/errors.md) +* [Cabeçalhos](docs/headers.md) +* [API do Microsoft Graph](https://graph.microsoft.io) +* [Notas de versão](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## Observações + +Instale o NewtonSoft.json primeiro caso queira usar uma versão posterior à NewtonSoft.Json 6.0.1. Por exemplo, você precisará instalar o NewtonSoft.Json 9.0.1 primeiro se quiser usá-lo nessa biblioteca enquanto visa o .NET Core com o padrão 1.0. + +Instale System.Runtime.InteropServices.RuntimeInformation antes de instalar o Microsoft.Graph 1.3 e versões posteriores se você estiver com problemas para atualizar o pacote de uma solução do Xamarin. Talvez você também precise de referências atualizadas para Microsoft.NETCore.UniversalWindowsPlatform 5.2.2 e versões posteriores. + +## Problemas + +Confira [problemas](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues) para exibir ou registrar problemas. + +Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira as [Perguntas frequentes sobre o Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou entre em contato pelo [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. + +## Outros recursos + +* Pacote NuGet: [https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## Construindo a biblioteca local + +Se você quiser construir uma biblioteca local a fim de colaborar em códigos ou testes em execução, você precisará do seguinte: + +- Ter o SDK do .NET Core (> 1.0) instalado +- Executar o `dotnet restore` na linha de comando do diretório do pacote +- Executar `nuget restore` e `msbuild` da CLI ou executar o Build do Visual Studio para restaurar pacotes NuGet e compilar o projeto + +## Licença + +Copyright (c) Microsoft Corporation. Todos os direitos reservados. Licenciada sob a [Licença](LICENSE.txt) do MIT. Confira as informações sobre os pacotes de referência via NuGet nos [Avisos a Terceiros](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES). diff --git a/README-Localized/README-ru-ru.md b/README-Localized/README-ru-ru.md new file mode 100644 index 00000000000..f967678ed26 --- /dev/null +++ b/README-Localized/README-ru-ru.md @@ -0,0 +1,115 @@ +# Клиентская библиотека .NET Microsoft Graph + +[![Состояние сборки](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![Версия NuGet](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +Интегрируйте [API Microsoft Graph](https://graph.microsoft.io) в свой +проект .NET! + +Клиентская библиотека .NET Microsoft Graph предназначена для .NetStandard 1.1 и .Net Framework 4.5. + +## Установка с помощью NuGet + +Чтобы установить клиентскую библиотеку с помощью NuGet: + +* Найдите `Microsoft.Graph` в библиотеке NuGet или +* Введите `Install-Package Microsoft.Graph` в консоли диспетчера пакетов. + +## Начало работы + +### 1. Регистрация приложения + +Зарегистрируйте приложение для использования API Microsoft Graph с помощью [портала регистрации приложений Майкрософт](https://aka.ms/appregistrations). + +### 2. Проверка подлинности для службы Microsoft Graph + +В настоящее время в клиентской библиотеке .NET Microsoft Graph не реализованы какие-либо проверки подлинности по умолчанию. +Набор поставщиков предварительных версий проверок подлинности доступен в репозитории [msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth). +Вы также можете использовать встроенный класс **DelegateAuthenticationProvider** для проверки подлинности каждого запроса. Дополнительные сведения о классе `DelegateAuthenticationProvider` см. в [обзоре библиотеки](docs/overview.md). + +Рекомендуемая библиотека для проверки подлинности с использованием удостоверений Майкрософт (Azure AD) — [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet). + +Пример проверки подлинности приложения UWP с использованием конечной точки проверки подлинности версии 2 см. в статье [Библиотека Microsoft Graph UWP Connect](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library). + +### 3. Создание клиентского объекта Microsoft Graph с поставщиком проверки подлинности + +Экземпляр класса **GraphServiceClient** обрабатывает запросы на создание, отправляя их в API Microsoft Graph API и обрабатывая ответы. +Чтобы создать экземпляр этого класса, +требуется предоставить экземпляр +`IAuthenticationProvider`, который может проверять подлинность запросов к Microsoft Graph. + +Дополнительные сведения об инициализации экземпляра клиента см. в [обзоре библиотеки](docs/overview.md) + +### 4. Отправка запросов к graph + +После завершения проверки подлинности и при наличии GraphServiceClient вы можете начать совершать вызовы в службу. +Запросы в SDK соответствуют формату синтаксиса +с применением REST интерфейса API Microsoft Graph. + +Пример получения используемого по умолчанию диска пользователя: + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` возвращает объект `Drive` в случае успеха и вызывает объект +`ServiceException` в случае ошибки. + +Получение корневой папки на диске по умолчанию текущего пользователя: + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` возвращает объект `DriveItem` в случае успеха и вызывает объект +`ServiceException` в случае ошибки. + +Общие сведения о конструкции пакета SDK см. в [обзоре](docs/overview.md). + +Также доступны следующие примеры приложений: +* [пример Microsoft Graph UWP Connect](https://github.com/microsoftgraph/uwp-csharp-connect-sample) +* [пример фрагментов Microsoft Graph UWP](https://github.com/microsoftgraph/uwp-csharp-snippets-sample) +* [пример Microsoft Graph MeetingBot для UWP](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample) +* [пример Microsoft Graph Connect для ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-connect-sample) +* [пример фрагментов Microsoft Graph для ASP.NET 4.6](https://github.com/microsoftgraph/aspnet-snippets-sample) +* [библиотека фрагментов Microsoft Graph SDK для Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample) +* [пример Microsoft Graph Connect для Xamarin Forms](https://github.com/microsoftgraph/xamarin-csharp-connect-sample) +* [пример диспетчера собраний Microsoft Graph для Xamarin.Forms](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample) +* [пример диспетчера свойств Microsoft Graph для Xamarin Native](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample) + +## Документация и ресурсы + +* [Обзор](docs/overview.md) +* [Коллекции](docs/collections.md) +* [Ошибки](docs/errors.md) +* [Заголовки](docs/headers.md) +* [API Microsoft Graph](https://graph.microsoft.io) +* [Заметки о выпуске](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## Примечания + +Сначала установите NewtonSoft.Json, если хотите использовать более позднюю версию, чем NewtonSoft.Json 6.0.1. Например, вам потребуется сначала установить NewtonSoft.Json 9.0.1, если вы хотите использовать его для библиотеки с целью применения .NET Core со стандартом 1.0. + +Установите System.Runtime.InteropServices.RuntimeInformation перед установкой Microsoft.Graph версии 1.3 и более поздней, если у вас возникла проблема с обновлением пакета для решения Xamarin. Вам также могут потребоваться обновленные ссылки на Microsoft.NETCore.UniversalWindowsPlatform для версии 5.2.2 и более поздней. + +## Проблемы + +Для просмотра и регистрации проблем см. раздел [проблем](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues). + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [часто задаваемых вопросов о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). + +## Другие ресурсы + +* Пакет NuGet: [https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## Локальное создание библиотеки + +Если вы собираетесь создать библиотеку в локальном расположении для добавления кода или выполнения тестов, вам потребуется выполнить следующие действия: + +- Установить пакет SDK .NET Core (> 1.0) +- Выполнить команду `dotnet restore` из командной строки в каталоге пакета +- Выполнить команды `nuget restore` и `msbuild` из CLI или запустить сборку из Visual Studio, чтобы восстановить пакеты Nuget и создать проект + +## Лицензия + +© Корпорация Майкрософт. Все права защищены. Предоставляется по [лицензии](LICENSE.txt) MIT. Сведения о пакетах, указанных в NuGet, см. в разделе [Уведомления третьих лиц](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES). diff --git a/README-Localized/README-zh-cn.md b/README-Localized/README-zh-cn.md new file mode 100644 index 00000000000..f951c3c94c2 --- /dev/null +++ b/README-Localized/README-zh-cn.md @@ -0,0 +1,115 @@ +# Microsoft Graph .NET 客户端库 + +[![生成状态](https://ci.appveyor.com/api/projects/status/m8qncaosr2ry4ks6/branch/master?svg=true)](https://ci.appveyor.com/project/MIchaelMainer/msgraph-sdk-dotnet/branch/master) +[![NuGet 版本](https://buildstats.info/nuget/Microsoft.Graph)](https://www.nuget.org/packages/Microsoft.Graph/) + +将 [Microsoft Graph API](https://graph.microsoft.io) 集成到你的 +.NET 项目中! + +Microsoft Graph .NET 客户端库面向 .NetStandard 1.1 和 .Net Framework 4.5。 + +## 通过 NuGet 安装 + +若要通过 NuGet 安装客户端库: + +* 在 NuGet 库中搜索 `Microsoft.Graph`,或者 +* 在包管理器控制台中键入 `Install-Package Microsoft.Graph`。 + +## 入门 + +### 1.注册应用程序 + +使用 [Microsoft 应用程序注册门户](https://aka.ms/appregistrations)注册你的应用程序以使用 Microsoft Graph API。 + +### 2.Microsoft Graph 服务身份验证 + +Microsoft Graph .NET 客户端库当前不包含任何默认身份验证实现。[msgraph-sdk-dotnet-auth](https://github.com/microsoftgraph/msgraph-sdk-dotnet-auth) +存储库中提供了一组预览版身份验证提供程序。或者,你可以使用内置的 +**DelegateAuthenticationProvider** 类对每个请求进行身份验证。有关 `DelegateAuthenticationProvider` 的详细信息,请参阅[库概述](docs/overview.md)。 + +推荐用于根据 Microsoft 标识 (Azure AD) 进行身份验证的库是 [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet)。 + +有关使用 V2 身份验证终结点对 UWP 应用进行身份验证的示例,请参阅 [Microsoft Graph UWP Connect 库](https://github.com/OfficeDev/Microsoft-Graph-UWP-Connect-Library)。 + +### 3.使用身份验证提供程序创建 Microsoft Graph 客户端对象 + +**GraphServiceClient** 类的一个实例会处理生成请求,将这些请求发送到 Microsoft Graph API,并处理响应。 +若要创建此类的新实例, +需要提供 +`IAuthenticationProvider` 的实例,可用于对提供给 Microsoft Graph 的请求进行身份验证。 + +有关初始化客户端实例的详细信息,请参阅[库概述](docs/overview.md) + +### 4.对图形发出请求 + +完成身份验证并有 GraphServiceClient 后,即可开始对服务进行调用。 +该 SDK 中的请求遵循 Microsoft Graph API +的 REST 风格语法的格式。 + +例如,若要检索用户的默认驱动器: + +```csharp +var drive = await graphClient.Me.Drive.Request().GetAsync(); +``` + +`GetAsync` 将在成功时返回一个 `Drive` 对象, +而在出现错误时引发 `ServiceException`。 + +若要获取当前用户的默认驱动器的根文件夹: + +```csharp +var rootItem = await graphClient.Me.Drive.Root.Request().GetAsync(); +``` + +`GetAsync` 将在成功时返回一个 `DriveItem` 对象, +而在出现错误时引发 `ServiceException`。 + +有关该 SDK 的设计方式的一般性概述,请参阅[概述](docs/overview.md)。 + +还可以使用以下示例应用程序: +* [Microsoft Graph UWP Connect 示例](https://github.com/microsoftgraph/uwp-csharp-connect-sample) +* [Microsoft Graph UWP 代码段示例](https://github.com/microsoftgraph/uwp-csharp-snippets-sample) +* [适用于 UWP 的 Microsoft Graph MeetingBot 示例](https://github.com/microsoftgraph/uwp-csharp-meetingbot-sample) +* [适用于 ASP.NET 4.6 的 Microsoft Graph Connect 示例](https://github.com/microsoftgraph/aspnet-connect-sample) +* [适用于 ASP.NET 4.6 的 Microsoft Graph 代码段示例](https://github.com/microsoftgraph/aspnet-snippets-sample) +* [适用于 Xamarin.Forms 的 Microsoft Graph SDK 代码段库](https://github.com/microsoftgraph/xamarin-csharp-snippets-sample) +* [适用于 Xamarin Forms 的 Microsoft Graph Connect 示例](https://github.com/microsoftgraph/xamarin-csharp-connect-sample) +* [适用于 Xamarin.Forms 的 Microsoft Graph Meeting Manager 示例](https://github.com/microsoftgraph/xamarin-csharp-meetingmanager-sample) +* [适用于 Xamarin Native 的 Microsoft Graph Property Manager 示例](https://github.com/microsoftgraph/xamarin-csharp-propertymanager-sample) + +## 文档和资源 + +* [概述](docs/overview.md) +* [集合](docs/collections.md) +* [错误](docs/errors.md) +* [标头](docs/headers.md) +* [Microsoft Graph API](https://graph.microsoft.io) +* [发行说明](https://github.com/microsoftgraph/msgraph-sdk-dotnet/releases) + +## 注意 + +如果要使用高于 NewtonSoft.Json 6.0.1 的版本,请先安装 NewtonSoft.Json。例如,如果要在以 .Net Core(采用标准 1.0)为目标时使用此库,则需要先安装 NewtonSoft.Json 9.0.1。 + +如果在更新 Xamarin 解决方案的包时遇到问题,请在安装 Microsoft.Graph 1.3 或更高版本之前先安装 System.Runtime.InteropServices.RuntimeInformation。你可能还需要将对 Microsoft.NETCore.UniversalWindowsPlatform 的引用也更新为 5.2.2 或更高版本。 + +## 问题 + +若要查看或记录问题,请参阅[问题](https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues)。 + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息,请参阅[行为准则 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见,也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 + +## 其他资源 + +* NuGet 包:[https://www.nuget.org/packages/Microsoft.Graph](https://www.nuget.org/packages/Microsoft.Graph) + +## 在本地生成库 + +如果你出于提供代码或运行测试的目的而在本地构建库,则需要: + +- 安装 .NET Core SDK (> 1.0) +- 从程序包目录的命令行运行 `dotnet restore` +- 从 CLI 运行 `nuget restore` 和 `msbuild`,或从 Visual Studio 运行构建,以还原 Nuget 程序包并构建项目 + +## 许可证 + +版权所有 (c) Microsoft Corporation。保留所有权利。在 MIT [许可证](LICENSE.txt)下获得许可。有关通过 NuGet 引用的程序包的信息,请参阅[第三方声明](https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/master/THIRD%20PARTY%20NOTICES)。