google-ads-data_manager-v1 0.2.0 → 0.3.0

data/proto_docs/google/ads/datamanager/v1/gender.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Ads
+    module DataManager
+      module V1
+        # The type of demographic genders (for example, female).
+        module Gender
+          # Not specified.
+          GENDER_UNSPECIFIED = 0
+
+          # Unknown.
+          GENDER_UNKNOWN = 1
+
+          # Male.
+          GENDER_MALE = 2
+
+          # Female.
+          GENDER_FEMALE = 3
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/ads/datamanager/v1/insights_service.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Ads
+    module DataManager
+      module V1
+        # Request message for DM API MarketingDataInsightsService.RetrieveInsights
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent account that owns the user list.
+        #     Format: `accountTypes/{account_type}/accounts/{account}`
+        # @!attribute [rw] baseline
+        #   @return [::Google::Ads::DataManager::V1::Baseline]
+        #     Required. Baseline for the insights requested.
+        # @!attribute [rw] user_list_id
+        #   @return [::String]
+        #     Required. The user list ID for which insights are requested.
+        class RetrieveInsightsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Baseline criteria against which insights are compared.
+        # @!attribute [rw] baseline_location
+        #   @return [::Google::Ads::DataManager::V1::Baseline::Location]
+        #     The baseline location of the request. Baseline location is an OR-list
+        #     of the requested regions.
+        #
+        #     Note: The following fields are mutually exclusive: `baseline_location`, `location_auto_detection_enabled`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] location_auto_detection_enabled
+        #   @return [::Boolean]
+        #     If set to true, the service will try to automatically detect the
+        #     baseline location for insights.
+        #
+        #     Note: The following fields are mutually exclusive: `location_auto_detection_enabled`, `baseline_location`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class Baseline
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The baseline location of the request. Baseline location is on OR-list of
+          # ISO 3166-1 alpha-2 region codes of the requested regions.
+          # @!attribute [rw] region_codes
+          #   @return [::Array<::String>]
+          #     List of ISO 3166-1 alpha-2 region codes.
+          class Location
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Response message for DM API MarketingDataInsightsService.RetrieveInsights
+        # @!attribute [rw] marketing_data_insights
+        #   @return [::Array<::Google::Ads::DataManager::V1::RetrieveInsightsResponse::MarketingDataInsight>]
+        #     Contains the insights for the marketing data.
+        class RetrieveInsightsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Insights for marketing data.
+          #
+          # This feature is only available to data partners.
+          # @!attribute [rw] dimension
+          #   @return [::Google::Ads::DataManager::V1::RetrieveInsightsResponse::MarketingDataInsight::AudienceInsightsDimension]
+          #     The dimension to which the insight belongs.
+          # @!attribute [rw] attributes
+          #   @return [::Array<::Google::Ads::DataManager::V1::RetrieveInsightsResponse::MarketingDataInsight::MarketingDataInsightsAttribute>]
+          #     Insights for values of a given dimension.
+          class MarketingDataInsight
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Insights for a collection of related attributes of the same dimension.
+            # @!attribute [rw] user_interest_id
+            #   @return [::Integer]
+            #     The user interest ID.
+            # @!attribute [rw] lift
+            #   @return [::Float]
+            #     Measure of lift that the audience has for the attribute value as
+            #     compared to the baseline. Range [0-1].
+            # @!attribute [rw] age_range
+            #   @return [::Google::Ads::DataManager::V1::AgeRange]
+            #     Age range of the audience for which the lift is provided.
+            # @!attribute [rw] gender
+            #   @return [::Google::Ads::DataManager::V1::Gender]
+            #     Gender of the audience for which the lift is provided.
+            class MarketingDataInsightsAttribute
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Possible dimensions for use in generating insights.
+            module AudienceInsightsDimension
+              # Not specified.
+              AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED = 0
+
+              # The value is unknown in this version.
+              AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN = 1
+
+              # An Affinity UserInterest.
+              AFFINITY_USER_INTEREST = 2
+
+              # An In-Market UserInterest.
+              IN_MARKET_USER_INTEREST = 3
+
+              # An age range.
+              AGE_RANGE = 4
+
+              # A gender.
+              GENDER = 5
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/ads/datamanager/v1/partner_link_service.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Ads
+    module DataManager
+      module V1
+        # Request to create a {::Google::Ads::DataManager::V1::PartnerLink PartnerLink}
+        # resource. Returns a
+        # {::Google::Ads::DataManager::V1::PartnerLink PartnerLink}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of partner links.
+        #     Format: accountTypes/\\{account_type}/accounts/\\{account}
+        # @!attribute [rw] partner_link
+        #   @return [::Google::Ads::DataManager::V1::PartnerLink]
+        #     Required. The partner link to create.
+        class CreatePartnerLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request to delete a {::Google::Ads::DataManager::V1::PartnerLink PartnerLink}
+        # resource. Returns a {::Google::Protobuf::Empty google.protobuf.Empty}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the partner link to delete.
+        #     Format:
+        #     accountTypes/\\{account_type}/accounts/\\{account}/partnerLinks/\\{partner_link}
+        class DeletePartnerLinkRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request to search for {::Google::Ads::DataManager::V1::PartnerLink PartnerLink}
+        # resources. Returns a
+        # {::Google::Ads::DataManager::V1::SearchPartnerLinksResponse SearchPartnerLinksResponse}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Account to search for partner links. If no `filter` is specified,
+        #     all partner links where this account is either the `owning_account` or
+        #     `partner_account` are returned.
+        #
+        #     Format: `accountTypes/{account_type}/accounts/{account}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of partner links to return. The service may return
+        #     fewer than this value.
+        #     If unspecified, at most 10 partner links will be returned.
+        #     The maximum value is 100; values above 100 will be coerced to 100.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `SearchPartnerLinks` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `SearchPartnerLinks`
+        #     must match the call that provided the page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A [filter string](https://google.aip.dev/160). All fields need to
+        #     be on the left hand side of each condition (for example: `partner_link_id =
+        #     123456789`). Fields must be specified using either all [camel
+        #     case](https://en.wikipedia.org/wiki/Camel_case) or all [snake
+        #     case](https://en.wikipedia.org/wiki/Snake_case). Don't use a combination of
+        #     camel case and snake case.
+        #
+        #     Supported operations:
+        #
+        #     - `AND`
+        #     - `=`
+        #     - `!=`
+        #
+        #     Supported fields:
+        #
+        #     - `partner_link_id`
+        #     - `owning_account.account_type`
+        #     - `owning_account.account_id`
+        #     - `partner_account.account_type`
+        #     - `partner_account.account_id`
+        #
+        #     Example:
+        #     `owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id
+        #     = 987654321`
+        class SearchPartnerLinksRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response from the
+        # {::Google::Ads::DataManager::V1::SearchPartnerLinksRequest SearchPartnerLinksRequest}.
+        # @!attribute [rw] partner_links
+        #   @return [::Array<::Google::Ads::DataManager::V1::PartnerLink>]
+        #     The partner links for the given account.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class SearchPartnerLinksResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A partner link between an owning account and a partner account.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The name of the partner link.
+        #     Format:
+        #     accountTypes/\\{account_type}/accounts/\\{account}/partnerLinks/\\{partner_link}
+        # @!attribute [r] partner_link_id
+        #   @return [::String]
+        #     Output only. The partner link ID.
+        # @!attribute [rw] owning_account
+        #   @return [::Google::Ads::DataManager::V1::ProductAccount]
+        #     Required. The owning account granting access to the partner account.
+        # @!attribute [rw] partner_account
+        #   @return [::Google::Ads::DataManager::V1::ProductAccount]
+        #     Required. The partner account granted access by the owning account.
+        class PartnerLink
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/ads/datamanager/v1/request_status_per_destination.rb

@@ -60,17 +60,27 @@ module Google
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::IngestUserDataStatus]
           #     The status of the user data ingestion to the destination.
           #
-          #     Note: The following fields are mutually exclusive: `user_data_ingestion_status`, `mobile_data_ingestion_status`, `pair_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `user_data_ingestion_status`, `mobile_data_ingestion_status`, `pair_data_ingestion_status`, `user_id_data_ingestion_status`, `ppid_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] mobile_data_ingestion_status
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::IngestMobileDataStatus]
           #     The status of the mobile data ingestion to the destination.
           #
-          #     Note: The following fields are mutually exclusive: `mobile_data_ingestion_status`, `user_data_ingestion_status`, `pair_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `mobile_data_ingestion_status`, `user_data_ingestion_status`, `pair_data_ingestion_status`, `user_id_data_ingestion_status`, `ppid_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] pair_data_ingestion_status
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::IngestPairDataStatus]
           #     The status of the pair data ingestion to the destination.
           #
-          #     Note: The following fields are mutually exclusive: `pair_data_ingestion_status`, `user_data_ingestion_status`, `mobile_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `pair_data_ingestion_status`, `user_data_ingestion_status`, `mobile_data_ingestion_status`, `user_id_data_ingestion_status`, `ppid_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] user_id_data_ingestion_status
+          #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::IngestUserIdDataStatus]
+          #     The status of the user id data ingestion to the destination.
+          #
+          #     Note: The following fields are mutually exclusive: `user_id_data_ingestion_status`, `user_data_ingestion_status`, `mobile_data_ingestion_status`, `pair_data_ingestion_status`, `ppid_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] ppid_data_ingestion_status
+          #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::IngestPpidDataStatus]
+          #     The status of the ppid data ingestion to the destination.
+          #
+          #     Note: The following fields are mutually exclusive: `ppid_data_ingestion_status`, `user_data_ingestion_status`, `mobile_data_ingestion_status`, `pair_data_ingestion_status`, `user_id_data_ingestion_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class IngestAudienceMembersStatus
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -81,17 +91,27 @@ module Google
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::RemoveUserDataStatus]
           #     The status of the user data removal from the destination.
           #
-          #     Note: The following fields are mutually exclusive: `user_data_removal_status`, `mobile_data_removal_status`, `pair_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `user_data_removal_status`, `mobile_data_removal_status`, `pair_data_removal_status`, `user_id_data_removal_status`, `ppid_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] mobile_data_removal_status
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::RemoveMobileDataStatus]
           #     The status of the mobile data removal from the destination.
           #
-          #     Note: The following fields are mutually exclusive: `mobile_data_removal_status`, `user_data_removal_status`, `pair_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `mobile_data_removal_status`, `user_data_removal_status`, `pair_data_removal_status`, `user_id_data_removal_status`, `ppid_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] pair_data_removal_status
           #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::RemovePairDataStatus]
           #     The status of the pair data removal from the destination.
           #
-          #     Note: The following fields are mutually exclusive: `pair_data_removal_status`, `user_data_removal_status`, `mobile_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `pair_data_removal_status`, `user_data_removal_status`, `mobile_data_removal_status`, `user_id_data_removal_status`, `ppid_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] user_id_data_removal_status
+          #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::RemoveUserIdDataStatus]
+          #     The status of the user id data removal from the destination.
+          #
+          #     Note: The following fields are mutually exclusive: `user_id_data_removal_status`, `user_data_removal_status`, `mobile_data_removal_status`, `pair_data_removal_status`, `ppid_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] ppid_data_removal_status
+          #   @return [::Google::Ads::DataManager::V1::RequestStatusPerDestination::RemovePpidDataStatus]
+          #     The status of the ppid data removal from the destination.
+          #
+          #     Note: The following fields are mutually exclusive: `ppid_data_removal_status`, `user_data_removal_status`, `mobile_data_removal_status`, `pair_data_removal_status`, `user_id_data_removal_status`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class RemoveAudienceMembersStatus
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -210,6 +230,72 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The status of the user id data ingestion to the destination containing
+          # stats related to the ingestion.
+          # @!attribute [rw] record_count
+          #   @return [::Integer]
+          #     The total count of audience members sent in the upload request for the
+          #     destination. Includes all audience members in the request, regardless of
+          #     whether they were successfully ingested or not.
+          # @!attribute [rw] user_id_count
+          #   @return [::Integer]
+          #     The total count of user ids sent in the upload request for the
+          #     destination. Includes all user ids in the request, regardless of
+          #     whether they were successfully ingested or not.
+          class IngestUserIdDataStatus
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The status of the user id data removal from the destination.
+          # @!attribute [rw] record_count
+          #   @return [::Integer]
+          #     The total count of audience members sent in the removal request. Includes
+          #     all audience members in the request, regardless of whether they were
+          #     successfully removed or not.
+          # @!attribute [rw] user_id_count
+          #   @return [::Integer]
+          #     The total count of user ids sent in the removal request. Includes all
+          #     user ids in the request, regardless of whether they were successfully
+          #     removed or not.
+          class RemoveUserIdDataStatus
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The status of the ppid data ingestion to the destination containing stats
+          # related to the ingestion.
+          # @!attribute [rw] record_count
+          #   @return [::Integer]
+          #     The total count of audience members sent in the upload request for the
+          #     destination. Includes all audience members in the request, regardless of
+          #     whether they were successfully ingested or not.
+          # @!attribute [rw] ppid_count
+          #   @return [::Integer]
+          #     The total count of ppids sent in the upload request for the
+          #     destination. Includes all ppids in the request, regardless of
+          #     whether they were successfully ingested or not.
+          class IngestPpidDataStatus
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The status of the ppid data removal from the destination.
+          # @!attribute [rw] record_count
+          #   @return [::Integer]
+          #     The total count of audience members sent in the removal request. Includes
+          #     all audience members in the request, regardless of whether they were
+          #     successfully removed or not.
+          # @!attribute [rw] ppid_count
+          #   @return [::Integer]
+          #     The total count of ppids sent in the removal request. Includes all
+          #     ppids in the request, regardless of whether they were successfully
+          #     removed or not.
+          class RemovePpidDataStatus
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The request status.
           module RequestStatus
             # The request status is unknown.