Skip to content
This repository has been archived by the owner on Feb 15, 2024. It is now read-only.

HB of localized Readme #4

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

HB of localized Readme #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 90 additions & 0 deletions README-Localized/Readme-es-es.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 [[email protected]](mailto:[email protected]) si tiene otras preguntas o comentarios.
90 changes: 90 additions & 0 deletions README-Localized/Readme-fr-fr.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 [[email protected]](mailto:[email protected]) pour toute question ou tout commentaire.
Loading