From 0d581fe8d7fd99a530fedaa2f4db21ed10f8f378 Mon Sep 17 00:00:00 2001 From: OfficeGlobal Date: Fri, 28 Feb 2020 15:22:02 +0100 Subject: [PATCH] HB of localized Readme --- README-Localized/Readme-es-es.md | 90 ++++++++++++++++++++++++++++++++ README-Localized/Readme-fr-fr.md | 90 ++++++++++++++++++++++++++++++++ README-Localized/Readme-ja-jp.md | 90 ++++++++++++++++++++++++++++++++ README-Localized/Readme-pt-br.md | 90 ++++++++++++++++++++++++++++++++ README-Localized/Readme-ru-ru.md | 90 ++++++++++++++++++++++++++++++++ README-Localized/Readme-zh-cn.md | 90 ++++++++++++++++++++++++++++++++ 6 files changed, 540 insertions(+) create mode 100644 README-Localized/Readme-es-es.md create mode 100644 README-Localized/Readme-fr-fr.md create mode 100644 README-Localized/Readme-ja-jp.md create mode 100644 README-Localized/Readme-pt-br.md create mode 100644 README-Localized/Readme-ru-ru.md create mode 100644 README-Localized/Readme-zh-cn.md diff --git a/README-Localized/Readme-es-es.md b/README-Localized/Readme-es-es.md new file mode 100644 index 0000000..e2b43e0 --- /dev/null +++ b/README-Localized/Readme-es-es.md @@ -0,0 +1,90 @@ +Ejemplo de API del servicio de OneNote para ASP.NET Core +--------------------------------------- + +Creado por Microsoft Corporation, 2017. Se proporciona tal cual sin garantía. Las marcas comerciales que se mencionan aquí pertenecen a sus propietarios. + +DEMO: https://onenoteapisamplegraph.azurewebsites.net + +### Introducción + +- Este es un pequeño ejemplo que muestra cómo acceder a los recursos de OneNote a través de la API de Microsoft Graph desde un servidor ASP.NET. + +### Requisitos previos + +**Herramientas y bibliotecas** que tendrá que descargar, instalar y configurar en el entorno de desarrollo + +* [Visual Studio 2015 Actualización 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. Haga clic en "Cómo instalar una versión específica de Visual Studio": + + ![Descargar una versión anterior de Visual Studio](./images/HowToInstall.png) + + 2. Haga clic en "My.VisualStudio.com": + + ![Haga clic en "My.VisualStudio.com"](./images/InstallingEarlierReleases.png) + + 3. [Descargar Visual Studio Enterprise 2015 con la actualización 3](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015) (debe iniciar sesión con una cuenta MSFT) + + ![Instalar versiones anteriores](./images/VisualStudioEnterpriseSearch.png) + +* [SDK de ASP.NET Core (para .NET Core 1.0)](https://www.microsoft.com/net/download/core) + +* [Visual Studio Tools 2015](https://www.microsoft.com/net/download/core) + + ![Instalación de Visual Studio Tools](./images/VisualStudioToolsInstall.png) + +### Uso del ejemplo + +Una vez que haya configurado las herramientas de desarrollo e instalado los requisitos previos indicados anteriormente,... + +1. Descargue el repositorio como archivo ZIP en el equipo local y extraiga los archivos. O bien, clone el repositorio en una copia local de Git. +2. Abra el proyecto (archivo .sln) en Visual Studio. +3. Es altamente recomendado que obtenga su propio Id. de cliente, secreto de cliente y URI de redireccionamiento y los copie en [Config.cs.](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9) Puede obtener su propio Id. de aplicación, secreto de aplicación y URI de redireccionamiento [aquí](http://developer.microsoft.com/es-es/graph/docs/authorization/auth_register_app_v2) +4. Para el desarrollo local, el ejemplo usa http://localhost:5001/msgraphoauthcallback como URI de redireccionamiento. Para producción, debe cambiar esta para indicar el dominio de la aplicación. > Nota: Chrome y Firefox no permiten establecer cookies en localhost y, por lo tanto, la autenticación no funcionará en estos navegadores durante el desarrollo si decide redirigir a localhost. +5. Asegúrese de haber seleccionado la configuración "OneNoteApiSample" al iniciar la aplicación de forma local. Vea [Captura de pantalla](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG). +6. Compile y ejecute la aplicación (F5) + +### Contenido + +Puede encontrar documentación adicional en los siguientes vínculos. + +- Páginas de creación: + - [Publicar una página HTML simple en una nueva página de notas rápidas de OneNote](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/notes_post_pages) +- Páginas de consultas y búsquedas: + - [Obtener una lista paginada de todas las páginas en OneNote](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/notes_list_pages) +- Administrar blocs de notas y secciones: + - [Obtener una lista de todos los blocs de notas](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [Obtener una lista de todas las secciones](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/notes_list_sections) + +#### Nota + +Como ejemplo, y para mayor simplicidad, este ejemplo no sigue las prácticas recomendadas para una aplicación en producción. Si su intención es enviar este código, le recomendamos que haga lo siguiente: + +- Nunca inserte los secretos de aplicaciones en su repositorio +- Solicite HTTPS en todo el sitio +- No almacene tokens de actualización sin cifrar en las cookies + +- **Paquetes NuGet** usados en el ejemplo. Estos se controlan con el administrador de paquetes, como se indica en las instrucciones de configuración. Los mismos deben actualizarse automáticamente al momento de la compilación; de no ser así, asegúrese de que el administrador de paquetes NuGet esté al día. Puede obtener más información sobre los paquetes que usamos en los siguientes vínculos. + + - El [Paquete Newtonsoft Json.NET](http://newtonsoft.com/) proporciona servicios + - Otros paquetes NuGet de Microsoft, enumerados en project.json + +### Información de versión + +| Fecha | Modificación | +|--------------|--------------------------------------------------------------------------------| +| Mayo 2017 | Actualizado para usar la dirección URL base de Microsoft Graph v1.0 para los recursos de OneNote | +| Marzo 2017 | Actualizado para usar los extremos de la API de Microsoft Graph. | +| Enero 2017 | Versión pública inicial para este ejemplo de código. | + +### Más información + +- Visite el centro para desarrolladores [dev.onenote.com](http://dev.onenote.com) +- Póngase en contacto con nosotros en [StackOverflow (OneNote etiquetado)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Síganos en [Twitter @onenotedev](http://www.twitter.com/onenotedev) +- Lea nuestro [Blog para desarrolladores de OneNote](http://go.microsoft.com/fwlink/?LinkID=390183) +- Pruebe la API usando el [Probador de Graph](https://developer.microsoft.com/es-es/graph/graph-explorer) +- Documentación de [referencia de API](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/resources/notes) +- [Problemas conocidos](https://developer.microsoft.com/es-es/graph/docs/overview/release_notes) +- [Introducción](https://developer.microsoft.com/es-es/graph/docs/get-started/get-started) a la API de Microsoft Graph + +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. diff --git a/README-Localized/Readme-fr-fr.md b/README-Localized/Readme-fr-fr.md new file mode 100644 index 0000000..a342735 --- /dev/null +++ b/README-Localized/Readme-fr-fr.md @@ -0,0 +1,90 @@ +Exemple de service OneNote via API ASP.NET +--------------------------------------- + +Créé par Microsoft Corporation, 2017. Fourni en l’état sans garantie. Les marques mentionnées ici sont la propriété de leurs propriétaires. + +DÉMONSTRATION : https://onenoteapisamplegraph.azurewebsites.net + +### Introduction + +- Il s’agit d’un court exemple indiquant comment utiliser les ressources OneNote d’accès via l’API Microsoft Graph à partir d’un serveur ASP.NET. + +### Conditions préalables + +**Outils et bibliothèques** vous devrez télécharger, installer et configurer pour votre environnement de développement + +* [Visual Studio 2015 Mise à jour 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. Cliquez sur « Comment installer une version spécifique de Visual Studio » : + + ![Télécharger une version antérieure de Visual Studio](./images/HowToInstall.png) + + 2. Cliquez sur « My.VisualStudio.com » : + + ![Click on "My.VisualStudio.com"](./images/InstallingEarlierReleases.png) + + 3. [Télécharger Visual Studio Enterprise 2015 avec la Mise à jour 3](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015) (connecté avec un compte MSFT) + + ![Installer des versions antérieures](./images/VisualStudioEnterpriseSearch.png) + +* [ASP.NET Core SDK (pour .NET Core 1,0)](https://www.microsoft.com/net/download/core) + +* [Outils Visual Studio 2015](https://www.microsoft.com/net/download/core) + + ![Installation des outils Visual Studio](./images/VisualStudioToolsInstall.png) + +### Utilisation de l’exemple + +Après avoir configuré vos outils de développement et installé les prérequis mentionnés ci-dessus... + +1. Téléchargez ce référentiel sous la forme d’un fichier ZIP sur votre ordinateur, puis extrayez les fichiers. Vous pouvez également cloner le référentiel dans une copie locale de Git. +2. Ouvrez le projet (fichier .sln) dans Visual Studio. +3. Nous vous recommandons vivement de vous procurer votre propre ID client, clé secrète et URI de redirection et des les copier dans [Config.cs](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9). Vous pouvez vous procurer votre appID, la clé secrète de l’application et l’URI de redirection [ici](http://developer.microsoft.com/fr-fr/graph/docs/authorization/auth_register_app_v2) +4. Pour le développement local, l’exemple utilise http://localhost:5001/msgraphoauthcallback comme URI de redirection. Pour la production, vous devez modifier ce protocole pour qu'il pointe vers votre domaine d'application. >Remarque : Chrome et Firefox n'autorisent pas l'installation de cookies sur localhost. De ce fait, l'authentification ne fonctionne pas sur ces navigateurs pendant le développement si vous choisissez de vous rediriger vers localhost. +5. Vérifiez que vous avez sélectionné la configuration « OneNoteApiSample » lors du lancement de l’application en local. Afficher la [capture d’écran](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG). +6. Génération et exécution de l’application (F5) + +### Contenu + +Vous trouverez des informations supplémentaires via les liens ci-dessous. + +- Créer des pages : + - [PUBLIER du simple HTML dans une nouvelle page OneNote QuickNotes](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/notes_post_pages) +- Pages de requête et de recherche : + - [OBTENIR la liste paginée de toutes les pages dans OneNote](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/notes_list_pages) +- Gérer les blocs-notes et les sections : + - [OBTENIR la liste de tous les blocs-notes](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [OBTENIR la liste de toutes les sections](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/notes_list_sections) + +#### Remarque + +Pour des raisons de simplification, cet exemple ne respecte pas les pratiques recommandées pour une application en Production. Si vous voulez expédier ce code, nous vous recommandons d’effectuer les opérations suivantes : + +- Ne jamais enregistrer les clés secrètes des applications dans votre référentiel +- Exiger le HTTPS sur votre site +- Ne pas stocker les jetons d’actualisation non chiffrés dans les cookies + +- **Packages NuGet** utilisés dans l’exemple. Ils sont gérés à l’aide du gestionnaire de package, comme décrit dans les instructions d’installation. Cela devrait être mis à jour automatiquement au moment de la création. Si ce n’est pas le cas, assurez-vous que votre gestionnaire de package NuGet est à jour. Vous pouvez en savoir plus sur les packages que nous avons utilisés avec les liens ci-dessous. + + - [Newtonsoft Json.NET package](http://newtonsoft.com/) fournit des utilitaires d’analyse JSON. + - Autres packages NuGet de Microsoft, répertoriés dans project.json + +### Informations sur la version + +| Date | Modifier | +|--------------|--------------------------------------------------------------------------------| +| Mai 2017 | Mise à jour pour utiliser l'URL de base de Microsoft Graph – Graphique v1.0 pour les ressources OneNote | +| Mars 2017 | Mise à jour pour utiliser les points de terminaison de l'API de Microsoft Graph. | +| Janvier 2017 | Version publique initiale de cet exemple de code. | + +### En savoir plus + +- Visitez le centre de développement [dev.onenote.com](http://dev.onenote.com) +- Contactez-nous sur [StackOverflow (avec la balise OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Suivez-nous sur [Twitter @onenotedev](http://www.twitter.com/onenotedev) +- Lisez notre [blog de OneNote pour les développeurs](http://go.microsoft.com/fwlink/?LinkID=390183) +- Explorez l’API à l’aide de l’[Afficheur Graph – Graphique](https://developer.microsoft.com/fr-fr/graph/graph-explorer) +- Documentation de [référence d’API](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/resources/notes) +- [Problèmes connus](https://developer.microsoft.com/fr-fr/graph/docs/overview/release_notes) +- [Prise en main](https://developer.microsoft.com/fr-fr/graph/docs/get-started/get-started) de l’API Microsoft Graph + +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. diff --git a/README-Localized/Readme-ja-jp.md b/README-Localized/Readme-ja-jp.md new file mode 100644 index 0000000..a04bdd2 --- /dev/null +++ b/README-Localized/Readme-ja-jp.md @@ -0,0 +1,90 @@ +OneNote サービス API ASP.NET コア サンプル +--------------------------------------- + +作成: Microsoft Corporation、2017。現状のまま提供され、保証はいたしません。ここに記載される商標は、商標の所有者の所有物です。 + +デモ: https://onenoteapisamplegraph.azurewebsites.net + +### はじめに + +- これは、ASP.NET サーバーの Microsoft Graph API 経由で OneNote のリソースを使用する方法を説明する簡単なサンプルです。 + +### 必要条件 + +ダウンロードしてインストールし、開発環境に合わせて構成する必要がある**ツールおよびライブラリ** + +* [Visual Studio 2015 Update 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. 「Visual Studio の特定のリリースをインストールする方法」 をクリックします。 + + ![Visual Studio の以前のリリースをダウンロードする](./images/HowToInstall.png) + + 2. 「My.VisualStudio.com」 をクリックします。 + + ![「My.VisualStudio.com」 をクリックする](./images/InstallingEarlierReleases.png) + + 3. [Visual Studio Enterprise 2015 Update 3 をダウンロード](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015) (MSFT アカウントを使用してログインします) + + ![以前のリリースをインストールする](./images/VisualStudioEnterpriseSearch.png) + +* [ASP.NET Core SDK (.NET Core 1.0 用)](https://www.microsoft.com/net/download/core) + +* [Visual Studio 2015 Tools](https://www.microsoft.com/net/download/core) + + ![Visual Studio Tools インストール](./images/VisualStudioToolsInstall.png) + +### サンプルの使用 + +開発ツールをセットアップし、上記の必要条件をインストールしたら、 + +1. リポジトリを ZIP ファイルとしてローカル コンピューターにダウンロードし、ファイルを抽出します。または、Git のローカル コピーにリポジトリを複製します。 +2. プロジェクトの .sln ファイルを Visual Studio で開きます。 +3. 独自のクライアント ID、シークレット、リダイレクト URI を取得し、[Config.cs](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9) にコピーすることを強くお勧めします。独自の AppID、アプリ シークレット、リダイレクト URI は [こちら](http://developer.microsoft.com/ja-jp/graph/docs/authorization/auth_register_app_v2)から取得できます。 +4. ローカルで開発する場合は、サンプルではリダイレクト URI として http://localhost:5001/msgraphoauthcallback が使用されます。運用環境では、アプリケーションのドメインをポイントするように URI を変更する必要があります。>注意:Chrome と Firefox では Cookie を Localhost に設定できないため、Localhost にリダイレクトするように設定した場合、開発中はこれらのブラウザーでは認証が機能しません。 +5. アプリをローカルで起動するときに、「OneNoteApiSample」 構成が選択されていることを確認します。[スクリーンショット](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG)を参照してください。 +6. アプリケーションをビルドして実行します (F5)。 + +### コンテンツ + +その他の資料については、以下のリンクを参照してください。 + +- ページの作成 + - [シンプルな HTML ページを新しい OneNote クイックノート ページに投稿する](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/notes_post_pages) +- ページのクエリおよび検索の実行 + - [OneNote のページ分割されたすべてのリストを取得する](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/notes_list_pages) +- ノートブックとセクションの管理 + - [すべてのノートブックの一覧を取得する](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [すべてのセクションの一覧を取得する](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/notes_list_sections) + +#### 注意 + +簡単にするため、このサンプルは運用中のアプリケーションのベスト プラクティスに準拠することはありません。このコードを発送する場合は、次の操作を行うことをお勧めします。 + +- アプリ シークレットをリポジトリにチェックインしない +- サイト全体で HTTPS を要求する +- 暗号化されていない更新トークンを Cookie に保存しない + +- サンプルで使用されている **NuGet パッケージ**。これらは、セットアップ手順に記載されているとおりに、パッケージ マネージャーを使用して処理されます。これらは、ビルド時に自動的に更新されます。更新されない場合は、NuGet パッケージ マネージャーが最新であることを確認します。以下のリンクから使用しているパッケージの詳細については、こちらを参照してください。 + + - [Newtonsoft Json.NET パッケージ](http://newtonsoft.com/) は Json 解析ユーティリティを提供します。 + - Microsoft のその他の Nuget パッケージは、project. json に記載されています。 + +### バージョン情報 + +| 日付 | 変更点 | +|--------------|--------------------------------------------------------------------------------| +| 2017 年 5 月 | OneNote リソース用に Microsoft Graph v1.0 ベース URL を利用するように更新。 | +| 2017 年 3 月 | Microsoft Graph API エンドポイントを利用するように更新。 | +| 2017 年 1 月 | 本コード サンプルの最初のパブリック リリース。 | + +### その他のリソース + +- [dev.onenote.com](http://dev.onenote.com) デベロッパー センターをご覧ください +- [StackOverflow (tagged OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) でご質問を受け付けています +- Twitter でフォローしてください ([@onenotedev](http://www.twitter.com/onenotedev)) +- [OneNote の開発者ブログ](http://go.microsoft.com/fwlink/?LinkID=390183)をご覧ください +- [Graph エクスプローラー](https://developer.microsoft.com/ja-jp/graph/graph-explorer)を使用して API をより深く知ってください +- [API リファレンス](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/resources/notes) ドキュメント +- [既知の問題](https://developer.microsoft.com/ja-jp/graph/docs/overview/release_notes) +- Microsoft Graph API の[使用を開始する](https://developer.microsoft.com/ja-jp/graph/docs/get-started/get-started) + +このプロジェクトでは、[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) までお問い合わせください。 diff --git a/README-Localized/Readme-pt-br.md b/README-Localized/Readme-pt-br.md new file mode 100644 index 0000000..faa4872 --- /dev/null +++ b/README-Localized/Readme-pt-br.md @@ -0,0 +1,90 @@ +Amostra principal de API ASP.NET do serviço OneNote +--------------------------------------- + +Criado pela Microsoft Corporation, 2017. Fornecido como está sem garantia. As marcas comerciais mencionadas aqui pertencem aos proprietários. + +DEMO: https://onenoteapisamplegraph.azurewebsites.net + +### Introdução + +- Este é um exemplo pequeno que mostra como usar o acesso a recursos do OneNote por meio da API do Microsoft Graph a partir de um servidor ASP.NET. + +### Pré-requisitos + +**Ferramentas e Bibliotecas** que serão necessárias baixar, instalar e configurar para o seu ambiente de desenvolvimento. + +* [Atualização 3 do Visual Studio 2015](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. Clique em "como instalar uma versão específica do Visual Studio": + + ![Baixar versões anteriores do Visual Studio](./images/HowToInstall.png) + + 2. Clique em "My.VisualStudio.com": + + ![Clique em "My.VisualStudio.com"](./images/InstallingEarlierReleases.png) + + 3. [Baixe Visual Studio Enterprise 2015 com Atualização 3](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015) (registrado com uma conta MSFT) + + ![Instalando versões anteriores](./images/VisualStudioEnterpriseSearch.png) + +* [SDK do ASP.NET Core (para .NET Core 1.0)](https://www.microsoft.com/net/download/core) + +* [Ferramentas do Visual Studio 2015](https://www.microsoft.com/net/download/core) + + ![Instalar Ferramentas do Visual Studio](./images/VisualStudioToolsInstall.png) + +### Usando a amostra + +Depois de configurar as ferramentas de desenvolvimento, e instalar os pré-requisitos listados acima,.... + +1. Baixe este repositório no formato de arquivo ZIP para o seu computador local e extraia os arquivos. Ou clone o repositório em uma cópia local do Git. +2. Abra o projeto (arquivo .sln) no Visual Studio. +3. É altamente recomendável que você obtenha seu próprio ID de cliente, segredo e uri de redirecionamento e copie-o para o [Config.cs](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9). Você pode obter sua appid, o segredo do aplicativo e o URI de redirecionamento [aqui](http://developer.microsoft.com/pt-br/graph/docs/authorization/auth_register_app_v2) +4. Para o desenvolvimento local, o exemplo usa o http://localhost:5001/callback.php como URI de redirecionamento. Para produção, você deve alterar isso para apontar para o domínio do aplicativo. >Observação: O Chrome e o Firefox não permitem que os cookies sejam configurados no localhost, e a autenticação não funcionará nesses navegadores durante o desenvolvimento, caso você opte por redirecionar para o localhost. +5. Verifique se você selecionou a configuração "OneNoteApiSample" ao iniciar o aplicativo localmente. Ver [captura de tela](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG). +6. Crie e execute o aplicativo (F5) + +### Conteúdo + +Você pode encontrar mais informações nos links abaixo. + +- Criar páginas: + - [POSTAR HTML simples em uma nova página do OneNote QuickNotes](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/notes_post_pages) +- Páginas de consulta e pesquisa: + - [OBTER uma lista de todas as páginas paginadas no OneNote](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/notes_list_pages) +- Gerenciar com blocos de anotações e seções: + - [OBTER uma lista de todos os blocos de anotações](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [OBTER uma lista de todas as seções](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/notes_list_sections) + +#### Observação + +Como exemplo, e para simplificação, este exemplo não segue as práticas recomendadas para um aplicativo em Produção. Se você pretende enviar esse código, recomendamos fazer o seguinte: + +- Nunca faça check-in dos segredos do aplicativo no repositório +- Exigir HTTPS em todo o site +- Não armazenar tokens de atualização sem criptografia em cookies + +- **Pacotes NuGet** usados no exemplo. Eles são tratados usando o gerenciador de pacotes, conforme descrito nas instruções de instalação. Esses devem ser atualizados automaticamente no momento da compilação. caso contrário, certifique-se de que o gerenciador de pacotes do NuGet está atualizado. Você pode saber mais sobre os pacotes que usamos, nos links abaixo. + + - [O pacote Newtonsoft Json.NET](http://newtonsoft.com/) fornece utilitários de análise de Json. + - Outros pacotes NuGet da Microsoft, listados no project.json + +### Informações de Versão + +| Data | Alterar | +|------------|--------------------------------------------------------------------------------| +| Maio de 2017 | Atualizado para usar o URL básica do Microsoft Graph v1.0 para recursos do OneNote | +| Março de 2017 | Atualizado para utilizar os pontos de extremidade de API do Microsoft Graph. | +| Janeiro de 2017 | Versão pública inicial deste exemplo de código. | + +### Saiba mais + +- Visite o Centro de Desenvolvimento do[dev.onenote.com](http://dev.onenote.com) +- Fale conosco na [StackOverflow (marcado OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Siga-nos em [@onenotedev Twitter](http://www.twitter.com/onenotedev) +- Leia nosso blog [OneNote Developer](http://go.microsoft.com/fwlink/?LinkID=390183) +- Explore as API usando o [Explorador do Graph](https://developer.microsoft.com/pt-br/graph/graph-explorer) +- Documentação de [referência da API](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/resources/notes) +- [Problemas conhecidos](https://developer.microsoft.com/pt-br/graph/docs/overview/release_notes) +- [Introdução](https://developer.microsoft.com/pt-br/graph/docs/get-started/get-started) com a API do Microsoft Graph + +Este projeto adotou o [Código de conduta do código-fonte da Microsoft Open](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. diff --git a/README-Localized/Readme-ru-ru.md b/README-Localized/Readme-ru-ru.md new file mode 100644 index 0000000..98eda45 --- /dev/null +++ b/README-Localized/Readme-ru-ru.md @@ -0,0 +1,90 @@ +Пример использования API OneNote для ASP.NET Core +--------------------------------------- + +Создано Microsoft Corporation, 2017. Предоставляется как есть без гарантии. Товарные знаки, упомянутые в этой статье, являются собственностью их владельцев. + +Демоверсия: https://onenoteapisamplegraph.azurewebsites.net + +### Введение + +- В этом небольшом примере показано, как использовать доступ к ресурсам OneNote через API Microsoft Graph с сервера ASP.NET. + +### Необходимые компоненты + +**Инструменты и библиотеки**, которые требуется скачать, установить и настроить для среды разработки + +* [Обновление 3 для Visual Studio 2015](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. Выберите "Установка специального выпуска Visual Studio": + + ![Скачайте более раннюю версию Visual Studio](./images/HowToInstall.png) + + 2. Выберите "My.VisualStudio.com": + + ![Выберите "My.VisualStudio.com"](./images/InstallingEarlierReleases.png) + + 3. [Скачать Visual Studio Enterprise 2015 с обновлением 3](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015) (вход в с помощью учетной записи MSFT) + + ![Установка более ранних выпусков](./images/VisualStudioEnterpriseSearch.png) + +* [Пакет SDK для ASP.NET Core (для .NET Core 1.0)](https://www.microsoft.com/net/download/core) + +* [Инструменты Visual Studio 2015](https://www.microsoft.com/net/download/core) + + ![Установка инструментов Visual Studio](./images/VisualStudioToolsInstall.png) + +### Использование примера + +После настройки инструментов разработки и установки описанных выше необходимых компонентов… + +1. Скачайте репозиторий в виде ZIP-архива на локальный компьютер и извлеките из него файлы. Вы также можете клонировать репозиторий в локальную копию GIT. +2. Откройте проект (SLN-файл) в Visual Studio. +3. Настоятельно рекомендуется получить собственный идентификатор клиента, секрет и URI перенаправления и скопировать их в [Config.cs](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9). Вы можете получить собственный идентификатор приложения, секрет и URI перенаправления [здесь](http://developer.microsoft.com/ru-ru/graph/docs/authorization/auth_register_app_v2) +4. Для локальной разработки в примере используется URI перенаправления http://localhost:5001/msgraphoauthcallback. Для рабочей среды этот адрес должен указывать на домен вашего приложения. >Примечание. Chrome и Firefox не позволяют устанавливать файлы cookie на localhost. Если вы решите перенаправить на localhost, проверка подлинности не будет выполняться в этих браузерах во время разработки. +5. При локальном запуске приложения убедитесь, что выбрана конфигурация "OneNoteApiSample". См. [снимок экрана](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG). +6. Выполните сборку и запуск приложения (F5) + +### Содержимое + +Дополнительные сведения можно найти по ссылкам ниже. + +- Создание страниц: + - [Поместить простой HTML на новую страницу быстрых заметок OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/notes_post_pages) +- Страницы запросов и поиска: + - [Получить список всех страниц в OneNote с разбивкой на страницы](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/notes_list_pages) +- Управление записными книжками и разделами: + - [Получить список всех записных книжек](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [Получить список всех разделов](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/notes_list_sections) + +#### Примечание + +Для простоты в этом примере не учитываются рекомендации по использованию приложения в рабочей среде. Если вы планируете предоставить этот код клиентам, рекомендуется сделать следующее: + +- Никогда не записывайте секреты приложения в репозиторий после изменения +- Требуйте протокол HTTPS на сайте +- Не храните незашифрованные маркеры обновления в файлах cookie + +- В примере используются **пакеты NuGet**. Они обрабатываются с помощью диспетчера пакетов, как описано в инструкциях по настройке. Пакеты должны обновляться автоматически во время построения; в противном случае убедитесь, что диспетчер пакетов NuGet обновлен. Дополнительные сведения об использованных пакетах см. по ссылкам ниже. + + - [Пакет Newtonsoft Json.NET](http://newtonsoft.com/) предоставляет служебные программы синтаксического анализа Json. + - Другие пакеты NuGet от Майкрософт, перечисленные в файле project.json + +### Сведения о версии + +| Дата | Изменить | +| -------------- | ---------------------------------- ---------------------------------------------- | +| Май 2017 г. | Обновлена для использования базового URL-адреса Microsoft Graph версии 1.0 для ресурсов OneNote | +| Март 2017 г. | Обновлена для использования конечных точек API Microsoft Graph. | +| Январь 2017 г. | Начальный общедоступный выпуск для этого примера кода. | + +### Дополнительные учебные материалы + +- Посетить центр разработчиков [dev.onenote.com](http://dev.onenote.com) +- Свяжитесь с нами на сайте [StackOverflow (тег OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Подпишитесь на нас в [Twitter @onenotedev](http://www.twitter.com/onenotedev) +- Читайте наш [блог для разработчиков OneNote](http://go.microsoft.com/fwlink/?LinkID=390183) +- Исследуйте API с помощью [Graph Explorer](https://developer.microsoft.com/ru-ru/graph/graph-explorer) +- [Справочная документация по API](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/resources/notes) +- [Известные проблемы](https://developer.microsoft.com/ru-ru/graph/docs/overview/release_notes) +- [Начало работы](https://developer.microsoft.com/ru-ru/graph/docs/get-started/get-started) с Microsoft Graph API + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [часто задаваемых вопросов о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). diff --git a/README-Localized/Readme-zh-cn.md b/README-Localized/Readme-zh-cn.md new file mode 100644 index 0000000..462b2af --- /dev/null +++ b/README-Localized/Readme-zh-cn.md @@ -0,0 +1,90 @@ +OneNote 服务 API ASP.NET 核心示例 +--------------------------------------- + +由 Microsoft Corporation 创建，2017。按原样提供，不做保证。此处提及的商标是其所有者的财产。 + +演示：https://onenoteapisamplegraph.azurewebsites.net + +### 简介 + +- 这是一个小示例，展示如何通过 Microsoft Graph API 从 ASP.NET 服务器访问 OneNote 资源。 + +### 先决条件 + +针对开发环境，需要下载、安装并配置**工具和库** + +* [Visual Studio 2015 更新 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) + 1. 单击“如何安装指定版本的 Visual Studio”： + + ![下载早期版本的 Visual Studio](./images/HowToInstall.png) + + 2. 单击“My.VisualStudio.com”： + + ![单击“My.VisualStudio.com”](./images/InstallingEarlierReleases.png) + + 3. [下载有更新 3 的 Visual Studio Enterprise 2015](https://my.visualstudio.com/downloads?q=visual%20studio%20enterprise%202015)（使用 MSFT 账户登录） + + ![安装早期版本](./images/VisualStudioEnterpriseSearch.png) + +* [ASP.NET Core SDK （适用于 .NET Core 1.0）](https://www.microsoft.com/net/download/core) + +* [Visual Studio 2015 工具](https://www.microsoft.com/net/download/core) + + ![Visual Studio 工具安装](./images/VisualStudioToolsInstall.png) + +### 使用示例 + +设置完开发工具、安装上述先决条件后，... + +1. 将此存储库以 ZIP 文件格式下载到本地计算机，并解压缩文件。或者将存储库克隆至 Git 的本地副本中。 +2. 在 Visual Studio 中打开项目（.sln 文件）。 +3. 强烈建议获取自己的客户端 ID、密码和重新向 URL 并复制至 [Config.cs](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/src/OneNoteApiSample/Config.cs#L9)中。你可[点击这里](http://developer.microsoft.com/zh-cn/graph/docs/authorization/auth_register_app_v2)获取自己的客户端 ID、密码和重新向 URL。 +4. 对于本地开发，示例使用 http://localhost:5001/msgraphoauthcallback 作为重定向 URI。对于生产，应将其更改为指向应用程序域。>注意：Chrome 和 Firefox 不允许对 localhost 设置 cookie，因此如果选择重定向到 localhost，则在开发过程中无法对这些浏览器进行身份验证。 +5. 确保本地启动应用时，已选定“OneNoteApiSample”配置。参见“[截屏](https://github.com/OneNoteDev/OneNoteApiSampleAspNetCore/blob/master/images/OneNoteApiSampleConfiguration.PNG)”。 +6. 构建并运行应用程序（F5） + +### 内容 + +可在下面链接中找到附加文档。 + +- 创建页面： + - [向新 OneNote QuickNotes 页面发布简单的 HTML](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/notes_post_pages) +- 查询和搜索页面： + - [获取 OneNote 所有页面的分页列表](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/notes_list_pages) +- 管理笔记本和分区： + - [获取所有笔记本的列表](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/notes_list_notebooks) + - [获取所有分区的列表](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/notes_list_sections) + +#### 备注 + +作为示例，并且为了简单起见，此示例并未遵循生产中应用程序的最佳做法。如果想要发布此代码，建议执行以下操作： + +- 请勿签入应用程序密码至存储库 +- 网站需要 HTTPS +- 请勿存储未加密的刷新令牌至 cookie 中 + +- 示例中使用的**NuGet 包**。这些使用程序包管理器进行处理，详见“安装说明”。它们应在生成时自动更新，确保 NuGet 程序包管理器为最新版。可详细了解我们在以下链接使用的程序包。 + + - [Newtonsoft Json.NET 程序包](http://newtonsoft.com/) 提供 Json 解析实用工具。 + - 其他 Nuget 程序包，在 project.json 中列出 + +### 版本信息 + +|日期 |更改 | +|--------------|--------------------------------------------------------------------------------| +| 2017年5月 | 更新以利用适用于 OneNote 资源的 Microsoft Graph v 1.0 基准 URL | +| 2017 年 3 月 | 更新以利用 Microsoft Graph API 端点。| +| 2017 年 1 月| 此代码示例的初始公共发布。| + +### 了解更多内容 + +- 访问 [dev.onenote.com](http://dev.onenote.com) 开发中心 +- 访问 [StackOverflow（已标记的 OneNote）](http://go.microsoft.com/fwlink/?LinkID=390182)联系我们 +- 在 [Twitter @onenotedev](http://www.twitter.com/onenotedev) 中关注我们 +- 阅读我们的 [OneNote 开发者博客](http://go.microsoft.com/fwlink/?LinkID=390183) +- 请在 [Graph 浏览器](https://developer.microsoft.com/zh-cn/graph/graph-explorer)中探索 API +- [API 参考](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/resources/notes)文档 +- [已知问题](https://developer.microsoft.com/zh-cn/graph/docs/overview/release_notes) +- Microsoft Graph API [入门](https://developer.microsoft.com/zh-cn/graph/docs/get-started/get-started) + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅[行为准则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。