campaign_budget.proto 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. // Copyright 2022 Google LLC
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. syntax = "proto3";
  15. package google.ads.searchads360.v0.resources;
  16. import "google/ads/searchads360/v0/enums/budget_delivery_method.proto";
  17. import "google/ads/searchads360/v0/enums/budget_period.proto";
  18. import "google/api/field_behavior.proto";
  19. import "google/api/resource.proto";
  20. option csharp_namespace = "Google.Ads.SearchAds360.V0.Resources";
  21. option go_package = "google.golang.org/genproto/googleapis/ads/searchads360/v0/resources;resources";
  22. option java_multiple_files = true;
  23. option java_outer_classname = "CampaignBudgetProto";
  24. option java_package = "com.google.ads.searchads360.v0.resources";
  25. option objc_class_prefix = "GASA360";
  26. option php_namespace = "Google\\Ads\\SearchAds360\\V0\\Resources";
  27. option ruby_package = "Google::Ads::SearchAds360::V0::Resources";
  28. // Proto file describing the Budget resource.
  29. // A campaign budget.
  30. message CampaignBudget {
  31. option (google.api.resource) = {
  32. type: "searchads360.googleapis.com/CampaignBudget"
  33. pattern: "customers/{customer_id}/campaignBudgets/{budget_id}"
  34. };
  35. // Immutable. The resource name of the campaign budget.
  36. // Campaign budget resource names have the form:
  37. //
  38. // `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
  39. string resource_name = 1 [
  40. (google.api.field_behavior) = IMMUTABLE,
  41. (google.api.resource_reference) = {
  42. type: "searchads360.googleapis.com/CampaignBudget"
  43. }
  44. ];
  45. // The amount of the budget, in the local currency for the account.
  46. // Amount is specified in micros, where one million is equivalent to one
  47. // currency unit. Monthly spend is capped at 30.4 times this amount.
  48. optional int64 amount_micros = 21;
  49. // The delivery method that determines the rate at which the campaign budget
  50. // is spent.
  51. //
  52. // Defaults to STANDARD if unspecified in a create operation.
  53. google.ads.searchads360.v0.enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod delivery_method = 7;
  54. // Immutable. Period over which to spend the budget. Defaults to DAILY if not specified.
  55. google.ads.searchads360.v0.enums.BudgetPeriodEnum.BudgetPeriod period = 13 [(google.api.field_behavior) = IMMUTABLE];
  56. }