رف كتب
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك مجموعة Bookshelf الاطّلاع على البيانات الوصفية لرف الكتب بالإضافة إلى تعديل محتوى رف الكتب.
تمثيلات الموارد
يمثل مورد رف الكتب البيانات الوصفية لرف الكتب، ولا يشمل المجلدات الموجودة في رف الكتب.
{
"kind": "books#bookshelf",
"id": integer,
"selfLink": string,
"title": string,
"description": string,
"access": string,
"updated": datetime,
"created": datetime,
"volumeCount": integer,
"volumesLastUpdated": datetime
}
| اسم الموقع |
القيمة |
الوصف |
Notes |
kind |
string |
نوع المصدر للبيانات الوصفية لرف الكتب |
|
id |
integer |
رقم تعريف رف الكتب هذا |
|
title |
string |
عنوان رف الكتب هذا. |
|
description |
string |
وصف رف الكتب هذا |
|
access |
string |
ما إذا كان رف الكتب هذا علنيًا أو خاصًا: |
|
updated |
datetime |
وقت آخر تعديل على رف الكتب هذا (الطابع الزمني بالتوقيت العالمي المنسَّق بالتنسيق بدقة ميلي ثانية) |
|
created |
datetime |
تم إنشاء وقت رف الكتب هذا (الطابع الزمني بالتوقيت العالمي المنسَّق بالتنسيق بدقة ملي ثانية). |
|
volumeCount |
integer |
عدد المجلّدات في رف الكتب هذا |
|
volumesLastUpdated |
datetime |
آخر مرة تمت فيها إضافة مجلد أو إزالته من رف الكتب هذا (الطابع الزمني بالتوقيت العالمي المنسَّق (UTC) مع دقة المللي ثانية) |
|
selfLink |
string |
عنوان URL الخاص بهذا المورد. |
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-06-28 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eBookshelf\u003c/code\u003e collection enables you to view and manage bookshelf metadata and contents.\u003c/p\u003e\n"],["\u003cp\u003ePublic methods allow access to bookshelf data without authentication, while private methods require authentication for "My Library" interactions.\u003c/p\u003e\n"],["\u003cp\u003eA Bookshelf resource represents metadata such as title, description, access level, and volume count, but it does not include the actual volumes within the bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve lists of bookshelves, individual bookshelf details, and modify "My Library" bookshelves using the provided methods.\u003c/p\u003e\n"]]],[],null,["# Bookshelf\n\nThe `Bookshelf` collection allows you to view bookshelf metadata as well as to modify the contents of a bookshelf.\n\nMethods\n-------\n\n\u003cbr /\u003e\n\nThe following methods apply to the public data about bookshelves and don't require authentication.\n[books.bookshelves.list](#method_books_bookshelves_list) \n[books.bookshelves.get](#method_books_bookshelves_get) \n\nThe following methods apply to the private, \"My Library\" view of bookshelves and require authentication.\n[books.mylibrary.bookshelves.list](#method_books_mylibrary_bookshelves_list) \n[books.mylibrary.bookshelves.get](#method_books_mylibrary_bookshelves_get) \n[books.mylibrary.bookshelves.addVolume](#method_books_mylibrary_bookshelves_addVolume) \n[books.mylibrary.bookshelves.removeVolume](#method_books_mylibrary_bookshelves_removeVolume) \n[books.mylibrary.bookshelves.clearVolumes](#method_books_mylibrary_bookshelves_clearVolumes)\n\n\u003cbr /\u003e\n\n[list](/books/docs/v1/reference/bookshelves/list)\n: Retrieves a list of public [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n\n[get](/books/docs/v1/reference/bookshelves/get)\n: Retrieves a specific [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n\nResource Representations\n------------------------\n\nA Bookshelf resource represents the metadata for a bookshelf, it does not include the volumes in the bookshelf.\n\n```text\n{\n \"kind\": \"books#bookshelf\",\n \"id\": integer,\n \"selfLink\": string,\n \"title\": string,\n \"description\": string,\n \"access\": string,\n \"updated\": datetime,\n \"created\": datetime,\n \"volumeCount\": integer,\n \"volumesLastUpdated\": datetime\n}\n```\n\n| Property Name | Value | Description | Notes |\n|----------------------|------------|--------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type for bookshelf metadata. | |\n| `id` | `integer` | ID of this bookshelf. | |\n| `title` | `string` | Title of this bookshelf. | |\n| `description` | `string` | Description of this bookshelf. | |\n| `access` | `string` | Whether this bookshelf is PUBLIC or PRIVATE. | |\n| `updated` | `datetime` | Last modified time of this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `created` | `datetime` | Created time for this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `volumeCount` | `integer` | Number of volumes in this bookshelf. | |\n| `volumesLastUpdated` | `datetime` | Last time a volume was added or removed from this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `selfLink` | `string` | URL to this resource. | |"]]
