/resources/local_services_lead.proto

--- v16/resources/local_services_lead.proto 2024-02-22 08:40:46.000000000 +0000
+++ v16-1/resources/local_services_lead.proto   2024-04-18 15:49:00.000000000 +0000
@@ -1,122 +1,140 @@
 // Copyright 2023 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.v16.resources;

+import "google/ads/googleads/v16/enums/local_services_lead_credit_state.proto";
 import "google/ads/googleads/v16/enums/local_services_lead_status.proto";
 import "google/ads/googleads/v16/enums/local_services_lead_type.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";

 option csharp_namespace = "Google.Ads.GoogleAds.V16.Resources";
 option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/resources;resources";
 option java_multiple_files = true;
 option java_outer_classname = "LocalServicesLeadProto";
 option java_package = "com.google.ads.googleads.v16.resources";
 option objc_class_prefix = "GAA";
 option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Resources";
 option ruby_package = "Google::Ads::GoogleAds::V16::Resources";

 // Proto file describing the local services lead resource.

 // Data from Local Services Lead.
 // Contains details of Lead which is generated when user calls, messages or
 // books service from advertiser.
 // More info: https://ads.google.com/local-services-ads
 message LocalServicesLead {
   option (google.api.resource) = {
     type: "googleads.googleapis.com/LocalServicesLead"
     pattern: "customers/{customer_id}/localServicesLeads/{local_services_lead_id}"
   };

   // Output only. The resource name of the local services lead data.
   // Local Services Lead resource name have the form
   //
   // `customers/{customer_id}/localServicesLead/{local_services_lead_id}`
   string resource_name = 1 [
     (google.api.field_behavior) = OUTPUT_ONLY,
     (google.api.resource_reference) = {
       type: "googleads.googleapis.com/LocalServicesLead"
     }
   ];

   // Output only. ID of this Lead.
   int64 id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Service category of the lead. For example:
   // `xcat:service_area_business_hvac`,
   // `xcat:service_area_business_real_estate_agent`, etc.
   // For more details see:
   // https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
   string category_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Service for the  category. For example: `buyer_agent`,
   // `seller_agent` for the category of
   // `xcat:service_area_business_real_estate_agent`.
   string service_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Lead's contact details.
   ContactDetails contact_details = 5
       [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Type of Local Services lead: phone, message, booking, etc.
   google.ads.googleads.v16.enums.LocalServicesLeadTypeEnum.LeadType lead_type =
       6 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Current status of lead.
   google.ads.googleads.v16.enums.LocalServicesLeadStatusEnum.LeadStatus
       lead_status = 7 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. The date time at which lead was created by Local Services Ads.
   // The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone.
   // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
   string creation_date_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Language used by the Local Services provider linked to lead.
   // See https://developers.google.com/google-ads/api/data/codes-formats#locales
   string locale = 9 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Note added by advertiser for the lead.
   optional Note note = 10 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. True if the advertiser was charged for the lead.
   bool lead_charged = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Credit details of the lead.
+  optional CreditDetails credit_details = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }

 // Fields containing consumer contact details.
 message ContactDetails {
   // Output only. Consumer phone number in E164 format.
   string phone_number = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Consumer email address.
   string email = 2 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Consumer name if consumer provided name from Message or
   // Booking form on google.com
   string consumer_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 }

 // Represents a note added to a lead by the advertiser. Advertisers can edit
 // notes, which will reset edit time and change description.
 message Note {
   // Output only. The date time when lead note was edited. The format is
   // "YYYY-MM-DD HH:MM:SS" in the Google Ads account's timezone. Examples:
   // "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
   string edit_date_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

   // Output only. Content of lead note.
   string description = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
+
+// Represents the credit details of a lead.
+message CreditDetails {
+  // Output only. Credit state of the lead.
+  google.ads.googleads.v16.enums.LocalServicesCreditStateEnum.CreditState
+      credit_state = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The date time when the credit state of the lead was last
+  // updated. The format is "YYYY-MM-DD HH:MM:SS" in the Google Ads account's
+  // timezone. Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
+  string credit_state_last_update_date_time = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}