رف كتب

تسمح لك مجموعة 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 آخر مرة تمت فيها إضافة مجلد أو إزالته من رف الكتب هذا (الطابع الزمني المنسق بالتوقيت العالمي المنسق بدقة تبلغ مللي ثانية).