google-api-client 0.32.1 → 0.40.0

data/generated/google/apis/blogger_v2/service.rb

@@ -20,9 +20,10 @@ require 'google/apis/errors'
 module Google
   module Apis
     module BloggerV2
-      # Blogger API
+      # Blogger API v3
       #
-      # API for access to the data within Blogger.
+      # The Blogger API provides access to posts, comments and pages of a
+      #  Blogger blog.
       #
       # @example
       #    require 'google/apis/blogger_v2'
@@ -30,7 +31,7 @@ module Google
       #    Blogger = Google::Apis::BloggerV2 # Alias the module
       #    service = Blogger::BloggerService.new
       #
-      # @see https://developers.google.com/blogger/docs/2.0/json/getting_started
+      # @see https://developers.google.com/blogger/docs/3.0/getting_started
       class BloggerService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -38,29 +39,22 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  An opaque string that represents a user for quota purposes. Must not exceed 40
-        #  characters.
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
         attr_accessor :quota_user
 
-        # @return [String]
-        #  Deprecated. Please use quotaUser instead.
-        attr_accessor :user_ip
-
         def initialize
-          super('https://www.googleapis.com/', 'blogger/v2/')
-          @batch_path = 'batch/blogger/v2'
+          super('https://blogger.googleapis.com/', '')
+          @batch_path = 'batch'
         end
         
-        # Gets one blog by id.
+        # Gets a blog by id.
         # @param [String] blog_id
-        #   The ID of the blog to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -73,31 +67,54 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_blog(blog_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}', options)
+        def get_blog(blog_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}', options)
           command.response_representation = Google::Apis::BloggerV2::Blog::Representation
           command.response_class = Google::Apis::BloggerV2::Blog
           command.params['blogId'] = blog_id unless blog_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets one comment by id.
+        # Lists blogs by user id, possibly filtered.
+        # @param [String] user_id
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BloggerV2::BlogList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BloggerV2::BlogList]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_blogs(user_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/users/{userId}/blogs', options)
+          command.response_representation = Google::Apis::BloggerV2::BlogList::Representation
+          command.response_class = Google::Apis::BloggerV2::BlogList
+          command.params['userId'] = user_id unless user_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a comment by blog id, post id and comment id.
         # @param [String] blog_id
-        #   ID of the blog to containing the comment.
         # @param [String] post_id
-        #   ID of the post to fetch posts from.
         # @param [String] comment_id
-        #   The ID of the comment to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -110,8 +127,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_comment(blog_id, post_id, comment_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/posts/{postId}/comments/{commentId}', options)
+        def get_comment(blog_id, post_id, comment_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/posts/{postId}/comments/{commentId}', options)
           command.response_representation = Google::Apis::BloggerV2::Comment::Representation
           command.response_class = Google::Apis::BloggerV2::Comment
           command.params['blogId'] = blog_id unless blog_id.nil?
@@ -119,30 +136,21 @@ module Google
           command.params['commentId'] = comment_id unless comment_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the comments for a blog, possibly filtered.
+        # Lists comments.
         # @param [String] blog_id
-        #   ID of the blog to fetch comments from.
         # @param [String] post_id
-        #   ID of the post to fetch posts from.
         # @param [Boolean] fetch_bodies
-        #   Whether the body content of the comments is included.
         # @param [Fixnum] max_results
-        #   Maximum number of comments to include in the result.
         # @param [String] page_token
-        #   Continuation token if request is paged.
-        # @param [DateTime] start_date
-        #   Earliest date of comment to fetch, a date-time with RFC 3339 formatting.
+        # @param [String] start_date
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -155,8 +163,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_comments(blog_id, post_id, fetch_bodies: nil, max_results: nil, page_token: nil, start_date: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/posts/{postId}/comments', options)
+        def list_comments(blog_id, post_id, fetch_bodies: nil, max_results: nil, page_token: nil, start_date: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/posts/{postId}/comments', options)
           command.response_representation = Google::Apis::BloggerV2::CommentList::Representation
           command.response_class = Google::Apis::BloggerV2::CommentList
           command.params['blogId'] = blog_id unless blog_id.nil?
@@ -167,22 +175,17 @@ module Google
           command.query['startDate'] = start_date unless start_date.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets one blog page by id.
+        # Gets a page by blog id and page id.
         # @param [String] blog_id
-        #   ID of the blog containing the page.
         # @param [String] page_id
-        #   The ID of the page to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -195,30 +198,25 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_page(blog_id, page_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/pages/{pageId}', options)
+        def get_page(blog_id, page_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/pages/{pageId}', options)
           command.response_representation = Google::Apis::BloggerV2::Page::Representation
           command.response_class = Google::Apis::BloggerV2::Page
           command.params['blogId'] = blog_id unless blog_id.nil?
           command.params['pageId'] = page_id unless page_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves pages for a blog, possibly filtered.
+        # Lists pages.
         # @param [String] blog_id
-        #   ID of the blog to fetch pages from.
         # @param [Boolean] fetch_bodies
-        #   Whether to retrieve the Page bodies.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -231,30 +229,25 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_pages(blog_id, fetch_bodies: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/pages', options)
+        def list_pages(blog_id, fetch_bodies: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/pages', options)
           command.response_representation = Google::Apis::BloggerV2::PageList::Representation
           command.response_class = Google::Apis::BloggerV2::PageList
           command.params['blogId'] = blog_id unless blog_id.nil?
           command.query['fetchBodies'] = fetch_bodies unless fetch_bodies.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Get a post by id.
+        # Gets a post by blog id and post id
         # @param [String] blog_id
-        #   ID of the blog to fetch the post from.
         # @param [String] post_id
-        #   The ID of the post
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -267,36 +260,28 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_post(blog_id, post_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/posts/{postId}', options)
+        def get_post(blog_id, post_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/posts/{postId}', options)
           command.response_representation = Google::Apis::BloggerV2::Post::Representation
           command.response_class = Google::Apis::BloggerV2::Post
           command.params['blogId'] = blog_id unless blog_id.nil?
           command.params['postId'] = post_id unless post_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a list of posts, possibly filtered.
+        # Lists posts.
         # @param [String] blog_id
-        #   ID of the blog to fetch posts from.
         # @param [Boolean] fetch_bodies
-        #   Whether the body content of posts is included.
         # @param [Fixnum] max_results
-        #   Maximum number of posts to fetch.
         # @param [String] page_token
-        #   Continuation token if the request is paged.
-        # @param [DateTime] start_date
-        #   Earliest post date to fetch, a date-time with RFC 3339 formatting.
+        # @param [String] start_date
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -309,8 +294,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_posts(blog_id, fetch_bodies: nil, max_results: nil, page_token: nil, start_date: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'blogs/{blogId}/posts', options)
+        def list_posts(blog_id, fetch_bodies: nil, max_results: nil, page_token: nil, start_date: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/blogs/{blogId}/posts', options)
           command.response_representation = Google::Apis::BloggerV2::PostList::Representation
           command.response_class = Google::Apis::BloggerV2::PostList
           command.params['blogId'] = blog_id unless blog_id.nil?
@@ -320,20 +305,16 @@ module Google
           command.query['startDate'] = start_date unless start_date.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets one user by id.
+        # Gets a user by user id.
         # @param [String] user_id
-        #   The ID of the user to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
         # @param [Google::Apis::RequestOptions] options
         #   Request-specific options
         #
@@ -346,48 +327,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_user(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'users/{userId}', options)
+        def get_user(user_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/users/{userId}', options)
           command.response_representation = Google::Apis::BloggerV2::User::Representation
           command.response_class = Google::Apis::BloggerV2::User
           command.params['userId'] = user_id unless user_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Retrieves a list of blogs, possibly filtered.
-        # @param [String] user_id
-        #   ID of the user whose blogs are to be fetched. Either the word 'self' (sans
-        #   quote marks) or the user's profile identifier.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::BloggerV2::BlogList] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::BloggerV2::BlogList]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_user_blogs(user_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'users/{userId}/blogs', options)
-          command.response_representation = Google::Apis::BloggerV2::BlogList::Representation
-          command.response_class = Google::Apis::BloggerV2::BlogList
-          command.params['userId'] = user_id unless user_id.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
           execute_or_queue_command(command, &block)
         end
 
@@ -396,7 +342,6 @@ module Google
         def apply_command_defaults(command)
           command.query['key'] = key unless key.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
         end
       end
     end

data/generated/google/apis/blogger_v2.rb

@@ -18,14 +18,15 @@ require 'google/apis/blogger_v2/representations.rb'
 
 module Google
   module Apis
-    # Blogger API
+    # Blogger API v3
     #
-    # API for access to the data within Blogger.
+    # The Blogger API provides access to posts, comments and pages of a
+    # Blogger blog.
     #
-    # @see https://developers.google.com/blogger/docs/2.0/json/getting_started
+    # @see https://developers.google.com/blogger/docs/3.0/getting_started
     module BloggerV2
       VERSION = 'V2'
-      REVISION = '20150422'
+      REVISION = '20200405'
 
       # Manage your Blogger account
       AUTH_BLOGGER = 'https://www.googleapis.com/auth/blogger'