feat: added partition_keys field to filter results from FetchReportResults (#235)

gcf-owl-bot[bot] · web-flow · commit 3e304f1e26f3 · 2023-05-16T11:28:19.000+02:00
* feat: added partition_keys field to filter results from FetchReportResults docs: Change references from GCP to Google Cloud PiperOrigin-RevId: 532265140 Source-Link: googleapis/googleapis@31893ad Source-Link: https://github.com/googleapis/googleapis-gen/commit/5015d29229762a1d03bb246fa5bdd05fbf7b9741 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTAxNWQyOTIyOTc2MmExZDAzYmIyNDZmYTViZGQwNWZiZjdiOTc0MSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/google/cloud/channel_v1/services/cloud_channel_reports_service/async_client.py b/google/cloud/channel_v1/services/cloud_channel_reports_service/async_client.py
@@ -57,8 +57,8 @@
 class CloudChannelReportsServiceAsyncClient:
     """CloudChannelReportsService lets Google Cloud resellers and
     distributors retrieve and combine a variety of data in Cloud
-    Channel for multiple products (Google Cloud Platform (GCP),
-    Google Voice, and Google Workspace.)
+    Channel for multiple products (Google Cloud, Google Voice, and
+    Google Workspace.)
     """
 
     _client: CloudChannelReportsServiceClient
diff --git a/google/cloud/channel_v1/services/cloud_channel_reports_service/client.py b/google/cloud/channel_v1/services/cloud_channel_reports_service/client.py
@@ -97,8 +97,8 @@ def get_transport_class(
 class CloudChannelReportsServiceClient(metaclass=CloudChannelReportsServiceClientMeta):
     """CloudChannelReportsService lets Google Cloud resellers and
     distributors retrieve and combine a variety of data in Cloud
-    Channel for multiple products (Google Cloud Platform (GCP),
-    Google Voice, and Google Workspace.)
+    Channel for multiple products (Google Cloud, Google Voice, and
+    Google Workspace.)
     """
 
     @staticmethod
diff --git a/google/cloud/channel_v1/services/cloud_channel_reports_service/transports/grpc.py b/google/cloud/channel_v1/services/cloud_channel_reports_service/transports/grpc.py
@@ -33,8 +33,8 @@ class CloudChannelReportsServiceGrpcTransport(CloudChannelReportsServiceTranspor
 
     CloudChannelReportsService lets Google Cloud resellers and
     distributors retrieve and combine a variety of data in Cloud
-    Channel for multiple products (Google Cloud Platform (GCP),
-    Google Voice, and Google Workspace.)
+    Channel for multiple products (Google Cloud, Google Voice, and
+    Google Workspace.)
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
diff --git a/google/cloud/channel_v1/services/cloud_channel_reports_service/transports/grpc_asyncio.py b/google/cloud/channel_v1/services/cloud_channel_reports_service/transports/grpc_asyncio.py
@@ -36,8 +36,8 @@ class CloudChannelReportsServiceGrpcAsyncIOTransport(
 
     CloudChannelReportsService lets Google Cloud resellers and
     distributors retrieve and combine a variety of data in Cloud
-    Channel for multiple products (Google Cloud Platform (GCP),
-    Google Voice, and Google Workspace.)
+    Channel for multiple products (Google Cloud, Google Voice, and
+    Google Workspace.)
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
diff --git a/google/cloud/channel_v1/types/entitlements.py b/google/cloud/channel_v1/types/entitlements.py
@@ -104,8 +104,8 @@ class Entitlement(proto.Message):
 
             -  assigned_units: The number of licenses assigned to users.
 
-            For GCP billing subaccounts, the following Parameter may be
-            accepted as input:
+            For Google Cloud billing subaccounts, the following
+            Parameter may be accepted as input:
 
             -  display_name: The display name of the billing subaccount.
         billing_account (str):
@@ -273,9 +273,9 @@ class ProvisionedService(proto.Message):
         provisioning_id (str):
             Output only. Provisioning ID of the
             entitlement. For Google Workspace, this is the
-            underlying Subscription ID. For Google Cloud
-            Platform, this is the Billing Account ID of the
-            billing subaccount.".
+            underlying Subscription ID. For Google Cloud,
+            this is the Billing Account ID of the billing
+            subaccount.".
         product_id (str):
             Output only. The product pertaining to the
             provisioning resource as specified in the Offer.
diff --git a/google/cloud/channel_v1/types/offers.py b/google/cloud/channel_v1/types/offers.py
@@ -130,16 +130,16 @@ class ResourceType(proto.Enum):
         MINUTES (5):
             Voice usage.
         IAAS_USAGE (6):
-            For IaaS SKUs like Google Cloud Platform,
-            monetization is based on usage accrued on your
-            billing account irrespective of the type of
-            monetizable resource. This enum represents an
-            aggregated resource/container for all usage SKUs
-            on a billing account. Currently, only applicable
-            to Google Cloud Platform.
+            For IaaS SKUs like Google Cloud, monetization
+            is based on usage accrued on your billing
+            account irrespective of the type of monetizable
+            resource. This enum represents an aggregated
+            resource/container for all usage SKUs on a
+            billing account. Currently, only applicable to
+            Google Cloud.
         SUBSCRIPTION (7):
-            For Google Cloud Platform subscriptions like
-            Anthos or SAP.
+            For Google Cloud subscriptions like Anthos or
+            SAP.
     """
     RESOURCE_TYPE_UNSPECIFIED = 0
     SEAT = 1
@@ -404,7 +404,7 @@ class Plan(proto.Message):
         billing_account (str):
             Reseller Billing account to charge after an
             offer transaction. Only present for Google Cloud
-            Platform offers.
+            offers.
     """
 
     payment_plan: "PaymentPlan" = proto.Field(
diff --git a/google/cloud/channel_v1/types/reports_service.py b/google/cloud/channel_v1/types/reports_service.py
@@ -149,6 +149,10 @@ class FetchReportResultsRequest(proto.Message):
             of the previous
             [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]
             call.
+        partition_keys (MutableSequence[str]):
+            Optional. List of keys specifying which
+            report partitions to return. If empty, returns
+            all partitions.
     """
 
     report_job: str = proto.Field(
@@ -163,6 +167,10 @@ class FetchReportResultsRequest(proto.Message):
         proto.STRING,
         number=3,
     )
+    partition_keys: MutableSequence[str] = proto.RepeatedField(
+        proto.STRING,
+        number=4,
+    )
 
 
 class FetchReportResultsResponse(proto.Message):
@@ -429,16 +437,14 @@ class DateRange(proto.Message):
             ``usage_start_date_time`` in Pacific time.
         invoice_start_date (google.type.date_pb2.Date):
             The earliest invoice date (inclusive).
-            If your product uses monthly invoices, and this
-            value is not the beginning of a month, this will
-            adjust the date to the first day of the given
-            month.
+            If this value is not the first day of a month,
+            this will move it back to the first day of the
+            given month.
         invoice_end_date (google.type.date_pb2.Date):
-            The latest invoice date (exclusive).
-            If your product uses monthly invoices, and this
-            value is not the beginning of a month, this will
-            adjust the date to the first day of the
-            following month.
+            The latest invoice date (inclusive).
+            If this value is not the last day of a month,
+            this will move it forward to the last day of the
+            given month.
     """
 
     usage_start_date_time: datetime_pb2.DateTime = proto.Field(
@@ -469,13 +475,21 @@ class Row(proto.Message):
     Attributes:
         values (MutableSequence[google.cloud.channel_v1.types.ReportValue]):
             The list of values in the row.
+        partition_key (str):
+            The key for the partition this row belongs
+            to. This field is empty if the report is not
+            partitioned.
     """
 
     values: MutableSequence["ReportValue"] = proto.RepeatedField(
         proto.MESSAGE,
         number=1,
         message="ReportValue",
     )
+    partition_key: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
 
 
 class ReportValue(proto.Message):
@@ -608,8 +622,8 @@ class State(proto.Enum):
 
 class Report(proto.Message):
     r"""The ID and description of a report that was used to generate
-    report data. For example, "GCP Daily Spend", "Google Workspace
-    License Activity", etc.
+    report data. For example, "Google Cloud Daily Spend", "Google
+    Workspace License Activity", etc.
 
     Attributes:
         name (str):
diff --git a/scripts/fixup_channel_v1_keywords.py b/scripts/fixup_channel_v1_keywords.py
@@ -53,7 +53,7 @@ class channelCallTransformer(cst.CSTTransformer):
         'delete_channel_partner_repricing_config': ('name', ),
         'delete_customer': ('name', ),
         'delete_customer_repricing_config': ('name', ),
-        'fetch_report_results': ('report_job', 'page_size', 'page_token', ),
+        'fetch_report_results': ('report_job', 'page_size', 'page_token', 'partition_keys', ),
         'get_channel_partner_link': ('name', 'view', ),
         'get_channel_partner_repricing_config': ('name', ),
         'get_customer': ('name', ),
