--- v13/resources/customer.proto 2023-04-26 19:21:31.000000000 +0000 +++ v14/resources/customer.proto 2023-06-07 19:32:16.000000000 +0000 @@ -1,231 +1,368 @@ // 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.v13.resources; +package google.ads.googleads.v14.resources; -import "google/ads/googleads/v13/enums/conversion_tracking_status_enum.proto"; -import "google/ads/googleads/v13/enums/customer_pay_per_conversion_eligibility_failure_reason.proto"; -import "google/ads/googleads/v13/enums/customer_status.proto"; +import "google/ads/googleads/v14/enums/conversion_tracking_status_enum.proto"; +import "google/ads/googleads/v14/enums/customer_pay_per_conversion_eligibility_failure_reason.proto"; +import "google/ads/googleads/v14/enums/customer_status.proto"; +import "google/ads/googleads/v14/enums/offline_conversion_diagnostic_status_enum.proto"; +import "google/ads/googleads/v14/enums/offline_event_upload_client_enum.proto"; +import "google/ads/googleads/v14/errors/collection_size_error.proto"; +import "google/ads/googleads/v14/errors/conversion_adjustment_upload_error.proto"; +import "google/ads/googleads/v14/errors/conversion_upload_error.proto"; +import "google/ads/googleads/v14/errors/date_error.proto"; +import "google/ads/googleads/v14/errors/distinct_error.proto"; +import "google/ads/googleads/v14/errors/field_error.proto"; +import "google/ads/googleads/v14/errors/mutate_error.proto"; +import "google/ads/googleads/v14/errors/not_allowlisted_error.proto"; +import "google/ads/googleads/v14/errors/string_format_error.proto"; +import "google/ads/googleads/v14/errors/string_length_error.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; -option csharp_namespace = "Google.Ads.GoogleAds.V13.Resources"; -option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v13/resources;resources"; +option csharp_namespace = "Google.Ads.GoogleAds.V14.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v14/resources;resources"; option java_multiple_files = true; option java_outer_classname = "CustomerProto"; -option java_package = "com.google.ads.googleads.v13.resources"; +option java_package = "com.google.ads.googleads.v14.resources"; option objc_class_prefix = "GAA"; -option php_namespace = "Google\\Ads\\GoogleAds\\V13\\Resources"; -option ruby_package = "Google::Ads::GoogleAds::V13::Resources"; +option php_namespace = "Google\\Ads\\GoogleAds\\V14\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V14::Resources"; // Proto file describing the Customer resource. // A customer. message Customer { option (google.api.resource) = { type: "googleads.googleapis.com/Customer" pattern: "customers/{customer_id}" }; // Immutable. The resource name of the customer. // Customer resource names have the form: // // `customers/{customer_id}` string resource_name = 1 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { type: "googleads.googleapis.com/Customer" } ]; // Output only. The ID of the customer. optional int64 id = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional, non-unique descriptive name of the customer. optional string descriptive_name = 20; // Immutable. The currency in which the account operates. // A subset of the currency codes from the ISO 4217 standard is // supported. optional string currency_code = 21 [(google.api.field_behavior) = IMMUTABLE]; // Immutable. The local timezone ID of the customer. optional string time_zone = 22 [(google.api.field_behavior) = IMMUTABLE]; // The URL template for constructing a tracking URL out of parameters. // Only mutable in an `update` operation. optional string tracking_url_template = 23; // The URL template for appending params to the final URL. // Only mutable in an `update` operation. optional string final_url_suffix = 24; // Whether auto-tagging is enabled for the customer. optional bool auto_tagging_enabled = 25; // Output only. Whether the Customer has a Partners program badge. If the // Customer is not associated with the Partners program, this will be false. // For more information, see // https://support.google.com/partners/answer/3125774. optional bool has_partners_badge = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Whether the customer is a manager. optional bool manager = 27 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Whether the customer is a test account. optional bool test_account = 28 [(google.api.field_behavior) = OUTPUT_ONLY]; // Call reporting setting for a customer. Only mutable in an `update` // operation. CallReportingSetting call_reporting_setting = 10; // Output only. Conversion tracking setting for a customer. ConversionTrackingSetting conversion_tracking_setting = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Remarketing setting for a customer. RemarketingSetting remarketing_setting = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Reasons why the customer is not eligible to use // PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. // This field is read-only. - repeated google.ads.googleads.v13.enums + repeated google.ads.googleads.v14.enums .CustomerPayPerConversionEligibilityFailureReasonEnum .CustomerPayPerConversionEligibilityFailureReason pay_per_conversion_eligibility_failure_reasons = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Optimization score of the customer. // // Optimization score is an estimate of how well a customer's campaigns are // set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null // for all manager customers, and for unscored non-manager customers. // // See "About optimization score" at // https://support.google.com/google-ads/answer/9061546. // // This field is read-only. optional double optimization_score = 29 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Optimization score weight of the customer. // // Optimization score weight can be used to compare/aggregate optimization // scores across multiple non-manager customers. The aggregate optimization // score of a manager is computed as the sum over all of their customers of // `Customer.optimization_score * Customer.optimization_score_weight`. This // field is 0 for all manager customers, and for unscored non-manager // customers. // // This field is read-only. double optimization_score_weight = 30 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The status of the customer. - google.ads.googleads.v13.enums.CustomerStatusEnum.CustomerStatus status = 36 + google.ads.googleads.v14.enums.CustomerStatusEnum.CustomerStatus status = 36 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. True if feed based location has been migrated to asset based // location. optional bool location_asset_auto_migration_done = 38 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. True if feed based image has been migrated to asset based // image. optional bool image_asset_auto_migration_done = 39 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Timestamp of migration from feed based location to asset base // location in yyyy-MM-dd HH:mm:ss format. optional string location_asset_auto_migration_done_date_time = 40 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Timestamp of migration from feed based image to asset base // image in yyyy-MM-dd HH:mm:ss format. optional string image_asset_auto_migration_done_date_time = 41 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Offline conversion upload diagnostics. + repeated OfflineConversionClientSummary offline_conversion_client_summaries = + 43 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Call reporting setting for a customer. Only mutable in an `update` operation. message CallReportingSetting { // Enable reporting of phone call events by redirecting them through Google // System. optional bool call_reporting_enabled = 10; // Whether to enable call conversion reporting. optional bool call_conversion_reporting_enabled = 11; // Customer-level call conversion action to attribute a call conversion to. // If not set a default conversion action is used. Only in effect when // call_conversion_reporting_enabled is set to true. optional string call_conversion_action = 12 [(google.api.resource_reference) = { type: "googleads.googleapis.com/ConversionAction" }]; } // A collection of customer-wide settings related to Google Ads Conversion // Tracking. message ConversionTrackingSetting { // Output only. The conversion tracking id used for this account. This id // doesn't indicate whether the customer uses conversion tracking // (conversion_tracking_status does). This field is read-only. optional int64 conversion_tracking_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The conversion tracking id of the customer's manager. This is // set when the customer is opted into cross account conversion tracking, and // it overrides conversion_tracking_id. This field can only be managed through // the Google Ads UI. This field is read-only. optional int64 cross_account_conversion_tracking_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Whether the customer has accepted customer data terms. If // using cross-account conversion tracking, this value is inherited from the // manager. This field is read-only. For more // information, see https://support.google.com/adspolicy/answer/7475709. bool accepted_customer_data_terms = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Conversion tracking status. It indicates whether the customer // is using conversion tracking, and who is the conversion tracking owner of // this customer. If this customer is using cross-account conversion tracking, // the value returned will differ based on the `login-customer-id` of the // request. - google.ads.googleads.v13.enums.ConversionTrackingStatusEnum + google.ads.googleads.v14.enums.ConversionTrackingStatusEnum .ConversionTrackingStatus conversion_tracking_status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Whether the customer is opted-in for enhanced conversions // for leads. If using cross-account conversion tracking, this value is // inherited from the manager. This field is read-only. bool enhanced_conversions_for_leads_enabled = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The resource name of the customer where conversions are // created and managed. This field is read-only. string google_ads_conversion_customer = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Remarketing setting for a customer. message RemarketingSetting { // Output only. The Google tag. optional string google_global_site_tag = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } + +// Offline conversion upload diagnostic summarized by client. This proto +// contains general information, breakdown by date/job and alerts for offline +// conversion upload results. +// Next tag: 10 +message OfflineConversionClientSummary { + // Output only. Client type of the upload event. + google.ads.googleads.v14.enums.OfflineEventUploadClientEnum + .OfflineEventUploadClient client = 1 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Overall status for offline conversion client summary. Status + // is generated from most recent calendar day with upload stats. + google.ads.googleads.v14.enums.OfflineConversionDiagnosticStatusEnum + .OfflineConversionDiagnosticStatus status = 2 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Total count of uploaded events. + int64 total_event_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Total count of successful uploaded events. + int64 successful_event_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Successful rate. + double success_rate = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Date for the latest upload batch. + string last_upload_date_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Summary of history stats by last N days. + repeated OfflineConversionUploadSummary daily_summaries = 7 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Summary of history stats by last N jobs. + repeated OfflineConversionUploadSummary job_summaries = 8 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Details for each error code. Alerts are generated from most + // recent calendar day with upload stats. + repeated OfflineConversionUploadAlert alerts = 9 + [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Historical upload summary, grouped by upload date or job. +// Next tag: 5 +message OfflineConversionUploadSummary { + // Output only. Total count of successful event. + int64 successful_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Total count of failed event. + int64 failed_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Dimension key for summary. + oneof dimension_key { + // Output only. Dimension key for last N jobs. + int64 job_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Dimension key for last N days. + string upload_date = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} + +// Alert for offline conversion client summary. +// Next tag: 3 +message OfflineConversionUploadAlert { + // Output only. Error for offline conversion client alert. + OfflineConversionUploadError error = 1 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Percentage of the error. + double error_percentage = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Possible errors for offline conversion client summary. +// Next tag: 11 +message OfflineConversionUploadError { + // Error with description. + oneof error_code { + // Output only. Collection size error. + google.ads.googleads.v14.errors.CollectionSizeErrorEnum.CollectionSizeError + collection_size_error = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Conversion adjustment upload error. + google.ads.googleads.v14.errors.ConversionAdjustmentUploadErrorEnum + .ConversionAdjustmentUploadError conversion_adjustment_upload_error = 2 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Conversion upload error. + google.ads.googleads.v14.errors.ConversionUploadErrorEnum + .ConversionUploadError conversion_upload_error = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Date error. + google.ads.googleads.v14.errors.DateErrorEnum.DateError date_error = 4 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Distinct error. + google.ads.googleads.v14.errors.DistinctErrorEnum.DistinctError + distinct_error = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Field error. + google.ads.googleads.v14.errors.FieldErrorEnum.FieldError field_error = 6 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Mutate error. + google.ads.googleads.v14.errors.MutateErrorEnum.MutateError mutate_error = 7 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Not allowlisted error. + google.ads.googleads.v14.errors.NotAllowlistedErrorEnum.NotAllowlistedError + not_allowlisted_error = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. String format error. + google.ads.googleads.v14.errors.StringFormatErrorEnum.StringFormatError + string_format_error = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. String length error. + google.ads.googleads.v14.errors.StringLengthErrorEnum.StringLengthError + string_length_error = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +}
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2023-06-07 (UTC) को अपडेट किया गया.
[]
[]