From 6b241c5c37839ad8715e6879d4de5c99f2f821b9 Mon Sep 17 00:00:00 2001 From: OfficeGlobal Date: Fri, 28 Feb 2020 15:26:43 +0100 Subject: [PATCH] HB of localized readme files --- README-Localized/README-es-es.md | 229 +++++++++++++++++++++++++++++++ README-Localized/README-fr-fr.md | 229 +++++++++++++++++++++++++++++++ README-Localized/README-ja-jp.md | 229 +++++++++++++++++++++++++++++++ README-Localized/README-pt-br.md | 229 +++++++++++++++++++++++++++++++ README-Localized/README-ru-ru.md | 229 +++++++++++++++++++++++++++++++ README-Localized/README-zh-cn.md | 229 +++++++++++++++++++++++++++++++ 6 files changed, 1374 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 000000000..de872586d --- /dev/null +++ b/README-Localized/README-es-es.md @@ -0,0 +1,229 @@ +# Biblioteca cliente de JavaScript de Microsoft Graph + +[![npm version badge](https://img.shields.io/npm/v/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) [![Travis](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript.svg?maxAge=86400)](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript) [![Known Vulnerabilities](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript/badge.svg?maxAge=86400)](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript) [![Licence](https://img.shields.io/github/license/microsoftgraph/msgraph-sdk-javascript.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![Downloads](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +La biblioteca cliente de JavaScript de Microsoft Graph es un envase reducido en torno a la API de Microsoft Graph que puede usarse en el lado del servidor y en el explorador. + +**¿Busca IntelliSense en los modelos (usuarios, grupos, etc.)? Vea el repositorio de [tipos de Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings).** + +[![Demostración de TypeScript](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## Instalación + +### Mediante npm + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +importe `@microsoft/microsoft-graph-client` en el módulo y también necesitará polyfills para capturar como [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch). + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### Mediante etiqueta de script + +Incluya [graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) en la página HTML. + +```HTML + +``` + +En caso de que el explorador no sea compatible con [Fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[support](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] o [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[support](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)], deberá usar polyfills como [github/fetch](https://github.com/github/fetch) para fetch y [es6-promise](https://github.com/stefanpenner/es6-promise) para promise. + +```HTML + + + + + + + + +``` + +## Introducción + +### 1. Registrar su aplicación + +Registre su aplicación para usar la API de Microsoft Graph con uno de los siguientes portales de autenticación compatibles: + +- [Portal de registro de aplicaciones de Microsoft](https://apps.dev.microsoft.com): Registre una nueva aplicación que funcione con cuentas de Microsoft y/o cuentas de la organización con el punto de conexión de autenticación V2 unificado. +- [Microsoft Azure Active Directory](https://manage.windowsazure.com): Registre una nueva aplicación en el espacio empresarial de Active Directory para dar soporte a los usuarios de cuentas profesionales o educativas de su espacio empresarial, o a varios espacios empresariales. + +### 2. Autenticarse para el servicio de Microsoft Graph + +La biblioteca cliente de JavaScript de Microsoft Graph tiene una implementación de adaptador ([ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)) para [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core) (biblioteca de autenticación de Microsoft) que se ocupa de recibir el `accessToken`. La biblioteca MSAL no se incluye con esta biblioteca, el usuario debe incluirla de forma externa (para incluir MSAL, consulte [esto](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)). + +> **Nota importante:** MSAL solo es compatible con las aplicaciones front-end, para la autenticación en el servidor tiene que implementar su propio AuthenticationProvider. Obtenga información acerca de cómo puede crear un [proveedor de autenticación personalizado](./docs/CustomAuthenticationProvider.md). + +#### Creación de una instancia de ImplicitMSALAuthenticationProvider en un entorno de explorador + +Consulte devDependencies en [package.json](./package.json) para ver la versión compatible de msal y actualícela a continuación. + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### Creación de una instancia de ImplicitMSALAuthenticationProvider en un entorno de nodo + +Consulte devDependencies en [package.json](./package.json) para ver la versión compatible de msal y actualícela a continuación. + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +El usuario puede integrar la biblioteca de autenticación preferida mediante la implementación de `IAuthenticationProvider` interfaz. Consulte la implementación de un [proveedor de autenticación personalizada](./docs/CustomAuthenticationProvider.md). + +### 3. Inicializar un objeto de cliente de Microsoft Graph con un proveedor de autenticación + +Una instancia de la clase **cliente** controla las solicitudes a la API de Microsoft Graph y procesa las respuestas. Para crear una nueva instancia de esta clase, tiene que proporcionar una instancia de [`IAuthenticationProvider`](src/IAuthenticationProvider.ts) que necesita pasarse como un valor para la clave `authProvider` en [`ClientOptions`](src/IClientOptions.ts) a un método de inicializador estático `Client.initWithMiddleware`. + +#### Para entornos de navegador + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### Para entornos de nodo + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +Para obtener más información sobre cómo inicializar el cliente, consulte [este documento](./docs/CreatingClientInstance.md). + +### 4. Realizar solicitudes a Graph + +Una vez que haya configurado la autenticación y una instancia del cliente, puede empezar a realizar llamadas al servicio. Todas las solicitudes deberían empezar con `client.api(path)` y terminar con una [acción](./docs/Actions.md). + +Obtención de detalles de usuario + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +Enviar un correo electrónico a los destinatarios + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +Para obtener más información, consulte: [Patrón de llamada](docs/CallingPattern.md), [acciones](docs/Actions.md), [parámetros de consulta](docs/QueryParameters.md), [métodos de la API](docs/OtherAPIs.md) y [más](docs/). + +## Documentación + +- [Procesamiento por lotes](docs/content/Batching.md) +- [Tarea de carga de archivos de gran tamaño](docs/tasks/LargeFileUploadTask.md) +- [Iterador de páginas](docs/tasks/PageIterator.md) +- [Acciones](docs/Actions.md) +- [Parámetros de consulta](docs/QueryParameters.md) +- [Otras API](docs/OtherAPIs.md) +- [Obtener respuesta sin procesar](docs/GettingRawResponse.md) + +## Preguntas y comentarios + +Nos encantaría recibir sus comentarios sobre la biblioteca cliente de JavaScript de Microsoft Graph. Puede enviarnos sus preguntas y sugerencias a través de la sección [Problemas](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues) de este repositorio. + +## Colaboradores + +Vea la [directrices de contribución](CONTRIBUTING.md). + +## Recursos adicionales + +- [Sitio web de Microsoft Graph](https://graph.microsoft.io) +- [Tipos de TypeScript de Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [Crear aplicaciones de página única en Angular con Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [Crear aplicaciones Node.js Express con Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Centro para desarrolladores de Office](http://dev.office.com/) + +## Avisos de terceros + +Consulte [avisos de terceros](./THIRD%20PARTY%20NOTICES) para obtener información sobre los paquetes que se incluyen en [package.json](./package.json) + +## Informes de seguridad + +Si encuentra un problema de seguridad con nuestras bibliotecas o servicios, informe a [secure@microsoft.com](mailto:secure@microsoft.com) con todos los detalles posibles. Es posible que el envío pueda optar a una recompensa a través del programa [Microsoft Bounty](http://aka.ms/bugbounty). No publique problemas de seguridad en problemas de GitHub ni ningún otro sitio público. Nos pondremos en contacto con usted rápidamente tras recibir la información. Le animamos a que obtenga notificaciones de los incidentes de seguridad que se produzcan; para ello, visite [esta página](https://technet.microsoft.com/en-us/security/dd252948) y suscríbase a las alertas de avisos de seguridad. + +## Licencia + +Copyright (c) Microsoft Corporation. Todos los derechos reservados. Publicado bajo la licencia MIT (la "[Licencia](./LICENSE)"). + +## Valoramos y nos adherimos al Código de conducta de código abierto de Microsoft + +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 000000000..465e6a911 --- /dev/null +++ b/README-Localized/README-fr-fr.md @@ -0,0 +1,229 @@ +# Bibliothèque cliente JavaScript Microsoft Graph + +[![badge version npm](https://img.shields.io/npm/v/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) [![Travis](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript.svg?maxAge=86400)](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript) [![Vulnérabilités connues](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript/badge.svg?maxAge=86400)](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript) [![Licence](https://img.shields.io/github/license/microsoftgraph/msgraph-sdk-javascript.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![style de code : plus beau](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![Téléchargements](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +La bibliothèque client JavaScript de Microsoft Graph est une enveloppe légère autour de l'API Microsoft Graph qui peut être utilisée côté serveur et dans le navigateur. + +**Vous recherchez IntelliSense sur les modèles (utilisateurs, groupes, etc.) ? Consultez les [types Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings) référentiel !** + +[![TypeScript demo](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## Installation + +### Via NPM + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +Importez `@microsoft/Microsoft-Graph-client` dans votre module. vous avez également besoin de polyremplissages pour la récupération tels que [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch). + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### Via la balise de script + +Incluez [graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) dans votre page HTML. + +```HTML + +``` + +Si votre navigateur ne prend pas en charge les fonctions [Récupérer](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[support](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] ou [Promesse](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[support](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)], vous devez utiliser des polyremplissages tels que [github/fetch](https://github.com/github/fetch) pour la récupération et [ES6 promise](https://github.com/stefanpenner/es6-promise) pour les promesses. + +```HTML + + + + + + + + +``` + +## Prise en main + +### 1. Inscription de votre application + +Enregistrez votre application à l’aide de l’un des portails d’authentification pris en charge suivants pour utiliser l'API Microsoft Graph : + +- [portail d’inscription des applications de Microsoft](https://apps.dev.microsoft.com) : Enregistrez une nouvelle application qui fonctionne avec des comptes Microsoft et/ou des comptes d’organisation à l’aide du point de terminaison d’authentification V2 unifié. +- [Microsoft Azure Active Directory](https://manage.windowsazure.com) : Enregistrez une nouvelle application dans l’annuaire Active Directory de votre locataire pour prendre en charge les utilisateurs professionnels ou scolaires de votre locataire ou de plusieurs clients. + +### 2. S'authentifier au service de Microsoft Graph + +La bibliothèque client JavaScript Microsoft Graph inclut une implémentation de carte ([ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)) pour [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core) (bibliothèque d’authentification Microsoft) qui prend en charge l’acquisition de `accessToken`. La bibliothèque MSAL n’est pas livrée avec cette bibliothèque, l’utilisateur doit l’inclure en externe (pour inclure MSAL, consultez [cet](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)). + +> **Remarque importante :** MSAL est pris en charge uniquement pour les applications frontend, pour l’authentification côté serveur, vous devez implémenter votre propre AuthenticationProvider. Découvrez comment créer un [fournisseur d’authentification personnalisée](./docs/CustomAuthenticationProvider.md). + +#### Création d’une instance de ImplicitMSALAuthenticationProvider dans l’environnement de navigateur + +Reportez-vous à devDependencies dans [package.json](./package.json) pour la version MSAL compatible et mettez à jour cette version dans la version suivante. + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### Création d’une instance de ImplicitMSALAuthenticationProvider dans l’environnement de nœud + +Reportez-vous à devDependencies dans [package.json](./package.json) pour la version MSAL compatible et mettez à jour cette version dans la version suivante. + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +Un utilisateur peut intégrer sa propre bibliothèque d’authentification par défaut en implémentant l’interface `IAuthenticationProvider`. Référez-vous à l’implémentation du [Fournisseur d’authentification personnalisé](./docs/CustomAuthenticationProvider.md). + +### 3. Initialiser un objet client Microsoft Graph avec un fournisseur d’authentification + +Une instance de la classe **Client** gère les demandes en les envoyant vers l’API Microsoft Graph et en traitant les réponses. Pour créer une instance de cette classe, vous devez fournir une instance de [`IAuthenticationProvider`](src/IAuthenticationProvider.ts) lequel doit être transmis sous la forme d’une valeur pour la clé `authProvider dans` [`ClientOptions`](src/IClientOptions.ts) à une méthode d'initialisation statique `Client.initWithMiddleware`. + +#### Pour l’environnement de navigateur + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### Pour l'environnement du nœud + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +Pour plus d'informations sur l'initialisation du client, consultez [ce document](./docs/CreatingClientInstance.md). + +### 4. Formuler des demandes auprès du Graph + +Une fois que vous disposez d’une configuration d’authentification et d’une instance de client, vous pouvez commencer à effectuer des appels vers le service. Toutes les demandes doivent commencer avec `client.api(path)` et se terminent par une [action](./docs/Actions.md). + +Obtenir les détails de l’utilisateur + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +Envoyez un courrier électronique aux destinataires + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +Pour plus d’informations, consultez : [Modèle d’appels](docs/CallingPattern.md), [Actions](docs/Actions.md), [Paramètres de requête](docs/QueryParameters.md)[Méthodes API](docs/OtherAPIs.md) et [plus](docs/). + +## Documentation + +- [Traitement par lots](docs/content/Batching.md) +- [Tâche de chargement d’un fichier volumineux](docs/tasks/LargeFileUploadTask.md) +- [Itérateur de page](docs/tasks/PageIterator.md) +- [Actions](docs/Actions.md) +- [ Paramètres de requête](docs/QueryParameters.md) +- [Autres API](docs/OtherAPIs.md) +- [Accès aux réponses brutes](docs/GettingRawResponse.md) + +## Questions et commentaires + +Nous serions ravis de connaître votre opinion sur la bibliothèque client JavaScript de Microsoft Graph. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique [Problèmes](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues) de ce référentiel. + +## Contribution + +Reportez-vous aux [instructions sur la contribution](CONTRIBUTING.md). + +## Ressources supplémentaires + +- [Site web Microsoft Graph](https://graph.microsoft.io) +- [Types TypeScript Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [Créez des applications page simple Angular avec Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [Créez des applications Node.js Express avec Microsoft Graph ](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Centre des développeurs Office](http://dev.office.com/) + +## Notifications tierces + +Consultez les [Notifications tierces](./THIRD%20PARTY%20NOTICES) pour des informations sur les paquets qui sont inclus dans le [package.json](./package.json) + +## Génération de rapports de sécurité + +Si vous rencontrez un problème de sécurité avec nos bibliothèques ou services, signalez-le à l’adresse [secure@microsoft.com](mailto:secure@microsoft.com) avec autant de détails que possible. Votre envoi vous donnera sans doute droit à une prime via le programme [Bounty de Microsoft](http://aka.ms/bugbounty). Merci de ne pas publier de problèmes de sécurité sur le site des problèmes GitHub ou sur un autre site public. Nous vous contacterons rapidement dès réception des informations. Nous vous encourageons à activer les notifications d’incidents de sécurité en vous rendant sur [cette page](https://technet.microsoft.com/en-us/security/dd252948) et en vous abonnant aux alertes d’avis de sécurité. + +## Licence + +Copyright (c) Microsoft Corporation. Tous droits réservés. Soumis à la licence MIT (la [« Licence](./LICENSE) ») ; + +## Nous respectons le code de conduite Open Source de Microsoft. + +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 000000000..9c347ef83 --- /dev/null +++ b/README-Localized/README-ja-jp.md @@ -0,0 +1,229 @@ +# Microsoft Graph JavaScript クライアント ライブラリ + +[![npm バージョン バッジ](https://img.shields.io/npm/v/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) [![Travis](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript.svg?maxAge=86400)](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript) [![既知の脆弱性](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript/badge.svg?maxAge=86400)](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript) [![ライセンス](https://img.shields.io/github/license/microsoftgraph/msgraph-sdk-javascript.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![コード スタイル: より見栄え良く](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![ダウンロード](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +Microsoft Graph JavaScript クライアント ライブラリは、Microsoft Graph API の軽量ラッパーであり、サーバー側およびブラウザー内で使用できます。 + +**モデル (ユーザー、グループなど) で IntelliSense を探していますか ?[Microsoft Graph Types](https://github.com/microsoftgraph/msgraph-typescript-typings) リポジトリをご覧ください !** + +[![TypeScript でも](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## インストール + +### npm 経由 + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +モジュールに `@microsoft/microsoft-graph-client` をインポートします。また、[isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch) のようなフェッチのためのポリフィルが必要になります。 + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### スクリプト タグ経由 + +[graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) を HTML ページに含めます。 + +```HTML + +``` + +ブラウザが [Fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[サポート](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] または [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[サポート](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)] をサポートしていない場合、フェッチには [github/fetch](https://github.com/github/fetch)、Promise には [es6-promise](https://github.com/stefanpenner/es6-promise) のようなポリフィルを使用する必要があります。 + +```HTML + + + + + + + + +``` + +## はじめに + +### 1.アプリケーションを登録する + +サポートされている次の認証ポータルのいずれかを使用して、Microsoft Graph API を使用するアプリケーションを登録します。 + +- [Microsoft アプリケーション登録ポータル](https://apps.dev.microsoft.com):統合 V2 認証エンドポイントを使用して、Microsoft アカウントや組織のアカウントで機能する新しいアプリケーションを登録します。 +- [Microsoft Azure Active Directory](https://manage.windowsazure.com)テナントまたは複数のテナントで職場または学校のユーザーをサポートするために、テナントの Active Directory に新しいアプリケーションを登録します。 + +### 2.Microsoft Graph サービスの認証 + +Microsoft Graph JavaScript クライアント ライブラリには、`accessToken` の取得を処理する [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core) (Microsoft Authentication Library) のアダプター実装 ([ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)) があります。MSAL ライブラリはこのライブラリに同梱されていません。ユーザーは外部でそれを含める必要があります (MSAL を含めるには、[こちら](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)を参照してください)。 + +> **重要なメモ:**MSAL は、フロントエンド アプリケーションでのみサポートされます。サーバー側の認証では、独自に AuthenticationProvider を実装する必要があります。[カスタム認証プロバイダー](./docs/CustomAuthenticationProvider.md)を作成する方法について説明します。 + +#### ブラウザー環境で ImplicitMSALAuthenticationProvider のインスタンスを作成する + +互換性のある MSAL バージョンについては、[package.json](./package.json) の devDependencies を参照し、以下でそのバージョンを更新してください。 + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### ノード環境で ImplicitMSALAuthenticationProvider のインスタンスを作成する + +互換性のある MSAL バージョンについては、[package.json](./package.json) の devDependencies を参照し、以下でそのバージョンを更新してください。 + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +ユーザーは `IAuthenticationProvider` インターフェイスを実装することにより、自分好みの認証ライブラリを統合できます。[カスタム認証プロバイダー](./docs/CustomAuthenticationProvider.md)の実装を参照してください。 + +### 3.認証プロバイダーで Microsoft Graph クライアント オブジェクトを初期化する + +**Client** クラスのインスタンスは、Microsoft Graph API への要求に対処し、応答を処理します。このクラスの新しいインスタンスを作成するには、[`ClientOptions`](src/IClientOptions.ts) の `authProvider` キーの値として静的初期化メソッド `Client.initWithMiddleware` に渡す必要がある [`IAuthenticationProvider`](src/IAuthenticationProvider.ts) のインスタンスを提供する必要があります。 + +#### ブラウザー環境の場合 + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### ノード環境の場合 + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +クライアントの初期化の詳細については、[こちらのドキュメント](./docs/CreatingClientInstance.md)を参照してください。 + +### 4.Graph への要求を実行する + +認証のセットアップとクライアントのインスタンスを用意したら、サービスの呼び出しを開始できます。すべてのリクエストは `client.api(path)` で始まり、[action](./docs/Actions.md) で終わる必要があります。 + +ユーザーの詳細の取得 + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +受信者にメールを送信する + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +詳細については、以下を参照してください:[呼び出しパターン](docs/CallingPattern.md)、[アクション](docs/Actions.md)、[クエリ パラメーター](docs/QueryParameters.md)、[API メソッド](docs/OtherAPIs.md)および[その他](docs/)。 + +## ドキュメント + +- [バッチ処理](docs/content/Batching.md) +- [大容量ファイルのアップロード タスク](docs/tasks/LargeFileUploadTask.md) +- [ページの反復子](docs/tasks/PageIterator.md) +- [アクション](docs/Actions.md) +- [クエリ パラメーター](docs/QueryParameters.md) +- [その他の API](docs/OtherAPIs.md) +- [Raw 応答の取得](docs/GettingRawResponse.md) + +## 質問とコメント + +Microsoft Graph JavaScript クライアント ライブラリに関するフィードバックをお寄せください。質問や提案につきましては、このリポジトリの「[問題](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues)」セクションで送信できます。 + +## 投稿 + +[投稿ガイドライン](CONTRIBUTING.md)を参照してください。 + +## その他のリソース + +- [Microsoft Graph Web サイト](https://graph.microsoft.io) +- [Microsoft Graph TypeScript 型](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [Microsoft Graph を使った Angular の単一ページ アプリの作成](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [Microsoft Graph を使った Node.js Express アプリの作成](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Office デベロッパー センター](http://dev.office.com/) + +## サードパーティについての通知 + +[package.json](./package.json) に含まれるパッケージの詳細については、[サードパーティについての通知](./THIRD%20PARTY%20NOTICES)を参照してください + +## セキュリティ レポート + +ライブラリまたはサービスでセキュリティに関する問題を発見した場合は、できるだけ詳細に [secure@microsoft.com](mailto:secure@microsoft.com) に報告してください。提出物は、[Microsoft Bounty](http://aka.ms/bugbounty) プログラムを通じて報酬を受ける対象となる場合があります。セキュリティの問題を GitHub の問題や他のパブリック サイトに投稿しないでください。情報を受け取り次第、ご連絡させていただきます。セキュリティの問題が発生したときに通知を受け取ることをお勧めします。そのためには、[このページ](https://technet.microsoft.com/en-us/security/dd252948)にアクセスし、セキュリティ アドバイザリ通知を受信登録してください。 + +## ライセンス + +Copyright (c) Microsoft Corporation。All rights reserved.MIT ライセンス ("[ライセンス](./LICENSE)") に基づいてライセンスされています。 + +## Microsoft Open Source Code of Conduct (Microsoft オープン ソース倫理規定) を尊重し、遵守します + +このプロジェクトでは、[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 000000000..1ee408fba --- /dev/null +++ b/README-Localized/README-pt-br.md @@ -0,0 +1,229 @@ +# Biblioteca do cliente Microsoft Graph JavaScript + +emblema da versão npm Travis Vulnerabilidades conhecidas Licença estilo do código: prettier [![Downloads](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +A biblioteca do cliente Microsoft Graph JavaScript é um invólucro leve em torno da API do Microsoft Graph, que pode ser usada no lado do servidor e no navegador. + +**Procurando o IntelliSense nos modelos (usuários, grupos, etc.)? Confira o](https://github.com/microsoftgraph/msgraph-typescript-typings) repositório [do Microsoft Graph Types!** + +[![Demonstração TypeScript ](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## Instalação + +### Via npm + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +importe `@microsoft/microsoft-graph-client` para o seu módulo e, além disso, você precisará de metapreenchimentos de busca, como [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch). + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### Via marca de script + +Inclua [graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) na página HTML. + +```HTML + +``` + +Caso o seu navegador não tenha suporte para [Buscar](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[suporte](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] ou [Prometer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[suporte](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)], você precisará usar o polipreenchimento, como [github/fetch](https://github.com/github/fetch) para a busca e [es6-promise](https://github.com/stefanpenner/es6-promise) para a promessa. + +```HTML + + + + + + + + +``` + +## Introdução + +### 1. Registre seu aplicativo + +Registre seu aplicativo para usar a API do Microsoft Graph usando um dos seguintes portais de autenticação com suporte: + +- Vá até o [](https://apps.dev.microsoft.com)Portal de Registro de Aplicativos da Microsoft: Registre um novo aplicativo que funcione com contas da Microsoft e/ou contas organizacionais usando o Ponto final de autenticação v2 unificado. +- [Microsoft Azure Active Directory](https://manage.windowsazure.com): Registre um novo aplicativo no Active Directory do locatário para oferecer suporte aos usuários corporativos ou estudantes para seu locatários ou vários locatários. + +### 2. Autentique o serviço do Microsoft Graph + +A biblioteca do cliente Microsoft Graph JavaScript possui uma implementação de adaptador ([ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)) para [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core) (Biblioteca de autenticação da Microsoft) que obtém o `accessToken`. A Biblioteca MSAL não é fornecida com essa biblioteca, o usuário deve incluí-la externamente (Para incluir MSAL, consulte [isso](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)). + +> **Observação importante:** O MSAL é suportado apenas por aplicativos frontend; para autenticação no servidor, você precisa implementar seu próprio AuthenticationProvider. Saiba como você pode criar um [Provedor de autenticação personalizado](./docs/CustomAuthenticationProvider.md). + +#### Crie uma instância do ImplicitMSALAuthenticationProvider no ambiente do navegador + +Consulte devDependencies no [package.json](./package.json) para a versão msal compatível e atualize essa versão no abaixo. + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### Crie uma instância do ImplicitMSALAuthenticationProvider no ambiente do navegador + +Consulte devDependencies no [package.json](./package.json) para a versão msal compatível e atualize essa versão no abaixo. + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +O usuário pode integrar a própria biblioteca de autenticação preferencial implementando a interface do `IAuthenticationProvider`. Consulte implementar [Provedor de autenticação personalizada](./docs/CustomAuthenticationProvider.md). + +### 3. Inicialize um objeto Microsoft Graph Client com um provedor de autenticação + +Uma instância da classe **Client** lida com solicitações à API do Microsoft Graph e processa as respostas. Para criar uma nova instância dessa classe, você precisa fornecer uma instância de IAuthenticationProvider que deve ser passada como um valor para a chave authProvider em Clienteoptions para um método inicializador estático `Client.initWithMiddleware`. + +#### Para o ambiente do navegador + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### Para o ambiente do nó + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +Para saber mais sobre a inicialização do cliente, confira [este documento](./docs/CreatingClientInstance.md). + +### 4. Fazer solicitações ao gráfico + +Depois de configurar a autenticação e uma instância do Cliente, você poderá começar a fazer chamadas para o serviço. Todas as solicitações devem começar com `client.api(path)` e terminar com uma [ação](./docs/Actions.md). + +Obter detalhes do usuário + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +Enviar um e-mail aos destinatários + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +Para obter mais informações, consulte: [Padrão da chamada](docs/CallingPattern.md), [Ações](docs/Actions.md), [Parâmetros de consulta](docs/QueryParameters.md), [Métodos API](docs/OtherAPIs.md) e [mais](docs/). + +## Documentação + +- [Envio em lote](docs/content/Batching.md) +- [Tarefa de carregar arquivos grandes](docs/tasks/LargeFileUploadTask.md) +- [Iterador de página](docs/tasks/PageIterator.md) +- [Ações](docs/Actions.md) +- [ Parâmetros de consulta](docs/QueryParameters.md) +- [Outras APIs](docs/OtherAPIs.md) +- [Obter uma resposta pura](docs/GettingRawResponse.md) + +## Perguntas e comentários + +Adoraríamos receber seus comentários sobre o projeto Biblioteca do cliente Microsoft Graph JavaScript. Você pode enviar perguntas e sugestões na seção [Problemas](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues) deste repositório. + +## Colaboração + +Confira as [diretrizes de colaboração](CONTRIBUTING.md). + +## Recursos adicionais + +- [](https://graph.microsoft.io)Website do Microsoft Graph +- [Tipos de TypeScript do Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [Criar aplicativos angulares de página simples com o Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [Criar aplicativos Node.js Express com o Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Centro de Desenvolvimento do Office](http://dev.office.com/) + +## Avisos de terceiros + +Consulte [Notificações de terceiros](./THIRD%20PARTY%20NOTICES) para obter mais informações sobre os pacotes que estão incluídos no [package.json](./package.json) + +## Relatórios de segurança + +Se você encontrar um problema de segurança com nossas bibliotecas ou serviços, informe-o em [secure@microsoft.com](mailto:secure@microsoft.com) com o máximo de detalhes possível. O seu envio pode estar qualificado para uma recompensa por meio do programa [Microsoft Bounty](http://aka.ms/bugbounty). Não poste problemas de segurança nos Problemas do GitHub ou qualquer outro site público. Entraremos em contato com você em breve após receber as informações. Recomendamos que você obtenha notificações sobre a ocorrência de incidentes de segurança visitando [esta página](https://technet.microsoft.com/en-us/security/dd252948) e assinando os alertas do Security Advisory. + +## Licença + +Copyright (c) Microsoft Corporation. Todos os direitos reservados. Licenciado sob a Licença MIT (a "[Licença](./LICENSE)"); + +## Valorizamos e cumprimos o Código de Conduta de Código Aberto da Microsoft + +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. diff --git a/README-Localized/README-ru-ru.md b/README-Localized/README-ru-ru.md new file mode 100644 index 000000000..e43fe89d9 --- /dev/null +++ b/README-Localized/README-ru-ru.md @@ -0,0 +1,229 @@ +# Клиентская библиотека JavaScript для Microsoft Graph + +[![Эмблема версии npm](https://img.shields.io/npm/v/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) [![Travis](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript.svg?maxAge=86400)](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript) [![Известные уязвимости](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript/badge.svg?maxAge=86400)](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript) [![Лицензия](https://img.shields.io/github/license/microsoftgraph/msgraph-sdk-javascript.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![Стиль кода: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![Загрузки](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +Клиентская библиотека JavaScript для Microsoft Graph — это компактная оболочка API Microsoft Graph, которую можно использовать на стороне сервера и в браузере. + +**Требуется IntelliSense для моделей (пользователи, группы и т. п.)? Ознакомьтесь с репозиторием [Microsoft Graph Types](https://github.com/microsoftgraph/msgraph-typescript-typings).** + +[![Демонстрация TypeScript](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## Установка + +### С помощью npm + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +Импортируйте `@microsoft/microsoft-graph-client` в модуль. Также потребуются полизаполнения для получения данных, например [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch). + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### С помощью тега Script + +Включите [graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) в страницу HTML. + +```HTML + +``` + +Если ваш браузер не поддерживает [Fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[поддержка](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] или [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[поддержка](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)], потребуется использовать полизаполнения, например [github/fetch](https://github.com/github/fetch) для fetch и [es6-promise](https://github.com/stefanpenner/es6-promise) для promise. + +```HTML + + + + + + + + +``` + +## Начало работы + +### 1. Зарегистрируйте приложение + +Зарегистрируйте приложение для использования API Microsoft Graph с помощью одного из следующих поддерживаемых порталов проверки подлинности. + +- [Портал регистрации приложений Майкрософт](https://apps.dev.microsoft.com). Зарегистрируйте новое приложение, работающее с учетными записями Майкрософт и/или с учетными записями организации, используя объединенную конечную точку проверки подлинности версии 2. +- [Microsoft Azure Active Directory](https://manage.windowsazure.com). Зарегистрируйте новое приложение в службе каталогов Active Directory клиента для поддержки пользователей рабочих или учебных учетных записей для одного или нескольких клиентов. + +### 2. Выполните проверку подлинности для службы Microsoft Graph + +В клиентской библиотеке JavaScript для Microsoft Graph есть реализация адаптера ([ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)) для [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core) (библиотека проверки подлинности Майкрософт), который получает `accessToken`. Библиотека MSAL не поставляется вместе с этой библиотекой, пользователю потребуется включить ее извне (сведения о включении MSAL см. [здесь](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)). + +> **Важное примечание.** MSAL поддерживается только для интерфейсных приложений. Для проверки подлинности на стороне сервера вам потребуется реализовать собственный поставщик AuthenticationProvider. Узнайте, как создать [настраиваемый поставщик проверки подлинности](./docs/CustomAuthenticationProvider.md). + +#### Создание экземпляра ImplicitMSALAuthenticationProvider в среде браузера + +См. devDependencies в [package.json](./package.json) для получения сведений о совместимой версии MSAL. Обновите эту версию ниже. + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### Создание экземпляра ImplicitMSALAuthenticationProvider в среде узла + +См. devDependencies в [package.json](./package.json) для получения сведений о совместимой версии MSAL. Обновите эту версию ниже. + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +Пользовать может реализовать предпочитаемую библиотеку проверки подлинности путем реализации интерфейса `IAuthenticationProvider`. См. сведения о реализации [настраиваемого поставщика проверки подлинности](./docs/CustomAuthenticationProvider.md). + +### 3. Инициализируйте клиентский объект Microsoft Graph с поставщиком проверки подлинности + +Экземпляр класса **Client** обрабатывает запросы к API Microsoft Graph и обработку ответов. Чтобы создать новый экземпляр этого класса, нужно предоставить экземпляр [`IAuthenticationProvider`](src/IAuthenticationProvider.ts), который необходимо передать в качестве значения для ключа `authProvider` в разделе [`ClientOptions`](src/IClientOptions.ts) статическому методу инициализатора `Client.initWithMiddleware`. + +#### Для среды браузера + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### Для среды узла + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +Сведения об инициализации клиента см. в [этом документе](./docs/CreatingClientInstance.md). + +### 4. Создайте запросы к Microsoft Graph + +После настройки проверки подлинности и экземпляра клиента можно начать вызывать службу. Все запросы должны начинаться с `client.api(путь)` и оканчиваться [действием](./docs/Actions.md). + +Получение сведений о пользователе + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +Отправка сообщения электронной почты получателям + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +Дополнительные сведения: [шаблон вызова](docs/CallingPattern.md), [действия](docs/Actions.md), [параметры запросов](docs/QueryParameters.md), [методы API](docs/OtherAPIs.md) и [прочее](docs/). + +## Документация + +- [Пакетная обработка](docs/content/Batching.md) +- [Задача отправки больших файлов](docs/tasks/LargeFileUploadTask.md) +- [Итератор страниц](docs/tasks/PageIterator.md) +- [Действия](docs/Actions.md) +- [Параметры запросов](docs/QueryParameters.md) +- [Прочие API](docs/OtherAPIs.md) +- [Получение необработанного ответа](docs/GettingRawResponse.md) + +## Вопросы и комментарии + +Мы будем рады узнать ваше мнение о клиентской библиотеке JavaScript для Microsoft Graph. Вы можете отправить нам вопросы и предложения в разделе [Проблемы](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues) этого репозитория. + +## Помощь + +См. [добавление рекомендаций](CONTRIBUTING.md). + +## Дополнительные ресурсы + +- [Веб-сайт Microsoft Graph](https://graph.microsoft.io) +- [Типы TypeScript в Microsoft Graph](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [Создание одностраничных приложений Angular с помощью Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [Создание приложений Node.js Express с помощью Microsoft Graph](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Центр разработчиков Office](http://dev.office.com/) + +## Уведомления третьих лиц + +См. раздел [Уведомления третьих лиц](./THIRD%20PARTY%20NOTICES) для получения сведений о пакетах, входящих в состав [package.json](./package.json) + +## Отчеты о безопасности + +Если вы столкнулись с проблемами безопасности наших библиотек или служб, сообщите о проблеме по адресу [secure@microsoft.com](mailto:secure@microsoft.com), добавив как можно больше деталей. Возможно, вы получите вознаграждение, в рамках программы [Microsoft Bounty](http://aka.ms/bugbounty). Не публикуйте ошибки безопасности в ошибках GitHub или на любом общедоступном сайте. Вскоре после получения информации, мы свяжемся с вами. Рекомендуем вам настроить уведомления о нарушениях безопасности. Это можно сделать, подписавшись на уведомления безопасности консультационных служб на [этой странице](https://technet.microsoft.com/en-us/security/dd252948). + +## Лицензия + +© Корпорация Майкрософт. Все права защищены. Предоставляется по лицензии MIT (далее — "[Лицензия](./LICENSE)"); + +## Мы соблюдаем правила поведения при использовании открытого кода Майкрософт. + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](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 000000000..662cac5d5 --- /dev/null +++ b/README-Localized/README-zh-cn.md @@ -0,0 +1,229 @@ +# Microsoft Graph JavaScript 客户端库 + +[![npm 版本徽章](https://img.shields.io/npm/v/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) [![Travis](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript.svg?maxAge=86400)](https://travis-ci.org/microsoftgraph/msgraph-sdk-javascript) [![已知漏洞](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript/badge.svg?maxAge=86400)](https://snyk.io/test/github/microsoftgraph/msgraph-sdk-javascript) [![许可证](https://img.shields.io/github/license/microsoftgraph/msgraph-sdk-javascript.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![代码样式：美观](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/microsoftgraph/msgraph-sdk-javascript) [![下载](https://img.shields.io/npm/dm/@microsoft/microsoft-graph-client.svg?maxAge=86400)](https://www.npmjs.com/package/@microsoft/microsoft-graph-client) + +Microsoft Graph JavaScript 客户端库轻型 Microsoft Graph API 包装器，可在服务器侧和浏览器中使用。 + +**正常查找模型上的 IntelliSense（用户、组等）？查看 [Microsoft Graph 类型](https://github.com/microsoftgraph/msgraph-typescript-typings)存储库！** + +[![TypeScript 演示](https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-javascript/master/types-demo.PNG)](https://github.com/microsoftgraph/msgraph-typescript-typings) + +## 安装 + +### 通过 npm + +```cmd +npm install @microsoft/microsoft-graph-client +``` + +导入 `@microsoft/microsoft-graph-client` 至你的模块，同时需要填充代码如[isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch)等来进行提取。 + +```typescript +import "isomorphic-fetch"; +import { Client } from "@microsoft/microsoft-graph-client"; +``` + +### 通过脚本标记 + +包含 [graph-js-sdk.js](https://cdn.jsdelivr.net/npm/@microsoft/microsoft-graph-client/lib/graph-js-sdk.js) 至 HTML 页面。 + +```HTML + +``` + +如果你的浏览器不支持“[提取](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) \[[支持](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API#Browser_compatibility)] 或[承诺](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) \[[支持](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Browser_compatibility)]，需要使用类似 [github/fetch](https://github.com/github/fetch) 的填充代码进行提取，并使用 [es6-promise](https://github.com/stefanpenner/es6-promise) 等进行承诺。 + +```HTML + + + + + + + + +``` + +## 入门 + +### 1.注册应用程序 + +使用下列支持的身份验证门户之一注册应用程序，以使用 Microsoft Graph API： + +- 转到 [Microsoft 应用程序注册门户](https://apps.dev.microsoft.com)：使用统一的 V2 验证终结点来注册使用 Microsoft 账户和/或组织账户工作的新应用程序。 +- [Microsoft Azure Active Directory](https://manage.windowsazure.com)：在租户 Active Directory 中注册新应用程序，以支持租户或多租户的工作或学校账户。 + +### 2.Microsoft Graph 服务身份验证 + +对于负责获取 `accessToken` 的 [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core)（Microsoft 身份验证库），Microsoft Graph JavaScript 客户端库拥有适配器实现（[ImplicitMSALAuthenticationProvider](src/ImplicitMSALAuthenticationProvider.ts)）。MSAL 库不随此库提供，用户需要外部将之包含（对于包含 MSAL，参见“[此处](https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-core#installation)”）。 + +> **重要说明：**MSAL 仅支持前端应用程序，对于服务器侧身份应用，需要实现自己的AuthenticationProvider。了解如何创建“[自定义身份验证提供程序](./docs/CustomAuthenticationProvider.md)”。 + +#### 在浏览器环境中创建 ImplicitMSALAuthenticationProvider 实例 + +有关兼容 msal 版本和下列版本的更新，参见[package.json](./package.json) 中的devDependencies。 + +```html + +``` + +```typescript + +// Configuration options for MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL.js-1.0.0-api-release#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new Msal.UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new MicrosoftGraph.ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +#### 在节点环境中创建 ImplicitMSALAuthenticationProvider 实例 + +有关兼容 msal 版本和下列版本的更新，参见[package.json](./package.json) 中的devDependencies。 + +```cmd +npm install msal@ +``` + +```typescript +import { UserAgentApplication } from "msal"; + +import { ImplicitMSALAuthenticationProvider } from "./node_modules/@microsoft/microsoft-graph-client/lib/src/ImplicitMSALAuthenticationProvider"; + +// An Optional options for initializing the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/MSAL-basics#configuration-options +const msalConfig = { + auth: { + clientId: "your_client_id", // Client Id of the registered application + redirectUri: "your_redirect_uri", + }, +}; +const graphScopes = ["user.read", "mail.send"]; // An array of graph scopes + +// Important Note: This library implements loginPopup and acquireTokenPopup flow, remember this while initializing the msal +// Initialize the MSAL @see https://github.com/AzureAD/microsoft-authentication-library-for-js#1-instantiate-the-useragentapplication +const msalApplication = new UserAgentApplication(msalConfig); +const options = new MicrosoftGraph.MSALAuthenticationProviderOptions(graphScopes); +const authProvider = new ImplicitMSALAuthenticationProvider(msalApplication, options); +``` + +通过实现 `IAuthenticationProvider` 接口，用户可集成自己首选的身份验证库。参见实现“[身份验证提供程序](./docs/CustomAuthenticationProvider.md)”。 + +### 3.使用身份验证提供程序初始化 Microsoft Graph 客户端 + +“**客户端**”类实例处理 Microsoft Graph API 请求并处理响应。若要创建此类的新实例，需要提供 [`IAuthenticationProvider`](src/IAuthenticationProvider.ts) 实例，它需要作为 [`ClientOptions`](src/IClientOptions.ts) 中的 `authProvider` 密钥值传递至静态初始化表达式方法 `Client.initWithMiddleware`。 + +#### 浏览器环境 + +```typescript +const options = { + authProvider, // An instance created from previous step +}; +const Client = MicrosoftGraph.Client; +const client = Client.initWithMiddleware(options); +``` + +#### 节点环境 + +```typescript +import { Client } from "@microsoft/microsoft-graph-client"; + +const options = { + authProvider, // An instance created from previous step +}; +const client = Client.initWithMiddleware(options); +``` + +有关初始化客户端的详细信息，请参阅“[此文档](./docs/CreatingClientInstance.md)”。 + +### 4.对图形发出请求 + +拥有身份验证设置和客户端实例后，可开始对服务进行调用。所有请求应使用 `client.api(path)` 开始并以 “[操作](./docs/Actions.md)”结束。 + +获取用户详情 + +```typescript +try { + let userDetails = await client.api("/me").get(); + console.log(userDetails); +} catch (error) { + throw error; +} +``` + +发送电子邮件至收件人 + +```typescript +// Construct email object +const mail = { + subject: "Microsoft Graph JavaScript Sample", + toRecipients: [ + { + emailAddress: { + address: "example@example.com", + }, + }, + ], + body: { + content: "

MicrosoftGraph JavaScript Sample

Check out https://github.com/microsoftgraph/msgraph-sdk-javascript", + contentType: "html", + }, +}; +try { + let response = await client.api("/me/sendMail").post({ message: mail }); + console.log(response); +} catch (error) { + throw error; +} +``` + +有关详细信息，请参阅：[调用模式](docs/CallingPattern.md)、 [操作](docs/Actions.md)、[查询参数](docs/QueryParameters.md)、[API 方法](docs/OtherAPIs.md) 和 [更多](docs/)。 + +## 文档 + +- [批处理](docs/content/Batching.md) +- [大型文件上传任务](docs/tasks/LargeFileUploadTask.md) +- [页面迭代器](docs/tasks/PageIterator.md) +- [操作](docs/Actions.md) +- [查询参数](docs/QueryParameters.md) +- [其他 API](docs/OtherAPIs.md) +- [获取原始响应](docs/GettingRawResponse.md) + +## 问题和意见 + +我们乐意倾听你有关 Microsoft Graph JavaScript 客户端库的反馈。你可以在该存储库中的[问题](https://github.com/microsoftgraph/msgraph-sdk-javascript/issues)部分将问题和建议发送给我们。 + +## 参与 + +请参阅[参与指南](CONTRIBUTING.md)。 + +## 其他资源 + +- [Microsoft Graph 网站](https://graph.microsoft.io) +- [Microsoft Graph TypeScript 类型](https://github.com/microsoftgraph/msgraph-typescript-typings/) +- [使用 Microsoft Graph 生成 Angular 单页应用](https://github.com/microsoftgraph/msgraph-training-angularspa) +- [使用 Microsoft Graph 生成 Node.js Express 应用](https://github.com/microsoftgraph/msgraph-training-nodeexpressapp) +- [Office 开发人员中心](http://dev.office.com/) + +## 第三方声明 + +有关 [package.json](./package.json) 包含的程序包信息，参见“[第三方声明](./THIRD%20PARTY%20NOTICES)” + +## 安全报告 + +如果发现库或服务存在安全问题，请尽可能详细地报告至 [secure@microsoft.com](mailto:secure@microsoft.com)。提交可能有资格通过 [Microsoft 报告奖励](http://aka.ms/bugbounty)计划获得奖励。请勿发布安全问题至 GitHub 问题或其他任何公共网站。我们将在收到信息后立即与你联系。建议发生安全事件时获取相关通知，方法是访问[此页](https://technet.microsoft.com/en-us/security/dd252948)并订阅“安全公告通知”。 + +## 许可证 + +版权所有 (c) Microsoft Corporation。保留所有权利。在 MIT 许可证（“[许可证](./LICENSE)”）下获得许可。 + +## 我们重视并遵守“Microsoft 开放源代码行为准则” + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息，请参阅[行为准则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见，也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。