Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 1 | |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| 3 | <html><head><title>Python: class Resource</title> |
| 4 | </head><body bgcolor="#f0f0f8"> |
| 5 | <p> |
| 6 | <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| 7 | <tr bgcolor="#ffc8d8"> |
| 8 | <td colspan=3 valign=bottom> <br> |
| 9 | <font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr> |
| 10 | |
| 11 | <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> |
| 12 | <td colspan=2><tt>A class for interacting with a resource.<br> </tt></td></tr> |
| 13 | <tr><td> </td> |
| 14 | <td width="100%">Methods defined here:<br> |
| 15 | <dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl> |
| 16 | |
| 17 | <dl><dt><a name="Resource-addVolume"><strong>addVolume</strong></a> = method(self, **kwargs)</dt><dd><tt>Adds a volume to a bookshelf.<br> |
| 18 | <br> |
| 19 | Args:<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 20 | source: string, String to identify the originator of this request.<br> |
Joe Gregorio | 0250385 | 2011-08-31 09:07:55 -0400 | [diff] [blame] | 21 | country: string, ISO-3166-1 code to override the IP-based location.<br> |
| 22 | volumeId: string, Id of volume to add. (required)<br> |
| 23 | shelf: string, Id of bookshelf to which to add a volume. (required)</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 24 | |
| 25 | <dl><dt><a name="Resource-clearVolumes"><strong>clearVolumes</strong></a> = method(self, **kwargs)</dt><dd><tt>Clears all volumes from a bookshelf.<br> |
| 26 | <br> |
| 27 | Args:<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 28 | source: string, String to identify the originator of this request.<br> |
Joe Gregorio | 3d55ac5 | 2012-02-21 10:11:19 -0500 | [diff] [blame] | 29 | shelf: string, Id of bookshelf from which to remove a volume. (required)<br> |
| 30 | country: string, ISO-3166-1 code to override the IP-based location.</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 31 | |
Joe Gregorio | 3d55ac5 | 2012-02-21 10:11:19 -0500 | [diff] [blame] | 32 | <dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves metadata for a specific bookshelf belonging to the authenticated user.<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 33 | <br> |
| 34 | Args:<br> |
Joe Gregorio | 0250385 | 2011-08-31 09:07:55 -0400 | [diff] [blame] | 35 | source: string, String to identify the originator of this request.<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 36 | shelf: string, Id of bookshelf to retrieve. (required)<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 37 | country: string, ISO-3166-1 code to override the IP-based location.<br> |
| 38 | <br> |
| 39 | Returns:<br> |
| 40 | An object of the form<br> |
| 41 | <br> |
| 42 | {<br> |
| 43 | "kind": "books#bookshelf", # Resource type for bookshelf metadata.<br> |
| 44 | "description": "A String", # Description of this bookshelf.<br> |
| 45 | "created": "A String", # Created time for this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 46 | "volumeCount": 42, # Number of volumes in this bookshelf.<br> |
| 47 | "title": "A String", # Title of this bookshelf.<br> |
| 48 | "updated": "A String", # Last modified time of this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 49 | "access": "A String", # Whether this bookshelf is PUBLIC or PRIVATE.<br> |
| 50 | "volumesLastUpdated": "A String", # Last time a volume was added or removed from this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 51 | "id": 42, # Id of this bookshelf, only unique by user.<br> |
| 52 | "selfLink": "A String", # URL to this resource.<br> |
| 53 | }</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 54 | |
| 55 | <dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves a list of bookshelves belonging to the authenticated user.<br> |
| 56 | <br> |
| 57 | Args:<br> |
Joe Gregorio | 0250385 | 2011-08-31 09:07:55 -0400 | [diff] [blame] | 58 | country: string, ISO-3166-1 code to override the IP-based location.<br> |
Joe Gregorio | b417caf | 2011-12-08 12:04:24 -0500 | [diff] [blame] | 59 | source: string, String to identify the originator of this request.<br> |
| 60 | <br> |
| 61 | Returns:<br> |
| 62 | An object of the form<br> |
| 63 | <br> |
| 64 | {<br> |
| 65 | "items": [ # A list of bookshelves.<br> |
| 66 | {<br> |
| 67 | "kind": "books#bookshelf", # Resource type for bookshelf metadata.<br> |
| 68 | "description": "A String", # Description of this bookshelf.<br> |
| 69 | "created": "A String", # Created time for this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 70 | "volumeCount": 42, # Number of volumes in this bookshelf.<br> |
| 71 | "title": "A String", # Title of this bookshelf.<br> |
| 72 | "updated": "A String", # Last modified time of this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 73 | "access": "A String", # Whether this bookshelf is PUBLIC or PRIVATE.<br> |
| 74 | "volumesLastUpdated": "A String", # Last time a volume was added or removed from this bookshelf (formatted UTC timestamp with millisecond resolution).<br> |
| 75 | "id": 42, # Id of this bookshelf, only unique by user.<br> |
| 76 | "selfLink": "A String", # URL to this resource.<br> |
| 77 | },<br> |
| 78 | ],<br> |
| 79 | "kind": "books#bookshelves", # Resource type.<br> |
| 80 | }</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 81 | |
Joe Gregorio | 3d55ac5 | 2012-02-21 10:11:19 -0500 | [diff] [blame] | 82 | <dl><dt><a name="Resource-moveVolume"><strong>moveVolume</strong></a> = method(self, **kwargs)</dt><dd><tt>Moves a volume within a bookshelf.<br> |
| 83 | <br> |
| 84 | Args:<br> |
| 85 | volumePosition: integer, Position on shelf to move the item (0 puts the item before the current first item, 1 puts it between the first and the second and so on.) (required)<br> |
| 86 | source: string, String to identify the originator of this request.<br> |
| 87 | country: string, ISO-3166-1 code to override the IP-based location.<br> |
| 88 | volumeId: string, Id of volume to move. (required)<br> |
| 89 | shelf: string, Id of bookshelf with the volume. (required)</tt></dd></dl> |
| 90 | |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 91 | <dl><dt><a name="Resource-removeVolume"><strong>removeVolume</strong></a> = method(self, **kwargs)</dt><dd><tt>Removes a volume from a bookshelf.<br> |
| 92 | <br> |
| 93 | Args:<br> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 94 | source: string, String to identify the originator of this request.<br> |
Joe Gregorio | 0250385 | 2011-08-31 09:07:55 -0400 | [diff] [blame] | 95 | country: string, ISO-3166-1 code to override the IP-based location.<br> |
| 96 | volumeId: string, Id of volume to remove. (required)<br> |
| 97 | shelf: string, Id of bookshelf from which to remove a volume. (required)</tt></dd></dl> |
Joe Gregorio | b9e63ff | 2011-06-30 12:38:10 -0400 | [diff] [blame] | 98 | |
| 99 | <dl><dt><a name="Resource-volumes"><strong><a href="books.v1.mylibrary.bookshelves.volumes.html">volumes</a></strong></a> = methodResource(self)</dt><dd><tt>A collection resource.</tt></dd></dl> |
| 100 | |
| 101 | <hr> |
| 102 | Data descriptors defined here:<br> |
| 103 | <dl><dt><strong>__dict__</strong></dt> |
| 104 | <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| 105 | </dl> |
| 106 | <dl><dt><strong>__weakref__</strong></dt> |
| 107 | <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| 108 | </dl> |
| 109 | </td></tr></table> |
| 110 | </body></html> |