نظرة عامة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهات برمجة التطبيقات في مجموعة واجهات برمجة تطبيقات "كتب Google" إمكانية الاستفادة من ميزات كتب Google في موقعك الإلكتروني أو تطبيقك.
تتيح لك Google Books API الجديدة إجراء معظم العمليات التي يمكنك تنفيذها بشكل تفاعلي على موقع "كتب Google" الإلكتروني، تتيح لك واجهة برمجة التطبيقات للعارض المضمَّن تضمين المحتوى مباشرةً في موقعك الإلكتروني.
في Google، نسعى باستمرار لتوفير المعلومات لأكبر عدد ممكن من المستخدمين، وقد تم تصميم واجهات برمجة التطبيقات لدينا مع وضع هذا الهدف في الاعتبار.
ومع ذلك، نحن نمنح تراخيص للكثير من البيانات التي نستخدمها لتشغيل "كتب Google"، لذا لا يمكننا توزيعها كيفما نختار.
لم يتم تصميم واجهة برمجة التطبيقات لاستخدامها كبديل للخدمات التجارية.
هذه الخدمات قيّمة وتعتمد Google أيضًا عليها لإنشاء واجهات برمجة التطبيقات الخاصة بنا للجمهور العام.
تتوفّر بنود خدمة Google لاستخدام واجهات برمجة التطبيقات على https://developer.google.com/books/terms.html. سنعلّق وصول المستخدم إلى واجهات برمجة التطبيقات إذا انتهك أحد بنود الخدمة ولم نتّخذ أي إجراء لمعالجة هذا الانتهاك بعد أن تلقّى إشعار من Google بالمخالفة.
الإصدار الأول من واجهة برمجة التطبيقات مع "كتب Google" (ميزة تجريبية)
يمنحك الإصدار الأول من Google Books API إمكانية الدخول الآلي إلى العديد من العمليات المتوفرة على موقع "كتب Google" الإلكتروني. يمكنك استخدامه لإنشاء تطبيقات قوية توفر تكاملاً أعمق مع كتب Google. في ما يلي بعض الميزات الأساسية التي توفرها واجهة برمجة التطبيقات:
- البحث في قائمة الكتب التي تطابق طلب بحث معين وتصفحها.
- عرض معلومات حول كتاب، بما في ذلك البيانات الوصفية ومدى التوفر والسعر وروابط تؤدي إلى صفحة المعاينة.
- في إدارة رفوف الكتب الخاصة بك.
إنّ صفحة البدء هي خطوة أولى مفيدة للتعرّف على واجهة برمجة التطبيقات. وهي تشرح المفاهيم الأساسية التي تستخدمها واجهة برمجة التطبيقات وتصف مبادئ التفاعل الأساسية التي تتّبعها واجهة برمجة التطبيقات. يتم تقديم وصف شامل لجميع العمليات التي تدعمها واجهة برمجة التطبيقات في صفحة استخدام واجهة برمجة التطبيقات.
واجهة برمجة تطبيقات المشاهد المضمنة
تتيح لك واجهة برمجة التطبيقات inline Viewer API تضمين محتوى الكتاب من "كتب Google" مباشرةً في صفحات الويب باستخدام JavaScript. يسمح لك هذا التطبيق بإنشاء تجربة مستخدم خاصة بك حول معاينات الكتب.
تُعد إضافة وظيفة معاينة الكتاب إلى موقعك أمرًا بسيطًا نسبيًا، مع أنها تتطلب بعض المعرفة بلغة HTML وJavaScript. يشرح دليل المطوّر طريقة تحميل واجهة برمجة التطبيقات باستخدام برنامج تحميل AJAX من Google ورسمها في حاوية معيّنة على صفحتك.
بعد إضافة العارض المضمّن إلى صفحة ويب، يمكن التحكّم فيه باستخدام وظائف JavaScript. ويتيح لك هذا الإجراء تنفيذ إجراءات مشابهة لما يمكن للمستخدم فعله بالنقر على عناصر التحكم: يمكنك الانتقال إلى الصفحة التالية، والتكبير أو التصغير، وتمييز عبارات البحث، وما إلى ذلك. ويمكنك أيضًا الحصول على رقم الصفحة الحالية، ما يسمح بالتفاعل مع رمزك أثناء تنقّل المستخدم في الكتاب.
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Books APIs allow you to integrate Google Books features, such as searching, browsing, and embedding book content, into your website or application.\u003c/p\u003e\n"],["\u003cp\u003eThe Books API provides programmatic access to book information, including metadata, availability, and pricing, enabling you to build book-related applications.\u003c/p\u003e\n"],["\u003cp\u003eThe Embedded Viewer API enables you to embed book previews directly into your web pages, offering customizable user experiences around book content.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Books APIs are subject to the Google Terms of Service, and misuse may lead to suspension of access.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nThe APIs in the Google Books API Family let you bring [Google Books](https://books.google.com/) features to your site or application.\n\nThe new [Google Books API](#books_api_v1) lets you perform programmatically most of the operations that you can do interactively on the\nGoogle Books website. The [Embedded Viewer API](#embedded_viewer_api) lets you embed the content directly into your site.\n\nAt Google, we're constantly striving to make information available to as\nmany people as possible, and our APIs were designed with that goal in mind.\nHowever, we license much of the data that we use to power Google Books, so\nit's not ours to distribute however we choose.\n\nThe API is not intended to be used as a replacement for commercial services.\nThese services are valuable and Google also relies upon them to build our\nown APIs for the general public.\n\nThe Google Terms of Service for use of the APIs is available at [https://developer.google.com/books/terms.html](/books/terms). We will suspend a user's access to the APIs if a user violates the Terms of Service and does not take action to remedy the violation after notice of violation by Google.\n\nBooks API v1 (Experimental)\n---------------------------\n\nThe new Google Books API v1 gives you programmatic access to many of the operations available on Google Books website. You can use it to\ncreate powerful applications that provide deeper integration with Google Books. Some of the main features that the API provides are:\n\n- search and browse through the list of books that match a given query.\n- view information about a book, including metadata, availability and price, links to the preview page.\n- manage your own bookshelves.\n\nA good first step in learning about the API is the [Getting Started](/books/docs/v1/getting_started) page. It explains the basic\nconcepts that the API uses and describes the basic interaction principles that the API follows. A comprehensive description of all the operations\nsupported by the API is given in the [Using the API](/books/docs/v1/using) page.\n\nEmbedded Viewer API\n-------------------\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------|\n| The Embedded Viewer API lets you embed book content from Google Books directly in your web pages with JavaScript. It allows you to build your own user experience around book previews. Adding book preview functionality to your site is relatively simple, though it does require some knowledge of HTML and JavaScript. The [Developer's Guide](/books/docs/viewer/developers_guide) explains how the API can be loaded using the Google AJAX loader and drawn into a particular container on your page. Once the embedded viewer has been added to a webpage, it can be controlled using [JavaScript functions](/books/docs/viewer/reference). This allows you to perform actions similar to what the user can do by clicking on the controls: you can go to the next page, zoom in or out, highlight search terms, and so on. You are also able to get the current page number, allowing your code react as the user navigates through the book. | [](/books/docs/viewer/examples/book-simple) |"]]