yt-andrewroth 0.25.5.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (191) hide show
  1. data/.gitignore +27 -0
  2. data/.rspec +3 -0
  3. data/.travis.yml +9 -0
  4. data/.yardopts +5 -0
  5. data/CHANGELOG.md +732 -0
  6. data/Gemfile +4 -0
  7. data/MIT-LICENSE +20 -0
  8. data/README.md +489 -0
  9. data/Rakefile +11 -0
  10. data/YOUTUBE_IT.md +835 -0
  11. data/bin/yt +30 -0
  12. data/gemfiles/Gemfile.activesupport-3.x +4 -0
  13. data/gemfiles/Gemfile.activesupport-4.x +4 -0
  14. data/lib/yt.rb +21 -0
  15. data/lib/yt/actions/base.rb +32 -0
  16. data/lib/yt/actions/delete.rb +19 -0
  17. data/lib/yt/actions/delete_all.rb +32 -0
  18. data/lib/yt/actions/insert.rb +42 -0
  19. data/lib/yt/actions/list.rb +139 -0
  20. data/lib/yt/actions/modify.rb +37 -0
  21. data/lib/yt/actions/patch.rb +19 -0
  22. data/lib/yt/actions/update.rb +19 -0
  23. data/lib/yt/associations/has_attribute.rb +55 -0
  24. data/lib/yt/associations/has_authentication.rb +214 -0
  25. data/lib/yt/associations/has_many.rb +22 -0
  26. data/lib/yt/associations/has_one.rb +22 -0
  27. data/lib/yt/associations/has_reports.rb +320 -0
  28. data/lib/yt/collections/advertising_options_sets.rb +34 -0
  29. data/lib/yt/collections/annotations.rb +62 -0
  30. data/lib/yt/collections/assets.rb +58 -0
  31. data/lib/yt/collections/authentications.rb +47 -0
  32. data/lib/yt/collections/base.rb +62 -0
  33. data/lib/yt/collections/channels.rb +31 -0
  34. data/lib/yt/collections/claim_histories.rb +34 -0
  35. data/lib/yt/collections/claims.rb +56 -0
  36. data/lib/yt/collections/content_details.rb +30 -0
  37. data/lib/yt/collections/content_owner_details.rb +34 -0
  38. data/lib/yt/collections/content_owners.rb +32 -0
  39. data/lib/yt/collections/device_flows.rb +23 -0
  40. data/lib/yt/collections/file_details.rb +30 -0
  41. data/lib/yt/collections/ids.rb +27 -0
  42. data/lib/yt/collections/live_streaming_details.rb +30 -0
  43. data/lib/yt/collections/ownerships.rb +34 -0
  44. data/lib/yt/collections/partnered_channels.rb +28 -0
  45. data/lib/yt/collections/players.rb +30 -0
  46. data/lib/yt/collections/playlist_items.rb +53 -0
  47. data/lib/yt/collections/playlists.rb +28 -0
  48. data/lib/yt/collections/policies.rb +28 -0
  49. data/lib/yt/collections/ratings.rb +23 -0
  50. data/lib/yt/collections/references.rb +46 -0
  51. data/lib/yt/collections/related_playlists.rb +43 -0
  52. data/lib/yt/collections/reports.rb +161 -0
  53. data/lib/yt/collections/resources.rb +57 -0
  54. data/lib/yt/collections/resumable_sessions.rb +51 -0
  55. data/lib/yt/collections/snippets.rb +27 -0
  56. data/lib/yt/collections/statistics_sets.rb +30 -0
  57. data/lib/yt/collections/statuses.rb +27 -0
  58. data/lib/yt/collections/subscribed_channels.rb +46 -0
  59. data/lib/yt/collections/subscribers.rb +33 -0
  60. data/lib/yt/collections/subscriptions.rb +50 -0
  61. data/lib/yt/collections/user_infos.rb +36 -0
  62. data/lib/yt/collections/video_categories.rb +35 -0
  63. data/lib/yt/collections/videos.rb +137 -0
  64. data/lib/yt/config.rb +54 -0
  65. data/lib/yt/errors/forbidden.rb +13 -0
  66. data/lib/yt/errors/missing_auth.rb +81 -0
  67. data/lib/yt/errors/no_items.rb +13 -0
  68. data/lib/yt/errors/request_error.rb +74 -0
  69. data/lib/yt/errors/server_error.rb +13 -0
  70. data/lib/yt/errors/unauthorized.rb +50 -0
  71. data/lib/yt/models/account.rb +216 -0
  72. data/lib/yt/models/advertising_options_set.rb +38 -0
  73. data/lib/yt/models/annotation.rb +132 -0
  74. data/lib/yt/models/asset.rb +111 -0
  75. data/lib/yt/models/asset_metadata.rb +38 -0
  76. data/lib/yt/models/asset_snippet.rb +46 -0
  77. data/lib/yt/models/authentication.rb +83 -0
  78. data/lib/yt/models/base.rb +32 -0
  79. data/lib/yt/models/channel.rb +302 -0
  80. data/lib/yt/models/claim.rb +156 -0
  81. data/lib/yt/models/claim_event.rb +67 -0
  82. data/lib/yt/models/claim_history.rb +29 -0
  83. data/lib/yt/models/configuration.rb +70 -0
  84. data/lib/yt/models/content_detail.rb +65 -0
  85. data/lib/yt/models/content_owner.rb +48 -0
  86. data/lib/yt/models/content_owner_detail.rb +18 -0
  87. data/lib/yt/models/description.rb +58 -0
  88. data/lib/yt/models/device_flow.rb +16 -0
  89. data/lib/yt/models/file_detail.rb +21 -0
  90. data/lib/yt/models/id.rb +9 -0
  91. data/lib/yt/models/iterator.rb +16 -0
  92. data/lib/yt/models/live_streaming_detail.rb +23 -0
  93. data/lib/yt/models/match_policy.rb +34 -0
  94. data/lib/yt/models/ownership.rb +75 -0
  95. data/lib/yt/models/player.rb +18 -0
  96. data/lib/yt/models/playlist.rb +218 -0
  97. data/lib/yt/models/playlist_item.rb +112 -0
  98. data/lib/yt/models/policy.rb +36 -0
  99. data/lib/yt/models/policy_rule.rb +124 -0
  100. data/lib/yt/models/rating.rb +37 -0
  101. data/lib/yt/models/reference.rb +172 -0
  102. data/lib/yt/models/resource.rb +136 -0
  103. data/lib/yt/models/resumable_session.rb +52 -0
  104. data/lib/yt/models/right_owner.rb +58 -0
  105. data/lib/yt/models/snippet.rb +50 -0
  106. data/lib/yt/models/statistics_set.rb +26 -0
  107. data/lib/yt/models/status.rb +32 -0
  108. data/lib/yt/models/subscription.rb +38 -0
  109. data/lib/yt/models/timestamp.rb +13 -0
  110. data/lib/yt/models/url.rb +90 -0
  111. data/lib/yt/models/user_info.rb +26 -0
  112. data/lib/yt/models/video.rb +630 -0
  113. data/lib/yt/models/video_category.rb +12 -0
  114. data/lib/yt/request.rb +278 -0
  115. data/lib/yt/version.rb +3 -0
  116. data/spec/collections/claims_spec.rb +30 -0
  117. data/spec/collections/playlist_items_spec.rb +44 -0
  118. data/spec/collections/playlists_spec.rb +27 -0
  119. data/spec/collections/policies_spec.rb +30 -0
  120. data/spec/collections/references_spec.rb +30 -0
  121. data/spec/collections/reports_spec.rb +30 -0
  122. data/spec/collections/subscriptions_spec.rb +25 -0
  123. data/spec/collections/videos_spec.rb +43 -0
  124. data/spec/errors/forbidden_spec.rb +10 -0
  125. data/spec/errors/missing_auth_spec.rb +24 -0
  126. data/spec/errors/no_items_spec.rb +10 -0
  127. data/spec/errors/request_error_spec.rb +44 -0
  128. data/spec/errors/server_error_spec.rb +10 -0
  129. data/spec/errors/unauthorized_spec.rb +10 -0
  130. data/spec/models/account_spec.rb +138 -0
  131. data/spec/models/annotation_spec.rb +180 -0
  132. data/spec/models/asset_spec.rb +20 -0
  133. data/spec/models/channel_spec.rb +127 -0
  134. data/spec/models/claim_event_spec.rb +62 -0
  135. data/spec/models/claim_history_spec.rb +27 -0
  136. data/spec/models/claim_spec.rb +211 -0
  137. data/spec/models/configuration_spec.rb +44 -0
  138. data/spec/models/content_detail_spec.rb +45 -0
  139. data/spec/models/content_owner_detail_spec.rb +6 -0
  140. data/spec/models/description_spec.rb +94 -0
  141. data/spec/models/file_detail_spec.rb +13 -0
  142. data/spec/models/live_streaming_detail_spec.rb +6 -0
  143. data/spec/models/ownership_spec.rb +59 -0
  144. data/spec/models/player_spec.rb +13 -0
  145. data/spec/models/playlist_item_spec.rb +120 -0
  146. data/spec/models/playlist_spec.rb +138 -0
  147. data/spec/models/policy_rule_spec.rb +63 -0
  148. data/spec/models/policy_spec.rb +41 -0
  149. data/spec/models/rating_spec.rb +12 -0
  150. data/spec/models/reference_spec.rb +249 -0
  151. data/spec/models/request_spec.rb +163 -0
  152. data/spec/models/resource_spec.rb +57 -0
  153. data/spec/models/right_owner_spec.rb +71 -0
  154. data/spec/models/snippet_spec.rb +13 -0
  155. data/spec/models/statistics_set_spec.rb +13 -0
  156. data/spec/models/status_spec.rb +13 -0
  157. data/spec/models/subscription_spec.rb +30 -0
  158. data/spec/models/url_spec.rb +78 -0
  159. data/spec/models/video_category_spec.rb +21 -0
  160. data/spec/models/video_spec.rb +669 -0
  161. data/spec/requests/as_account/account_spec.rb +125 -0
  162. data/spec/requests/as_account/authentications_spec.rb +139 -0
  163. data/spec/requests/as_account/channel_spec.rb +259 -0
  164. data/spec/requests/as_account/channels_spec.rb +18 -0
  165. data/spec/requests/as_account/playlist_item_spec.rb +56 -0
  166. data/spec/requests/as_account/playlist_spec.rb +244 -0
  167. data/spec/requests/as_account/resource_spec.rb +18 -0
  168. data/spec/requests/as_account/thumbnail.jpg +0 -0
  169. data/spec/requests/as_account/video.mp4 +0 -0
  170. data/spec/requests/as_account/video_spec.rb +408 -0
  171. data/spec/requests/as_content_owner/account_spec.rb +25 -0
  172. data/spec/requests/as_content_owner/advertising_options_set_spec.rb +15 -0
  173. data/spec/requests/as_content_owner/asset_spec.rb +20 -0
  174. data/spec/requests/as_content_owner/channel_spec.rb +1934 -0
  175. data/spec/requests/as_content_owner/claim_history_spec.rb +20 -0
  176. data/spec/requests/as_content_owner/content_owner_spec.rb +241 -0
  177. data/spec/requests/as_content_owner/match_policy_spec.rb +17 -0
  178. data/spec/requests/as_content_owner/ownership_spec.rb +25 -0
  179. data/spec/requests/as_content_owner/playlist_spec.rb +782 -0
  180. data/spec/requests/as_content_owner/video_spec.rb +1239 -0
  181. data/spec/requests/as_server_app/channel_spec.rb +74 -0
  182. data/spec/requests/as_server_app/playlist_item_spec.rb +30 -0
  183. data/spec/requests/as_server_app/playlist_spec.rb +53 -0
  184. data/spec/requests/as_server_app/video_spec.rb +58 -0
  185. data/spec/requests/as_server_app/videos_spec.rb +40 -0
  186. data/spec/requests/unauthenticated/video_spec.rb +22 -0
  187. data/spec/spec_helper.rb +20 -0
  188. data/spec/support/fail_matcher.rb +15 -0
  189. data/spec/support/global_hooks.rb +48 -0
  190. data/yt.gemspec +32 -0
  191. metadata +416 -0
@@ -0,0 +1,32 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/content_owner'
3
+
4
+ module Yt
5
+ module Collections
6
+ # Provides methods to interact with a collection of Content Owners.
7
+ #
8
+ # Resources with content_owners are: {Yt::Models::Account accounts}.
9
+ class ContentOwners < Base
10
+
11
+ private
12
+
13
+ def attributes_for_new_item(data)
14
+ {owner_name: data['id'], authentication: @auth.authentication}
15
+ end
16
+
17
+ # @return [Hash] the parameters to submit to YouTube to list content
18
+ # owners administered by the account.
19
+ # @see https://developers.google.com/youtube/partner/docs/v1/contentOwners/list
20
+ def list_params
21
+ super.tap do |params|
22
+ params[:params] = content_owners_params
23
+ params[:path] = '/youtube/partner/v1/contentOwners'
24
+ end
25
+ end
26
+
27
+ def content_owners_params
28
+ {fetch_mine: true}
29
+ end
30
+ end
31
+ end
32
+ end
@@ -0,0 +1,23 @@
1
+ require 'yt/collections/authentications'
2
+ require 'yt/models/device_flow'
3
+
4
+ module Yt
5
+ module Collections
6
+ class DeviceFlows < Authentications
7
+ attr_accessor :auth_params
8
+
9
+ private
10
+
11
+ # This overrides the parent mehthod defined in Authentications
12
+ def attributes_for_new_item(data)
13
+ {data: data}
14
+ end
15
+
16
+ def list_params
17
+ super.tap do |params|
18
+ params[:path] = '/o/oauth2/device/code'
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
@@ -0,0 +1,30 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/file_detail'
3
+
4
+ module Yt
5
+ module Collections
6
+ # @private
7
+ class FileDetails < Base
8
+
9
+ private
10
+
11
+ def attributes_for_new_item(data)
12
+ {data: data['fileDetails']}
13
+ end
14
+
15
+ # @return [Hash] the parameters to submit to YouTube to get the
16
+ # file detail of a video.
17
+ # @see https://developers.google.com/youtube/v3/docs/videos#fileDetails
18
+ def list_params
19
+ super.tap do |params|
20
+ params[:params] = file_details_params
21
+ params[:path] = '/youtube/v3/videos'
22
+ end
23
+ end
24
+
25
+ def file_details_params
26
+ {max_results: 50, part: 'fileDetails', id: @parent.id}
27
+ end
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,27 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/id'
3
+
4
+ module Yt
5
+ module Collections
6
+ # @private
7
+ class Ids < Base
8
+
9
+ private
10
+
11
+ def attributes_for_new_item(data)
12
+ data['id']
13
+ end
14
+
15
+ def list_params
16
+ super.tap do |params|
17
+ params[:params] = ids_params
18
+ params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
19
+ end
20
+ end
21
+
22
+ def ids_params
23
+ {for_username: @parent.username, part: 'id'}
24
+ end
25
+ end
26
+ end
27
+ end
@@ -0,0 +1,30 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/live_streaming_detail'
3
+
4
+ module Yt
5
+ module Collections
6
+ # @private
7
+ class LiveStreamingDetails < Base
8
+
9
+ private
10
+
11
+ def attributes_for_new_item(data)
12
+ {data: data['liveStreamingDetails']}
13
+ end
14
+
15
+ # @return [Hash] the parameters to submit to YouTube to get the
16
+ # live streaming detail of a resource, for instance a video.
17
+ # @see https://developers.google.com/youtube/v3/docs/videos#resource
18
+ def list_params
19
+ super.tap do |params|
20
+ params[:params] = live_streaming_details_params
21
+ params[:path] = '/youtube/v3/videos'
22
+ end
23
+ end
24
+
25
+ def live_streaming_details_params
26
+ {max_results: 50, part: 'liveStreamingDetails', id: @parent.id}
27
+ end
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,34 @@
1
+ require 'yt/collections/resources'
2
+ require 'yt/models/ownership'
3
+
4
+ module Yt
5
+ module Collections
6
+ # Provides methods to interact with a the ownership of a YouTube resource.
7
+ #
8
+ # Resources with ownerships are: {Yt::Models::Asset assets}.
9
+ class Ownerships < Resources
10
+
11
+ private
12
+
13
+ def attributes_for_new_item(data)
14
+ {data: data, asset_id: @parent.id, auth: @auth}
15
+ end
16
+
17
+ # @return [Hash] the parameters to submit to YouTube to get ownerships.
18
+ # @see https://developers.google.com/youtube/partner/docs/v1/ownership/get
19
+ def list_params
20
+ super.tap do |params|
21
+ params[:path] = "/youtube/partner/v1/assets/#{@parent.id}/ownership"
22
+ params[:params] = {on_behalf_of_content_owner: @auth.owner_name}
23
+ end
24
+ end
25
+
26
+ # @private
27
+ # @note Ownerships overwrites +fetch_page+ since it’s a get.
28
+ def fetch_page(params = {})
29
+ response = list_request(params).run
30
+ {items: [response.body], token: nil}
31
+ end
32
+ end
33
+ end
34
+ end
@@ -0,0 +1,28 @@
1
+ require 'yt/collections/channels'
2
+
3
+ module Yt
4
+ module Collections
5
+ class PartneredChannels < Channels
6
+
7
+ private
8
+
9
+ # @private
10
+ # @note Partnered Channels overwrites +channel_params+ since the query
11
+ # is slightly different.
12
+ def channels_params
13
+ super.tap do |params|
14
+ params.delete :mine
15
+ params[:managed_by_me] = true
16
+ params[:on_behalf_of_content_owner] = @auth.owner_name
17
+ end
18
+ end
19
+
20
+ # @private
21
+ # @note Partnered Channels overwrites +list_resources+ since the endpoint
22
+ # to hit is 'channels', not 'partnered_channels'.
23
+ def list_resources
24
+ self.class.superclass.to_s.demodulize
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,30 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/player'
3
+
4
+ module Yt
5
+ module Collections
6
+ # @private
7
+ class Players < Base
8
+
9
+ private
10
+
11
+ def attributes_for_new_item(data)
12
+ {data: data['player']}
13
+ end
14
+
15
+ # @return [Hash] the parameters to submit to YouTube to get the
16
+ # statistics of a resource, for instance a video.
17
+ # @see https://developers.google.com/youtube/v3/docs/videos#resource
18
+ def list_params
19
+ super.tap do |params|
20
+ params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
21
+ params[:params] = players_params
22
+ end
23
+ end
24
+
25
+ def players_params
26
+ {max_results: 50, part: 'player', id: @parent.id}
27
+ end
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,53 @@
1
+ require 'yt/collections/resources'
2
+
3
+ module Yt
4
+ module Collections
5
+ class PlaylistItems < Resources
6
+
7
+ def insert(attributes = {}, options = {})
8
+ super attributes.merge(playlist_id: @parent.id), options
9
+ rescue Yt::Error => error
10
+ ignorable_errors = error.reasons & ['videoNotFound', 'forbidden']
11
+ raise error unless options[:ignore_errors] && ignorable_errors.any?
12
+ end
13
+
14
+ private
15
+
16
+ def attributes_for_new_item(data)
17
+ snippet = data.fetch 'snippet', {}
18
+ data['snippet'].reverse_merge! complete: snippet.key?('position')
19
+ super(data).tap do |attributes|
20
+ attributes[:video] = data['video']
21
+ end
22
+ end
23
+
24
+ def eager_load_items_from(items)
25
+ if included_relationships.include?(:video)
26
+ video_ids = items.map{|item| item['snippet']['resourceId']['videoId']}.uniq
27
+ conditions = {id: video_ids.join(',')}
28
+ conditions[:part] = 'snippet,status,statistics'
29
+ videos = Collections::Videos.new(auth: @auth).where conditions
30
+ items.each do |item|
31
+ video = videos.find{|v| v.id == item['snippet']['resourceId']['videoId']}
32
+ item['video'] = video
33
+ end
34
+ end
35
+ super
36
+ end
37
+
38
+ # @return [Hash] the parameters to submit to YouTube to list playlist items.
39
+ # @see https://developers.google.com/youtube/v3/docs/playlistItems/list
40
+ def list_params
41
+ super.tap{|params| params[:params] = playlist_items_params}
42
+ end
43
+
44
+ def playlist_items_params
45
+ resources_params.merge playlist_id: @parent.id
46
+ end
47
+
48
+ def insert_parts
49
+ {snippet: {keys: [:playlist_id, :resource_id, :position]}}
50
+ end
51
+ end
52
+ end
53
+ end
@@ -0,0 +1,28 @@
1
+ require 'yt/collections/resources'
2
+
3
+ module Yt
4
+ module Collections
5
+ class Playlists < Resources
6
+
7
+ private
8
+
9
+ # @return [Hash] the parameters to submit to YouTube to list channels.
10
+ # @see https://developers.google.com/youtube/v3/docs/channels/list
11
+ def list_params
12
+ super.tap{|params| params[:params] = playlists_params}
13
+ end
14
+
15
+ def playlists_params
16
+ params = resources_params
17
+ params.merge! channel_id: @parent.id if @parent
18
+ apply_where_params! params
19
+ end
20
+
21
+ def insert_parts
22
+ snippet = {keys: [:title, :description, :tags], sanitize_brackets: true}
23
+ status = {keys: [:privacy_status]}
24
+ {snippet: snippet, status: status}
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,28 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/policy'
3
+
4
+ module Yt
5
+ module Collections
6
+ # Provides methods to interact with a collection of Content ID policies.
7
+ #
8
+ # Resources with policies are: {Yt::Models::ContentOwner content owners}.
9
+ class Policies < Base
10
+
11
+ private
12
+
13
+ # @return [Hash] the parameters to submit to YouTube to list policies
14
+ # saved by the content owner.
15
+ # @see https://developers.google.com/youtube/partner/docs/v1/policies/list
16
+ def list_params
17
+ super.tap do |params|
18
+ params[:params] = policies_params
19
+ params[:path] = '/youtube/partner/v1/policies'
20
+ end
21
+ end
22
+
23
+ def policies_params
24
+ apply_where_params! on_behalf_of_content_owner: @parent.owner_name
25
+ end
26
+ end
27
+ end
28
+ end
@@ -0,0 +1,23 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/rating'
3
+
4
+ module Yt
5
+ module Collections
6
+ # @private
7
+ class Ratings < Base
8
+
9
+ private
10
+
11
+ def attributes_for_new_item(data)
12
+ {rating: data['rating'], video_id: @parent.id, auth: @auth}
13
+ end
14
+
15
+ def list_params
16
+ super.tap do |params|
17
+ params[:path] = '/youtube/v3/videos/getRating'
18
+ params[:params] = {id: @parent.id}
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
@@ -0,0 +1,46 @@
1
+ require 'yt/collections/base'
2
+ require 'yt/models/reference'
3
+
4
+ module Yt
5
+ module Collections
6
+ # Provides methods to interact with a collection of Content ID references.
7
+ #
8
+ # Resources with references are: {Yt::Models::ContentOwner content owners}.
9
+ class References < Base
10
+ def insert(attributes = {})
11
+ underscore_keys! attributes
12
+ body = attributes.slice(*body_params)
13
+ params = {claim_id: attributes[:claim_id], on_behalf_of_content_owner: @auth.owner_name}
14
+ do_insert(params: params, body: body)
15
+ end
16
+
17
+ private
18
+
19
+ # @return [Hash] the parameters to submit to YouTube to add a reference.
20
+ # @see https://developers.google.com/youtube/partner/docs/v1/references/insert
21
+ def insert_params
22
+ super.tap do |params|
23
+ params[:path] = '/youtube/partner/v1/references'
24
+ end
25
+ end
26
+
27
+ # @return [Hash] the parameters to submit to YouTube to list references
28
+ # administered by the content owner.
29
+ # @see https://developers.google.com/youtube/partner/docs/v1/references/list
30
+ def list_params
31
+ super.tap do |params|
32
+ params[:params] = references_params
33
+ params[:path] = '/youtube/partner/v1/references'
34
+ end
35
+ end
36
+
37
+ def references_params
38
+ apply_where_params! on_behalf_of_content_owner: @parent.owner_name
39
+ end
40
+
41
+ def body_params
42
+ [:content_type, :audioswap_enabled, :ignore_fps_match, :excluded_intervals]
43
+ end
44
+ end
45
+ end
46
+ end
@@ -0,0 +1,43 @@
1
+ require 'yt/collections/playlists'
2
+
3
+ module Yt
4
+ module Collections
5
+ class RelatedPlaylists < Playlists
6
+
7
+ private
8
+
9
+ # Retrieving related playlists requires to hit the /channels endpoint.
10
+ def list_resources
11
+ 'channels'
12
+ end
13
+
14
+ # The related playlists are included in the content details of a channel.
15
+ def playlists_params
16
+ {part: 'contentDetails', id: @parent.id}
17
+ end
18
+
19
+ # The object to create is "Yt::Models::Playlist", not "RelatedPlaylist"
20
+ def resource_class
21
+ Yt::Models::Playlist
22
+ end
23
+
24
+ # The related playlists are nested inside the "relatedPlaylists" key.
25
+ def extract_items(list)
26
+ if (items = super).any?
27
+ items.first['contentDetails'].fetch 'relatedPlaylists', {}
28
+ end
29
+ end
30
+
31
+ # Since there are at most 5 related playlists, they can be eager-loaded.
32
+ def eager_load_items_from(items)
33
+ conditions = {id: items.values.join(','), part: 'snippet,status'}
34
+ Collections::Playlists.new(auth: @auth).where conditions
35
+ end
36
+
37
+ # Related playlists are eager-loaded, there’s no need to load them again.
38
+ def new_item(playlist)
39
+ playlist
40
+ end
41
+ end
42
+ end
43
+ end