google-api-client 0.42.0 → 0.44.1

data/generated/google/apis/gmailpostmastertools_v1beta1.rb

@@ -20,14 +20,17 @@ module Google
   module Apis
     # Gmail Postmaster Tools API
     #
-    # The Gmail Postmaster API is a RESTful API that provides programmatic access to
+    # The Postmaster Tools API is a RESTful API that provides programmatic access to
     # email traffic metrics (like spam reports, delivery errors etc) otherwise
     # available through the Gmail Postmaster Tools UI currently.
     #
     # @see https://developers.google.com/gmail/postmaster
     module GmailpostmastertoolsV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200629'
+      REVISION = '20200817'
+
+      # See email traffic metrics for the domains you have registered in Gmail Postmaster Tools
+      AUTH_POSTMASTER_READONLY = 'https://www.googleapis.com/auth/postmaster.readonly'
     end
   end
 end

data/generated/google/apis/gmailpostmastertools_v1beta1/classes.rb

@@ -31,8 +31,7 @@ module Google
         # @return [String]
         attr_accessor :error_class
       
-        # The ratio of messages where the error occurred vs all authenticated
-        # traffic.
+        # The ratio of messages where the error occurred vs all authenticated traffic.
         # Corresponds to the JSON property `errorRatio`
         # @return [Float]
         attr_accessor :error_ratio
@@ -58,15 +57,14 @@ module Google
       class Domain
         include Google::Apis::Core::Hashable
       
-        # Timestamp when the user registered this domain. Assigned by
-        # the server.
+        # Timestamp when the user registered this domain. Assigned by the server.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # The resource name of the Domain.
-        # Domain names have the form `domains/`domain_name``, where domain_name
-        # is the fully qualified domain name (i.e.,  mymail.mydomain.com).
+        # The resource name of the Domain. Domain names have the form `domains/`
+        # domain_name``, where domain_name is the fully qualified domain name (i.e.,
+        # mymail.mydomain.com).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -98,8 +96,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # The ratio of user marked spam messages with the identifier vs the total
-        # number of inboxed messages with that identifier.
+        # The ratio of user marked spam messages with the identifier vs the total number
+        # of inboxed messages with that identifier.
         # Corresponds to the JSON property `spamRatio`
         # @return [Float]
         attr_accessor :spam_ratio
@@ -120,8 +118,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Total number of unique IPs in this reputation category. This metric only
-        # pertains to traffic that passed [SPF](http://www.openspf.org/) or
-        # [DKIM](http://www.dkim.org/).
+        # pertains to traffic that passed [SPF](http://www.openspf.org/) or [DKIM](http:/
+        # /www.dkim.org/).
         # Corresponds to the JSON property `numIps`
         # @return [Fixnum]
         attr_accessor :num_ips
@@ -157,8 +155,8 @@ module Google
         # @return [Array<Google::Apis::GmailpostmastertoolsV1beta1::Domain>]
         attr_accessor :domains
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -178,8 +176,8 @@ module Google
       class ListTrafficStatsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -210,16 +208,16 @@ module Google
         # @return [Array<Google::Apis::GmailpostmastertoolsV1beta1::DeliveryError>]
         attr_accessor :delivery_errors
       
-        # The ratio of mail that successfully authenticated with DKIM vs. all mail
-        # that attempted to authenticate with [DKIM](http://www.dkim.org/). Spoofed
-        # mail is excluded.
+        # The ratio of mail that successfully authenticated with DKIM vs. all mail that
+        # attempted to authenticate with [DKIM](http://www.dkim.org/). Spoofed mail is
+        # excluded.
         # Corresponds to the JSON property `dkimSuccessRatio`
         # @return [Float]
         attr_accessor :dkim_success_ratio
       
-        # The ratio of mail that passed [DMARC](https://dmarc.org/) alignment checks
-        # vs all mail received from the domain that successfully authenticated with
-        # either of [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/).
+        # The ratio of mail that passed [DMARC](https://dmarc.org/) alignment checks vs
+        # all mail received from the domain that successfully authenticated with either
+        # of [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/).
         # Corresponds to the JSON property `dmarcSuccessRatio`
         # @return [Float]
         attr_accessor :dmarc_success_ratio
@@ -229,27 +227,26 @@ module Google
         # @return [String]
         attr_accessor :domain_reputation
       
-        # The ratio of incoming mail (to Gmail), that passed secure transport (TLS)
-        # vs all mail received from that domain. This metric only pertains to traffic
-        # that passed [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/).
+        # The ratio of incoming mail (to Gmail), that passed secure transport (TLS) vs
+        # all mail received from that domain. This metric only pertains to traffic that
+        # passed [SPF](http://www.openspf.org/) or [DKIM](http://www.dkim.org/).
         # Corresponds to the JSON property `inboundEncryptionRatio`
         # @return [Float]
         attr_accessor :inbound_encryption_ratio
       
-        # Reputation information pertaining to the IP addresses of the email servers
-        # for the domain. There is exactly one entry for each reputation category
-        # except
+        # Reputation information pertaining to the IP addresses of the email servers for
+        # the domain. There is exactly one entry for each reputation category except
         # REPUTATION_CATEGORY_UNSPECIFIED.
         # Corresponds to the JSON property `ipReputations`
         # @return [Array<Google::Apis::GmailpostmastertoolsV1beta1::IpReputation>]
         attr_accessor :ip_reputations
       
-        # The resource name of the traffic statistics. Traffic statistic names have
-        # the form `domains/`domain`/trafficStats/`date``, where
-        # domain_name is the fully qualified domain name (i.e.,  mymail.mydomain.com)
-        # of the domain this traffic statistics pertains to and date is the date in
-        # yyyymmdd format that these statistics corresponds to.
-        # For example: domains/mymail.mydomain.com/trafficStats/20160807
+        # The resource name of the traffic statistics. Traffic statistic names have the
+        # form `domains/`domain`/trafficStats/`date``, where domain_name is the fully
+        # qualified domain name (i.e., mymail.mydomain.com) of the domain this traffic
+        # statistics pertains to and date is the date in yyyymmdd format that these
+        # statistics corresponds to. For example: domains/mymail.mydomain.com/
+        # trafficStats/20160807
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -260,24 +257,22 @@ module Google
         # @return [Float]
         attr_accessor :outbound_encryption_ratio
       
-        # Spammy [Feedback loop identifiers]
-        # (https://support.google.com/mail/answer/6254652) with their individual spam
-        # rates. This metric only pertains to traffic that is authenticated by
-        # [DKIM](http://www.dkim.org/).
+        # Spammy [Feedback loop identifiers] (https://support.google.com/mail/answer/
+        # 6254652) with their individual spam rates. This metric only pertains to
+        # traffic that is authenticated by [DKIM](http://www.dkim.org/).
         # Corresponds to the JSON property `spammyFeedbackLoops`
         # @return [Array<Google::Apis::GmailpostmastertoolsV1beta1::FeedbackLoop>]
         attr_accessor :spammy_feedback_loops
       
-        # The ratio of mail that successfully authenticated with SPF vs. all mail
-        # that attempted to authenticate with [SPF](http://www.openspf.org/). Spoofed
-        # mail is excluded.
+        # The ratio of mail that successfully authenticated with SPF vs. all mail that
+        # attempted to authenticate with [SPF](http://www.openspf.org/). Spoofed mail is
+        # excluded.
         # Corresponds to the JSON property `spfSuccessRatio`
         # @return [Float]
         attr_accessor :spf_success_ratio
       
         # The ratio of user-report spam vs. email that was sent to the inbox. This
-        # metric only pertains to emails authenticated by
-        # [DKIM](http://www.dkim.org/).
+        # metric only pertains to emails authenticated by [DKIM](http://www.dkim.org/).
         # Corresponds to the JSON property `userReportedSpamRatio`
         # @return [Float]
         attr_accessor :user_reported_spam_ratio

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

@@ -22,7 +22,7 @@ module Google
     module GmailpostmastertoolsV1beta1
       # Gmail Postmaster Tools API
       #
-      # The Gmail Postmaster API is a RESTful API that provides programmatic access to
+      # The Postmaster Tools API is a RESTful API that provides programmatic access to
       #  email traffic metrics (like spam reports, delivery errors etc) otherwise
       #  available through the Gmail Postmaster Tools UI currently.
       #
@@ -49,12 +49,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets a specific domain registered by the client.
-        # Returns NOT_FOUND if the domain does not exist.
+        # Gets a specific domain registered by the client. Returns NOT_FOUND if the
+        # domain does not exist.
         # @param [String] name
-        #   The resource name of the domain. It should have the form
-        #   `domains/`domain_name``, where domain_name is the fully qualified
-        #   domain name.
+        #   The resource name of the domain. It should have the form `domains/`domain_name`
+        #   `, where domain_name is the fully qualified domain name.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -86,13 +85,12 @@ module Google
         # domains in the response is unspecified and non-deterministic. Newly created
         # domains will not necessarily be added to the end of this list.
         # @param [Fixnum] page_size
-        #   Requested page size. Server may return fewer domains than requested.
-        #   If unspecified, server will pick an appropriate default.
+        #   Requested page size. Server may return fewer domains than requested. If
+        #   unspecified, server will pick an appropriate default.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous List request, if any.
-        #   This is the value of
-        #   ListDomainsResponse.next_page_token
-        #   returned from the previous call to `ListDomains` method.
+        #   The next_page_token value returned from a previous List request, if any. This
+        #   is the value of ListDomainsResponse.next_page_token returned from the previous
+        #   call to `ListDomains` method.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -121,12 +119,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get traffic statistics for a domain on a specific date.
-        # Returns PERMISSION_DENIED if user does not have permission to access
-        # TrafficStats for the domain.
+        # Get traffic statistics for a domain on a specific date. Returns
+        # PERMISSION_DENIED if user does not have permission to access TrafficStats for
+        # the domain.
         # @param [String] name
-        #   The resource name of the traffic statistics to get.
-        #   E.g., domains/mymail.mydomain.com/trafficStats/20160807.
+        #   The resource name of the traffic statistics to get. E.g., domains/mymail.
+        #   mydomain.com/trafficStats/20160807.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -154,41 +152,37 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List traffic statistics for all available days.
-        # Returns PERMISSION_DENIED if user does not have permission to access
-        # TrafficStats for the domain.
+        # List traffic statistics for all available days. Returns PERMISSION_DENIED if
+        # user does not have permission to access TrafficStats for the domain.
         # @param [String] parent
-        #   The resource name of the domain whose traffic statistics we'd like to list.
-        #   It should have the form `domains/`domain_name``, where domain_name is
-        #   the fully qualified domain name.
+        #   The resource name of the domain whose traffic statistics we'd like to list. It
+        #   should have the form `domains/`domain_name``, where domain_name is the fully
+        #   qualified domain name.
         # @param [Fixnum] end_date_day
-        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0
-        #   if specifying a year by itself or a year and month where the day is not
+        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if
+        #   specifying a year by itself or a year and month where the day is not
         #   significant.
         # @param [Fixnum] end_date_month
-        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a
-        #   month and day.
+        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a month
+        #   and day.
         # @param [Fixnum] end_date_year
-        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without
-        #   a year.
+        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year.
         # @param [Fixnum] page_size
-        #   Requested page size. Server may return fewer TrafficStats than
-        #   requested. If unspecified, server will pick an appropriate default.
+        #   Requested page size. Server may return fewer TrafficStats than requested. If
+        #   unspecified, server will pick an appropriate default.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous List request, if any.
-        #   This is the value of
-        #   ListTrafficStatsResponse.next_page_token
-        #   returned from the previous call to `ListTrafficStats` method.
+        #   The next_page_token value returned from a previous List request, if any. This
+        #   is the value of ListTrafficStatsResponse.next_page_token returned from the
+        #   previous call to `ListTrafficStats` method.
         # @param [Fixnum] start_date_day
-        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0
-        #   if specifying a year by itself or a year and month where the day is not
+        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if
+        #   specifying a year by itself or a year and month where the day is not
         #   significant.
         # @param [Fixnum] start_date_month
-        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a
-        #   month and day.
+        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a month
+        #   and day.
         # @param [Fixnum] start_date_year
-        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without
-        #   a year.
+        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/groupsmigration_v1.rb

@@ -0,0 +1,35 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/groupsmigration_v1/service.rb'
+require 'google/apis/groupsmigration_v1/classes.rb'
+require 'google/apis/groupsmigration_v1/representations.rb'
+
+module Google
+  module Apis
+    # Groups Migration API
+    #
+    # The Groups Migration API allows domain administrators to archive emails into
+    # Google groups.
+    #
+    # @see https://developers.google.com/google-apps/groups-migration/
+    module GroupsmigrationV1
+      VERSION = 'V1'
+      REVISION = '20200820'
+
+      # Manage messages in groups on your domain
+      AUTH_APPS_GROUPS_MIGRATION = 'https://www.googleapis.com/auth/apps.groups.migration'
+    end
+  end
+end

data/generated/google/apis/groupsmigration_v1/classes.rb

@@ -0,0 +1,51 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module GroupsmigrationV1
+      
+      # JSON response template for groups migration API.
+      class Groups
+        include Google::Apis::Core::Hashable
+      
+        # The kind of insert resource this is.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The status of the insert request.
+        # Corresponds to the JSON property `responseCode`
+        # @return [String]
+        attr_accessor :response_code
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @response_code = args[:response_code] if args.key?(:response_code)
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/groupsmigration_v1/representations.rb

@@ -0,0 +1,40 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module GroupsmigrationV1
+      
+      class Groups
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Groups
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+          property :response_code, as: 'responseCode'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module GroupsmigrationV1
+      # Groups Migration API
+      #
+      # The Groups Migration API allows domain administrators to archive emails into
+      #  Google groups.
+      #
+      # @example
+      #    require 'google/apis/groupsmigration_v1'
+      #
+      #    Groupsmigration = Google::Apis::GroupsmigrationV1 # Alias the module
+      #    service = Groupsmigration::GroupsMigrationService.new
+      #
+      # @see https://developers.google.com/google-apps/groups-migration/
+      class GroupsMigrationService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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
+
+        def initialize
+          super('https://groupsmigration.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Inserts a new mail into the archive of the Google group.
+        # @param [String] group_id
+        #   The group 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 [IO, String] upload_source
+        #   IO stream or filename containing content to upload
+        # @param [String] content_type
+        #   Content type of the uploaded content.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::GroupsmigrationV1::Groups] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GroupsmigrationV1::Groups]
+        #
+        # @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 insert_archive(group_id, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
+          if upload_source.nil?
+            command = make_simple_command(:post, 'groups/v1/groups/{groupId}/archive', options)
+          else
+            command = make_upload_command(:post, 'groups/v1/groups/{groupId}/archive', options)
+            command.upload_source = upload_source
+            command.upload_content_type = content_type
+          end
+          command.response_representation = Google::Apis::GroupsmigrationV1::Groups::Representation
+          command.response_class = Google::Apis::GroupsmigrationV1::Groups
+          command.params['groupId'] = group_id unless group_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
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end