/services/invoice_service.proto

--- v22/services/invoice_service.proto  2026-01-23 15:31:44.000000000 +0000
+++ v23/services/invoice_service.proto  2026-01-22 20:49:25.000000000 +0000
@@ -1,86 +1,92 @@
 // 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
 //
 //     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.

 syntax = "proto3";

-package google.ads.googleads.v22.services;
+package google.ads.googleads.v23.services;

-import "google/ads/googleads/v22/enums/month_of_year.proto";
-import "google/ads/googleads/v22/resources/invoice.proto";
+import "google/ads/googleads/v23/enums/month_of_year.proto";
+import "google/ads/googleads/v23/resources/invoice.proto";
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";

-option csharp_namespace = "Google.Ads.GoogleAds.V22.Services";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/services;services";
+option csharp_namespace = "Google.Ads.GoogleAds.V23.Services";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/services;services";
 option java_multiple_files = true;
 option java_outer_classname = "InvoiceServiceProto";
-option java_package = "com.google.ads.googleads.v22.services";
+option java_package = "com.google.ads.googleads.v23.services";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Services";
-option ruby_package = "Google::Ads::GoogleAds::V22::Services";
+option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Services";
+option ruby_package = "Google::Ads::GoogleAds::V23::Services";

 // Proto file describing the Invoice service.

 // A service to fetch invoices issued for a billing setup during a given month.
 service InvoiceService {
   option (google.api.default_host) = "googleads.googleapis.com";
   option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/adwords";

   // Returns all invoices associated with a billing setup, for a given month.
   //
   // List of thrown errors:
   //   [AuthenticationError]()
   //   [AuthorizationError]()
   //   [FieldError]()
   //   [HeaderError]()
   //   [InternalError]()
   //   [InvoiceError]()
   //   [QuotaError]()
   //   [RequestError]()
   rpc ListInvoices(ListInvoicesRequest) returns (ListInvoicesResponse) {
     option (google.api.http) = {
-      get: "/v22/customers/{customer_id=*}/invoices"
+      get: "/v23/customers/{customer_id=*}/invoices"
     };
     option (google.api.method_signature) =
         "customer_id,billing_setup,issue_year,issue_month";
   }
 }

 // Request message for fetching the invoices of a given billing setup that were
 // issued during a given month.
 message ListInvoicesRequest {
   // Required. The ID of the customer to fetch invoices for.
   string customer_id = 1 [(google.api.field_behavior) = REQUIRED];

   // Required. The billing setup resource name of the requested invoices.
   //
   // `customers/{customer_id}/billingSetups/{billing_setup_id}`
   string billing_setup = 2 [(google.api.field_behavior) = REQUIRED];

   // Required. The issue year to retrieve invoices, in yyyy format. Only
   // invoices issued in 2019 or later can be retrieved.
   string issue_year = 3 [(google.api.field_behavior) = REQUIRED];

   // Required. The issue month to retrieve invoices.
-  google.ads.googleads.v22.enums.MonthOfYearEnum.MonthOfYear issue_month = 4
+  google.ads.googleads.v23.enums.MonthOfYearEnum.MonthOfYear issue_month = 4
       [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. When true, the response will include more granular level invoice
+  // details such as campaign level cost breakdown, itemized regulatory costs
+  // and adjustments. The default value is false.
+  bool include_granular_level_invoice_details = 5
+      [(google.api.field_behavior) = OPTIONAL];
 }

 // Response message for
-// [InvoiceService.ListInvoices][google.ads.googleads.v22.services.InvoiceService.ListInvoices].
+// [InvoiceService.ListInvoices][google.ads.googleads.v23.services.InvoiceService.ListInvoices].
 message ListInvoicesResponse {
   // The list of invoices that match the billing setup and time period.
-  repeated google.ads.googleads.v22.resources.Invoice invoices = 1;
+  repeated google.ads.googleads.v23.resources.Invoice invoices = 1;
 }