Skip to content
This repository was archived by the owner on Jul 22, 2024. It is now read-only.

HB of localized readme files #5

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
82 changes: 82 additions & 0 deletions README-Localized/Readme-es-es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
Ejemplo Léame de PHP de la API de OneNote en Microsoft Graph
---------------------------------------------

Creado por Microsoft Corporation, 2017. Se proporciona tal cual sin garantía. Las marcas comerciales que se mencionan aquí pertenecen a sus propietarios.

### La funcionalidad de la API que se muestra en este ejemplo

En este ejemplo, se tratan los siguientes aspectos de la API. Puede encontrar documentación adicional en los siguientes vínculos.

- [Iniciar sesión de usuario](https://developer.microsoft.com/es-es/graph/docs/authorization/app_authorization)
- [Obtener las páginas de OneNote de un usuario](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/page_get)
- [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)
- [Publicar mensaje de varias partes con datos de imagen incluidos en la solicitud*](http://msdn.microsoft.com/es-es/library/office/dn575432.aspx)
- [Publicar página con una URL representada como una imagen*](http://msdn.microsoft.com/es-es/library/office/dn575431.aspx)
- [Publicar página con HTML representado como una imagen*](http://msdn.microsoft.com/es-es/library/office/dn575432.aspx)
- [Publicar página con un archivo PDF representado y adjunto*](http://msdn.microsoft.com/es-es/library/office/dn655137.aspx)

\* Indica la documentación de las solicitudes de publicación de varias partes a la API de OneNote antes de su integración en la API de Microsoft Graph. La documentación de los ejemplos de solicitud detallados funciona a partir de la producción de este ejemplo, pero tenga en cuenta que pueden producirse cambios.

### Requisitos previos

**Herramientas y bibliotecas** que tendrá que descargar, instalar y configurar en el entorno de desarrollo.

El ejemplo de PHP se ejecuta en un servidor web. El navegador del cliente debe poder acceder al servidor web para completar el protocolo de enlace. Asegúrese de instalar los archivos PHP para que:

- El servidor web que está usando sea accesible desde Internet
- El servidor web tenga PHP instalado, con el paquete cURL activado
- Tenga una dirección URL normal con un nombre de host (no solo una dirección IP) para usar para la URL de redireccionamiento. Si lo ejecuta desde su propio escritorio, tendrá que modificar el archivo de hosts (en C:\\Windows\\System32\\drivers\\etc para equipos Windows y /private/etc para Mac) y asignar la dirección IP del servidor local a un nuevo nombre de dominio, como en el ejemplo siguiente. ![Modificar el archivo de hosts y asignar la dirección IP del servidor local a un nuevo nombre de dominio](images/HostsFile.png)

**Cuentas**

- Como desarrollador, necesitará [tener una cuenta de Microsoft y obtener una cadena de Id. de cliente](http://msdn.microsoft.com/es-es/library/office/dn575426.aspx) para que su aplicación pueda autenticarse con el punto de conexión de Microsoft Azure AD v2.0.
- Como usuario del ejemplo, necesitará una cuenta de Microsoft (Azure AD/Id. org. o una cuenta MSA) para que la API de OneNote pueda enviar las páginas a OneDrive.

### Registrar el ejemplo

Después de configurar su servidor web descrito anteriormente,....

1. Clone el repositorio de Git en una carpeta del equipo local.
2. Vaya a la [página de registro de aplicaciones de Microsoft](https://account.live.com/developers/applications/index).
3. Es altamente recomendado que obtenga su propio Id. de cliente, secreto de cliente y URI de redireccionamiento. Puede obtener su propio Id. de cliente, secreto de cliente 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:8888/callback.php como URI de redireccionamiento. Para producción, debe cambiar esta para indicar el dominio de la aplicación en la implementación hospedada. Si la dirección URL de implementación raíz es https://onenoteapisamples.com, especifique https://onenoteapisamples.com/callback.php como la URL de redireccionamiento (como en el ejemplo siguiente). Esta dirección URL debe coincidir exactamente con la URL de redireccionamiento implementado. El nombre de dominio raíz tiene que ser único, por lo que si usa un dominio para pruebas y otro para producción, tendrá que registrar los Id. de cliente y secretos de cliente separados para cada dominio.[Especificar la configuración de API en el Portal de registro de aplicaciones de Microsoft](images/OneNoteMSAScreen.png)
>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.

### Configurar el ejemplo

1. Reemplace los siguientes marcadores de posición en los archivos callback.php e index.php con los valores asociados de la página Configuración de la aplicación:
1. Reemplace CLIENT\_ID por el valor de Id. de cliente.
2. Reemplace CLIENT\_SECRET por el valor de secreto de cliente.
3. Reemplace REDIRECT\_URI\_PATH por el valor de la dirección URL raíz de la implementación. La dirección URL raíz de la implementación consiste en "http://" más la URL del dominio raíz, por lo que si la URL de redireccionamiento es como http://onenoteapisamples.com/callback.php, la dirección URL raíz de la implementación es "http://onenoteapisamples.com". En tiempo de ejecución, el valor URL de redireccionamiento se resolverá como "http://onenoteapisamples.com/callback.php".
2. Coloque los archivos de ejemplo en el directorio raíz de su servidor web.
3. Abra un navegador y vaya a la página .php predeterminada.
4. Inicie sesión con su cuenta de Microsoft y permita que la aplicación cree páginas en los blocs de notas de OneNote.

### Información de versión


### Información de versión

| Fecha | Modificación |
|--------------|--------------------------------------------------------------------------------|
| mayo de 2017 | Actualizado para utilizar la URL base de Microsoft Graph v1.0 para recursos de OneNote |
| abril de 2017 | Actualizado para utilizar los puntos de conexión de la API de Microsoft Graph. |
| mayo de 2014 | Versión pública inicial para este ejemplo de código. |

### Problemas conocidos

- Si está ejecutando el ejemplo en un servidor web en una red doméstica, y no tiene una dirección IP fija y un nombre de dominio asignado, es posible que deba usar un proveedor DDNS y, a continuación, reenviar los puertos HTTP/S a su servidor local.
- Los archivos PHP en este ejemplo contienen finales de línea CRLF. Tendrá que conservar estos finales de línea cuando abra y edite estos archivos en el editor. Consulte [Manejo de finales de línea](https://help.github.com/articles/dealing-with-line-endings#platform-all) para obtener instrucciones sobre cómo conservar los finales de línea CRLF en todas las plataformas.

### 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.
82 changes: 82 additions & 0 deletions README-Localized/Readme-fr-fr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
LISEZMOI de l’exemple PHP de OneNote API Microsoft Graph – Graphique
---------------------------------------------

Créé par Microsoft Corporation, 2017. Fourni en l’état sans garantie. Les marques mentionnées ici sont la propriété de leurs propriétaires.

### Fonctionnalité de l’API illustrée dans cet exemple

Les aspects suivants de l’API sont décrits dans cet exemple. Vous trouverez des informations supplémentaires via les liens ci-dessous.

- [Connecter l'utilisateur](https://developer.microsoft.com/fr-fr/graph/docs/authorization/app_authorization)
- [OBTENIR les pages OneNote d’un utilisateur](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/page_get)
- [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)
- [PUBLIER un message en plusieurs parties avec des données d’image incluses dans la demande*](http://msdn.microsoft.com/fr-fr/library/office/dn575432.aspx)
- [PUBLIER une page avec une URL générée comme image*](http://msdn.microsoft.com/fr-fr/library/office/dn575431.aspx)
- [PUBLIER une page avec du HTML généré comme image*](http://msdn.microsoft.com/fr-fr/library/office/dn575432.aspx)
- [PUBLIER une page avec un fichier PDF généré et joint*](http://msdn.microsoft.com/fr-fr/library/office/dn655137.aspx)

\* Indique la documentation pour les demandes de publication en plusieurs parties à l’API OneNote avant son intégration dans l’API Microsoft Graph – Graphique. La documentation relative aux exemples de demande décrits s’applique dès la production de cet exemple, mais sachez que des modifications peuvent être apportées prochainement.

### Conditions préalables

**Outils et bibliothèques** que vous devrez télécharger, installer et configurer pour votre environnement de développement.

L’exemple PHP s’exécute sur un serveur Web. Le navigateur client doit pouvoir accéder au serveur Web pour terminer le protocole de transfert. Veillez à installer les fichiers PHP de manière que :

- Le serveur Web que vous utilisez soit accessible à partir d’Internet
- PHP soit installé sur le serveur Web, avec le paquet cURL activé
- Vous ayez une URL normale avec nom d’hôte (et non une adresse IP uniquement) à utiliser pour l’URL de redirection. Si vous exécutez celle-ci à partir de votre ordinateur de bureau, vous devez modifier le fichier d’hôte (dans C:\\Windows\\System32\\drivers\\etc pour les ordinateurs Windows et /private/etc pour les ordinateurs Mac), puis mapper l’adresse IP de votre serveur local vers un nouveau nom de domaine, comme dans l’exemple suivant. ![Modifiez votre fichier hôte et mappez l’adresse IP de votre serveur local vers un nouveau nom de domaine](images/HostsFile.png)

**Comptes**

- En tant que développeur, vous devez [disposer d’un compte Microsoft et obtenir une chaîne d’ID client](http://msdn.microsoft.com/fr-fr/library/office/dn575426.aspx) pour votre application puisse s’authentifier avec le point de terminaison Microsoft Azure AD v2.0.
- En tant qu’utilisateur de l’exemple, vous devez posséder un compte Microsoft (Azure AD/ID d’organisation ou d’un compte MSA) pour que l’API OneNote puisse envoyer les pages vers votre espace OneDrive.

### Inscrire l’exemple

Une fois que vous avez configuré le serveur Web décrit ci-dessus,...

1. Clonez le référentiel Git dans un dossier sur votre ordinateur local.
2. Accédez à la [page d’inscription des applications Microsoft](https://account.live.com/developers/applications/index).
3. Nous vous recommandons vivement de vous procurer votre propre ID client, clé secrète et URI de redirection. Vous pouvez vous procurer l’ID client, la clé secrète client 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:8888/callback.php comme URI de redirection. Pour la production, vous devez modifier ce protocole pour qu'il pointe vers votre domaine d'application sur le déploiement hébergé. Si l’URL du déploiement racine est https://onenoteapisamples.com, alors spécifiez https://onenoteapisamples.com/callback.php comme URL de redirection (comme dans l’exemple suivant). Cette URL doit correspondre exactement à l’URL de redirection déployée. Le nom de domaine racine doit être unique. Par conséquent, si vous utilisez un domaine à des fins de test et un autre pour la production, vous devez inscrire des ID clients distincts et des clés secrètes pour chaque domaine.[Spécifiez les paramètres de l’API dans le portail d’inscription des applications Microsoft](images/OneNoteMSAScreen.png)
>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.

### Configurer l’exemple

1. Remplacez les espaces réservés suivants dans les fichiers callback.php et index.php avec les valeurs associées à partir de la page Paramètres de l’application :
1. Remplacez CLIENT\_ID par la valeur ID client.
2. Remplacez CLIENT\_SECRET par la valeur de clé secrète client.
3. Remplacez REDIRECT\_URI\_PATH par la valeur de l’URL racine de déploiement. L’URL racine de déploiement se compose de « http:// » et l’URL de domaine racine. Par conséquent, si votre URL de redirection ressemble à http://onenoteapisamples.com/callback.php, l’URL racine de déploiement est « http://onenoteapisamples.com ». Au moment de l’exécution, la valeur de l’URL de redirection correspond à « http://onenoteapisamples.com/callback.php ».
2. Mettez les fichiers d'exemple dans le répertoire racine de votre serveur web.
3. Ouvrez un navigateur et accédez à la page .php par défaut.
4. Connectez-vous à l’aide du compte Microsoft et autorisez l’application à créer des pages dans vos blocs-notes OneNote.

### Informations relatives à la version


### Informations relatives à la version

| Date | Modifier |
|--------------|--------------------------------------------------------------------------------|
| Mai 2017 | Mise à jour pour utiliser l'URL de base de Microsoft Graph – Graphique v1.0 pour les ressources OneNote |
| Avril 2017 | Mise à jour pour utiliser les points de terminaison de l'API de Microsoft Graph. |
| Mai 2014 | Version publique initiale de cet exemple de code. |

### Problèmes connus

- Si vous exécutez l’exemple sur un serveur Web sur un réseau domestique et que vous n’avez pas d’adresse IP fixe et de nom de domaine attribué, vous devez peut-être utiliser un fournisseur DDNS, puis transférer les ports HTTP/S vers votre serveur local.
- Dans cet exemple, les fichiers PHP contiennent des fins de ligne CRLF. Vous devez conserver ces fins de ligne lorsque vous ouvrez et modifiez ces fichiers dans votre éditeur. Consultez la rubrique [Traitement des fins de ligne](https://help.github.com/articles/dealing-with-line-endings#platform-all) pour savoir comment conserver les fins de ligne CRLF sur toutes les plateformes.

### Pour 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