رف كتب

تتيح لك مجموعة Bookshelf الاطّلاع على البيانات الوصفية لرف الكتب بالإضافة إلى تعديل محتوى رف الكتب.

الطُرق

تنطبق الطرق التالية على البيانات العلنية حول رفوف الكتب ولا تتطلّب المصادقة.
books.bookshelves.list
books.bookshelves.get

تنطبق الطرق التالية على العرض الخاص "مكتبتي" لأرفف الكتب وتتطلّب إثبات الهوية.
books.mylibrary.bookshelves.list
books.mylibrary.bookshelves.get
books.mylibrary.bookshelves.addVolume
books.mylibrary.bookshelves.removeVolume
books.mylibrary.bookshelves.clearVolumes

list
تعرض هذه الطريقة قائمة بموارد رف الكتب العامة للمستخدم المحدّد.
الحصول على
تسترد هذه الطريقة مورد رف كتب محدّدًا للمستخدم المحدّد.

تمثيلات الموارد

يمثّل مرجع "رف الكتب" البيانات الوصفية لرف الكتب، ولا يتضمّن المجلدات في رف الكتب.

{
  "kind": "books#bookshelf",
  "id": integer,
  "selfLink": string,
  "title": string,
  "description": string,
  "access": string,
  "updated": datetime,
  "created": datetime,
  "volumeCount": integer,
  "volumesLastUpdated": datetime
}
اسم السمة القيمة الوصف ملاحظات
kind string نوع المورد الخاص بالبيانات الوصفية لرف الكتب
id integer رقم تعريف رف الكتب هذا.
title string تمثّل هذه السمة عنوان رف الكتب.
description string وصف رف الكتب هذا
access string تحدّد هذه السمة ما إذا كانت الرفوف علنية أو خاصة.
updated datetime وقت آخر تعديل في رف الكتب هذا (طابع زمني منسَّق للتوقيت العالمي المتفق عليه بدقة المللي ثانية)
created datetime وقت إنشاء رف الكتب هذا (طابع زمني منسَّق بالتوقيت العالمي المتفق عليه بدقة تصل إلى جزء من الألف من الثانية)
volumeCount integer عدد المجلدات في رف الكتب هذا.
volumesLastUpdated datetime آخر مرة تمت فيها إضافة كتاب أو إزالته من رف الكتب هذا (طابع زمني منسّق للتوقيت العالمي المتفق عليه بدقة تصل إلى جزء من الألف من الثانية)