pinterest-ruby 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +7 -0
  3. data/.rubocop.yml +63 -0
  4. data/.travis-gemfile +17 -0
  5. data/.travis.yml +12 -0
  6. data/.yardopts +1 -0
  7. data/CHANGELOG.md +3 -0
  8. data/Gemfile +24 -0
  9. data/README.md +34 -0
  10. data/Rakefile +44 -0
  11. data/docs/FaradayMiddleware/SafeOj.html +218 -0
  12. data/docs/FaradayMiddleware.html +125 -0
  13. data/docs/Pinterest/Board.html +410 -0
  14. data/docs/Pinterest/Client.html +1894 -0
  15. data/docs/Pinterest/Collection.html +1877 -0
  16. data/docs/Pinterest/Endpoints/Authentication.html +578 -0
  17. data/docs/Pinterest/Endpoints/Boards.html +1443 -0
  18. data/docs/Pinterest/Endpoints/Pins.html +1296 -0
  19. data/docs/Pinterest/Endpoints/Users.html +1220 -0
  20. data/docs/Pinterest/Endpoints.html +127 -0
  21. data/docs/Pinterest/Entity.html +473 -0
  22. data/docs/Pinterest/Errors/AuthorizationError.html +158 -0
  23. data/docs/Pinterest/Errors/BadRequestError.html +158 -0
  24. data/docs/Pinterest/Errors/BaseError.html +487 -0
  25. data/docs/Pinterest/Errors/MethodNotAllowedError.html +158 -0
  26. data/docs/Pinterest/Errors/NotFoundError.html +158 -0
  27. data/docs/Pinterest/Errors/NotImplementedError.html +158 -0
  28. data/docs/Pinterest/Errors/PermissionsError.html +158 -0
  29. data/docs/Pinterest/Errors/RateLimitError.html +158 -0
  30. data/docs/Pinterest/Errors/ServerError.html +158 -0
  31. data/docs/Pinterest/Errors/TimeoutError.html +158 -0
  32. data/docs/Pinterest/Errors.html +377 -0
  33. data/docs/Pinterest/Image.html +617 -0
  34. data/docs/Pinterest/Interest.html +402 -0
  35. data/docs/Pinterest/Pin.html +511 -0
  36. data/docs/Pinterest/User.html +408 -0
  37. data/docs/Pinterest/Version.html +187 -0
  38. data/docs/Pinterest.html +130 -0
  39. data/docs/_index.html +401 -0
  40. data/docs/class_list.html +51 -0
  41. data/docs/css/common.css +1 -0
  42. data/docs/css/full_list.css +58 -0
  43. data/docs/css/style.css +492 -0
  44. data/docs/file.README.html +106 -0
  45. data/docs/file_list.html +56 -0
  46. data/docs/frames.html +17 -0
  47. data/docs/index.html +106 -0
  48. data/docs/js/app.js +243 -0
  49. data/docs/js/full_list.js +216 -0
  50. data/docs/js/jquery.js +4 -0
  51. data/docs/method_list.html +643 -0
  52. data/docs/top-level-namespace.html +110 -0
  53. data/lib/pinterest/client.rb +146 -0
  54. data/lib/pinterest/collection.rb +97 -0
  55. data/lib/pinterest/endpoints/authentication.rb +99 -0
  56. data/lib/pinterest/endpoints/boards.rb +193 -0
  57. data/lib/pinterest/endpoints/pins.rb +187 -0
  58. data/lib/pinterest/endpoints/users.rb +158 -0
  59. data/lib/pinterest/errors.rb +94 -0
  60. data/lib/pinterest/models/board.rb +34 -0
  61. data/lib/pinterest/models/entity.rb +42 -0
  62. data/lib/pinterest/models/image.rb +49 -0
  63. data/lib/pinterest/models/interest.rb +30 -0
  64. data/lib/pinterest/models/pin.rb +43 -0
  65. data/lib/pinterest/models/user.rb +33 -0
  66. data/lib/pinterest/safe_oj.rb +25 -0
  67. data/lib/pinterest/version.rb +23 -0
  68. data/lib/pinterest.rb +31 -0
  69. data/pinterest.gemspec +32 -0
  70. data/spec/cassettes/Pinterest_Client/_perform_network_request_private_/should_correctly_handle_malformed_requests.yml +51 -0
  71. data/spec/cassettes/Pinterest_Endpoints_Authentication/_fetch_access_token/should_make_the_call_to_Pinterest_and_return_the_authorization_token_also_saving_it.yml +58 -0
  72. data/spec/cassettes/Pinterest_Endpoints_Authentication/_verify_access_token/should_return_an_exception_when_using_an_invalid_token.yml +52 -0
  73. data/spec/cassettes/Pinterest_Endpoints_Authentication/_verify_access_token/should_verify_the_token.yml +59 -0
  74. data/spec/cassettes/Pinterest_Endpoints_Boards/_board/should_complain_for_invalid_boards.yml +48 -0
  75. data/spec/cassettes/Pinterest_Endpoints_Boards/_board/should_get_the_current_informations.yml +63 -0
  76. data/spec/cassettes/Pinterest_Endpoints_Boards/_board/should_restrict_to_requested_fields.yml +57 -0
  77. data/spec/cassettes/Pinterest_Endpoints_Boards/_boards/should_only_get_requested_fields.yml +57 -0
  78. data/spec/cassettes/Pinterest_Endpoints_Boards/_boards/should_return_a_list_of_boards.yml +74 -0
  79. data/spec/cassettes/Pinterest_Endpoints_Boards/_create_board/should_create_the_board_and_return_it_with_only_the_requested_fields.yml +56 -0
  80. data/spec/cassettes/Pinterest_Endpoints_Boards/_delete_board/should_perform_the_call_and_return_an_error.yml +48 -0
  81. data/spec/cassettes/Pinterest_Endpoints_Boards/_delete_board/should_perform_the_call_and_return_true.yml +109 -0
  82. data/spec/cassettes/Pinterest_Endpoints_Boards/_edit_board/should_edit_the_board_and_return_it_with_only_the_requested_fields.yml +56 -0
  83. data/spec/cassettes/Pinterest_Endpoints_Boards/_follow_board/should_complain_for_invalid_boards.yml +56 -0
  84. data/spec/cassettes/Pinterest_Endpoints_Boards/_follow_board/should_perform_the_call_and_return_true.yml +109 -0
  85. data/spec/cassettes/Pinterest_Endpoints_Boards/_following_boards/should_only_get_requested_fields.yml +59 -0
  86. data/spec/cassettes/Pinterest_Endpoints_Boards/_following_boards/should_paginate_correctly.yml +72 -0
  87. data/spec/cassettes/Pinterest_Endpoints_Boards/_following_boards/should_return_the_followed_boards.yml +72 -0
  88. data/spec/cassettes/Pinterest_Endpoints_Boards/_search_my_boards/should_only_get_requested_fields.yml +59 -0
  89. data/spec/cassettes/Pinterest_Endpoints_Boards/_search_my_boards/should_paginate_correctly.yml +66 -0
  90. data/spec/cassettes/Pinterest_Endpoints_Boards/_search_my_boards/should_search_boards.yml +75 -0
  91. data/spec/cassettes/Pinterest_Endpoints_Boards/_suggested_boards/should_return_the_suggested_boards_returning_only_the_requested_fields.yml +56 -0
  92. data/spec/cassettes/Pinterest_Endpoints_Boards/_unfollow_board/should_complain_for_invalid_boards.yml +56 -0
  93. data/spec/cassettes/Pinterest_Endpoints_Boards/_unfollow_board/should_perform_the_call_and_return_true.yml +109 -0
  94. data/spec/cassettes/Pinterest_Endpoints_Pins/_board_pins/should_only_get_requested_fields.yml +59 -0
  95. data/spec/cassettes/Pinterest_Endpoints_Pins/_board_pins/should_paginate_correctly.yml +85 -0
  96. data/spec/cassettes/Pinterest_Endpoints_Pins/_board_pins/should_return_the_pins_of_the_board.yml +85 -0
  97. data/spec/cassettes/Pinterest_Endpoints_Pins/_create_pin/should_create_a_pin_by_using_a_image_URL.yml +71 -0
  98. data/spec/cassettes/Pinterest_Endpoints_Pins/_create_pin/should_create_a_pin_by_using_a_image_file.yml +1997 -0
  99. data/spec/cassettes/Pinterest_Endpoints_Pins/_create_pin/should_return_a_pin_containing_only_requested_fields.yml +56 -0
  100. data/spec/cassettes/Pinterest_Endpoints_Pins/_delete_pin/should_perform_the_call_and_return_an_error.yml +56 -0
  101. data/spec/cassettes/Pinterest_Endpoints_Pins/_delete_pin/should_perform_the_call_and_return_true.yml +109 -0
  102. data/spec/cassettes/Pinterest_Endpoints_Pins/_edit_pin/should_edit_the_pin_and_return_it_with_only_the_requested_fields.yml +56 -0
  103. data/spec/cassettes/Pinterest_Endpoints_Pins/_likes/should_only_get_requested_fields.yml +58 -0
  104. data/spec/cassettes/Pinterest_Endpoints_Pins/_likes/should_paginate_correctly.yml +87 -0
  105. data/spec/cassettes/Pinterest_Endpoints_Pins/_likes/should_return_the_list_of_liked_pins.yml +85 -0
  106. data/spec/cassettes/Pinterest_Endpoints_Pins/_pin/should_complain_for_non_existent_pins.yml +56 -0
  107. data/spec/cassettes/Pinterest_Endpoints_Pins/_pin/should_get_the_current_informations.yml +71 -0
  108. data/spec/cassettes/Pinterest_Endpoints_Pins/_pin/should_restrict_to_requested_fields.yml +56 -0
  109. data/spec/cassettes/Pinterest_Endpoints_Pins/_pins/should_only_get_requested_fields.yml +59 -0
  110. data/spec/cassettes/Pinterest_Endpoints_Pins/_pins/should_paginate_correctly.yml +808 -0
  111. data/spec/cassettes/Pinterest_Endpoints_Pins/_pins/should_return_my_pins.yml +88 -0
  112. data/spec/cassettes/Pinterest_Endpoints_Pins/_search_my_pins/should_only_get_requested_fields.yml +61 -0
  113. data/spec/cassettes/Pinterest_Endpoints_Pins/_search_my_pins/should_paginate_correctly.yml +89 -0
  114. data/spec/cassettes/Pinterest_Endpoints_Pins/_search_my_pins/should_search_my_pins.yml +89 -0
  115. data/spec/cassettes/Pinterest_Endpoints_Users/_follow_interest/should_perform_the_call_and_return_an_error.yml +48 -0
  116. data/spec/cassettes/Pinterest_Endpoints_Users/_follow_user/should_complain_for_invalid_users.yml +56 -0
  117. data/spec/cassettes/Pinterest_Endpoints_Users/_follow_user/should_perform_the_call_and_return_true.yml +109 -0
  118. data/spec/cassettes/Pinterest_Endpoints_Users/_followers/should_only_get_requested_fields.yml +62 -0
  119. data/spec/cassettes/Pinterest_Endpoints_Users/_followers/should_paginate_correctly.yml +62 -0
  120. data/spec/cassettes/Pinterest_Endpoints_Users/_followers/should_return_a_list_of_followers.yml +62 -0
  121. data/spec/cassettes/Pinterest_Endpoints_Users/_following_users/should_only_get_requested_fields.yml +62 -0
  122. data/spec/cassettes/Pinterest_Endpoints_Users/_following_users/should_paginate_correctly.yml +131 -0
  123. data/spec/cassettes/Pinterest_Endpoints_Users/_following_users/should_return_a_list_of_followed_users.yml +66 -0
  124. data/spec/cassettes/Pinterest_Endpoints_Users/_interests/should_paginate_correctly.yml +112 -0
  125. data/spec/cassettes/Pinterest_Endpoints_Users/_interests/should_return_a_list_of_followed_interest.yml +58 -0
  126. data/spec/cassettes/Pinterest_Endpoints_Users/_me/should_get_the_current_informations.yml +62 -0
  127. data/spec/cassettes/Pinterest_Endpoints_Users/_me/should_restrict_to_requested_fields.yml +56 -0
  128. data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_interest/should_perform_the_call_and_return_an_error.yml +48 -0
  129. data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_user/should_complain_for_invalid_users.yml +56 -0
  130. data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_user/should_perform_the_call_and_return_true.yml +109 -0
  131. data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_complain_for_non_existent_users.yml +56 -0
  132. data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_get_the_current_informations.yml +60 -0
  133. data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_restrict_to_requested_fields.yml +56 -0
  134. data/spec/pinterest/client_spec.rb +70 -0
  135. data/spec/pinterest/collection_spec.rb +82 -0
  136. data/spec/pinterest/endpoints/authentication_spec.rb +81 -0
  137. data/spec/pinterest/endpoints/boards_spec.rb +209 -0
  138. data/spec/pinterest/endpoints/pins_spec.rb +239 -0
  139. data/spec/pinterest/endpoints/users_spec.rb +194 -0
  140. data/spec/pinterest/errors_spec.rb +59 -0
  141. data/spec/pinterest/fixtures/first.jpg +0 -0
  142. data/spec/pinterest/models/board_spec.rb +48 -0
  143. data/spec/pinterest/models/entity_spec.rb +35 -0
  144. data/spec/pinterest/models/image_spec.rb +50 -0
  145. data/spec/pinterest/models/interest_spec.rb +20 -0
  146. data/spec/pinterest/models/pin_spec.rb +55 -0
  147. data/spec/pinterest/models/user_spec.rb +45 -0
  148. data/spec/spec_helper.rb +49 -0
  149. data/tester.rb +19 -0
  150. metadata +341 -0
@@ -0,0 +1,1443 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>
7
+ Module: Pinterest::Endpoints::Boards
8
+
9
+ &mdash; Documentation by YARD 0.9.7
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="../../css/style.css" type="text/css" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="../../css/common.css" type="text/css" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ pathId = "Pinterest::Endpoints::Boards";
19
+ relpath = '../../';
20
+ </script>
21
+
22
+
23
+ <script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
24
+
25
+ <script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div class="nav_wrap">
31
+ <iframe id="nav" src="../../class_list.html?1"></iframe>
32
+ <div id="resizer"></div>
33
+ </div>
34
+
35
+ <div id="main" tabindex="-1">
36
+ <div id="header">
37
+ <div id="menu">
38
+
39
+ <a href="../../_index.html">Index (B)</a> &raquo;
40
+ <span class='title'><span class='object_link'><a href="../../Pinterest.html" title="Pinterest (module)">Pinterest</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Endpoints.html" title="Pinterest::Endpoints (module)">Endpoints</a></span></span>
41
+ &raquo;
42
+ <span class="title">Boards</span>
43
+
44
+ </div>
45
+
46
+ <div id="search">
47
+
48
+ <a class="full_list_link" id="class_list_link"
49
+ href="../../class_list.html">
50
+
51
+ <svg width="24" height="24">
52
+ <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
53
+ <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
54
+ <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
55
+ </svg>
56
+ </a>
57
+
58
+ </div>
59
+ <div class="clear"></div>
60
+ </div>
61
+
62
+ <div id="content"><h1>Module: Pinterest::Endpoints::Boards
63
+
64
+
65
+
66
+ </h1>
67
+ <div class="box_info">
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+
77
+ <dl>
78
+ <dt>Included in:</dt>
79
+ <dd><span class='object_link'><a href="../Client.html" title="Pinterest::Client (class)">Client</a></span></dd>
80
+ </dl>
81
+
82
+
83
+
84
+ <dl>
85
+ <dt>Defined in:</dt>
86
+ <dd>lib/pinterest/endpoints/boards.rb</dd>
87
+ </dl>
88
+
89
+ </div>
90
+
91
+ <h2>Overview</h2><div class="docstring">
92
+ <div class="discussion">
93
+ <p>Boards related endpoints.</p>
94
+
95
+
96
+ </div>
97
+ </div>
98
+ <div class="tags">
99
+
100
+
101
+ </div>
102
+
103
+
104
+
105
+
106
+
107
+
108
+
109
+ <h2>
110
+ Instance Method Summary
111
+ <small><a href="#" class="summary_toggle">collapse</a></small>
112
+ </h2>
113
+
114
+ <ul class="summary">
115
+
116
+ <li class="public ">
117
+ <span class="summary_signature">
118
+
119
+ <a href="#board-instance_method" title="#board (instance method)">#<strong>board</strong>(board, fields: nil) &#x21d2; Pinterest::Board </a>
120
+
121
+
122
+
123
+ </span>
124
+
125
+
126
+
127
+
128
+
129
+
130
+
131
+
132
+
133
+ <span class="summary_desc"><div class='inline'><p>Returns information about a board.</p>
134
+ </div></span>
135
+
136
+ </li>
137
+
138
+
139
+ <li class="public ">
140
+ <span class="summary_signature">
141
+
142
+ <a href="#boards-instance_method" title="#boards (instance method)">#<strong>boards</strong>(fields: nil) &#x21d2; Pinterest::Collection </a>
143
+
144
+
145
+
146
+ </span>
147
+
148
+
149
+
150
+
151
+
152
+
153
+
154
+
155
+
156
+ <span class="summary_desc"><div class='inline'><p>Returns the list of the boards of the authenticated user.</p>
157
+ </div></span>
158
+
159
+ </li>
160
+
161
+
162
+ <li class="public ">
163
+ <span class="summary_signature">
164
+
165
+ <a href="#create_board-instance_method" title="#create_board (instance method)">#<strong>create_board</strong>(name, description = &quot;&quot;, fields: nil) &#x21d2; Pinterest::Board </a>
166
+
167
+
168
+
169
+ </span>
170
+
171
+
172
+
173
+
174
+
175
+
176
+
177
+
178
+
179
+ <span class="summary_desc"><div class='inline'><p>Creates a new board.</p>
180
+ </div></span>
181
+
182
+ </li>
183
+
184
+
185
+ <li class="public ">
186
+ <span class="summary_signature">
187
+
188
+ <a href="#delete_board-instance_method" title="#delete_board (instance method)">#<strong>delete_board</strong>(board) &#x21d2; Boolean </a>
189
+
190
+
191
+
192
+ </span>
193
+
194
+
195
+
196
+
197
+
198
+
199
+
200
+
201
+
202
+ <span class="summary_desc"><div class='inline'><p>Deletes a board.</p>
203
+ </div></span>
204
+
205
+ </li>
206
+
207
+
208
+ <li class="public ">
209
+ <span class="summary_signature">
210
+
211
+ <a href="#edit_board-instance_method" title="#edit_board (instance method)">#<strong>edit_board</strong>(board, name: nil, description: nil, fields: nil) &#x21d2; Pinterest::Board </a>
212
+
213
+
214
+
215
+ </span>
216
+
217
+
218
+
219
+
220
+
221
+
222
+
223
+
224
+
225
+ <span class="summary_desc"><div class='inline'><p>Edits a board.</p>
226
+ </div></span>
227
+
228
+ </li>
229
+
230
+
231
+ <li class="public ">
232
+ <span class="summary_signature">
233
+
234
+ <a href="#follow_board-instance_method" title="#follow_board (instance method)">#<strong>follow_board</strong>(board) &#x21d2; Boolean </a>
235
+
236
+
237
+
238
+ </span>
239
+
240
+
241
+
242
+
243
+
244
+
245
+
246
+
247
+
248
+ <span class="summary_desc"><div class='inline'><p>Follows a board.</p>
249
+ </div></span>
250
+
251
+ </li>
252
+
253
+
254
+ <li class="public ">
255
+ <span class="summary_signature">
256
+
257
+ <a href="#following_boards-instance_method" title="#following_boards (instance method)">#<strong>following_boards</strong>(fields: nil, cursor: nil, limit: nil) &#x21d2; Pinterest::Collection </a>
258
+
259
+
260
+
261
+ </span>
262
+
263
+
264
+
265
+
266
+
267
+
268
+
269
+
270
+
271
+ <span class="summary_desc"><div class='inline'><p>Returns the list of boards followed by the authenticated user.</p>
272
+ </div></span>
273
+
274
+ </li>
275
+
276
+
277
+ <li class="public ">
278
+ <span class="summary_signature">
279
+
280
+ <a href="#search_my_boards-instance_method" title="#search_my_boards (instance method)">#<strong>search_my_boards</strong>(query, fields: nil, cursor: nil, limit: nil) &#x21d2; Pinterest::Collection </a>
281
+
282
+
283
+
284
+ </span>
285
+
286
+
287
+
288
+
289
+
290
+
291
+
292
+
293
+
294
+ <span class="summary_desc"><div class='inline'><p>Search between of boards of the authenticated user.</p>
295
+ </div></span>
296
+
297
+ </li>
298
+
299
+
300
+ <li class="public ">
301
+ <span class="summary_signature">
302
+
303
+ <a href="#suggested_boards-instance_method" title="#suggested_boards (instance method)">#<strong>suggested_boards</strong>(fields: nil, cursor: nil, limit: nil) &#x21d2; Pinterest::Collection </a>
304
+
305
+
306
+
307
+ </span>
308
+
309
+
310
+
311
+
312
+
313
+
314
+
315
+
316
+
317
+ <span class="summary_desc"><div class='inline'><p>Returns the list of boards of suggested boards for the authenticated user.</p>
318
+ </div></span>
319
+
320
+ </li>
321
+
322
+
323
+ <li class="public ">
324
+ <span class="summary_signature">
325
+
326
+ <a href="#unfollow_board-instance_method" title="#unfollow_board (instance method)">#<strong>unfollow_board</strong>(board) &#x21d2; Boolean </a>
327
+
328
+
329
+
330
+ </span>
331
+
332
+
333
+
334
+
335
+
336
+
337
+
338
+
339
+
340
+ <span class="summary_desc"><div class='inline'><p>Stop following a board.</p>
341
+ </div></span>
342
+
343
+ </li>
344
+
345
+
346
+ </ul>
347
+
348
+
349
+
350
+
351
+ <div id="instance_method_details" class="method_details_list">
352
+ <h2>Instance Method Details</h2>
353
+
354
+
355
+ <div class="method_details first">
356
+ <h3 class="signature first" id="board-instance_method">
357
+
358
+ #<strong>board</strong>(board, fields: nil) &#x21d2; <tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>
359
+
360
+
361
+
362
+
363
+
364
+ </h3><div class="docstring">
365
+ <div class="discussion">
366
+ <p>Returns information about a board.</p>
367
+
368
+
369
+ </div>
370
+ </div>
371
+ <div class="tags">
372
+ <p class="tag_title">Parameters:</p>
373
+ <ul class="param">
374
+
375
+ <li>
376
+
377
+ <span class='name'>board</span>
378
+
379
+
380
+ <span class='type'>(<tt>String</tt>)</span>
381
+
382
+
383
+
384
+ &mdash;
385
+ <div class='inline'><p>The board path (username/id) or user id.</p>
386
+ </div>
387
+
388
+ </li>
389
+
390
+ <li>
391
+
392
+ <span class='name'>fields</span>
393
+
394
+
395
+ <span class='type'>(<tt>Array</tt>)</span>
396
+
397
+
398
+
399
+ &mdash;
400
+ <div class='inline'><p>A list of fields to return.</p>
401
+ </div>
402
+
403
+ </li>
404
+
405
+ </ul>
406
+
407
+ <p class="tag_title">Returns:</p>
408
+ <ul class="return">
409
+
410
+ <li>
411
+
412
+
413
+ <span class='type'>(<tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>)</span>
414
+
415
+
416
+
417
+ &mdash;
418
+ <div class='inline'><p>A board object.</p>
419
+ </div>
420
+
421
+ </li>
422
+
423
+ </ul>
424
+
425
+ </div><table class="source_code">
426
+ <tr>
427
+ <td>
428
+ <pre class="lines">
429
+
430
+
431
+ 15
432
+ 16
433
+ 17
434
+ 18
435
+ 19
436
+ 20
437
+ 21
438
+ 22
439
+ 23
440
+ 24
441
+ 25</pre>
442
+ </td>
443
+ <td>
444
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 15</span>
445
+
446
+ <span class='kw'>def</span> <span class='id identifier rubyid_board'>board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='comma'>,</span> <span class='label'>fields:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
447
+ <span class='comment'># Validate the board id
448
+ </span> <span class='id identifier rubyid_board'>board</span> <span class='op'>=</span> <span class='id identifier rubyid_validate_board'>validate_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
449
+
450
+ <span class='comment'># Ensure only valid fields are used
451
+ </span> <span class='id identifier rubyid_fields'>fields</span> <span class='op'>=</span> <span class='id identifier rubyid_ensure_board_fields'>ensure_board_fields</span><span class='lparen'>(</span><span class='id identifier rubyid_fields'>fields</span><span class='rparen'>)</span>
452
+
453
+ <span class='comment'># Perform the request and create the board
454
+ </span> <span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span><span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/boards/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_board'>board</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='label'>query:</span> <span class='id identifier rubyid_cleanup_params'>cleanup_params</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='label'>fields:</span> <span class='id identifier rubyid_fields'>fields</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>,</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>data</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span>
455
+ <span class='op'>::</span><span class='const'><span class='object_link'><a href="../../Pinterest.html" title="Pinterest (module)">Pinterest</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Board</a></span></span><span class='period'>.</span><span class='id identifier rubyid_create'><span class='object_link'><a href="../Board.html#create-class_method" title="Pinterest::Board.create (method)">create</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='rparen'>)</span>
456
+ <span class='kw'>end</span></pre>
457
+ </td>
458
+ </tr>
459
+ </table>
460
+ </div>
461
+
462
+ <div class="method_details ">
463
+ <h3 class="signature " id="boards-instance_method">
464
+
465
+ #<strong>boards</strong>(fields: nil) &#x21d2; <tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>
466
+
467
+
468
+
469
+
470
+
471
+ </h3><div class="docstring">
472
+ <div class="discussion">
473
+ <p>Returns the list of the boards of the authenticated user. Pagination is not supported by Pinterest API.</p>
474
+
475
+
476
+ </div>
477
+ </div>
478
+ <div class="tags">
479
+ <p class="tag_title">Parameters:</p>
480
+ <ul class="param">
481
+
482
+ <li>
483
+
484
+ <span class='name'>fields</span>
485
+
486
+
487
+ <span class='type'>(<tt>Array</tt>)</span>
488
+
489
+
490
+
491
+ &mdash;
492
+ <div class='inline'><p>A list of fields to return.</p>
493
+ </div>
494
+
495
+ </li>
496
+
497
+ </ul>
498
+
499
+ <p class="tag_title">Returns:</p>
500
+ <ul class="return">
501
+
502
+ <li>
503
+
504
+
505
+ <span class='type'>(<tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>)</span>
506
+
507
+
508
+
509
+ &mdash;
510
+ <div class='inline'><p>An collection of board objects.</p>
511
+ </div>
512
+
513
+ </li>
514
+
515
+ </ul>
516
+
517
+ </div><table class="source_code">
518
+ <tr>
519
+ <td>
520
+ <pre class="lines">
521
+
522
+
523
+ 31
524
+ 32
525
+ 33</pre>
526
+ </td>
527
+ <td>
528
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 31</span>
529
+
530
+ <span class='kw'>def</span> <span class='id identifier rubyid_boards'>boards</span><span class='lparen'>(</span><span class='label'>fields:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
531
+ <span class='id identifier rubyid_get_boards_collection'>get_boards_collection</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/boards/</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_fields'>fields</span><span class='rparen'>)</span>
532
+ <span class='kw'>end</span></pre>
533
+ </td>
534
+ </tr>
535
+ </table>
536
+ </div>
537
+
538
+ <div class="method_details ">
539
+ <h3 class="signature " id="create_board-instance_method">
540
+
541
+ #<strong>create_board</strong>(name, description = &quot;&quot;, fields: nil) &#x21d2; <tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>
542
+
543
+
544
+
545
+
546
+
547
+ </h3><div class="docstring">
548
+ <div class="discussion">
549
+ <p>Creates a new board.</p>
550
+
551
+
552
+ </div>
553
+ </div>
554
+ <div class="tags">
555
+ <p class="tag_title">Parameters:</p>
556
+ <ul class="param">
557
+
558
+ <li>
559
+
560
+ <span class='name'>name</span>
561
+
562
+
563
+ <span class='type'>(<tt>String</tt>)</span>
564
+
565
+
566
+
567
+ &mdash;
568
+ <div class='inline'><p>The board name.</p>
569
+ </div>
570
+
571
+ </li>
572
+
573
+ <li>
574
+
575
+ <span class='name'>description</span>
576
+
577
+
578
+ <span class='type'>(<tt>String</tt>)</span>
579
+
580
+
581
+ <em class="default">(defaults to: <tt>&quot;&quot;</tt>)</em>
582
+
583
+
584
+ &mdash;
585
+ <div class='inline'><p>The board description.</p>
586
+ </div>
587
+
588
+ </li>
589
+
590
+ <li>
591
+
592
+ <span class='name'>fields</span>
593
+
594
+
595
+ <span class='type'>(<tt>Array</tt>)</span>
596
+
597
+
598
+
599
+ &mdash;
600
+ <div class='inline'><p>A list of fields to return.</p>
601
+ </div>
602
+
603
+ </li>
604
+
605
+ </ul>
606
+
607
+ <p class="tag_title">Returns:</p>
608
+ <ul class="return">
609
+
610
+ <li>
611
+
612
+
613
+ <span class='type'>(<tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>)</span>
614
+
615
+
616
+
617
+ &mdash;
618
+ <div class='inline'><p>The created board object.</p>
619
+ </div>
620
+
621
+ </li>
622
+
623
+ </ul>
624
+
625
+ </div><table class="source_code">
626
+ <tr>
627
+ <td>
628
+ <pre class="lines">
629
+
630
+
631
+ 41
632
+ 42
633
+ 43
634
+ 44
635
+ 45
636
+ 46
637
+ 47
638
+ 48
639
+ 49
640
+ 50
641
+ 51
642
+ 52
643
+ 53
644
+ 54
645
+ 55
646
+ 56
647
+ 57</pre>
648
+ </td>
649
+ <td>
650
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 41</span>
651
+
652
+ <span class='kw'>def</span> <span class='id identifier rubyid_create_board'>create_board</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_description'>description</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>fields:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
653
+ <span class='comment'># Validate name
654
+ </span> <span class='id identifier rubyid_ensure_param'>ensure_param</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>You have to specify the board name.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
655
+
656
+ <span class='comment'># Ensure only valid fields are used
657
+ </span> <span class='id identifier rubyid_fields'>fields</span> <span class='op'>=</span> <span class='id identifier rubyid_ensure_board_fields'>ensure_board_fields</span><span class='lparen'>(</span><span class='id identifier rubyid_fields'>fields</span><span class='rparen'>)</span>
658
+
659
+ <span class='comment'># Create the board
660
+ </span> <span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span>
661
+ <span class='label'>method:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>POST</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/boards/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='comma'>,</span>
662
+ <span class='label'>query:</span> <span class='id identifier rubyid_cleanup_params'>cleanup_params</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='label'>fields:</span> <span class='id identifier rubyid_fields'>fields</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>,</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='rparen'>)</span><span class='comma'>,</span>
663
+ <span class='label'>body:</span> <span class='id identifier rubyid_cleanup_params'>cleanup_params</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='label'>name:</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>description:</span> <span class='id identifier rubyid_description'>description</span><span class='rbrace'>}</span><span class='rparen'>)</span>
664
+ <span class='rparen'>)</span>
665
+
666
+ <span class='comment'># Wrap in a object
667
+ </span> <span class='op'>::</span><span class='const'><span class='object_link'><a href="../../Pinterest.html" title="Pinterest (module)">Pinterest</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Board</a></span></span><span class='period'>.</span><span class='id identifier rubyid_create'><span class='object_link'><a href="../Board.html#create-class_method" title="Pinterest::Board.create (method)">create</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>data</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span><span class='rparen'>)</span>
668
+ <span class='kw'>end</span></pre>
669
+ </td>
670
+ </tr>
671
+ </table>
672
+ </div>
673
+
674
+ <div class="method_details ">
675
+ <h3 class="signature " id="delete_board-instance_method">
676
+
677
+ #<strong>delete_board</strong>(board) &#x21d2; <tt>Boolean</tt>
678
+
679
+
680
+
681
+
682
+
683
+ </h3><div class="docstring">
684
+ <div class="discussion">
685
+ <p>Deletes a board.</p>
686
+
687
+
688
+ </div>
689
+ </div>
690
+ <div class="tags">
691
+ <p class="tag_title">Parameters:</p>
692
+ <ul class="param">
693
+
694
+ <li>
695
+
696
+ <span class='name'>board</span>
697
+
698
+
699
+ <span class='type'>(<tt>Fixnum</tt>)</span>
700
+
701
+
702
+
703
+ &mdash;
704
+ <div class='inline'><p>The board id.</p>
705
+ </div>
706
+
707
+ </li>
708
+
709
+ </ul>
710
+
711
+ <p class="tag_title">Returns:</p>
712
+ <ul class="return">
713
+
714
+ <li>
715
+
716
+
717
+ <span class='type'>(<tt>Boolean</tt>)</span>
718
+
719
+
720
+
721
+ &mdash;
722
+ <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
723
+ </div>
724
+
725
+ </li>
726
+
727
+ </ul>
728
+
729
+ </div><table class="source_code">
730
+ <tr>
731
+ <td>
732
+ <pre class="lines">
733
+
734
+
735
+ 89
736
+ 90
737
+ 91
738
+ 92
739
+ 93
740
+ 94
741
+ 95
742
+ 96</pre>
743
+ </td>
744
+ <td>
745
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 89</span>
746
+
747
+ <span class='kw'>def</span> <span class='id identifier rubyid_delete_board'>delete_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
748
+ <span class='comment'># Validate the board id
749
+ </span> <span class='id identifier rubyid_board'>board</span> <span class='op'>=</span> <span class='id identifier rubyid_validate_board'>validate_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
750
+
751
+ <span class='comment'># Perform the request
752
+ </span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span><span class='label'>method:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>DELETE</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/boards/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_board'>board</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
753
+ <span class='kw'>true</span>
754
+ <span class='kw'>end</span></pre>
755
+ </td>
756
+ </tr>
757
+ </table>
758
+ </div>
759
+
760
+ <div class="method_details ">
761
+ <h3 class="signature " id="edit_board-instance_method">
762
+
763
+ #<strong>edit_board</strong>(board, name: nil, description: nil, fields: nil) &#x21d2; <tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>
764
+
765
+
766
+
767
+
768
+
769
+ </h3><div class="docstring">
770
+ <div class="discussion">
771
+ <p>Edits a board.</p>
772
+
773
+
774
+ </div>
775
+ </div>
776
+ <div class="tags">
777
+ <p class="tag_title">Parameters:</p>
778
+ <ul class="param">
779
+
780
+ <li>
781
+
782
+ <span class='name'>board</span>
783
+
784
+
785
+ <span class='type'>(<tt>Fixnum</tt>)</span>
786
+
787
+
788
+
789
+ &mdash;
790
+ <div class='inline'><p>The board id.</p>
791
+ </div>
792
+
793
+ </li>
794
+
795
+ <li>
796
+
797
+ <span class='name'>name</span>
798
+
799
+
800
+ <span class='type'>(<tt>String</tt>)</span>
801
+
802
+
803
+
804
+ &mdash;
805
+ <div class='inline'><p>The new board name.</p>
806
+ </div>
807
+
808
+ </li>
809
+
810
+ <li>
811
+
812
+ <span class='name'>description</span>
813
+
814
+
815
+ <span class='type'>(<tt>String</tt>)</span>
816
+
817
+
818
+
819
+ &mdash;
820
+ <div class='inline'><p>The new board description.</p>
821
+ </div>
822
+
823
+ </li>
824
+
825
+ <li>
826
+
827
+ <span class='name'>fields</span>
828
+
829
+
830
+ <span class='type'>(<tt>Array</tt>)</span>
831
+
832
+
833
+
834
+ &mdash;
835
+ <div class='inline'><p>A list of fields to return.</p>
836
+ </div>
837
+
838
+ </li>
839
+
840
+ </ul>
841
+
842
+ <p class="tag_title">Returns:</p>
843
+ <ul class="return">
844
+
845
+ <li>
846
+
847
+
848
+ <span class='type'>(<tt><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Pinterest::Board</a></span></tt>)</span>
849
+
850
+
851
+
852
+ &mdash;
853
+ <div class='inline'><p>The updated board object.</p>
854
+ </div>
855
+
856
+ </li>
857
+
858
+ </ul>
859
+ <p class="tag_title">Raises:</p>
860
+ <ul class="raise">
861
+
862
+ <li>
863
+
864
+
865
+ <span class='type'>(<tt>ArgumentError</tt>)</span>
866
+
867
+
868
+
869
+ </li>
870
+
871
+ </ul>
872
+
873
+ </div><table class="source_code">
874
+ <tr>
875
+ <td>
876
+ <pre class="lines">
877
+
878
+
879
+ 66
880
+ 67
881
+ 68
882
+ 69
883
+ 70
884
+ 71
885
+ 72
886
+ 73
887
+ 74
888
+ 75
889
+ 76
890
+ 77
891
+ 78
892
+ 79
893
+ 80
894
+ 81
895
+ 82
896
+ 83</pre>
897
+ </td>
898
+ <td>
899
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 66</span>
900
+
901
+ <span class='kw'>def</span> <span class='id identifier rubyid_edit_board'>edit_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='comma'>,</span> <span class='label'>name:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>description:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>fields:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
902
+ <span class='comment'># Validate the board id
903
+ </span> <span class='id identifier rubyid_raise'>raise</span><span class='lparen'>(</span><span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>You have to specify a board or its id.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_board'>board</span>
904
+ <span class='id identifier rubyid_board'>board</span> <span class='op'>=</span> <span class='id identifier rubyid_board'>board</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span> <span class='kw'>if</span> <span class='id identifier rubyid_board'>board</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../../Pinterest.html" title="Pinterest (module)">Pinterest</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Board</a></span></span><span class='rparen'>)</span>
905
+
906
+ <span class='comment'># Ensure only valid fields are used
907
+ </span> <span class='id identifier rubyid_fields'>fields</span> <span class='op'>=</span> <span class='id identifier rubyid_ensure_board_fields'>ensure_board_fields</span><span class='lparen'>(</span><span class='id identifier rubyid_fields'>fields</span><span class='rparen'>)</span>
908
+
909
+ <span class='comment'># Create the board
910
+ </span> <span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span>
911
+ <span class='label'>method:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>PATCH</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/boards/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_board'>board</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='comma'>,</span>
912
+ <span class='label'>query:</span> <span class='id identifier rubyid_cleanup_params'>cleanup_params</span><span class='lparen'>(</span><span class='label'>fields:</span> <span class='id identifier rubyid_fields'>fields</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>,</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span><span class='comma'>,</span>
913
+ <span class='label'>body:</span> <span class='id identifier rubyid_cleanup_params'>cleanup_params</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='label'>name:</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>description:</span> <span class='id identifier rubyid_description'>description</span><span class='rbrace'>}</span><span class='rparen'>)</span>
914
+ <span class='rparen'>)</span>
915
+
916
+ <span class='comment'># Wrap in a object
917
+ </span> <span class='op'>::</span><span class='const'><span class='object_link'><a href="../../Pinterest.html" title="Pinterest (module)">Pinterest</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Board.html" title="Pinterest::Board (class)">Board</a></span></span><span class='period'>.</span><span class='id identifier rubyid_create'><span class='object_link'><a href="../Board.html#create-class_method" title="Pinterest::Board.create (method)">create</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>data</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span><span class='rparen'>)</span>
918
+ <span class='kw'>end</span></pre>
919
+ </td>
920
+ </tr>
921
+ </table>
922
+ </div>
923
+
924
+ <div class="method_details ">
925
+ <h3 class="signature " id="follow_board-instance_method">
926
+
927
+ #<strong>follow_board</strong>(board) &#x21d2; <tt>Boolean</tt>
928
+
929
+
930
+
931
+
932
+
933
+ </h3><div class="docstring">
934
+ <div class="discussion">
935
+ <p>Follows a board.</p>
936
+
937
+
938
+ </div>
939
+ </div>
940
+ <div class="tags">
941
+ <p class="tag_title">Parameters:</p>
942
+ <ul class="param">
943
+
944
+ <li>
945
+
946
+ <span class='name'>board</span>
947
+
948
+
949
+ <span class='type'>(<tt>String</tt>)</span>
950
+
951
+
952
+
953
+ &mdash;
954
+ <div class='inline'><p>The board id.</p>
955
+ </div>
956
+
957
+ </li>
958
+
959
+ </ul>
960
+
961
+ <p class="tag_title">Returns:</p>
962
+ <ul class="return">
963
+
964
+ <li>
965
+
966
+
967
+ <span class='type'>(<tt>Boolean</tt>)</span>
968
+
969
+
970
+
971
+ &mdash;
972
+ <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
973
+ </div>
974
+
975
+ </li>
976
+
977
+ </ul>
978
+
979
+ </div><table class="source_code">
980
+ <tr>
981
+ <td>
982
+ <pre class="lines">
983
+
984
+
985
+ 134
986
+ 135
987
+ 136
988
+ 137
989
+ 138
990
+ 139
991
+ 140
992
+ 141</pre>
993
+ </td>
994
+ <td>
995
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 134</span>
996
+
997
+ <span class='kw'>def</span> <span class='id identifier rubyid_follow_board'>follow_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
998
+ <span class='comment'># Validate the board id
999
+ </span> <span class='id identifier rubyid_board'>board</span> <span class='op'>=</span> <span class='id identifier rubyid_validate_board'>validate_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
1000
+
1001
+ <span class='comment'># Perform the request
1002
+ </span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span><span class='label'>method:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>POST</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>query:</span> <span class='lbrace'>{</span><span class='label'>board:</span> <span class='id identifier rubyid_board'>board</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/following/boards/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
1003
+ <span class='kw'>true</span>
1004
+ <span class='kw'>end</span></pre>
1005
+ </td>
1006
+ </tr>
1007
+ </table>
1008
+ </div>
1009
+
1010
+ <div class="method_details ">
1011
+ <h3 class="signature " id="following_boards-instance_method">
1012
+
1013
+ #<strong>following_boards</strong>(fields: nil, cursor: nil, limit: nil) &#x21d2; <tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>
1014
+
1015
+
1016
+
1017
+
1018
+
1019
+ </h3><div class="docstring">
1020
+ <div class="discussion">
1021
+ <p>Returns the list of boards followed by the authenticated user.</p>
1022
+
1023
+
1024
+ </div>
1025
+ </div>
1026
+ <div class="tags">
1027
+ <p class="tag_title">Parameters:</p>
1028
+ <ul class="param">
1029
+
1030
+ <li>
1031
+
1032
+ <span class='name'>fields</span>
1033
+
1034
+
1035
+ <span class='type'>(<tt>Array</tt>)</span>
1036
+
1037
+
1038
+
1039
+ &mdash;
1040
+ <div class='inline'><p>A list of fields to return.</p>
1041
+ </div>
1042
+
1043
+ </li>
1044
+
1045
+ <li>
1046
+
1047
+ <span class='name'>cursor</span>
1048
+
1049
+
1050
+ <span class='type'>(<tt>String</tt>)</span>
1051
+
1052
+
1053
+
1054
+ &mdash;
1055
+ <div class='inline'><p>A cursor to paginate results, obtained by a previous call.</p>
1056
+ </div>
1057
+
1058
+ </li>
1059
+
1060
+ <li>
1061
+
1062
+ <span class='name'>limit</span>
1063
+
1064
+
1065
+ <span class='type'>(<tt>Fixnum</tt>)</span>
1066
+
1067
+
1068
+
1069
+ &mdash;
1070
+ <div class='inline'><p>The maximum number of objects to return.</p>
1071
+ </div>
1072
+
1073
+ </li>
1074
+
1075
+ </ul>
1076
+
1077
+ <p class="tag_title">Returns:</p>
1078
+ <ul class="return">
1079
+
1080
+ <li>
1081
+
1082
+
1083
+ <span class='type'>(<tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>)</span>
1084
+
1085
+
1086
+
1087
+ &mdash;
1088
+ <div class='inline'><p>An collection of board objects.</p>
1089
+ </div>
1090
+
1091
+ </li>
1092
+
1093
+ </ul>
1094
+
1095
+ </div><table class="source_code">
1096
+ <tr>
1097
+ <td>
1098
+ <pre class="lines">
1099
+
1100
+
1101
+ 126
1102
+ 127
1103
+ 128</pre>
1104
+ </td>
1105
+ <td>
1106
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 126</span>
1107
+
1108
+ <span class='kw'>def</span> <span class='id identifier rubyid_following_boards'>following_boards</span><span class='lparen'>(</span><span class='label'>fields:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>cursor:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>limit:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1109
+ <span class='id identifier rubyid_get_boards_collection'>get_boards_collection</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/following/boards/</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_fields'>fields</span><span class='comma'>,</span> <span class='id identifier rubyid_cursor'>cursor</span><span class='comma'>,</span> <span class='id identifier rubyid_limit'>limit</span><span class='rparen'>)</span>
1110
+ <span class='kw'>end</span></pre>
1111
+ </td>
1112
+ </tr>
1113
+ </table>
1114
+ </div>
1115
+
1116
+ <div class="method_details ">
1117
+ <h3 class="signature " id="search_my_boards-instance_method">
1118
+
1119
+ #<strong>search_my_boards</strong>(query, fields: nil, cursor: nil, limit: nil) &#x21d2; <tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>
1120
+
1121
+
1122
+
1123
+
1124
+
1125
+ </h3><div class="docstring">
1126
+ <div class="discussion">
1127
+ <p>Search between of boards of the authenticated user.</p>
1128
+
1129
+
1130
+ </div>
1131
+ </div>
1132
+ <div class="tags">
1133
+ <p class="tag_title">Parameters:</p>
1134
+ <ul class="param">
1135
+
1136
+ <li>
1137
+
1138
+ <span class='name'>query</span>
1139
+
1140
+
1141
+ <span class='type'>(<tt>String</tt>)</span>
1142
+
1143
+
1144
+
1145
+ &mdash;
1146
+ <div class='inline'><p>The query to perform.</p>
1147
+ </div>
1148
+
1149
+ </li>
1150
+
1151
+ <li>
1152
+
1153
+ <span class='name'>fields</span>
1154
+
1155
+
1156
+ <span class='type'>(<tt>Array</tt>)</span>
1157
+
1158
+
1159
+
1160
+ &mdash;
1161
+ <div class='inline'><p>A list of fields to return.</p>
1162
+ </div>
1163
+
1164
+ </li>
1165
+
1166
+ <li>
1167
+
1168
+ <span class='name'>cursor</span>
1169
+
1170
+
1171
+ <span class='type'>(<tt>String</tt>)</span>
1172
+
1173
+
1174
+
1175
+ &mdash;
1176
+ <div class='inline'><p>A cursor to paginate results, obtained by a previous call.</p>
1177
+ </div>
1178
+
1179
+ </li>
1180
+
1181
+ <li>
1182
+
1183
+ <span class='name'>limit</span>
1184
+
1185
+
1186
+ <span class='type'>(<tt>Fixnum</tt>)</span>
1187
+
1188
+
1189
+
1190
+ &mdash;
1191
+ <div class='inline'><p>The maximum number of objects to return.</p>
1192
+ </div>
1193
+
1194
+ </li>
1195
+
1196
+ </ul>
1197
+
1198
+ <p class="tag_title">Returns:</p>
1199
+ <ul class="return">
1200
+
1201
+ <li>
1202
+
1203
+
1204
+ <span class='type'>(<tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>)</span>
1205
+
1206
+
1207
+
1208
+ &mdash;
1209
+ <div class='inline'><p>An collection of board objects.</p>
1210
+ </div>
1211
+
1212
+ </li>
1213
+
1214
+ </ul>
1215
+
1216
+ </div><table class="source_code">
1217
+ <tr>
1218
+ <td>
1219
+ <pre class="lines">
1220
+
1221
+
1222
+ 105
1223
+ 106
1224
+ 107
1225
+ 108</pre>
1226
+ </td>
1227
+ <td>
1228
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 105</span>
1229
+
1230
+ <span class='kw'>def</span> <span class='id identifier rubyid_search_my_boards'>search_my_boards</span><span class='lparen'>(</span><span class='id identifier rubyid_query'>query</span><span class='comma'>,</span> <span class='label'>fields:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>cursor:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>limit:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1231
+ <span class='id identifier rubyid_ensure_param'>ensure_param</span><span class='lparen'>(</span><span class='id identifier rubyid_query'>query</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>You have to specify a query.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1232
+ <span class='id identifier rubyid_get_boards_collection'>get_boards_collection</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/search/boards/</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='label'>query:</span> <span class='id identifier rubyid_query'>query</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='id identifier rubyid_fields'>fields</span><span class='comma'>,</span> <span class='id identifier rubyid_cursor'>cursor</span><span class='comma'>,</span> <span class='id identifier rubyid_limit'>limit</span><span class='rparen'>)</span>
1233
+ <span class='kw'>end</span></pre>
1234
+ </td>
1235
+ </tr>
1236
+ </table>
1237
+ </div>
1238
+
1239
+ <div class="method_details ">
1240
+ <h3 class="signature " id="suggested_boards-instance_method">
1241
+
1242
+ #<strong>suggested_boards</strong>(fields: nil, cursor: nil, limit: nil) &#x21d2; <tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>
1243
+
1244
+
1245
+
1246
+
1247
+
1248
+ </h3><div class="docstring">
1249
+ <div class="discussion">
1250
+ <p>Returns the list of boards of suggested boards for the authenticated user.</p>
1251
+
1252
+
1253
+ </div>
1254
+ </div>
1255
+ <div class="tags">
1256
+ <p class="tag_title">Parameters:</p>
1257
+ <ul class="param">
1258
+
1259
+ <li>
1260
+
1261
+ <span class='name'>fields</span>
1262
+
1263
+
1264
+ <span class='type'>(<tt>Array</tt>)</span>
1265
+
1266
+
1267
+
1268
+ &mdash;
1269
+ <div class='inline'><p>A list of fields to return.</p>
1270
+ </div>
1271
+
1272
+ </li>
1273
+
1274
+ <li>
1275
+
1276
+ <span class='name'>cursor</span>
1277
+
1278
+
1279
+ <span class='type'>(<tt>String</tt>)</span>
1280
+
1281
+
1282
+
1283
+ &mdash;
1284
+ <div class='inline'><p>A cursor to paginate results, obtained by a previous call.</p>
1285
+ </div>
1286
+
1287
+ </li>
1288
+
1289
+ <li>
1290
+
1291
+ <span class='name'>limit</span>
1292
+
1293
+
1294
+ <span class='type'>(<tt>Fixnum</tt>)</span>
1295
+
1296
+
1297
+
1298
+ &mdash;
1299
+ <div class='inline'><p>The maximum number of objects to return.</p>
1300
+ </div>
1301
+
1302
+ </li>
1303
+
1304
+ </ul>
1305
+
1306
+ <p class="tag_title">Returns:</p>
1307
+ <ul class="return">
1308
+
1309
+ <li>
1310
+
1311
+
1312
+ <span class='type'>(<tt><span class='object_link'><a href="../Collection.html" title="Pinterest::Collection (class)">Pinterest::Collection</a></span></tt>)</span>
1313
+
1314
+
1315
+
1316
+ &mdash;
1317
+ <div class='inline'><p>An collection of board objects.</p>
1318
+ </div>
1319
+
1320
+ </li>
1321
+
1322
+ </ul>
1323
+
1324
+ </div><table class="source_code">
1325
+ <tr>
1326
+ <td>
1327
+ <pre class="lines">
1328
+
1329
+
1330
+ 116
1331
+ 117
1332
+ 118</pre>
1333
+ </td>
1334
+ <td>
1335
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 116</span>
1336
+
1337
+ <span class='kw'>def</span> <span class='id identifier rubyid_suggested_boards'>suggested_boards</span><span class='lparen'>(</span><span class='label'>fields:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>cursor:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>limit:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1338
+ <span class='id identifier rubyid_get_boards_collection'>get_boards_collection</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/boards/suggested/</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_fields'>fields</span><span class='comma'>,</span> <span class='id identifier rubyid_cursor'>cursor</span><span class='comma'>,</span> <span class='id identifier rubyid_limit'>limit</span><span class='rparen'>)</span>
1339
+ <span class='kw'>end</span></pre>
1340
+ </td>
1341
+ </tr>
1342
+ </table>
1343
+ </div>
1344
+
1345
+ <div class="method_details ">
1346
+ <h3 class="signature " id="unfollow_board-instance_method">
1347
+
1348
+ #<strong>unfollow_board</strong>(board) &#x21d2; <tt>Boolean</tt>
1349
+
1350
+
1351
+
1352
+
1353
+
1354
+ </h3><div class="docstring">
1355
+ <div class="discussion">
1356
+ <p>Stop following a board.</p>
1357
+
1358
+
1359
+ </div>
1360
+ </div>
1361
+ <div class="tags">
1362
+ <p class="tag_title">Parameters:</p>
1363
+ <ul class="param">
1364
+
1365
+ <li>
1366
+
1367
+ <span class='name'>board</span>
1368
+
1369
+
1370
+ <span class='type'>(<tt>String</tt>)</span>
1371
+
1372
+
1373
+
1374
+ &mdash;
1375
+ <div class='inline'><p>The board id.</p>
1376
+ </div>
1377
+
1378
+ </li>
1379
+
1380
+ </ul>
1381
+
1382
+ <p class="tag_title">Returns:</p>
1383
+ <ul class="return">
1384
+
1385
+ <li>
1386
+
1387
+
1388
+ <span class='type'>(<tt>Boolean</tt>)</span>
1389
+
1390
+
1391
+
1392
+ &mdash;
1393
+ <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
1394
+ </div>
1395
+
1396
+ </li>
1397
+
1398
+ </ul>
1399
+
1400
+ </div><table class="source_code">
1401
+ <tr>
1402
+ <td>
1403
+ <pre class="lines">
1404
+
1405
+
1406
+ 147
1407
+ 148
1408
+ 149
1409
+ 150
1410
+ 151
1411
+ 152
1412
+ 153
1413
+ 154</pre>
1414
+ </td>
1415
+ <td>
1416
+ <pre class="code"><span class="info file"># File 'lib/pinterest/endpoints/boards.rb', line 147</span>
1417
+
1418
+ <span class='kw'>def</span> <span class='id identifier rubyid_unfollow_board'>unfollow_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
1419
+ <span class='comment'># Validate the board id
1420
+ </span> <span class='id identifier rubyid_board'>board</span> <span class='op'>=</span> <span class='id identifier rubyid_validate_board'>validate_board</span><span class='lparen'>(</span><span class='id identifier rubyid_board'>board</span><span class='rparen'>)</span>
1421
+
1422
+ <span class='comment'># Perform the request
1423
+ </span> <span class='id identifier rubyid_perform_network_request'>perform_network_request</span><span class='lparen'>(</span><span class='label'>method:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>DELETE</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='id identifier rubyid_versioned_url'>versioned_url</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/me/following/boards/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_board'>board</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
1424
+ <span class='kw'>true</span>
1425
+ <span class='kw'>end</span></pre>
1426
+ </td>
1427
+ </tr>
1428
+ </table>
1429
+ </div>
1430
+
1431
+ </div>
1432
+
1433
+ </div>
1434
+
1435
+ <div id="footer">
1436
+ Generated on Thu Jan 12 16:28:12 2017 by
1437
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
1438
+ 0.9.7 (ruby-2.3.0).
1439
+ </div>
1440
+
1441
+ </div>
1442
+ </body>
1443
+ </html>