google-apis-adsense_v2 0.31.0 → 0.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eda84d6da37ad87bfab1f53d06ef03b0e946231f021b0807027697fe3fb0842b
-  data.tar.gz: cf26a621baa2d2e20db864af539229c887f4f633dd066bf225771b22b59bad87
+  metadata.gz: 91c475a801903efdb8be13a8c8f8655398befebf27830762a8923d4aba3980b3
+  data.tar.gz: e87b83f0239ccd7eb80f13ac9cfac2b084557c5fa080973bac918e956a22d93f
 SHA512:
-  metadata.gz: 9a77d063a7939d176dd090d9dc6707549ec853a4173b88207635bd21b92496cd0cf7af7482827344b46734747f7db8c643ffeb38a4a8c14608c4875d04a12455
-  data.tar.gz: b8e3193916a87fd13007040cef7db37d3c2bf5c950f1b4f9b3b76480785af041402c9c7c1317555f89621ac6fba1426bfa1d511b5543d4be297e22f6839bb64e
+  metadata.gz: 0d13d93708bfb51373dd21ed1b0b488b834e6fac3558df7aeee116e3777d3525c5c2b8d7284b566475ad14fc68e90b1a11e27941aa5454920b31be208f763ec4
+  data.tar.gz: 20a4a250d003438c5948293d814e43bec5470e5e165875617ce4febdc60038350361a5c01f381cf3c7af116bf193b75fb6ecf2b21ae0be8b230fd1d5043bbce7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-adsense_v2
 
+### v0.33.0 (2024-03-31)
+
+* Regenerated from discovery document revision 20240324
+
+### v0.32.0 (2024-03-24)
+
+* Regenerated from discovery document revision 20240320
+
 ### v0.31.0 (2024-02-24)
 
 * Regenerated using generator version 0.14.0

data/lib/google/apis/adsense_v2/classes.rb

@@ -739,6 +739,35 @@ module Google
         end
       end
       
+      # Response definition for the policy issues list rpc. Policy issues are reported
+      # only if the publisher has at least one AFC ad client in READY or GETTING_READY
+      # state. If the publisher has no such AFC ad client, the response will be an
+      # empty list.
+      class ListPolicyIssuesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Continuation token used to page through policy issues. To retrieve the next
+        # page of the results, set the next request's "page_token" value to this.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The policy issues returned in the list response.
+        # Corresponds to the JSON property `policyIssues`
+        # @return [Array<Google::Apis::AdsenseV2::PolicyIssue>]
+        attr_accessor :policy_issues
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @policy_issues = args[:policy_issues] if args.key?(:policy_issues)
+        end
+      end
+      
       # Response definition for the saved reports list rpc.
       class ListSavedReportsResponse
         include Google::Apis::Core::Hashable
@@ -864,6 +893,162 @@ module Google
         end
       end
       
+      # Representation of a policy issue for a single entity (site, site-section, or
+      # page). All issues for a single entity are represented by a single PolicyIssue
+      # resource, though that PolicyIssue can have multiple causes (or "topics") that
+      # can change over time. Policy issues are removed if there are no issues
+      # detected recently or if there's a recent successful appeal for the entity.
+      class PolicyIssue
+        include Google::Apis::Core::Hashable
+      
+        # Required. The most severe action taken on the entity over the past seven days.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+      
+        # Optional. List of ad clients associated with the policy issue (either as the
+        # primary ad client or an associated host/secondary ad client). In the latter
+        # case, this will be an ad client that is not owned by the current account.
+        # Corresponds to the JSON property `adClients`
+        # @return [Array<String>]
+        attr_accessor :ad_clients
+      
+        # Required. Total number of ad requests affected by the policy violations over
+        # the past seven days.
+        # Corresponds to the JSON property `adRequestCount`
+        # @return [Fixnum]
+        attr_accessor :ad_request_count
+      
+        # Required. Type of the entity indicating if the entity is a site, site-section,
+        # or page.
+        # Corresponds to the JSON property `entityType`
+        # @return [String]
+        attr_accessor :entity_type
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `firstDetectedDate`
+        # @return [Google::Apis::AdsenseV2::Date]
+        attr_accessor :first_detected_date
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `lastDetectedDate`
+        # @return [Google::Apis::AdsenseV2::Date]
+        attr_accessor :last_detected_date
+      
+        # Required. Resource name of the entity with policy issues. Format: accounts/`
+        # account`/policyIssues/`policy_issue`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. Unordered list. The policy topics that this entity was found to
+        # violate over the past seven days.
+        # Corresponds to the JSON property `policyTopics`
+        # @return [Array<Google::Apis::AdsenseV2::PolicyTopic>]
+        attr_accessor :policy_topics
+      
+        # Required. Hostname/domain of the entity (for example "foo.com" or "www.foo.com"
+        # ). This _should_ be a bare domain/host name without any protocol. This will be
+        # present for all policy issues.
+        # Corresponds to the JSON property `site`
+        # @return [String]
+        attr_accessor :site
+      
+        # Optional. Prefix of the site-section having policy issues (For example "foo.
+        # com/bar-section"). This will be present if the `entity_type` is `SITE_SECTION`
+        # and will be absent for other entity types.
+        # Corresponds to the JSON property `siteSection`
+        # @return [String]
+        attr_accessor :site_section
+      
+        # Optional. URI of the page having policy violations (for example "foo.com/bar"
+        # or "www.foo.com/bar"). This will be present if the `entity_type` is `PAGE` and
+        # will be absent for other entity types.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `warningEscalationDate`
+        # @return [Google::Apis::AdsenseV2::Date]
+        attr_accessor :warning_escalation_date
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @ad_clients = args[:ad_clients] if args.key?(:ad_clients)
+          @ad_request_count = args[:ad_request_count] if args.key?(:ad_request_count)
+          @entity_type = args[:entity_type] if args.key?(:entity_type)
+          @first_detected_date = args[:first_detected_date] if args.key?(:first_detected_date)
+          @last_detected_date = args[:last_detected_date] if args.key?(:last_detected_date)
+          @name = args[:name] if args.key?(:name)
+          @policy_topics = args[:policy_topics] if args.key?(:policy_topics)
+          @site = args[:site] if args.key?(:site)
+          @site_section = args[:site_section] if args.key?(:site_section)
+          @uri = args[:uri] if args.key?(:uri)
+          @warning_escalation_date = args[:warning_escalation_date] if args.key?(:warning_escalation_date)
+        end
+      end
+      
+      # Information about a particular policy topic. A policy topic represents a
+      # single class of policy issue that can impact ad serving for your site. For
+      # example, sexual content or having ads that obscure your content. A single
+      # policy issue can have multiple policy topics for a single entity.
+      class PolicyTopic
+        include Google::Apis::Core::Hashable
+      
+        # Required. Indicates if this is a policy violation or not. When the value is
+        # true, issues that are instances of this topic must be addressed to remain in
+        # compliance with the partner's agreements with Google. A false value indicates
+        # that it's not mandatory to fix the issues but advertising demand might be
+        # restricted.
+        # Corresponds to the JSON property `mustFix`
+        # @return [Boolean]
+        attr_accessor :must_fix
+        alias_method :must_fix?, :must_fix
+      
+        # Required. The policy topic. For example, "sexual-content" or "ads-obscuring-
+        # content"."
+        # Corresponds to the JSON property `topic`
+        # @return [String]
+        attr_accessor :topic
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @must_fix = args[:must_fix] if args.key?(:must_fix)
+          @topic = args[:topic] if args.key?(:topic)
+        end
+      end
+      
       # Result of a generated report.
       class ReportResult
         include Google::Apis::Core::Hashable

data/lib/google/apis/adsense_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module AdsenseV2
       # Version of the google-apis-adsense_v2 gem
-      GEM_VERSION = "0.31.0"
+      GEM_VERSION = "0.33.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231016"
+      REVISION = "20240324"
     end
   end
 end

data/lib/google/apis/adsense_v2/representations.rb

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListPolicyIssuesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListSavedReportsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +190,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PolicyIssue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PolicyTopic
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ReportResult
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -427,6 +445,15 @@ module Google
         end
       end
       
+      class ListPolicyIssuesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :policy_issues, as: 'policyIssues', class: Google::Apis::AdsenseV2::PolicyIssue, decorator: Google::Apis::AdsenseV2::PolicyIssue::Representation
+      
+        end
+      end
+      
       class ListSavedReportsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -464,6 +491,36 @@ module Google
         end
       end
       
+      class PolicyIssue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :action, as: 'action'
+          collection :ad_clients, as: 'adClients'
+          property :ad_request_count, :numeric_string => true, as: 'adRequestCount'
+          property :entity_type, as: 'entityType'
+          property :first_detected_date, as: 'firstDetectedDate', class: Google::Apis::AdsenseV2::Date, decorator: Google::Apis::AdsenseV2::Date::Representation
+      
+          property :last_detected_date, as: 'lastDetectedDate', class: Google::Apis::AdsenseV2::Date, decorator: Google::Apis::AdsenseV2::Date::Representation
+      
+          property :name, as: 'name'
+          collection :policy_topics, as: 'policyTopics', class: Google::Apis::AdsenseV2::PolicyTopic, decorator: Google::Apis::AdsenseV2::PolicyTopic::Representation
+      
+          property :site, as: 'site'
+          property :site_section, as: 'siteSection'
+          property :uri, as: 'uri'
+          property :warning_escalation_date, as: 'warningEscalationDate', class: Google::Apis::AdsenseV2::Date, decorator: Google::Apis::AdsenseV2::Date::Representation
+      
+        end
+      end
+      
+      class PolicyTopic
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :must_fix, as: 'mustFix'
+          property :topic, as: 'topic'
+        end
+      end
+      
       class ReportResult
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/adsense_v2/service.rb

@@ -298,13 +298,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an ad unit. This method can only be used by projects enabled for the [
-        # AdSense for Platforms](https://developers.google.com/adsense/platforms/)
-        # product. Note that ad units can only be created for ad clients with an "AFC"
-        # product code. For more info see the [AdClient resource](/adsense/management/
-        # reference/rest/v2/accounts.adclients). For now, this method can only be used
-        # to create `DISPLAY` ad units. See: https://support.google.com/adsense/answer/
-        # 9183566
+        # Creates an ad unit. This method can be called only by a restricted set of
+        # projects, which are usually owned by [AdSense for Platforms](https://
+        # developers.google.com/adsense/platforms/) publishers. Contact your account
+        # manager if you need to use this method. Note that ad units can only be created
+        # for ad clients with an "AFC" product code. For more info see the [AdClient
+        # resource](/adsense/management/reference/rest/v2/accounts.adclients). For now,
+        # this method can only be used to create `DISPLAY` ad units. See: https://
+        # support.google.com/adsense/answer/9183566
         # @param [String] parent
         #   Required. Ad client to create an ad unit under. Format: accounts/`account`/
         #   adclients/`adclient`
@@ -486,10 +487,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an ad unit. This method can only be used by projects enabled for the [
-        # AdSense for Platforms](https://developers.google.com/adsense/platforms/)
-        # product. For now, this method can only be used to update `DISPLAY` ad units.
-        # See: https://support.google.com/adsense/answer/9183566
+        # Updates an ad unit. This method can be called only by a restricted set of
+        # projects, which are usually owned by [AdSense for Platforms](https://
+        # developers.google.com/adsense/platforms/) publishers. Contact your account
+        # manager if you need to use this method. For now, this method can only be used
+        # to update `DISPLAY` ad units. See: https://support.google.com/adsense/answer/
+        # 9183566
         # @param [String] name
         #   Output only. Resource name of the ad unit. Format: accounts/`account`/
         #   adclients/`adclient`/adunits/`adunit`
@@ -526,9 +529,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a custom channel. This method can only be used by projects enabled for
-        # the [AdSense for Platforms](https://developers.google.com/adsense/platforms/)
-        # product.
+        # Creates a custom channel. This method can be called only by a restricted set
+        # of projects, which are usually owned by [AdSense for Platforms](https://
+        # developers.google.com/adsense/platforms/) publishers. Contact your account
+        # manager if you need to use this method.
         # @param [String] parent
         #   Required. The ad client to create a custom channel under. Format: accounts/`
         #   account`/adclients/`adclient`
@@ -562,9 +566,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a custom channel. This method can only be used by projects enabled for
-        # the [AdSense for Platforms](https://developers.google.com/adsense/platforms/)
-        # product.
+        # Deletes a custom channel. This method can be called only by a restricted set
+        # of projects, which are usually owned by [AdSense for Platforms](https://
+        # developers.google.com/adsense/platforms/) publishers. Contact your account
+        # manager if you need to use this method.
         # @param [String] name
         #   Required. Name of the custom channel to delete. Format: accounts/`account`/
         #   adclients/`adclient`/customchannels/`customchannel`
@@ -710,9 +715,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a custom channel. This method can only be used by projects enabled for
-        # the [AdSense for Platforms](https://developers.google.com/adsense/platforms/)
-        # product.
+        # Updates a custom channel. This method can be called only by a restricted set
+        # of projects, which are usually owned by [AdSense for Platforms](https://
+        # developers.google.com/adsense/platforms/) publishers. Contact your account
+        # manager if you need to use this method.
         # @param [String] name
         #   Output only. Resource name of the custom channel. Format: accounts/`account`/
         #   adclients/`adclient`/customchannels/`customchannel`
@@ -889,6 +895,79 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets information about the selected policy issue.
+        # @param [String] name
+        #   Required. Name of the policy issue. Format: accounts/`account`/policyIssues/`
+        #   policy_issue`
+        # @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::AdsenseV2::PolicyIssue] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AdsenseV2::PolicyIssue]
+        #
+        # @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_account_policy_issue(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::AdsenseV2::PolicyIssue::Representation
+          command.response_class = Google::Apis::AdsenseV2::PolicyIssue
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the policy issues for the specified account.
+        # @param [String] parent
+        #   Required. The account for which policy issues are being retrieved. Format:
+        #   accounts/`account`
+        # @param [Fixnum] page_size
+        #   The maximum number of policy issues to include in the response, used for
+        #   paging. If unspecified, at most 10000 policy issues will be returned. The
+        #   maximum value is 10000; values above 10000 will be coerced to 10000.
+        # @param [String] page_token
+        #   A page token, received from a previous `ListPolicyIssues` call. Provide this
+        #   to retrieve the subsequent page. When paginating, all other parameters
+        #   provided to `ListPolicyIssues` must match the call that provided the page
+        #   token.
+        # @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::AdsenseV2::ListPolicyIssuesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AdsenseV2::ListPolicyIssuesResponse]
+        #
+        # @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_account_policy_issues(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/policyIssues', options)
+          command.response_representation = Google::Apis::AdsenseV2::ListPolicyIssuesResponse::Representation
+          command.response_class = Google::Apis::AdsenseV2::ListPolicyIssuesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Generates an ad hoc report.
         # @param [String] account
         #   Required. The account which owns the collection of reports. Format: accounts/`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-adsense_v2
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.33.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-25 00:00:00.000000000 Z
+date: 2024-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-adsense_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-adsense_v2/v0.31.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-adsense_v2/v0.33.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-adsense_v2
 post_install_message: 
 rdoc_options: []