--- v9/services/campaign_bid_modifier_service.proto 2021-11-03 19:10:26.000000000 +0000 +++ v10/services/campaign_bid_modifier_service.proto 2022-02-09 20:02:43.000000000 +0000 @@ -1,174 +1,151 @@ -// Copyright 2021 Google LLC +// Copyright 2022 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.v9.services; +package google.ads.googleads.v10.services; -import "google/ads/googleads/v9/enums/response_content_type.proto"; -import "google/ads/googleads/v9/resources/campaign_bid_modifier.proto"; +import "google/ads/googleads/v10/enums/response_content_type.proto"; +import "google/ads/googleads/v10/resources/campaign_bid_modifier.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -option csharp_namespace = "Google.Ads.GoogleAds.V9.Services"; -option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v9/services;services"; +option csharp_namespace = "Google.Ads.GoogleAds.V10.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v10/services;services"; option java_multiple_files = true; option java_outer_classname = "CampaignBidModifierServiceProto"; -option java_package = "com.google.ads.googleads.v9.services"; +option java_package = "com.google.ads.googleads.v10.services"; option objc_class_prefix = "GAA"; -option php_namespace = "Google\\Ads\\GoogleAds\\V9\\Services"; -option ruby_package = "Google::Ads::GoogleAds::V9::Services"; +option php_namespace = "Google\\Ads\\GoogleAds\\V10\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V10::Services"; // Proto file describing the Campaign Bid Modifier service. // Service to manage campaign bid modifiers. service CampaignBidModifierService { option (google.api.default_host) = "googleads.googleapis.com"; option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/adwords"; - // Returns the requested campaign bid modifier in full detail. - // - // List of thrown errors: - // [AuthenticationError]() - // [AuthorizationError]() - // [HeaderError]() - // [InternalError]() - // [QuotaError]() - // [RequestError]() - rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) returns (google.ads.googleads.v9.resources.CampaignBidModifier) { - option (google.api.http) = { - get: "/v9/{resource_name=customers/*/campaignBidModifiers/*}" - }; - option (google.api.method_signature) = "resource_name"; - } - // Creates, updates, or removes campaign bid modifiers. // Operation statuses are returned. // // List of thrown errors: // [AuthenticationError]() // [AuthorizationError]() // [ContextError]() // [CriterionError]() // [DatabaseError]() // [DateError]() // [DistinctError]() // [FieldError]() // [HeaderError]() // [IdError]() // [InternalError]() // [MutateError]() // [NewResourceCreationError]() // [NotEmptyError]() // [NullError]() // [OperatorError]() // [QuotaError]() // [RangeError]() // [RequestError]() // [SizeLimitError]() // [StringFormatError]() // [StringLengthError]() rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) returns (MutateCampaignBidModifiersResponse) { option (google.api.http) = { - post: "/v9/customers/{customer_id=*}/campaignBidModifiers:mutate" + post: "/v10/customers/{customer_id=*}/campaignBidModifiers:mutate" body: "*" }; option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v9.services.CampaignBidModifierService.GetCampaignBidModifier]. -message GetCampaignBidModifierRequest { - // Required. The resource name of the campaign bid modifier to fetch. - string resource_name = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "googleads.googleapis.com/CampaignBidModifier" - } - ]; -} - // Request message for -// [CampaignBidModifierService.MutateCampaignBidModifiers][google.ads.googleads.v9.services.CampaignBidModifierService.MutateCampaignBidModifiers]. +// [CampaignBidModifierService.MutateCampaignBidModifiers][google.ads.googleads.v10.services.CampaignBidModifierService.MutateCampaignBidModifiers]. message MutateCampaignBidModifiersRequest { // Required. ID of the customer whose campaign bid modifiers are being modified. string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The list of operations to perform on individual campaign bid modifiers. repeated CampaignBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried // out in one transaction if and only if they are all valid. // Default is false. bool partial_failure = 3; // If true, the request is validated but not executed. Only errors are // returned, not results. bool validate_only = 4; // The response content type setting. Determines whether the mutable resource // or just the resource name should be returned post mutation. - google.ads.googleads.v9.enums.ResponseContentTypeEnum.ResponseContentType response_content_type = 5; + google.ads.googleads.v10.enums.ResponseContentTypeEnum.ResponseContentType response_content_type = 5; } // A single operation (create, remove, update) on a campaign bid modifier. message CampaignBidModifierOperation { // FieldMask that determines which resource fields are modified in an update. google.protobuf.FieldMask update_mask = 4; // The mutate operation. oneof operation { // Create operation: No resource name is expected for the new campaign bid // modifier. - google.ads.googleads.v9.resources.CampaignBidModifier create = 1; + google.ads.googleads.v10.resources.CampaignBidModifier create = 1; // Update operation: The campaign bid modifier is expected to have a valid // resource name. - google.ads.googleads.v9.resources.CampaignBidModifier update = 2; + google.ads.googleads.v10.resources.CampaignBidModifier update = 2; // Remove operation: A resource name for the removed campaign bid modifier // is expected, in this format: // // `customers/{customer_id}/CampaignBidModifiers/{campaign_id}~{criterion_id}` - string remove = 3; + string remove = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + }]; } } // Response message for campaign bid modifiers mutate. message MutateCampaignBidModifiersResponse { // Errors that pertain to operation failures in the partial failure mode. // Returned only when partial_failure = true and all errors occur inside the // operations. If any errors occur outside the operations (e.g. auth errors), // we return an RPC level error. google.rpc.Status partial_failure_error = 3; // All results for the mutate. repeated MutateCampaignBidModifierResult results = 2; } // The result for the criterion mutate. message MutateCampaignBidModifierResult { // Returned for successful operations. - string resource_name = 1; + string resource_name = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + }]; // The mutated campaign bid modifier with only mutable fields after mutate. // The field will only be returned when response_content_type is set to // "MUTABLE_RESOURCE". - google.ads.googleads.v9.resources.CampaignBidModifier campaign_bid_modifier = 2; + google.ads.googleads.v10.resources.CampaignBidModifier campaign_bid_modifier = 2; }
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-06-07 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]