facebook_video.rb in ruby-oembed-0.15.0

- old
+ new
@@ -1,18 +1,30 @@
 module OEmbed
   class Providers
     # Provider for Facebook videos
-    class FacebookVideo < OEmbed::Provider
-      def initialize(access_token:)
-        super("https://graph.facebook.com/v8.0/oembed_video?access_token=#{access_token}", :json)
-        register_urls!
-      end
+    # See https://developers.facebook.com/docs/plugins/oembed
+    # See https://developers.facebook.com/docs/graph-api/reference/v8.0/oembed-video
+    FacebookVideo = OEmbed::Provider.new(
+      "https://graph.facebook.com/v8.0/oembed_video",
+      required_query_params: { access_token: 'OEMBED_FACEBOOK_TOKEN' },
+      format: :json
+    )
+    FacebookVideo << 'https://www.facebook.com/*/videos/*'
+    FacebookVideo << 'https://www.facebook.com/video*'
 
-      private
+    # Note: even though FacebookVideo is automatically registered as an official provider
+    # it will NOT resolve any URLs unless its access_token is set
+    # either via the OEMBED_FACEBOOK_TOKEN environment variable
+    # or by calling `OEmbed::Providers::FacebookVideo.access_token = @your_token`
+    add_official_provider(FacebookVideo, nil, access_token: {name: :facebook, method: :access_token})
 
-      def register_urls!
-        ['https://www.facebook.com/*/videos/*',
-         'https://www.facebook.com/video*'].each { |u| self << u }
-      end
+    # Respond to the `new` method to maintain backwards compatibility with v0.14.0
+    # See also:
+    # * https://github.com/ruby-oembed/ruby-oembed/pull/75
+    # * https://github.com/ruby-oembed/ruby-oembed/issues/77#issuecomment-727024682
+    # @deprecated *Note*: This method will be be removed in the future.
+    def FacebookVideo.new(access_token:)
+      self.access_token = access_token
+      self
     end
   end
 end