diff --git a/README-Localized/README-es-es.md b/README-Localized/README-es-es.md new file mode 100644 index 0000000..265c2de --- /dev/null +++ b/README-Localized/README-es-es.md @@ -0,0 +1,60 @@ +Ejemplo Léame de API de OneNote en Microsoft Graph para iOS +--------------------------------------------- + +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 la sesión del usuario con el SDK de ADAL](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [OBTENER los blocs de notas de OneNote de un usuario](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/notebook_get) +- [OBTENER los blocs de notas con secciones expandidas de OneNote de un usuario](https://msdn.microsoft.com/es-es/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [OBTENER las páginas de OneNote de un usuario](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/page_get) +- [OBTENER las secciones de OneNote de un usuario](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/api/section_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/section_post_pages) + +### Requisitos previos + +**Herramientas y bibliotecas** que tendrá que descargar, instalar y configurar en el entorno de desarrollo. + +Asegúrese de comprobar también los requisitos previos para ellas. + +- [Apple XCode](https://developer.apple.com/xcode/) y los SDK de iOS. +- Instalación de [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) como administrador de dependencias. Çon CocoaPods, podrá extraer las dependencias necesarias en el proyecto. + +**Cuentas ** + +- Como desarrollador, deberá [disponer de una cuenta de Microsoft y obtener una cadena de Id. de cliente](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app) para que la aplicación pueda autenticarse con el SDK de ADAL. Dado que en este ejemplo se usa el SDK de ADAL, los usuarios tendrán que autenticarse con una cuenta de Azure AD/Id.de la organización, aunque la API de Microsoft Graph admite la autenticación convergente. +- Si necesita otros elementos para el desarrollo de aplicaciones iOS, visite el [sitio para desarrolladores de Apple](http://developer.apple.com/) para obtener una cuenta de desarrollador de Apple. + +### Uso del ejemplo + +Una vez que haya configurado las herramientas de desarrollo e instalado los requisitos previos indicados anteriormente,... + +1. Descargue este repo como archivo ZIP en el MAC local y extraiga los archivos. O bien, clone el repositorio en una copia local de Git. +2. Con CocoaPods, ejecute `pod install` en la raíz del proyecto. +3. Abra el archivo MSGraphOneNoteiOSSample.xcworkspace generado en el paso anterior. +4. Obtenga una cadena de Id. de cliente y cópiela en MSGONAppConfig.m (~línea 25). +5. Compile y ejecute la aplicación. +6. Inicie sesión con la aplicación que se está ejecutando, con su cuenta de Azure AD. +7. Permita que la aplicación tenga acceso de lectura y escritura a los blocs de notas de OneNote. + +### Información de versión + +| Fecha | Modificación| +|------------|-------------------------------------------------------| +| Abril de 2017 | Se actualizó para usar los puntos de conexión de la API de Microsoft Graph. | +| Mayo de 2014 | Publicación inicial de 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) +- Explore la API con el [Probador de Microsoft Graph a través de los puntos de conexión de la versión beta](https://developer.microsoft.com/es-es/graph/graph-explorer). Vea también la documentación del [documentación de recurso de OneNote](https://developer.microsoft.com/es-es/graph/docs/api-reference/beta/resources/notes). +- [Introducción](https://developer.microsoft.com/es-es/graph/docs/get-started/get-started) a las API de Microsoft Graph +- [Información general](https://developer.microsoft.com/es-es/graph/docs/overview/overview) de Microsoft Graph + +Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, vea [Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios. diff --git a/README-Localized/README-fr-fr.md b/README-Localized/README-fr-fr.md new file mode 100644 index 0000000..0e14515 --- /dev/null +++ b/README-Localized/README-fr-fr.md @@ -0,0 +1,60 @@ +Exemple de fichier LISEZMOI iOS de OneNote API Microsoft Graph +--------------------------------------------- + +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 à l’aide du kit de développement logiciel (SDK) ADAL](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [OBTENIR les blocs-notes OneNote d’un utilisateur](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/notebook_get) +- [OBTENIR les blocs-notes OneNote d’un utilisateur avec des sections développées](https://msdn.microsoft.com/fr-fr/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [OBTENIR les pages OneNote d’un utilisateur](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/page_get) +- [OBTENIR les sections OneNote d’un utilisateur](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/section_get) +- [PUBLIER une page HTML simple dans une nouvelle page OneNote QuickNotes](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/api/section_post_pages) + +### Conditions préalables + +**Outils et bibliothèques** que vous devrez télécharger, installer et configurer pour votre environnement de développement. + +Vérifiez bien également les conditions préalables de ces éléments. + +- [Apple XCode](https://developer.apple.com/xcode/) et kits de développement logiciel iOS. +- Installation de [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) comme gestionnaire de dépendances. CocoaPods vous permet d’extraire les dépendances requises dans le projet. + +**Comptes** + +- En tant que développeur, vous devez [disposer d’un compte Microsoft et obtenir une chaîne d’ID client](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app) afin que votre application puisse s’authentifier auprès du kit de développement logiciel (SDK) ADAL. Comme cet exemple utilise le kit de développement logiciel (SDK) ADAL, les utilisateurs doivent s’authentifier à l’aide d’un compte Azure AD/ID d’organisation, même si l’authentification convergente est prise en charge par l’API Microsoft Graph. +- Si vous avez besoin d’autres éléments pour le développement de votre application iOS, visitez le [site du développeur Apple](http://developer.apple.com/) pour obtenir un compte de développeur Apple. + +### 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 le référentiel sous la forme d’un fichier ZIP sur votre ordinateur Mac local, puis extrayez les fichiers. Vous pouvez également cloner le référentiel dans une copie locale de Git. +2. À l’aide de CocoaPods, exécutez `pod install` à la racine du projet. +3. Ouvrez le fichier MSGraphOneNoteiOSSample. xcworkspace généré à l’étape précédente. +4. Procurez-vous une chaîne ID client et copiez-la dans MSGONAppConfig. m (~ ligne 25). +5. Générez et exécutez l'application. +6. Connectez-vous à l’aide de l’application en cours d’exécution et de votre compte Azure AD. +7. Autorisez l’application à accéder à vos blocs-notes OneNote en lecture et en écriture. + +### Informations sur la version + +| Date | Modifier | +|------------|-------------------------------------------------------| +| avril 2017 | Mis à jour pour utiliser les points de terminaison de l’API Microsoft Graph. | +| mai 2014 | Divulgation 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’[Explorateur Microsoft Graph via les points de terminaison bêta](https://developer.microsoft.com/fr-fr/graph/graph-explorer). Reportez-vous également à la [documentation sur les ressources OneNote](https://developer.microsoft.com/fr-fr/graph/docs/api-reference/beta/resources/notes). +- [Prise en main](https://developer.microsoft.com/fr-fr/graph/docs/get-started/get-started) des API Microsoft Graph +- [Présentation](https://developer.microsoft.com/fr-fr/graph/docs/overview/overview) de Microsoft Graph + +Ce projet a adopté le [code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire. diff --git a/README-Localized/README-ja-jp.md b/README-Localized/README-ja-jp.md new file mode 100644 index 0000000..157e2df --- /dev/null +++ b/README-Localized/README-ja-jp.md @@ -0,0 +1,60 @@ +Microsoft Graph OneNote API iOS のサンプル README +--------------------------------------------- + +作成: 2017 年 Microsoft Corporation。現状のまま提供され、保証はいたしません。ここに記載される商標は、商標の所有者の所有物です。 + +### このサンプルでデモンストレーションを行う API 機能 + +このサンプルでは、API の以下の点について説明します。その他の資料については、以下のリンクを参照してください。 + +- [ADAL SDK を使用したユーザーの Log-in](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [ユーザーの OneNote ノートブックの GET](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/notebook_get) +- [ユーザーの、拡張されたセクション付き OneNote ノートブックの GET](https://msdn.microsoft.com/ja-jp/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [ユーザーの OneNote ページの GET](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/page_get) +- [ユーザーの OneNote セクションの GET](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/section_get) +- [新しい OneNote のクイック ノート ページへのシンプルな HTML の POST](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/api/section_post_pages) + +### 前提条件 + +ダウンロードしてインストールし、開発環境に合わせて構成する必要がある**ツールおよびライブラリ**。 + +これらの前提条件も確認してください。 + +- [Apple XCode](https://developer.apple.com/xcode/) と iOS SDK。 +- 依存関係マネージャーとしての [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) のインストール。CocoaPods を使用すると、必要な依存関係をプロジェクトに取り込むことができます。 + +**アカウント** + +- アプリが ADAL SDK を使用して認証を行えるよう、開発者は [Microsoft アカウントを所有し、クライアント ID 文字列を取得する](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app)必要があります。統合認証は Microsoft Graph API でサポートされていますが、このサンプルでは ADAL SDK を使用しているため、ユーザーは Azure AD/組織 ID アカウントを使用して認証する必要があります。 +- iOS アプリの開発に必要なものが他にある場合は、[Apple Developer サイト](http://developer.apple.com/)にアクセスして、Apple の開発者アカウントを入手してください。 + +### サンプルを使う + +開発ツールをセットアップし、上記の前提条件をインストールしたら、次の手順を実行します。 + +1. リポジトリを ZIP ファイルとしてローカルの Mac にダウンロードし、ファイルを抽出します。または、Git のローカル コピーにリポジトリを複製します。 +2. CocoaPods を使用して、プロジェクトのルートで `pod install` を実行します。 +3. 前の手順で生成された MSGraphOneNoteiOSSample.xcworkspace ファイルを開きます。 +4. クライアント ID 文字列を取得し、それを MSGONAppConfig.m (~line 25) にコピーします。 +5. アプリケーションをビルドし、実行します。 +6. Azure AD アカウントを使用して、実行中のアプリを使用してログインします。 +7. OneNote ノートブックへの読み取りと書き込みアクセスをアプリに許可します。 + +### バージョン情報 + +| 日付 | 変更内容 | +|------------|-------------------------------------------------------| +| 2017 年 4 月 | Microsoft Graph API エンドポイントを利用するように更新。 | +| 2014 年 5 月 | このコード サンプルの最初のパブリック リリース。 | + +### その他のリソース + +- [dev.onenote.com](http://dev.onenote.com) デベロッパー センターをご覧ください +- [(OneNote とタグ付けされた) StackOverflow](http://go.microsoft.com/fwlink/?LinkID=390182) でご質問を受け付けています +- Twitter でフォローしてください ([@onenotedev](http://www.twitter.com/onenotedev)) +- [OneNote の開発者ブログ](http://go.microsoft.com/fwlink/?LinkID=390183)をご覧ください +- [ベータ エンドポイントを使用する Microsoft Graph Explorer](https://developer.microsoft.com/ja-jp/graph/graph-explorer) を使用して API を確認してみてください。また、[OneNote のリソース ドキュメント](https://developer.microsoft.com/ja-jp/graph/docs/api-reference/beta/resources/notes)も参照してください。 +- Microsoft Graph API の[使用を開始する](https://developer.microsoft.com/ja-jp/graph/docs/get-started/get-started) +- Microsoft Graph の [概要](https://developer.microsoft.com/ja-jp/graph/docs/overview/overview) + +このプロジェクトでは、[Microsoft Open Source Code of Conduct (Microsoft オープン ソース倫理規定)](https://opensource.microsoft.com/codeofconduct/) が採用されています。詳細については、「[Code of Conduct の FAQ (倫理規定の FAQ)](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。また、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までお問い合わせください。 diff --git a/README-Localized/README-pt-br.md b/README-Localized/README-pt-br.md new file mode 100644 index 0000000..31b5380 --- /dev/null +++ b/README-Localized/README-pt-br.md @@ -0,0 +1,60 @@ +Exemplo Microsoft Graph API do OneNote iOS README +--------------------------------------------- + +Criado pela Microsoft Corporation, 2017. Fornecido como está sem garantia. As marcas comerciais mencionadas aqui pertencem aos proprietários. + +### Funcionalidade da API demonstrada neste exemplo + +Os seguintes aspectos da API são abordados nesta amostra. Para saber mais, confira os links abaixo. + +- [Entrar no usuário usando o SDK do ADAL](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [OBTER blocos de anotações do OneNote do usuário](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/notebook_get) +- [OBTER bloco de anotações do OneNote de um usuário com seções expandidas](https://msdn.microsoft.com/pt-br/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [OBTER páginas do OneNote do usuário](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/page_get) +- [OBTER seções do OneNote do usuário](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/section_get) +- [POSTAR uma página HTML simples em uma nova página do OneNote QuickNotes](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/api/section_post_pages) + +### Pré-requisitos + +Será necessário baixar, instalar e configurar**Ferramentas e Bibliotecas** para o seu ambiente de desenvolvimento. + +Certifique-se de verificar estes pré-requisitos também. + +- [Apple XCode](https://developer.apple.com/xcode/) e SDKs do iOS. +- A instalação de [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) como um gerenciador de dependências. CocoaPods permite que você extraia as dependências necessárias no projeto. + +**Contas** + +- Como desenvolvedor, você precisará [ter uma conta da Microsoft e obter uma cadeia de caracteres de ID do cliente](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app), para que seu aplicativo possa ser autenticado com o SDK do ADAL. Como este exemplo usa o SDK do ADAL, os usuários precisam autenticar usando uma conta de ID do Azure AD/org, embora o suporte convergente da API do Microsoft Graph tenha suporte. +- Se você precisar de outras coisas para o desenvolvimento de aplicativos iOS, visite o [site da Apple Developer](http://developer.apple.com/) para obter uma conta de desenvolvedor da Apple. + +### Usando a amostra + +Depois de configurar as ferramentas de desenvolvimento, instale os pré-requisitos listados acima,.... + +1. Baixe o repositório como um arquivo ZIP no Mac local e extraia os arquivos. Ou clone o repositório em uma cópia local do Git. +2. Usando o CocoaPods, execute a instalação `Pod` na raiz do projeto. +3. Abra o arquivo MSGraphOneNoteiOSSample. xcworkspace gerado pela etapa anterior. +4. Obtenha uma cadeia de caracteres de ID de cliente e a copie em MSGONAppConfig. m (~ linha 25). +5. Compile e execute o aplicativo. +6. Faça logon usando o aplicativo em execução, usando uma conta do Azure AD. +7. Permita que o aplicativo Leia e escreva acesso a seus blocos de anotações do OneNote. + +### Informações de Versão + +| Data | Alterar | +|------------|-------------------------------------------------------| +| Abril de 2017 | Atualizado para utilizar os pontos de extremidade da API do Microsoft Graph. | +| Maio 2014 | Versão pública inicial deste exemplo de código. | + +### Saiba mais + +- Visite o Centro de Desenvolvimento do[dev.onenote.com](http://dev.onenote.com) +- Fale conosco na [StackOverflow (marcado OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Siga-nos em [@onenotedev Twitter](http://www.twitter.com/onenotedev) +- Leia nosso blog [OneNote Developer](http://go.microsoft.com/fwlink/?LinkID=390183) +- Explore a API usando o [Microsoft Graph Explorer por meio dos pontos de extremidade beta](https://developer.microsoft.com/pt-br/graph/graph-explorer). Além disso, confira a [documentação de recursos OneNote](https://developer.microsoft.com/pt-br/graph/docs/api-reference/beta/resources/notes). +- [introdução](https://developer.microsoft.com/pt-br/graph/docs/get-started/get-started) com as APIs do Microsoft Graph +- [Visão geral](https://developer.microsoft.com/pt-br/graph/docs/overview/overview) do Microsoft Graph + +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 0000000..931c50b --- /dev/null +++ b/README-Localized/README-ru-ru.md @@ -0,0 +1,60 @@ +Microsoft Graph OneNote API iOS Образец README +--------------------------------------------- + +Создано Microsoft Corporation, 2017. Предоставляется как есть без гарантии. Товарные знаки, упомянутые в этой статье, являются собственностью их владельцев. + +### Функции API, демонстрируются в этом примере + +В этом примере рассматриваются указанные ниже аспекты API. Дополнительные сведения можно найти по ссылкам ниже. + +- [Войдите в систему, используя ADAL SDK](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [ПОЛУЧИТЕ блокноты пользователя OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/notebook_get) +- [ПОЛУЧИТЕ записные книжки OneNote пользователя с расширенными разделами](https://msdn.microsoft.com/ru-ru/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [ПОЛУЧИТЕ страницы пользователя OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/page_get) +- [ПОЛУЧИТЕ разделы пользователя OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/section_get) +- [Отправьте простую HTML-страницу на новую страницу быстрых заметок OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/api/section_post_pages) + +### Предварительные требования + +**Инструменты и Библиотеки** которые вам потребуется скачать, установить и настроить для вашей среды разработки. + +Обязательно проверьте предварительные требования для этого тоже. + +- [Apple XCode](https://developer.apple.com/xcode/) и iOS SDKs. +- Установка [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) в качестве диспетчера зависимостей. CocoaPods позволит извлечь необходимые зависимости в проект. + +**Учетные записи** + +- В качестве разработчика вам потребуется [учетная запись Microsoft и строка идентификатора клиента](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app), чтобы ваше приложение могло проходить аутентификацию с помощью ADAL SDK. Поскольку в этом примере используется ADAL SDK, пользователям потребуется пройти проверку подлинности с использованием учетной записи Azure AD / Org ID, хотя согласованная аутентификация поддерживается в Microsoft Graph API. +- Если вам нужны другие возможности для разработки приложений для iOS, посетите сайт [Apple Developer](http://developer.apple.com/), чтобы получить учетную запись разработчика Apple. + +### Использование примера + +После настройки средств разработки и установки описанных выше требований,.... + +1. Скачайте этот репозиторий в виде ZIP-архива на ваш MAC и извлеките из него файлы. Вы также можете скопировать репозиторий в локальную копию GIT. +2. Используя CocoaPods, запустите `pod install`в корне проекта. +3. Откройте файл MSGraphOneNoteiOSSample.xcworkspace, созданный на предыдущем этапе. +4. Получите строку идентификатора клиента и скопируйте ее в MSGONAppConfig.m (~ строка 25). +5. Выполните сборку и запустите приложение. +6. Войдите в систему с помощью запущенного приложения, используя свою учетную запись Azure AD. +7. Предоставьте приложению доступ на чтение и запись в записные книжки OneNote. + +### Сведения о версии + +| Дата | Изменить | +|------------|-------------------------------------------------------| +| Апрель 2017 | Обновлены для использования конечных точек API Microsoft Graph. | +| Май 2014 | Первоначальный общедоступный выпуск для примера этого кода. | + +### Дополнительные учебные материалы + +- Посетить центр разработчиков [dev.onenote.com](http://dev.onenote.com) +- Свяжитесь с нами на сайте [StackOverflow (тег OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182) +- Подпишитесь на нас в [Twitter @onenotedev](http://www.twitter.com/onenotedev) +- Читайте наш [блог для разработчиков OneNote](http://go.microsoft.com/fwlink/?LinkID=390183) +- Ознакомьтесь с API, используя [Проводник Microsoft Graph с помощью бета-версии конечных точек](https://developer.microsoft.com/ru-ru/graph/graph-explorer). Также см. раздел [документация по ресурсу OneNote](https://developer.microsoft.com/ru-ru/graph/docs/api-reference/beta/resources/notes). +- [Начало работы](https://developer.microsoft.com/ru-ru/graph/docs/get-started/get-started) с помощью API Microsoft Graph +- [общие сведения](https://developer.microsoft.com/ru-ru/graph/docs/overview/overview) о Microsoft Graph + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [Часто задаваемые вопросы о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). diff --git a/README-Localized/README-zh-cn.md b/README-Localized/README-zh-cn.md new file mode 100644 index 0000000..56c572b --- /dev/null +++ b/README-Localized/README-zh-cn.md @@ -0,0 +1,60 @@ +Microsoft Graph OneNote API iOS 示例自述文件 +--------------------------------------------- + +2017 年由 Microsoft Corporation 创建。按原样提供,不做保证。此处提及的商标是其所有者的财产。 + +### 此示例中演示的 API 功能 + +本示例介绍了 API 的以下方面。可在下面链接中找到附加文档。 + +- [使用 ADAL SDK 登录用户](https://github.com/AzureAD/azure-activedirectory-library-for-objc) +- [获取用户的 OneNote 笔记本](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/notebook_get) +- [获取用户的包含扩展分区的 OneNote 笔记本](https://msdn.microsoft.com/zh-cn/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options?f=255&MSPPError=-2147217396#expand) +- [获取用户的 OneNote 页面](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/page_get) +- [获取用户的 OneNote 分区](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/section_get) +- [向新 OneNote QuickNotes 页面发布简单的 HTML 页面](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/api/section_post_pages) + +### 先决条件 + +针对开发环境,需要下载、安装并配置**工具和库**。 + +同时,请务必验证以下先决条件。 + +- [Apple XCode](https://developer.apple.com/xcode/) 和 iOS SDK。 +- 安装 [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) 作为依存关系管理器。CocoaPods 允许你将所需的依赖项提取到项目中。 + +**帐户** + +- 作为开发人员,你需要[拥有 Microsoft 帐户,并获取客户端 ID 字符串](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-app-registration#build-a-quick-start-app),使应用可以向 ADAL SDK 进行身份验证。由于本示例使用 ADAL SDK,因此虽然 Microsoft Graph API 支持聚合身份验证,但是用户需要使用 Azure AD/组织 ID 帐户进行身份验证。 +- 如果你的 iOS 应用开发还需要其他资料,请访问 [Apple 开发人员网站](http://developer.apple.com/)以获取 Apple 开发人员帐户。 + +### 使用本示例 + +设置完开发工具并满足上述先决条件后, + +1. 将此存储库以 ZIP 文件格式下载到本地 Mac,并解压缩文件。或者将存储库克隆至 Git 的本地副本中。 +2. 使用 CocoaPods 在项目根目录下运行 `pod install`。 +3. 打开上一步生成的 MSGraphOneNoteiOSSample.xcworkspace 文件。 +4. 获取客户端 ID 字符串并将其复制到 MSGONAppConfig.m(大约第 25 行)。 +5. 生成并运行应用。 +6. 使用你的 Azure AD 帐户,使用正在运行的应用进行登录。 +7. 允许应用对你的 OneNote 笔记本进行读和写访问。 + +### 版本信息 + +| 日期 | 更改 | +|------------|-------------------------------------------------------| +| 2017 年 4 月 | 进行了更新以利用 Microsoft Graph API 终结点。| +| 2014 年 5 月 | 首次公开发布本代码示例。| + +### 了解更多 + +- 访问 [dev.onenote.com](http://dev.onenote.com) 开发中心 +- 访问 [StackOverflow(已标记的 OneNote)](http://go.microsoft.com/fwlink/?LinkID=390182)联系我们 +- 在 [Twitter @onenotedev](http://www.twitter.com/onenotedev) 中关注我们 +- 阅读我们的 [OneNote 开发人员博客](http://go.microsoft.com/fwlink/?LinkID=390183) +- 使用 [Microsoft Graph 资源管理器通过 Beta 终结点](https://developer.microsoft.com/zh-cn/graph/graph-explorer)浏览 API。此外,请参阅 [OneNote 资源文档](https://developer.microsoft.com/zh-cn/graph/docs/api-reference/beta/resources/notes)。 +- Microsoft Graph API [入门](https://developer.microsoft.com/zh-cn/graph/docs/get-started/get-started) +- Microsoft Graph [概述](https://developer.microsoft.com/zh-cn/graph/docs/overview/overview) + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息,请参阅[行为准则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见,也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。