suguo
/
googleapis
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Synchronize new proto/yaml changes. 

PiperOrigin-RevId: 249721027
This commit is contained in:
Google APIs 2019-05-23 14:55:16 -07:00 committed by Copybara-Service
parent 326272b3b6
commit 2e95f389af
98 changed files with 692 additions and 345 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
google/ads/googleads/v1/services/account_budget_proposal_service.proto
View File

@ -47,7 +47,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// The REMOVE operation cancels a pending proposal.
service AccountBudgetProposalService {
// Returns an account-level budget proposal in full detail.
rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest) returns (google.ads.googleads.v1.resources.AccountBudgetProposal) {
rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest)
returns (google.ads.googleads.v1.resources.AccountBudgetProposal) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/accountBudgetProposals/*}"
};
@ -55,7 +56,8 @@ service AccountBudgetProposalService {
// Creates, updates, or removes account budget proposals. Operation statuses
// are returned.
rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest) returns (MutateAccountBudgetProposalResponse) {
rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest)
returns (MutateAccountBudgetProposalResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/accountBudgetProposals:mutate"
body: "*"

3
google/ads/googleads/v1/services/account_budget_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Account-level budgets are mutated by creating proposal resources.
service AccountBudgetService {
// Returns an account-level budget in full detail.
rpc GetAccountBudget(GetAccountBudgetRequest) returns (google.ads.googleads.v1.resources.AccountBudget) {
rpc GetAccountBudget(GetAccountBudgetRequest)
returns (google.ads.googleads.v1.resources.AccountBudget) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/accountBudgets/*}"
};

12
google/ads/googleads/v1/services/ad_group_ad_label_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels on ad group ads.
service AdGroupAdLabelService {
// Returns the requested ad group ad label in full detail.
rpc GetAdGroupAdLabel(GetAdGroupAdLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupAdLabel) {
rpc GetAdGroupAdLabel(GetAdGroupAdLabelRequest)
returns (google.ads.googleads.v1.resources.AdGroupAdLabel) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupAdLabels/*}"
};
@ -44,7 +45,8 @@ service AdGroupAdLabelService {
// Creates and removes ad group ad labels.
// Operation statuses are returned.
rpc MutateAdGroupAdLabels(MutateAdGroupAdLabelsRequest) returns (MutateAdGroupAdLabelsResponse) {
rpc MutateAdGroupAdLabels(MutateAdGroupAdLabelsRequest)
returns (MutateAdGroupAdLabelsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupAdLabels:mutate"
body: "*"
@ -52,13 +54,15 @@ service AdGroupAdLabelService {
}
}
// Request message for [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v1.services.AdGroupAdLabelService.GetAdGroupAdLabel].
// Request message for
// [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v1.services.AdGroupAdLabelService.GetAdGroupAdLabel].
message GetAdGroupAdLabelRequest {
// The resource name of the ad group ad label to fetch.
string resource_name = 1;
}
// Request message for [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v1.services.AdGroupAdLabelService.MutateAdGroupAdLabels].
// Request message for
// [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v1.services.AdGroupAdLabelService.MutateAdGroupAdLabels].
message MutateAdGroupAdLabelsRequest {
// ID of the customer whose ad group ad labels are being modified.
string customer_id = 1;

15
google/ads/googleads/v1/services/ad_group_ad_service.proto
View File

@ -38,14 +38,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ads in an ad group.
service AdGroupAdService {
// Returns the requested ad in full detail.
rpc GetAdGroupAd(GetAdGroupAdRequest) returns (google.ads.googleads.v1.resources.AdGroupAd) {
rpc GetAdGroupAd(GetAdGroupAdRequest)
returns (google.ads.googleads.v1.resources.AdGroupAd) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupAds/*}"
};
}
// Creates, updates, or removes ads. Operation statuses are returned.
rpc MutateAdGroupAds(MutateAdGroupAdsRequest) returns (MutateAdGroupAdsResponse) {
rpc MutateAdGroupAds(MutateAdGroupAdsRequest)
returns (MutateAdGroupAdsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupAds:mutate"
body: "*"
@ -53,13 +55,15 @@ service AdGroupAdService {
}
}
// Request message for [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v1.services.AdGroupAdService.GetAdGroupAd].
// Request message for
// [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v1.services.AdGroupAdService.GetAdGroupAd].
message GetAdGroupAdRequest {
// The resource name of the ad to fetch.
string resource_name = 1;
}
// Request message for [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v1.services.AdGroupAdService.MutateAdGroupAds].
// Request message for
// [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v1.services.AdGroupAdService.MutateAdGroupAds].
message MutateAdGroupAdsRequest {
// The ID of the customer whose ads are being modified.
string customer_id = 1;
@ -84,7 +88,8 @@ message AdGroupAdOperation {
google.protobuf.FieldMask update_mask = 4;
// Configuration for how policies are validated.
google.ads.googleads.v1.common.PolicyValidationParameter policy_validation_parameter = 5;
google.ads.googleads.v1.common.PolicyValidationParameter
policy_validation_parameter = 5;
// The mutate operation.
oneof operation {

3
google/ads/googleads/v1/services/ad_group_audience_view_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad group audience views.
service AdGroupAudienceViewService {
// Returns the requested ad group audience view in full detail.
rpc GetAdGroupAudienceView(GetAdGroupAudienceViewRequest) returns (google.ads.googleads.v1.resources.AdGroupAudienceView) {
rpc GetAdGroupAudienceView(GetAdGroupAudienceViewRequest)
returns (google.ads.googleads.v1.resources.AdGroupAudienceView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupAudienceViews/*}"
};

12
google/ads/googleads/v1/services/ad_group_bid_modifier_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad group bid modifiers.
service AdGroupBidModifierService {
// Returns the requested ad group bid modifier in full detail.
rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest) returns (google.ads.googleads.v1.resources.AdGroupBidModifier) {
rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest)
returns (google.ads.googleads.v1.resources.AdGroupBidModifier) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupBidModifiers/*}"
};
@ -45,7 +46,8 @@ service AdGroupBidModifierService {
// Creates, updates, or removes ad group bid modifiers.
// Operation statuses are returned.
rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest) returns (MutateAdGroupBidModifiersResponse) {
rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest)
returns (MutateAdGroupBidModifiersResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupBidModifiers:mutate"
body: "*"
@ -53,13 +55,15 @@ service AdGroupBidModifierService {
}
}
// Request message for [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v1.services.AdGroupBidModifierService.GetAdGroupBidModifier].
// Request message for
// [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v1.services.AdGroupBidModifierService.GetAdGroupBidModifier].
message GetAdGroupBidModifierRequest {
// The resource name of the ad group bid modifier to fetch.
string resource_name = 1;
}
// Request message for [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v1.services.AdGroupBidModifierService.MutateAdGroupBidModifiers].
// Request message for
// [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v1.services.AdGroupBidModifierService.MutateAdGroupBidModifiers].
message MutateAdGroupBidModifiersRequest {
// ID of the customer whose ad group bid modifiers are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/ad_group_criterion_label_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels on ad group criteria.
service AdGroupCriterionLabelService {
// Returns the requested ad group criterion label in full detail.
rpc GetAdGroupCriterionLabel(GetAdGroupCriterionLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterionLabel) {
rpc GetAdGroupCriterionLabel(GetAdGroupCriterionLabelRequest)
returns (google.ads.googleads.v1.resources.AdGroupCriterionLabel) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupCriterionLabels/*}"
};
@ -44,7 +45,8 @@ service AdGroupCriterionLabelService {
// Creates and removes ad group criterion labels.
// Operation statuses are returned.
rpc MutateAdGroupCriterionLabels(MutateAdGroupCriterionLabelsRequest) returns (MutateAdGroupCriterionLabelsResponse) {
rpc MutateAdGroupCriterionLabels(MutateAdGroupCriterionLabelsRequest)
returns (MutateAdGroupCriterionLabelsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupCriterionLabels:mutate"
body: "*"

15
google/ads/googleads/v1/services/ad_group_criterion_service.proto
View File

@ -38,14 +38,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad group criteria.
service AdGroupCriterionService {
// Returns the requested criterion in full detail.
rpc GetAdGroupCriterion(GetAdGroupCriterionRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterion) {
rpc GetAdGroupCriterion(GetAdGroupCriterionRequest)
returns (google.ads.googleads.v1.resources.AdGroupCriterion) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupCriteria/*}"
};
}
// Creates, updates, or removes criteria. Operation statuses are returned.
rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest) returns (MutateAdGroupCriteriaResponse) {
rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest)
returns (MutateAdGroupCriteriaResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupCriteria:mutate"
body: "*"
@ -53,13 +55,15 @@ service AdGroupCriterionService {
}
}
// Request message for [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v1.services.AdGroupCriterionService.GetAdGroupCriterion].
// Request message for
// [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v1.services.AdGroupCriterionService.GetAdGroupCriterion].
message GetAdGroupCriterionRequest {
// The resource name of the criterion to fetch.
string resource_name = 1;
}
// Request message for [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v1.services.AdGroupCriterionService.MutateAdGroupCriteria].
// Request message for
// [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v1.services.AdGroupCriterionService.MutateAdGroupCriteria].
message MutateAdGroupCriteriaRequest {
// ID of the customer whose criteria are being modified.
string customer_id = 1;
@ -92,7 +96,8 @@ message AdGroupCriterionOperation {
// to serve. They may begin serving at a later time due to a change in
// policies, re-review of the resource, or a change in advertiser
// certificates.
repeated google.ads.googleads.v1.common.PolicyViolationKey exempt_policy_violation_keys = 5;
repeated google.ads.googleads.v1.common.PolicyViolationKey
exempt_policy_violation_keys = 5;
// The mutate operation.
oneof operation {

3
google/ads/googleads/v1/services/ad_group_criterion_simulation_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch ad group criterion simulations.
service AdGroupCriterionSimulationService {
// Returns the requested ad group criterion simulation in full detail.
rpc GetAdGroupCriterionSimulation(GetAdGroupCriterionSimulationRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterionSimulation) {
rpc GetAdGroupCriterionSimulation(GetAdGroupCriterionSimulationRequest)
returns (google.ads.googleads.v1.resources.AdGroupCriterionSimulation) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupCriterionSimulations/*}"
};

6
google/ads/googleads/v1/services/ad_group_extension_setting_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad group extension settings.
service AdGroupExtensionSettingService {
// Returns the requested ad group extension setting in full detail.
rpc GetAdGroupExtensionSetting(GetAdGroupExtensionSettingRequest) returns (google.ads.googleads.v1.resources.AdGroupExtensionSetting) {
rpc GetAdGroupExtensionSetting(GetAdGroupExtensionSettingRequest)
returns (google.ads.googleads.v1.resources.AdGroupExtensionSetting) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupExtensionSettings/*}"
};
@ -45,7 +46,8 @@ service AdGroupExtensionSettingService {
// Creates, updates, or removes ad group extension settings. Operation
// statuses are returned.
rpc MutateAdGroupExtensionSettings(MutateAdGroupExtensionSettingsRequest) returns (MutateAdGroupExtensionSettingsResponse) {
rpc MutateAdGroupExtensionSettings(MutateAdGroupExtensionSettingsRequest)
returns (MutateAdGroupExtensionSettingsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupExtensionSettings:mutate"
body: "*"

12
google/ads/googleads/v1/services/ad_group_feed_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad group feeds.
service AdGroupFeedService {
// Returns the requested ad group feed in full detail.
rpc GetAdGroupFeed(GetAdGroupFeedRequest) returns (google.ads.googleads.v1.resources.AdGroupFeed) {
rpc GetAdGroupFeed(GetAdGroupFeedRequest)
returns (google.ads.googleads.v1.resources.AdGroupFeed) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupFeeds/*}"
};
@ -45,7 +46,8 @@ service AdGroupFeedService {
// Creates, updates, or removes ad group feeds. Operation statuses are
// returned.
rpc MutateAdGroupFeeds(MutateAdGroupFeedsRequest) returns (MutateAdGroupFeedsResponse) {
rpc MutateAdGroupFeeds(MutateAdGroupFeedsRequest)
returns (MutateAdGroupFeedsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupFeeds:mutate"
body: "*"
@ -53,13 +55,15 @@ service AdGroupFeedService {
}
}
// Request message for [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v1.services.AdGroupFeedService.GetAdGroupFeed].
// Request message for
// [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v1.services.AdGroupFeedService.GetAdGroupFeed].
message GetAdGroupFeedRequest {
// The resource name of the ad group feed to fetch.
string resource_name = 1;
}
// Request message for [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v1.services.AdGroupFeedService.MutateAdGroupFeeds].
// Request message for
// [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v1.services.AdGroupFeedService.MutateAdGroupFeeds].
message MutateAdGroupFeedsRequest {
// The ID of the customer whose ad group feeds are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/ad_group_label_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels on ad groups.
service AdGroupLabelService {
// Returns the requested ad group label in full detail.
rpc GetAdGroupLabel(GetAdGroupLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupLabel) {
rpc GetAdGroupLabel(GetAdGroupLabelRequest)
returns (google.ads.googleads.v1.resources.AdGroupLabel) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupLabels/*}"
};
@ -44,7 +45,8 @@ service AdGroupLabelService {
// Creates and removes ad group labels.
// Operation statuses are returned.
rpc MutateAdGroupLabels(MutateAdGroupLabelsRequest) returns (MutateAdGroupLabelsResponse) {
rpc MutateAdGroupLabels(MutateAdGroupLabelsRequest)
returns (MutateAdGroupLabelsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adGroupLabels:mutate"
body: "*"
@ -52,13 +54,15 @@ service AdGroupLabelService {
}
}
// Request message for [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v1.services.AdGroupLabelService.GetAdGroupLabel].
// Request message for
// [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v1.services.AdGroupLabelService.GetAdGroupLabel].
message GetAdGroupLabelRequest {
// The resource name of the ad group label to fetch.
string resource_name = 1;
}
// Request message for [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v1.services.AdGroupLabelService.MutateAdGroupLabels].
// Request message for
// [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v1.services.AdGroupLabelService.MutateAdGroupLabels].
message MutateAdGroupLabelsRequest {
// ID of the customer whose ad group labels are being modified.
string customer_id = 1;

9
google/ads/googleads/v1/services/ad_group_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad groups.
service AdGroupService {
// Returns the requested ad group in full detail.
rpc GetAdGroup(GetAdGroupRequest) returns (google.ads.googleads.v1.resources.AdGroup) {
rpc GetAdGroup(GetAdGroupRequest)
returns (google.ads.googleads.v1.resources.AdGroup) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroups/*}"
};
@ -52,13 +53,15 @@ service AdGroupService {
}
}
// Request message for [AdGroupService.GetAdGroup][google.ads.googleads.v1.services.AdGroupService.GetAdGroup].
// Request message for
// [AdGroupService.GetAdGroup][google.ads.googleads.v1.services.AdGroupService.GetAdGroup].
message GetAdGroupRequest {
// The resource name of the ad group to fetch.
string resource_name = 1;
}
// Request message for [AdGroupService.MutateAdGroups][google.ads.googleads.v1.services.AdGroupService.MutateAdGroups].
// Request message for
// [AdGroupService.MutateAdGroups][google.ads.googleads.v1.services.AdGroupService.MutateAdGroups].
message MutateAdGroupsRequest {
// The ID of the customer whose ad groups are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/ad_group_simulation_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch ad group simulations.
service AdGroupSimulationService {
// Returns the requested ad group simulation in full detail.
rpc GetAdGroupSimulation(GetAdGroupSimulationRequest) returns (google.ads.googleads.v1.resources.AdGroupSimulation) {
rpc GetAdGroupSimulation(GetAdGroupSimulationRequest)
returns (google.ads.googleads.v1.resources.AdGroupSimulation) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adGroupSimulations/*}"
};
}
}
// Request message for [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v1.services.AdGroupSimulationService.GetAdGroupSimulation].
// Request message for
// [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v1.services.AdGroupSimulationService.GetAdGroupSimulation].
message GetAdGroupSimulationRequest {
// The resource name of the ad group simulation to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/ad_parameter_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage ad parameters.
service AdParameterService {
// Returns the requested ad parameter in full detail.
rpc GetAdParameter(GetAdParameterRequest) returns (google.ads.googleads.v1.resources.AdParameter) {
rpc GetAdParameter(GetAdParameterRequest)
returns (google.ads.googleads.v1.resources.AdParameter) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adParameters/*}"
};
@ -45,7 +46,8 @@ service AdParameterService {
// Creates, updates, or removes ad parameters. Operation statuses are
// returned.
rpc MutateAdParameters(MutateAdParametersRequest) returns (MutateAdParametersResponse) {
rpc MutateAdParameters(MutateAdParametersRequest)
returns (MutateAdParametersResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/adParameters:mutate"
body: "*"
@ -53,13 +55,15 @@ service AdParameterService {
}
}
// Request message for [AdParameterService.GetAdParameter][google.ads.googleads.v1.services.AdParameterService.GetAdParameter]
// Request message for
// [AdParameterService.GetAdParameter][google.ads.googleads.v1.services.AdParameterService.GetAdParameter]
message GetAdParameterRequest {
// The resource name of the ad parameter to fetch.
string resource_name = 1;
}
// Request message for [AdParameterService.MutateAdParameters][google.ads.googleads.v1.services.AdParameterService.MutateAdParameters]
// Request message for
// [AdParameterService.MutateAdParameters][google.ads.googleads.v1.services.AdParameterService.MutateAdParameters]
message MutateAdParametersRequest {
// The ID of the customer whose ad parameters are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/ad_schedule_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch ad schedule views.
service AdScheduleViewService {
// Returns the requested ad schedule view in full detail.
rpc GetAdScheduleView(GetAdScheduleViewRequest) returns (google.ads.googleads.v1.resources.AdScheduleView) {
rpc GetAdScheduleView(GetAdScheduleViewRequest)
returns (google.ads.googleads.v1.resources.AdScheduleView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/adScheduleViews/*}"
};
}
}
// Request message for [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v1.services.AdScheduleViewService.GetAdScheduleView].
// Request message for
// [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v1.services.AdScheduleViewService.GetAdScheduleView].
message GetAdScheduleViewRequest {
// The resource name of the ad schedule view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/age_range_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage age range views.
service AgeRangeViewService {
// Returns the requested age range view in full detail.
rpc GetAgeRangeView(GetAgeRangeViewRequest) returns (google.ads.googleads.v1.resources.AgeRangeView) {
rpc GetAgeRangeView(GetAgeRangeViewRequest)
returns (google.ads.googleads.v1.resources.AgeRangeView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/ageRangeViews/*}"
};
}
}
// Request message for [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v1.services.AgeRangeViewService.GetAgeRangeView].
// Request message for
// [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v1.services.AgeRangeViewService.GetAgeRangeView].
message GetAgeRangeViewRequest {
// The resource name of the age range view to fetch.
string resource_name = 1;

9
google/ads/googleads/v1/services/asset_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// created with Ad inline.
service AssetService {
// Returns the requested asset in full detail.
rpc GetAsset(GetAssetRequest) returns (google.ads.googleads.v1.resources.Asset) {
rpc GetAsset(GetAssetRequest)
returns (google.ads.googleads.v1.resources.Asset) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/assets/*}"
};
@ -51,13 +52,15 @@ service AssetService {
}
}
// Request message for [AssetService.GetAsset][google.ads.googleads.v1.services.AssetService.GetAsset]
// Request message for
// [AssetService.GetAsset][google.ads.googleads.v1.services.AssetService.GetAsset]
message GetAssetRequest {
// The resource name of the asset to fetch.
string resource_name = 1;
}
// Request message for [AssetService.MutateAssets][google.ads.googleads.v1.services.AssetService.MutateAssets]
// Request message for
// [AssetService.MutateAssets][google.ads.googleads.v1.services.AssetService.MutateAssets]
message MutateAssetsRequest {
// The ID of the customer whose assets are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/bidding_strategy_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage bidding strategies.
service BiddingStrategyService {
// Returns the requested bidding strategy in full detail.
rpc GetBiddingStrategy(GetBiddingStrategyRequest) returns (google.ads.googleads.v1.resources.BiddingStrategy) {
rpc GetBiddingStrategy(GetBiddingStrategyRequest)
returns (google.ads.googleads.v1.resources.BiddingStrategy) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/biddingStrategies/*}"
};
@ -45,7 +46,8 @@ service BiddingStrategyService {
// Creates, updates, or removes bidding strategies. Operation statuses are
// returned.
rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest) returns (MutateBiddingStrategiesResponse) {
rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest)
returns (MutateBiddingStrategiesResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/biddingStrategies:mutate"
body: "*"
@ -53,13 +55,15 @@ service BiddingStrategyService {
}
}
// Request message for [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v1.services.BiddingStrategyService.GetBiddingStrategy].
// Request message for
// [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v1.services.BiddingStrategyService.GetBiddingStrategy].
message GetBiddingStrategyRequest {
// The resource name of the bidding strategy to fetch.
string resource_name = 1;
}
// Request message for [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v1.services.BiddingStrategyService.MutateBiddingStrategies].
// Request message for
// [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v1.services.BiddingStrategyService.MutateBiddingStrategies].
message MutateBiddingStrategiesRequest {
// The ID of the customer whose bidding strategies are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/billing_setup_service.proto
View File

@ -42,14 +42,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// The CREATE operation creates a new billing setup.
service BillingSetupService {
// Returns a billing setup.
rpc GetBillingSetup(GetBillingSetupRequest) returns (google.ads.googleads.v1.resources.BillingSetup) {
rpc GetBillingSetup(GetBillingSetupRequest)
returns (google.ads.googleads.v1.resources.BillingSetup) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/billingSetups/*}"
};
}
// Creates a billing setup, or cancels an existing billing setup.
rpc MutateBillingSetup(MutateBillingSetupRequest) returns (MutateBillingSetupResponse) {
rpc MutateBillingSetup(MutateBillingSetupRequest)
returns (MutateBillingSetupResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/billingSetups:mutate"
body: "*"

6
google/ads/googleads/v1/services/campaign_audience_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign audience views.
service CampaignAudienceViewService {
// Returns the requested campaign audience view in full detail.
rpc GetCampaignAudienceView(GetCampaignAudienceViewRequest) returns (google.ads.googleads.v1.resources.CampaignAudienceView) {
rpc GetCampaignAudienceView(GetCampaignAudienceViewRequest)
returns (google.ads.googleads.v1.resources.CampaignAudienceView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignAudienceViews/*}"
};
}
}
// Request message for [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v1.services.CampaignAudienceViewService.GetCampaignAudienceView].
// Request message for
// [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v1.services.CampaignAudienceViewService.GetCampaignAudienceView].
message GetCampaignAudienceViewRequest {
// The resource name of the campaign audience view to fetch.
string resource_name = 1;

9
google/ads/googleads/v1/services/campaign_bid_modifier_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign bid modifiers.
service CampaignBidModifierService {
// Returns the requested campaign bid modifier in full detail.
rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) returns (google.ads.googleads.v1.resources.CampaignBidModifier) {
rpc GetCampaignBidModifier(GetCampaignBidModifierRequest)
returns (google.ads.googleads.v1.resources.CampaignBidModifier) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignBidModifiers/*}"
};
@ -45,7 +46,8 @@ service CampaignBidModifierService {
// Creates, updates, or removes campaign bid modifiers.
// Operation statuses are returned.
rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) returns (MutateCampaignBidModifiersResponse) {
rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest)
returns (MutateCampaignBidModifiersResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignBidModifiers:mutate"
body: "*"
@ -53,7 +55,8 @@ service CampaignBidModifierService {
}
}
// Request message for [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v1.services.CampaignBidModifierService.GetCampaignBidModifier].
// Request message for
// [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v1.services.CampaignBidModifierService.GetCampaignBidModifier].
message GetCampaignBidModifierRequest {
// The resource name of the campaign bid modifier to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/campaign_budget_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign budgets.
service CampaignBudgetService {
// Returns the requested Campaign Budget in full detail.
rpc GetCampaignBudget(GetCampaignBudgetRequest) returns (google.ads.googleads.v1.resources.CampaignBudget) {
rpc GetCampaignBudget(GetCampaignBudgetRequest)
returns (google.ads.googleads.v1.resources.CampaignBudget) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignBudgets/*}"
};
@ -45,7 +46,8 @@ service CampaignBudgetService {
// Creates, updates, or removes campaign budgets. Operation statuses are
// returned.
rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest) returns (MutateCampaignBudgetsResponse) {
rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest)
returns (MutateCampaignBudgetsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignBudgets:mutate"
body: "*"
@ -53,13 +55,15 @@ service CampaignBudgetService {
}
}
// Request message for [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v1.services.CampaignBudgetService.GetCampaignBudget].
// Request message for
// [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v1.services.CampaignBudgetService.GetCampaignBudget].
message GetCampaignBudgetRequest {
// The resource name of the campaign budget to fetch.
string resource_name = 1;
}
// Request message for [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v1.services.CampaignBudgetService.MutateCampaignBudgets].
// Request message for
// [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v1.services.CampaignBudgetService.MutateCampaignBudgets].
message MutateCampaignBudgetsRequest {
// The ID of the customer whose campaign budgets are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/campaign_criterion_service.proto
View File

@ -37,14 +37,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign criteria.
service CampaignCriterionService {
// Returns the requested criterion in full detail.
rpc GetCampaignCriterion(GetCampaignCriterionRequest) returns (google.ads.googleads.v1.resources.CampaignCriterion) {
rpc GetCampaignCriterion(GetCampaignCriterionRequest)
returns (google.ads.googleads.v1.resources.CampaignCriterion) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignCriteria/*}"
};
}
// Creates, updates, or removes criteria. Operation statuses are returned.
rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest) returns (MutateCampaignCriteriaResponse) {
rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest)
returns (MutateCampaignCriteriaResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignCriteria:mutate"
body: "*"
@ -52,13 +54,15 @@ service CampaignCriterionService {
}
}
// Request message for [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v1.services.CampaignCriterionService.GetCampaignCriterion].
// Request message for
// [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v1.services.CampaignCriterionService.GetCampaignCriterion].
message GetCampaignCriterionRequest {
// The resource name of the criterion to fetch.
string resource_name = 1;
}
// Request message for [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v1.services.CampaignCriterionService.MutateCampaignCriteria].
// Request message for
// [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v1.services.CampaignCriterionService.MutateCampaignCriteria].
message MutateCampaignCriteriaRequest {
// The ID of the customer whose criteria are being modified.
string customer_id = 1;

3
google/ads/googleads/v1/services/campaign_criterion_simulation_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch campaign criterion simulations.
service CampaignCriterionSimulationService {
// Returns the requested campaign criterion simulation in full detail.
rpc GetCampaignCriterionSimulation(GetCampaignCriterionSimulationRequest) returns (google.ads.googleads.v1.resources.CampaignCriterionSimulation) {
rpc GetCampaignCriterionSimulation(GetCampaignCriterionSimulationRequest)
returns (google.ads.googleads.v1.resources.CampaignCriterionSimulation) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignCriterionSimulations/*}"
};

6
google/ads/googleads/v1/services/campaign_extension_setting_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign extension settings.
service CampaignExtensionSettingService {
// Returns the requested campaign extension setting in full detail.
rpc GetCampaignExtensionSetting(GetCampaignExtensionSettingRequest) returns (google.ads.googleads.v1.resources.CampaignExtensionSetting) {
rpc GetCampaignExtensionSetting(GetCampaignExtensionSettingRequest)
returns (google.ads.googleads.v1.resources.CampaignExtensionSetting) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignExtensionSettings/*}"
};
@ -45,7 +46,8 @@ service CampaignExtensionSettingService {
// Creates, updates, or removes campaign extension settings. Operation
// statuses are returned.
rpc MutateCampaignExtensionSettings(MutateCampaignExtensionSettingsRequest) returns (MutateCampaignExtensionSettingsResponse) {
rpc MutateCampaignExtensionSettings(MutateCampaignExtensionSettingsRequest)
returns (MutateCampaignExtensionSettingsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignExtensionSettings:mutate"
body: "*"

12
google/ads/googleads/v1/services/campaign_feed_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign feeds.
service CampaignFeedService {
// Returns the requested campaign feed in full detail.
rpc GetCampaignFeed(GetCampaignFeedRequest) returns (google.ads.googleads.v1.resources.CampaignFeed) {
rpc GetCampaignFeed(GetCampaignFeedRequest)
returns (google.ads.googleads.v1.resources.CampaignFeed) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignFeeds/*}"
};
@ -45,7 +46,8 @@ service CampaignFeedService {
// Creates, updates, or removes campaign feeds. Operation statuses are
// returned.
rpc MutateCampaignFeeds(MutateCampaignFeedsRequest) returns (MutateCampaignFeedsResponse) {
rpc MutateCampaignFeeds(MutateCampaignFeedsRequest)
returns (MutateCampaignFeedsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignFeeds:mutate"
body: "*"
@ -53,13 +55,15 @@ service CampaignFeedService {
}
}
// Request message for [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v1.services.CampaignFeedService.GetCampaignFeed].
// Request message for
// [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v1.services.CampaignFeedService.GetCampaignFeed].
message GetCampaignFeedRequest {
// The resource name of the campaign feed to fetch.
string resource_name = 1;
}
// Request message for [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v1.services.CampaignFeedService.MutateCampaignFeeds].
// Request message for
// [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v1.services.CampaignFeedService.MutateCampaignFeeds].
message MutateCampaignFeedsRequest {
// The ID of the customer whose campaign feeds are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/campaign_label_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels on campaigns.
service CampaignLabelService {
// Returns the requested campaign-label relationship in full detail.
rpc GetCampaignLabel(GetCampaignLabelRequest) returns (google.ads.googleads.v1.resources.CampaignLabel) {
rpc GetCampaignLabel(GetCampaignLabelRequest)
returns (google.ads.googleads.v1.resources.CampaignLabel) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignLabels/*}"
};
@ -44,7 +45,8 @@ service CampaignLabelService {
// Creates and removes campaign-label relationships.
// Operation statuses are returned.
rpc MutateCampaignLabels(MutateCampaignLabelsRequest) returns (MutateCampaignLabelsResponse) {
rpc MutateCampaignLabels(MutateCampaignLabelsRequest)
returns (MutateCampaignLabelsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignLabels:mutate"
body: "*"
@ -52,13 +54,15 @@ service CampaignLabelService {
}
}
// Request message for [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v1.services.CampaignLabelService.GetCampaignLabel].
// Request message for
// [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v1.services.CampaignLabelService.GetCampaignLabel].
message GetCampaignLabelRequest {
// The resource name of the campaign-label relationship to fetch.
string resource_name = 1;
}
// Request message for [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v1.services.CampaignLabelService.MutateCampaignLabels].
// Request message for
// [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v1.services.CampaignLabelService.MutateCampaignLabels].
message MutateCampaignLabelsRequest {
// ID of the customer whose campaign-label relationships are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/campaign_service.proto
View File

@ -37,14 +37,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaigns.
service CampaignService {
// Returns the requested campaign in full detail.
rpc GetCampaign(GetCampaignRequest) returns (google.ads.googleads.v1.resources.Campaign) {
rpc GetCampaign(GetCampaignRequest)
returns (google.ads.googleads.v1.resources.Campaign) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaigns/*}"
};
}
// Creates, updates, or removes campaigns. Operation statuses are returned.
rpc MutateCampaigns(MutateCampaignsRequest) returns (MutateCampaignsResponse) {
rpc MutateCampaigns(MutateCampaignsRequest)
returns (MutateCampaignsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaigns:mutate"
body: "*"
@ -52,13 +54,15 @@ service CampaignService {
}
}
// Request message for [CampaignService.GetCampaign][google.ads.googleads.v1.services.CampaignService.GetCampaign].
// Request message for
// [CampaignService.GetCampaign][google.ads.googleads.v1.services.CampaignService.GetCampaign].
message GetCampaignRequest {
// The resource name of the campaign to fetch.
string resource_name = 1;
}
// Request message for [CampaignService.MutateCampaigns][google.ads.googleads.v1.services.CampaignService.MutateCampaigns].
// Request message for
// [CampaignService.MutateCampaigns][google.ads.googleads.v1.services.CampaignService.MutateCampaigns].
message MutateCampaignsRequest {
// The ID of the customer whose campaigns are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/campaign_shared_set_service.proto
View File

@ -36,14 +36,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage campaign shared sets.
service CampaignSharedSetService {
// Returns the requested campaign shared set in full detail.
rpc GetCampaignSharedSet(GetCampaignSharedSetRequest) returns (google.ads.googleads.v1.resources.CampaignSharedSet) {
rpc GetCampaignSharedSet(GetCampaignSharedSetRequest)
returns (google.ads.googleads.v1.resources.CampaignSharedSet) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/campaignSharedSets/*}"
};
}
// Creates or removes campaign shared sets. Operation statuses are returned.
rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest) returns (MutateCampaignSharedSetsResponse) {
rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest)
returns (MutateCampaignSharedSetsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/campaignSharedSets:mutate"
body: "*"
@ -51,13 +53,15 @@ service CampaignSharedSetService {
}
}
// Request message for [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v1.services.CampaignSharedSetService.GetCampaignSharedSet].
// Request message for
// [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v1.services.CampaignSharedSetService.GetCampaignSharedSet].
message GetCampaignSharedSetRequest {
// The resource name of the campaign shared set to fetch.
string resource_name = 1;
}
// Request message for [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v1.services.CampaignSharedSetService.MutateCampaignSharedSets].
// Request message for
// [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v1.services.CampaignSharedSetService.MutateCampaignSharedSets].
message MutateCampaignSharedSetsRequest {
// The ID of the customer whose campaign shared sets are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/carrier_constant_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch carrier constants.
service CarrierConstantService {
// Returns the requested carrier constant in full detail.
rpc GetCarrierConstant(GetCarrierConstantRequest) returns (google.ads.googleads.v1.resources.CarrierConstant) {
rpc GetCarrierConstant(GetCarrierConstantRequest)
returns (google.ads.googleads.v1.resources.CarrierConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=carrierConstants/*}"
};
}
}
// Request message for [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v1.services.CarrierConstantService.GetCarrierConstant].
// Request message for
// [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v1.services.CarrierConstantService.GetCarrierConstant].
message GetCarrierConstantRequest {
// Resource name of the carrier constant to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/change_status_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch change statuses.
service ChangeStatusService {
// Returns the requested change status in full detail.
rpc GetChangeStatus(GetChangeStatusRequest) returns (google.ads.googleads.v1.resources.ChangeStatus) {
rpc GetChangeStatus(GetChangeStatusRequest)
returns (google.ads.googleads.v1.resources.ChangeStatus) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/changeStatus/*}"
};
}
}
// Request message for '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v1.services.ChangeStatusService.GetChangeStatus]'.
// Request message for
// '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v1.services.ChangeStatusService.GetChangeStatus]'.
message GetChangeStatusRequest {
// The resource name of the change status to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/click_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch click views.
service ClickViewService {
// Returns the requested click view in full detail.
rpc GetClickView(GetClickViewRequest) returns (google.ads.googleads.v1.resources.ClickView) {
rpc GetClickView(GetClickViewRequest)
returns (google.ads.googleads.v1.resources.ClickView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/clickViews/*}"
};
}
}
// Request message for [ClickViewService.GetClickView][google.ads.googleads.v1.services.ClickViewService.GetClickView].
// Request message for
// [ClickViewService.GetClickView][google.ads.googleads.v1.services.ClickViewService.GetClickView].
message GetClickViewRequest {
// The resource name of the click view to fetch.
string resource_name = 1;

15
google/ads/googleads/v1/services/conversion_action_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage conversion actions.
service ConversionActionService {
// Returns the requested conversion action.
rpc GetConversionAction(GetConversionActionRequest) returns (google.ads.googleads.v1.resources.ConversionAction) {
rpc GetConversionAction(GetConversionActionRequest)
returns (google.ads.googleads.v1.resources.ConversionAction) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/conversionActions/*}"
};
@ -45,7 +46,8 @@ service ConversionActionService {
// Creates, updates or removes conversion actions. Operation statuses are
// returned.
rpc MutateConversionActions(MutateConversionActionsRequest) returns (MutateConversionActionsResponse) {
rpc MutateConversionActions(MutateConversionActionsRequest)
returns (MutateConversionActionsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/conversionActions:mutate"
body: "*"
@ -53,13 +55,15 @@ service ConversionActionService {
}
}
// Request message for [ConversionActionService.GetConversionAction][google.ads.googleads.v1.services.ConversionActionService.GetConversionAction].
// Request message for
// [ConversionActionService.GetConversionAction][google.ads.googleads.v1.services.ConversionActionService.GetConversionAction].
message GetConversionActionRequest {
// The resource name of the conversion action to fetch.
string resource_name = 1;
}
// Request message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions].
// Request message for
// [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions].
message MutateConversionActionsRequest {
// The ID of the customer whose conversion actions are being modified.
string customer_id = 1;
@ -101,7 +105,8 @@ message ConversionActionOperation {
}
}
// Response message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions].
// Response message for
// [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions].
message MutateConversionActionsResponse {
// Errors that pertain to operation failures in the partial failure mode.
// Returned only when partial_failure = true and all errors occur inside the

9
google/ads/googleads/v1/services/conversion_adjustment_upload_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to upload conversion adjustments.
service ConversionAdjustmentUploadService {
// Processes the given conversion adjustments.
rpc UploadConversionAdjustments(UploadConversionAdjustmentsRequest) returns (UploadConversionAdjustmentsResponse) {
rpc UploadConversionAdjustments(UploadConversionAdjustmentsRequest)
returns (UploadConversionAdjustmentsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}:uploadConversionAdjustments"
body: "*"
@ -91,7 +92,8 @@ message ConversionAdjustment {
google.protobuf.StringValue adjustment_date_time = 4;
// The adjustment type.
google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5;
google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum
.ConversionAdjustmentType adjustment_type = 5;
// Information needed to restate the conversion's value.
// Required for restatements. Should not be supplied for retractions. An error
@ -149,7 +151,8 @@ message ConversionAdjustmentResult {
google.protobuf.StringValue adjustment_date_time = 4;
// The adjustment type.
google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5;
google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum
.ConversionAdjustmentType adjustment_type = 5;
// Identifies the conversion that was adjusted.
oneof conversion_identifier {

18
google/ads/googleads/v1/services/conversion_upload_service.proto
View File

@ -33,7 +33,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to upload conversions.
service ConversionUploadService {
// Processes the given click conversions.
rpc UploadClickConversions(UploadClickConversionsRequest) returns (UploadClickConversionsResponse) {
rpc UploadClickConversions(UploadClickConversionsRequest)
returns (UploadClickConversionsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}:uploadClickConversions"
body: "*"
@ -41,7 +42,8 @@ service ConversionUploadService {
}
// Processes the given call conversions.
rpc UploadCallConversions(UploadCallConversionsRequest) returns (UploadCallConversionsResponse) {
rpc UploadCallConversions(UploadCallConversionsRequest)
returns (UploadCallConversionsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}:uploadCallConversions"
body: "*"
@ -49,7 +51,8 @@ service ConversionUploadService {
}
}
// Request message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions].
// Request message for
// [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions].
message UploadClickConversionsRequest {
// The ID of the customer performing the upload.
string customer_id = 1;
@ -68,7 +71,8 @@ message UploadClickConversionsRequest {
bool validate_only = 4;
}
// Response message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions].
// Response message for
// [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions].
message UploadClickConversionsResponse {
// Errors that pertain to conversion failures in the partial failure mode.
// Returned when all errors occur inside the conversions. If any errors occur
@ -81,7 +85,8 @@ message UploadClickConversionsResponse {
repeated ClickConversionResult results = 2;
}
// Request message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions].
// Request message for
// [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions].
message UploadCallConversionsRequest {
// The ID of the customer performing the upload.
string customer_id = 1;
@ -100,7 +105,8 @@ message UploadCallConversionsRequest {
bool validate_only = 4;
}
// Response message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions].
// Response message for
// [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions].
message UploadCallConversionsResponse {
// Errors that pertain to conversion failures in the partial failure mode.
// Returned when all errors occur inside the conversions. If any errors occur

12
google/ads/googleads/v1/services/custom_interest_service.proto
View File

@ -36,14 +36,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage custom interests.
service CustomInterestService {
// Returns the requested custom interest in full detail.
rpc GetCustomInterest(GetCustomInterestRequest) returns (google.ads.googleads.v1.resources.CustomInterest) {
rpc GetCustomInterest(GetCustomInterestRequest)
returns (google.ads.googleads.v1.resources.CustomInterest) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customInterests/*}"
};
}
// Creates or updates custom interests. Operation statuses are returned.
rpc MutateCustomInterests(MutateCustomInterestsRequest) returns (MutateCustomInterestsResponse) {
rpc MutateCustomInterests(MutateCustomInterestsRequest)
returns (MutateCustomInterestsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customInterests:mutate"
body: "*"
@ -51,13 +53,15 @@ service CustomInterestService {
}
}
// Request message for [CustomInterestService.GetCustomInterest][google.ads.googleads.v1.services.CustomInterestService.GetCustomInterest].
// Request message for
// [CustomInterestService.GetCustomInterest][google.ads.googleads.v1.services.CustomInterestService.GetCustomInterest].
message GetCustomInterestRequest {
// The resource name of the custom interest to fetch.
string resource_name = 1;
}
// Request message for [CustomInterestService.MutateCustomInterests][google.ads.googleads.v1.services.CustomInterestService.MutateCustomInterests].
// Request message for
// [CustomInterestService.MutateCustomInterests][google.ads.googleads.v1.services.CustomInterestService.MutateCustomInterests].
message MutateCustomInterestsRequest {
// The ID of the customer whose custom interests are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/customer_client_link_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customer client links.
service CustomerClientLinkService {
// Returns the requested CustomerClientLink in full detail.
rpc GetCustomerClientLink(GetCustomerClientLinkRequest) returns (google.ads.googleads.v1.resources.CustomerClientLink) {
rpc GetCustomerClientLink(GetCustomerClientLinkRequest)
returns (google.ads.googleads.v1.resources.CustomerClientLink) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerClientLinks/*}"
};
}
// Creates or updates a customer client link. Operation statuses are returned.
rpc MutateCustomerClientLink(MutateCustomerClientLinkRequest) returns (MutateCustomerClientLinkResponse) {
rpc MutateCustomerClientLink(MutateCustomerClientLinkRequest)
returns (MutateCustomerClientLinkResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerClientLinks:mutate"
body: "*"
@ -49,13 +51,15 @@ service CustomerClientLinkService {
}
}
// Request message for [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.GetCustomerClientLink].
// Request message for
// [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.GetCustomerClientLink].
message GetCustomerClientLinkRequest {
// The resource name of the customer client link to fetch.
string resource_name = 1;
}
// Request message for [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.MutateCustomerClientLink].
// Request message for
// [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.MutateCustomerClientLink].
message MutateCustomerClientLinkRequest {
// The ID of the customer whose customer link are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/customer_client_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to get clients in a customer's hierarchy.
service CustomerClientService {
// Returns the requested client in full detail.
rpc GetCustomerClient(GetCustomerClientRequest) returns (google.ads.googleads.v1.resources.CustomerClient) {
rpc GetCustomerClient(GetCustomerClientRequest)
returns (google.ads.googleads.v1.resources.CustomerClient) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerClients/*}"
};
}
}
// Request message for [CustomerClientService.GetCustomerClient][google.ads.googleads.v1.services.CustomerClientService.GetCustomerClient].
// Request message for
// [CustomerClientService.GetCustomerClient][google.ads.googleads.v1.services.CustomerClientService.GetCustomerClient].
message GetCustomerClientRequest {
// The resource name of the client to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/customer_extension_setting_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customer extension settings.
service CustomerExtensionSettingService {
// Returns the requested customer extension setting in full detail.
rpc GetCustomerExtensionSetting(GetCustomerExtensionSettingRequest) returns (google.ads.googleads.v1.resources.CustomerExtensionSetting) {
rpc GetCustomerExtensionSetting(GetCustomerExtensionSettingRequest)
returns (google.ads.googleads.v1.resources.CustomerExtensionSetting) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerExtensionSettings/*}"
};
@ -45,7 +46,8 @@ service CustomerExtensionSettingService {
// Creates, updates, or removes customer extension settings. Operation
// statuses are returned.
rpc MutateCustomerExtensionSettings(MutateCustomerExtensionSettingsRequest) returns (MutateCustomerExtensionSettingsResponse) {
rpc MutateCustomerExtensionSettings(MutateCustomerExtensionSettingsRequest)
returns (MutateCustomerExtensionSettingsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerExtensionSettings:mutate"
body: "*"

12
google/ads/googleads/v1/services/customer_feed_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customer feeds.
service CustomerFeedService {
// Returns the requested customer feed in full detail.
rpc GetCustomerFeed(GetCustomerFeedRequest) returns (google.ads.googleads.v1.resources.CustomerFeed) {
rpc GetCustomerFeed(GetCustomerFeedRequest)
returns (google.ads.googleads.v1.resources.CustomerFeed) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerFeeds/*}"
};
@ -45,7 +46,8 @@ service CustomerFeedService {
// Creates, updates, or removes customer feeds. Operation statuses are
// returned.
rpc MutateCustomerFeeds(MutateCustomerFeedsRequest) returns (MutateCustomerFeedsResponse) {
rpc MutateCustomerFeeds(MutateCustomerFeedsRequest)
returns (MutateCustomerFeedsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerFeeds:mutate"
body: "*"
@ -53,13 +55,15 @@ service CustomerFeedService {
}
}
// Request message for [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v1.services.CustomerFeedService.GetCustomerFeed].
// Request message for
// [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v1.services.CustomerFeedService.GetCustomerFeed].
message GetCustomerFeedRequest {
// The resource name of the customer feed to fetch.
string resource_name = 1;
}
// Request message for [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v1.services.CustomerFeedService.MutateCustomerFeeds].
// Request message for
// [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v1.services.CustomerFeedService.MutateCustomerFeeds].
message MutateCustomerFeedsRequest {
// The ID of the customer whose customer feeds are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/customer_label_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels on customers.
service CustomerLabelService {
// Returns the requested customer-label relationship in full detail.
rpc GetCustomerLabel(GetCustomerLabelRequest) returns (google.ads.googleads.v1.resources.CustomerLabel) {
rpc GetCustomerLabel(GetCustomerLabelRequest)
returns (google.ads.googleads.v1.resources.CustomerLabel) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerLabels/*}"
};
@ -44,7 +45,8 @@ service CustomerLabelService {
// Creates and removes customer-label relationships.
// Operation statuses are returned.
rpc MutateCustomerLabels(MutateCustomerLabelsRequest) returns (MutateCustomerLabelsResponse) {
rpc MutateCustomerLabels(MutateCustomerLabelsRequest)
returns (MutateCustomerLabelsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerLabels:mutate"
body: "*"
@ -52,13 +54,15 @@ service CustomerLabelService {
}
}
// Request message for [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v1.services.CustomerLabelService.GetCustomerLabel].
// Request message for
// [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v1.services.CustomerLabelService.GetCustomerLabel].
message GetCustomerLabelRequest {
// The resource name of the customer-label relationship to fetch.
string resource_name = 1;
}
// Request message for [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v1.services.CustomerLabelService.MutateCustomerLabels].
// Request message for
// [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v1.services.CustomerLabelService.MutateCustomerLabels].
message MutateCustomerLabelsRequest {
// ID of the customer whose customer-label relationships are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/customer_manager_link_service.proto
View File

@ -33,14 +33,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customer-manager links.
service CustomerManagerLinkService {
// Returns the requested CustomerManagerLink in full detail.
rpc GetCustomerManagerLink(GetCustomerManagerLinkRequest) returns (google.ads.googleads.v1.resources.CustomerManagerLink) {
rpc GetCustomerManagerLink(GetCustomerManagerLinkRequest)
returns (google.ads.googleads.v1.resources.CustomerManagerLink) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerManagerLinks/*}"
};
}
// Creates or updates customer manager links. Operation statuses are returned.
rpc MutateCustomerManagerLink(MutateCustomerManagerLinkRequest) returns (MutateCustomerManagerLinkResponse) {
rpc MutateCustomerManagerLink(MutateCustomerManagerLinkRequest)
returns (MutateCustomerManagerLinkResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerManagerLinks:mutate"
body: "*"
@ -48,13 +50,15 @@ service CustomerManagerLinkService {
}
}
// Request message for [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.GetCustomerManagerLink].
// Request message for
// [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.GetCustomerManagerLink].
message GetCustomerManagerLinkRequest {
// The resource name of the CustomerManagerLink to fetch.
string resource_name = 1;
}
// Request message for [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.MutateCustomerManagerLink].
// Request message for
// [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.MutateCustomerManagerLink].
message MutateCustomerManagerLinkRequest {
// The ID of the customer whose customer manager links are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/customer_negative_criterion_service.proto
View File

@ -36,14 +36,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customer negative criteria.
service CustomerNegativeCriterionService {
// Returns the requested criterion in full detail.
rpc GetCustomerNegativeCriterion(GetCustomerNegativeCriterionRequest) returns (google.ads.googleads.v1.resources.CustomerNegativeCriterion) {
rpc GetCustomerNegativeCriterion(GetCustomerNegativeCriterionRequest)
returns (google.ads.googleads.v1.resources.CustomerNegativeCriterion) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/customerNegativeCriteria/*}"
};
}
// Creates or removes criteria. Operation statuses are returned.
rpc MutateCustomerNegativeCriteria(MutateCustomerNegativeCriteriaRequest) returns (MutateCustomerNegativeCriteriaResponse) {
rpc MutateCustomerNegativeCriteria(MutateCustomerNegativeCriteriaRequest)
returns (MutateCustomerNegativeCriteriaResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/customerNegativeCriteria:mutate"
body: "*"

28
google/ads/googleads/v1/services/customer_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage customers.
service CustomerService {
// Returns the requested customer in full detail.
rpc GetCustomer(GetCustomerRequest) returns (google.ads.googleads.v1.resources.Customer) {
rpc GetCustomer(GetCustomerRequest)
returns (google.ads.googleads.v1.resources.Customer) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*}"
};
@ -52,14 +53,16 @@ service CustomerService {
// Returns resource names of customers directly accessible by the
// user authenticating the call.
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) {
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
returns (ListAccessibleCustomersResponse) {
option (google.api.http) = {
get: "/v1/customers:listAccessibleCustomers"
};
}
// Creates a new client under manager. The new client customer is returned.
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) {
rpc CreateCustomerClient(CreateCustomerClientRequest)
returns (CreateCustomerClientResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}:createCustomerClient"
body: "*"
@ -67,13 +70,15 @@ service CustomerService {
}
}
// Request message for [CustomerService.GetCustomer][google.ads.googleads.v1.services.CustomerService.GetCustomer].
// Request message for
// [CustomerService.GetCustomer][google.ads.googleads.v1.services.CustomerService.GetCustomer].
message GetCustomerRequest {
// The resource name of the customer to fetch.
string resource_name = 1;
}
// Request message for [CustomerService.MutateCustomer][google.ads.googleads.v1.services.CustomerService.MutateCustomer].
// Request message for
// [CustomerService.MutateCustomer][google.ads.googleads.v1.services.CustomerService.MutateCustomer].
message MutateCustomerRequest {
// The ID of the customer being modified.
string customer_id = 1;
@ -86,7 +91,8 @@ message MutateCustomerRequest {
bool validate_only = 5;
}
// Request message for [CustomerService.CreateCustomerClient][google.ads.googleads.v1.services.CustomerService.CreateCustomerClient].
// Request message for
// [CustomerService.CreateCustomerClient][google.ads.googleads.v1.services.CustomerService.CreateCustomerClient].
message CreateCustomerClientRequest {
// The ID of the Manager under whom client customer is being created.
string customer_id = 1;
@ -123,12 +129,12 @@ message MutateCustomerResult {
string resource_name = 1;
}
// Request message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers].
message ListAccessibleCustomersRequest {
// Request message for
// [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers].
message ListAccessibleCustomersRequest {}
}
// Response message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers].
// Response message for
// [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers].
message ListAccessibleCustomersResponse {
// Resource name of customers directly accessible by the
// user authenticating the call.

6
google/ads/googleads/v1/services/detail_placement_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Detail Placement views.
service DetailPlacementViewService {
// Returns the requested Detail Placement view in full detail.
rpc GetDetailPlacementView(GetDetailPlacementViewRequest) returns (google.ads.googleads.v1.resources.DetailPlacementView) {
rpc GetDetailPlacementView(GetDetailPlacementViewRequest)
returns (google.ads.googleads.v1.resources.DetailPlacementView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/detailPlacementViews/*}"
};
}
}
// Request message for [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v1.services.DetailPlacementViewService.GetDetailPlacementView].
// Request message for
// [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v1.services.DetailPlacementViewService.GetDetailPlacementView].
message GetDetailPlacementViewRequest {
// The resource name of the Detail Placement view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/display_keyword_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage display keyword views.
service DisplayKeywordViewService {
// Returns the requested display keyword view in full detail.
rpc GetDisplayKeywordView(GetDisplayKeywordViewRequest) returns (google.ads.googleads.v1.resources.DisplayKeywordView) {
rpc GetDisplayKeywordView(GetDisplayKeywordViewRequest)
returns (google.ads.googleads.v1.resources.DisplayKeywordView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/displayKeywordViews/*}"
};
}
}
// Request message for [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v1.services.DisplayKeywordViewService.GetDisplayKeywordView].
// Request message for
// [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v1.services.DisplayKeywordViewService.GetDisplayKeywordView].
message GetDisplayKeywordViewRequest {
// The resource name of the display keyword view to fetch.
string resource_name = 1;

3
google/ads/googleads/v1/services/domain_category_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch domain categories.
service DomainCategoryService {
// Returns the requested domain category.
rpc GetDomainCategory(GetDomainCategoryRequest) returns (google.ads.googleads.v1.resources.DomainCategory) {
rpc GetDomainCategory(GetDomainCategoryRequest)
returns (google.ads.googleads.v1.resources.DomainCategory) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/domainCategories/*}"
};

5
google/ads/googleads/v1/services/dynamic_search_ads_search_term_view_service.proto
View File

@ -34,7 +34,10 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch dynamic search ads views.
service DynamicSearchAdsSearchTermViewService {
// Returns the requested dynamic search ads search term view in full detail.
rpc GetDynamicSearchAdsSearchTermView(GetDynamicSearchAdsSearchTermViewRequest) returns (google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView) {
rpc GetDynamicSearchAdsSearchTermView(
GetDynamicSearchAdsSearchTermViewRequest)
returns (
google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/dynamicSearchAdsSearchTermViews/*}"
};

3
google/ads/googleads/v1/services/expanded_landing_page_view_service.proto
View File

@ -35,7 +35,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch expanded landing page views.
service ExpandedLandingPageViewService {
// Returns the requested expanded landing page view in full detail.
rpc GetExpandedLandingPageView(GetExpandedLandingPageViewRequest) returns (google.ads.googleads.v1.resources.ExpandedLandingPageView) {
rpc GetExpandedLandingPageView(GetExpandedLandingPageViewRequest)
returns (google.ads.googleads.v1.resources.ExpandedLandingPageView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/expandedLandingPageViews/*}"
};

12
google/ads/googleads/v1/services/extension_feed_item_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage extension feed items.
service ExtensionFeedItemService {
// Returns the requested extension feed item in full detail.
rpc GetExtensionFeedItem(GetExtensionFeedItemRequest) returns (google.ads.googleads.v1.resources.ExtensionFeedItem) {
rpc GetExtensionFeedItem(GetExtensionFeedItemRequest)
returns (google.ads.googleads.v1.resources.ExtensionFeedItem) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/extensionFeedItems/*}"
};
@ -44,7 +45,8 @@ service ExtensionFeedItemService {
// Creates, updates, or removes extension feed items. Operation
// statuses are returned.
rpc MutateExtensionFeedItems(MutateExtensionFeedItemsRequest) returns (MutateExtensionFeedItemsResponse) {
rpc MutateExtensionFeedItems(MutateExtensionFeedItemsRequest)
returns (MutateExtensionFeedItemsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/extensionFeedItems:mutate"
body: "*"
@ -52,13 +54,15 @@ service ExtensionFeedItemService {
}
}
// Request message for [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v1.services.ExtensionFeedItemService.GetExtensionFeedItem].
// Request message for
// [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v1.services.ExtensionFeedItemService.GetExtensionFeedItem].
message GetExtensionFeedItemRequest {
// The resource name of the extension feed item to fetch.
string resource_name = 1;
}
// Request message for [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v1.services.ExtensionFeedItemService.MutateExtensionFeedItems].
// Request message for
// [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v1.services.ExtensionFeedItemService.MutateExtensionFeedItems].
message MutateExtensionFeedItemsRequest {
// The ID of the customer whose extension feed items are being
// modified.

12
google/ads/googleads/v1/services/feed_item_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage feed items.
service FeedItemService {
// Returns the requested feed item in full detail.
rpc GetFeedItem(GetFeedItemRequest) returns (google.ads.googleads.v1.resources.FeedItem) {
rpc GetFeedItem(GetFeedItemRequest)
returns (google.ads.googleads.v1.resources.FeedItem) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/feedItems/*}"
};
@ -45,7 +46,8 @@ service FeedItemService {
// Creates, updates, or removes feed items. Operation statuses are
// returned.
rpc MutateFeedItems(MutateFeedItemsRequest) returns (MutateFeedItemsResponse) {
rpc MutateFeedItems(MutateFeedItemsRequest)
returns (MutateFeedItemsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/feedItems:mutate"
body: "*"
@ -53,13 +55,15 @@ service FeedItemService {
}
}
// Request message for [FeedItemService.GetFeedItem][google.ads.googleads.v1.services.FeedItemService.GetFeedItem].
// Request message for
// [FeedItemService.GetFeedItem][google.ads.googleads.v1.services.FeedItemService.GetFeedItem].
message GetFeedItemRequest {
// The resource name of the feed item to fetch.
string resource_name = 1;
}
// Request message for [FeedItemService.MutateFeedItems][google.ads.googleads.v1.services.FeedItemService.MutateFeedItems].
// Request message for
// [FeedItemService.MutateFeedItems][google.ads.googleads.v1.services.FeedItemService.MutateFeedItems].
message MutateFeedItemsRequest {
// The ID of the customer whose feed items are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/feed_item_target_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage feed item targets.
service FeedItemTargetService {
// Returns the requested feed item targets in full detail.
rpc GetFeedItemTarget(GetFeedItemTargetRequest) returns (google.ads.googleads.v1.resources.FeedItemTarget) {
rpc GetFeedItemTarget(GetFeedItemTargetRequest)
returns (google.ads.googleads.v1.resources.FeedItemTarget) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/feedItemTargets/*}"
};
}
// Creates or removes feed item targets. Operation statuses are returned.
rpc MutateFeedItemTargets(MutateFeedItemTargetsRequest) returns (MutateFeedItemTargetsResponse) {
rpc MutateFeedItemTargets(MutateFeedItemTargetsRequest)
returns (MutateFeedItemTargetsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/feedItemTargets:mutate"
body: "*"
@ -49,13 +51,15 @@ service FeedItemTargetService {
}
}
// Request message for [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v1.services.FeedItemTargetService.GetFeedItemTarget].
// Request message for
// [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v1.services.FeedItemTargetService.GetFeedItemTarget].
message GetFeedItemTargetRequest {
// The resource name of the feed item targets to fetch.
string resource_name = 1;
}
// Request message for [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v1.services.FeedItemTargetService.MutateFeedItemTargets].
// Request message for
// [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v1.services.FeedItemTargetService.MutateFeedItemTargets].
message MutateFeedItemTargetsRequest {
// The ID of the customer whose feed item targets are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/feed_mapping_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage feed mappings.
service FeedMappingService {
// Returns the requested feed mapping in full detail.
rpc GetFeedMapping(GetFeedMappingRequest) returns (google.ads.googleads.v1.resources.FeedMapping) {
rpc GetFeedMapping(GetFeedMappingRequest)
returns (google.ads.googleads.v1.resources.FeedMapping) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/feedMappings/*}"
};
@ -44,7 +45,8 @@ service FeedMappingService {
// Creates or removes feed mappings. Operation statuses are
// returned.
rpc MutateFeedMappings(MutateFeedMappingsRequest) returns (MutateFeedMappingsResponse) {
rpc MutateFeedMappings(MutateFeedMappingsRequest)
returns (MutateFeedMappingsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/feedMappings:mutate"
body: "*"
@ -52,13 +54,15 @@ service FeedMappingService {
}
}
// Request message for [FeedMappingService.GetFeedMapping][google.ads.googleads.v1.services.FeedMappingService.GetFeedMapping].
// Request message for
// [FeedMappingService.GetFeedMapping][google.ads.googleads.v1.services.FeedMappingService.GetFeedMapping].
message GetFeedMappingRequest {
// The resource name of the feed mapping to fetch.
string resource_name = 1;
}
// Request message for [FeedMappingService.MutateFeedMappings][google.ads.googleads.v1.services.FeedMappingService.MutateFeedMappings].
// Request message for
// [FeedMappingService.MutateFeedMappings][google.ads.googleads.v1.services.FeedMappingService.MutateFeedMappings].
message MutateFeedMappingsRequest {
// The ID of the customer whose feed mappings are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/feed_placeholder_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch feed placeholder views.
service FeedPlaceholderViewService {
// Returns the requested feed placeholder view in full detail.
rpc GetFeedPlaceholderView(GetFeedPlaceholderViewRequest) returns (google.ads.googleads.v1.resources.FeedPlaceholderView) {
rpc GetFeedPlaceholderView(GetFeedPlaceholderViewRequest)
returns (google.ads.googleads.v1.resources.FeedPlaceholderView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/feedPlaceholderViews/*}"
};
}
}
// Request message for [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v1.services.FeedPlaceholderViewService.GetFeedPlaceholderView].
// Request message for
// [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v1.services.FeedPlaceholderViewService.GetFeedPlaceholderView].
message GetFeedPlaceholderViewRequest {
// The resource name of the feed placeholder view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/feed_service.proto
View File

@ -53,13 +53,15 @@ service FeedService {
}
}
// Request message for [FeedService.GetFeed][google.ads.googleads.v1.services.FeedService.GetFeed].
// Request message for
// [FeedService.GetFeed][google.ads.googleads.v1.services.FeedService.GetFeed].
message GetFeedRequest {
// The resource name of the feed to fetch.
string resource_name = 1;
}
// Request message for [FeedService.MutateFeeds][google.ads.googleads.v1.services.FeedService.MutateFeeds].
// Request message for
// [FeedService.MutateFeeds][google.ads.googleads.v1.services.FeedService.MutateFeeds].
message MutateFeedsRequest {
// The ID of the customer whose feeds are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/gender_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage gender views.
service GenderViewService {
// Returns the requested gender view in full detail.
rpc GetGenderView(GetGenderViewRequest) returns (google.ads.googleads.v1.resources.GenderView) {
rpc GetGenderView(GetGenderViewRequest)
returns (google.ads.googleads.v1.resources.GenderView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/genderViews/*}"
};
}
}
// Request message for [GenderViewService.GetGenderView][google.ads.googleads.v1.services.GenderViewService.GetGenderView].
// Request message for
// [GenderViewService.GetGenderView][google.ads.googleads.v1.services.GenderViewService.GetGenderView].
message GetGenderViewRequest {
// The resource name of the gender view to fetch.
string resource_name = 1;

15
google/ads/googleads/v1/services/geo_target_constant_service.proto
View File

@ -35,14 +35,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch geo target constants.
service GeoTargetConstantService {
// Returns the requested geo target constant in full detail.
rpc GetGeoTargetConstant(GetGeoTargetConstantRequest) returns (google.ads.googleads.v1.resources.GeoTargetConstant) {
rpc GetGeoTargetConstant(GetGeoTargetConstantRequest)
returns (google.ads.googleads.v1.resources.GeoTargetConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=geoTargetConstants/*}"
};
}
// Returns GeoTargetConstant suggestions by location name or by resource name.
rpc SuggestGeoTargetConstants(SuggestGeoTargetConstantsRequest) returns (SuggestGeoTargetConstantsResponse) {
rpc SuggestGeoTargetConstants(SuggestGeoTargetConstantsRequest)
returns (SuggestGeoTargetConstantsResponse) {
option (google.api.http) = {
post: "/v1/geoTargetConstants:suggest"
body: "*"
@ -50,7 +52,8 @@ service GeoTargetConstantService {
}
}
// Request message for [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v1.services.GeoTargetConstantService.GetGeoTargetConstant].
// Request message for
// [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v1.services.GeoTargetConstantService.GetGeoTargetConstant].
message GetGeoTargetConstantRequest {
// The resource name of the geo target constant to fetch.
string resource_name = 1;
@ -89,7 +92,8 @@ message SuggestGeoTargetConstantsRequest {
}
}
// Response message for [GeoTargetConstantService.SuggestGeoTargetConstants][google.ads.googleads.v1.services.GeoTargetConstantService.SuggestGeoTargetConstants]
// Response message for
// [GeoTargetConstantService.SuggestGeoTargetConstants][google.ads.googleads.v1.services.GeoTargetConstantService.SuggestGeoTargetConstants]
message SuggestGeoTargetConstantsResponse {
// Geo target constant suggestions.
repeated GeoTargetConstantSuggestion geo_target_constant_suggestions = 1;
@ -115,5 +119,6 @@ message GeoTargetConstantSuggestion {
google.ads.googleads.v1.resources.GeoTargetConstant geo_target_constant = 4;
// The list of parents of the geo target constant.
repeated google.ads.googleads.v1.resources.GeoTargetConstant geo_target_constant_parents = 5;
repeated google.ads.googleads.v1.resources.GeoTargetConstant
geo_target_constant_parents = 5;
}

6
google/ads/googleads/v1/services/geographic_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage geographic views.
service GeographicViewService {
// Returns the requested geographic view in full detail.
rpc GetGeographicView(GetGeographicViewRequest) returns (google.ads.googleads.v1.resources.GeographicView) {
rpc GetGeographicView(GetGeographicViewRequest)
returns (google.ads.googleads.v1.resources.GeographicView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/geographicViews/*}"
};
}
}
// Request message for [GeographicViewService.GetGeographicView][google.ads.googleads.v1.services.GeographicViewService.GetGeographicView].
// Request message for
// [GeographicViewService.GetGeographicView][google.ads.googleads.v1.services.GeographicViewService.GetGeographicView].
message GetGeographicViewRequest {
// The resource name of the geographic view to fetch.
string resource_name = 1;

15
google/ads/googleads/v1/services/google_ads_field_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Google Ads API fields.
service GoogleAdsFieldService {
// Returns just the requested field.
rpc GetGoogleAdsField(GetGoogleAdsFieldRequest) returns (google.ads.googleads.v1.resources.GoogleAdsField) {
rpc GetGoogleAdsField(GetGoogleAdsFieldRequest)
returns (google.ads.googleads.v1.resources.GoogleAdsField) {
option (google.api.http) = {
get: "/v1/{resource_name=googleAdsFields/*}"
};
}
// Returns all fields that match the search query.
rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest) returns (SearchGoogleAdsFieldsResponse) {
rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest)
returns (SearchGoogleAdsFieldsResponse) {
option (google.api.http) = {
post: "/v1/googleAdsFields:search"
body: "*"
@ -49,13 +51,15 @@ service GoogleAdsFieldService {
}
}
// Request message for [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v1.services.GoogleAdsFieldService.GetGoogleAdsField].
// Request message for
// [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v1.services.GoogleAdsFieldService.GetGoogleAdsField].
message GetGoogleAdsFieldRequest {
// The resource name of the field to get.
string resource_name = 1;
}
// Request message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields].
// Request message for
// [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields].
message SearchGoogleAdsFieldsRequest {
// The query string.
string query = 1;
@ -71,7 +75,8 @@ message SearchGoogleAdsFieldsRequest {
int32 page_size = 3;
}
// Response message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields].
// Response message for
// [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields].
message SearchGoogleAdsFieldsResponse {
// The list of fields that matched the query.
repeated google.ads.googleads.v1.resources.GoogleAdsField results = 1;

117
google/ads/googleads/v1/services/google_ads_service.proto
View File

@ -233,7 +233,8 @@ service GoogleAdsService {
}
}
// Request message for [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search].
// Request message for
// [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search].
message SearchGoogleAdsRequest {
// The ID of the customer being queried.
string customer_id = 1;
@ -256,7 +257,8 @@ message SearchGoogleAdsRequest {
bool validate_only = 5;
}
// Response message for [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search].
// Response message for
// [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search].
message SearchGoogleAdsResponse {
// The list of rows that matched the query.
repeated GoogleAdsRow results = 1;
@ -281,7 +283,8 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.AccountBudget account_budget = 42;
// The account budget proposal referenced in the query.
google.ads.googleads.v1.resources.AccountBudgetProposal account_budget_proposal = 43;
google.ads.googleads.v1.resources.AccountBudgetProposal
account_budget_proposal = 43;
// The ad group referenced in the query.
google.ads.googleads.v1.resources.AdGroup ad_group = 3;
@ -293,22 +296,27 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.AdGroupAdLabel ad_group_ad_label = 120;
// The ad group audience view referenced in the query.
google.ads.googleads.v1.resources.AdGroupAudienceView ad_group_audience_view = 57;
google.ads.googleads.v1.resources.AdGroupAudienceView ad_group_audience_view =
57;
// The bid modifier referenced in the query.
google.ads.googleads.v1.resources.AdGroupBidModifier ad_group_bid_modifier = 24;
google.ads.googleads.v1.resources.AdGroupBidModifier ad_group_bid_modifier =
24;
// The criterion referenced in the query.
google.ads.googleads.v1.resources.AdGroupCriterion ad_group_criterion = 17;
// The ad group criterion label referenced in the query.
google.ads.googleads.v1.resources.AdGroupCriterionLabel ad_group_criterion_label = 121;
google.ads.googleads.v1.resources.AdGroupCriterionLabel
ad_group_criterion_label = 121;
// The ad group criterion simulation referenced in the query.
google.ads.googleads.v1.resources.AdGroupCriterionSimulation ad_group_criterion_simulation = 110;
google.ads.googleads.v1.resources.AdGroupCriterionSimulation
ad_group_criterion_simulation = 110;
// The ad group extension setting referenced in the query.
google.ads.googleads.v1.resources.AdGroupExtensionSetting ad_group_extension_setting = 112;
google.ads.googleads.v1.resources.AdGroupExtensionSetting
ad_group_extension_setting = 112;
// The ad group feed referenced in the query.
google.ads.googleads.v1.resources.AdGroupFeed ad_group_feed = 67;
@ -347,16 +355,19 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.Campaign campaign = 2;
// The campaign audience view referenced in the query.
google.ads.googleads.v1.resources.CampaignAudienceView campaign_audience_view = 69;
google.ads.googleads.v1.resources.CampaignAudienceView
campaign_audience_view = 69;
// The campaign bid modifier referenced in the query.
google.ads.googleads.v1.resources.CampaignBidModifier campaign_bid_modifier = 26;
google.ads.googleads.v1.resources.CampaignBidModifier campaign_bid_modifier =
26;
// The campaign criterion referenced in the query.
google.ads.googleads.v1.resources.CampaignCriterion campaign_criterion = 20;
// The campaign criterion simulation referenced in the query.
google.ads.googleads.v1.resources.CampaignCriterionSimulation campaign_criterion_simulation = 111;
google.ads.googleads.v1.resources.CampaignCriterionSimulation
campaign_criterion_simulation = 111;
// The campaign draft referenced in the query.
google.ads.googleads.v1.resources.CampaignDraft campaign_draft = 49;
@ -365,7 +376,8 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.CampaignExperiment campaign_experiment = 84;
// The campaign extension setting referenced in the query.
google.ads.googleads.v1.resources.CampaignExtensionSetting campaign_extension_setting = 113;
google.ads.googleads.v1.resources.CampaignExtensionSetting
campaign_extension_setting = 113;
// The campaign feed referenced in the query.
google.ads.googleads.v1.resources.CampaignFeed campaign_feed = 63;
@ -395,16 +407,19 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.Customer customer = 1;
// The CustomerManagerLink referenced in the query.
google.ads.googleads.v1.resources.CustomerManagerLink customer_manager_link = 61;
google.ads.googleads.v1.resources.CustomerManagerLink customer_manager_link =
61;
// The CustomerClientLink referenced in the query.
google.ads.googleads.v1.resources.CustomerClientLink customer_client_link = 62;
google.ads.googleads.v1.resources.CustomerClientLink customer_client_link =
62;
// The CustomerClient referenced in the query.
google.ads.googleads.v1.resources.CustomerClient customer_client = 70;
// The customer extension setting referenced in the query.
google.ads.googleads.v1.resources.CustomerExtensionSetting customer_extension_setting = 114;
google.ads.googleads.v1.resources.CustomerExtensionSetting
customer_extension_setting = 114;
// The customer feed referenced in the query.
google.ads.googleads.v1.resources.CustomerFeed customer_feed = 64;
@ -413,19 +428,24 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.CustomerLabel customer_label = 124;
// The customer negative criterion referenced in the query.
google.ads.googleads.v1.resources.CustomerNegativeCriterion customer_negative_criterion = 88;
google.ads.googleads.v1.resources.CustomerNegativeCriterion
customer_negative_criterion = 88;
// The detail placement view referenced in the query.
google.ads.googleads.v1.resources.DetailPlacementView detail_placement_view = 118;
google.ads.googleads.v1.resources.DetailPlacementView detail_placement_view =
118;
// The display keyword view referenced in the query.
google.ads.googleads.v1.resources.DisplayKeywordView display_keyword_view = 47;
google.ads.googleads.v1.resources.DisplayKeywordView display_keyword_view =
47;
// The dynamic search ads search term view referenced in the query.
google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView dynamic_search_ads_search_term_view = 106;
google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView
dynamic_search_ads_search_term_view = 106;
// The expanded landing page view referenced in the query.
google.ads.googleads.v1.resources.ExpandedLandingPageView expanded_landing_page_view = 128;
google.ads.googleads.v1.resources.ExpandedLandingPageView
expanded_landing_page_view = 128;
// The extension feed item referenced in the query.
google.ads.googleads.v1.resources.ExtensionFeedItem extension_feed_item = 85;
@ -443,7 +463,8 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.FeedMapping feed_mapping = 58;
// The feed placeholder view referenced in the query.
google.ads.googleads.v1.resources.FeedPlaceholderView feed_placeholder_view = 97;
google.ads.googleads.v1.resources.FeedPlaceholderView feed_placeholder_view =
97;
// The gender view referenced in the query.
google.ads.googleads.v1.resources.GenderView gender_view = 40;
@ -455,13 +476,15 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.GeographicView geographic_view = 125;
// The group placement view referenced in the query.
google.ads.googleads.v1.resources.GroupPlacementView group_placement_view = 119;
google.ads.googleads.v1.resources.GroupPlacementView group_placement_view =
119;
// The hotel group view referenced in the query.
google.ads.googleads.v1.resources.HotelGroupView hotel_group_view = 51;
// The hotel performance view referenced in the query.
google.ads.googleads.v1.resources.HotelPerformanceView hotel_performance_view = 71;
google.ads.googleads.v1.resources.HotelPerformanceView
hotel_performance_view = 71;
// The keyword view referenced in the query.
google.ads.googleads.v1.resources.KeywordView keyword_view = 21;
@ -470,16 +493,20 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.KeywordPlan keyword_plan = 32;
// The keyword plan campaign referenced in the query.
google.ads.googleads.v1.resources.KeywordPlanCampaign keyword_plan_campaign = 33;
google.ads.googleads.v1.resources.KeywordPlanCampaign keyword_plan_campaign =
33;
// The keyword plan negative keyword referenced in the query.
google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword keyword_plan_negative_keyword = 34;
google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword
keyword_plan_negative_keyword = 34;
// The keyword plan ad group referenced in the query.
google.ads.googleads.v1.resources.KeywordPlanAdGroup keyword_plan_ad_group = 35;
google.ads.googleads.v1.resources.KeywordPlanAdGroup keyword_plan_ad_group =
35;
// The keyword plan keyword referenced in the query.
google.ads.googleads.v1.resources.KeywordPlanKeyword keyword_plan_keyword = 36;
google.ads.googleads.v1.resources.KeywordPlanKeyword keyword_plan_keyword =
36;
// The label referenced in the query.
google.ads.googleads.v1.resources.Label label = 52;
@ -494,31 +521,38 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.LocationView location_view = 123;
// The managed placement view referenced in the query.
google.ads.googleads.v1.resources.ManagedPlacementView managed_placement_view = 53;
google.ads.googleads.v1.resources.ManagedPlacementView
managed_placement_view = 53;
// The media file referenced in the query.
google.ads.googleads.v1.resources.MediaFile media_file = 90;
// The mobile app category constant referenced in the query.
google.ads.googleads.v1.resources.MobileAppCategoryConstant mobile_app_category_constant = 87;
google.ads.googleads.v1.resources.MobileAppCategoryConstant
mobile_app_category_constant = 87;
// The mobile device constant referenced in the query.
google.ads.googleads.v1.resources.MobileDeviceConstant mobile_device_constant = 98;
google.ads.googleads.v1.resources.MobileDeviceConstant
mobile_device_constant = 98;
// The mutate job referenced in the query.
google.ads.googleads.v1.resources.MutateJob mutate_job = 127;
// The operating system version constant referenced in the query.
google.ads.googleads.v1.resources.OperatingSystemVersionConstant operating_system_version_constant = 86;
google.ads.googleads.v1.resources.OperatingSystemVersionConstant
operating_system_version_constant = 86;
// The paid organic search term view referenced in the query.
google.ads.googleads.v1.resources.PaidOrganicSearchTermView paid_organic_search_term_view = 129;
google.ads.googleads.v1.resources.PaidOrganicSearchTermView
paid_organic_search_term_view = 129;
// The parental status view referenced in the query.
google.ads.googleads.v1.resources.ParentalStatusView parental_status_view = 45;
google.ads.googleads.v1.resources.ParentalStatusView parental_status_view =
45;
// The Product Bidding Category referenced in the query.
google.ads.googleads.v1.resources.ProductBiddingCategoryConstant product_bidding_category_constant = 109;
google.ads.googleads.v1.resources.ProductBiddingCategoryConstant
product_bidding_category_constant = 109;
// The product group view referenced in the query.
google.ads.googleads.v1.resources.ProductGroupView product_group_view = 54;
@ -536,7 +570,8 @@ message GoogleAdsRow {
google.ads.googleads.v1.resources.SharedSet shared_set = 27;
// The shopping performance view referenced in the query.
google.ads.googleads.v1.resources.ShoppingPerformanceView shopping_performance_view = 117;
google.ads.googleads.v1.resources.ShoppingPerformanceView
shopping_performance_view = 117;
// The topic view referenced in the query.
google.ads.googleads.v1.resources.TopicView topic_view = 44;
@ -563,7 +598,8 @@ message GoogleAdsRow {
google.ads.googleads.v1.common.Segments segments = 102;
}
// Request message for [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate].
// Request message for
// [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate].
message MutateGoogleAdsRequest {
// The ID of the customer whose resources are being modified.
string customer_id = 1;
@ -582,7 +618,8 @@ message MutateGoogleAdsRequest {
bool validate_only = 4;
}
// Response message for [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate].
// Response message for
// [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate].
message MutateGoogleAdsResponse {
// Errors that pertain to operation failures in the partial failure mode.
// Returned only when partial_failure = true and all errors occur inside the
@ -677,7 +714,8 @@ message MutateOperation {
CustomerLabelOperation customer_label_operation = 32;
// A customer negative criterion mutate operation.
CustomerNegativeCriterionOperation customer_negative_criterion_operation = 34;
CustomerNegativeCriterionOperation customer_negative_criterion_operation =
34;
// A customer mutate operation.
CustomerOperation customer_operation = 35;
@ -800,7 +838,8 @@ message MutateOperationResponse {
MutateCustomerLabelResult customer_label_result = 32;
// The result for the customer negative criterion mutate.
MutateCustomerNegativeCriteriaResult customer_negative_criterion_result = 34;
MutateCustomerNegativeCriteriaResult customer_negative_criterion_result =
34;
// The result for the customer mutate.
MutateCustomerResult customer_result = 35;

6
google/ads/googleads/v1/services/group_placement_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Group Placement views.
service GroupPlacementViewService {
// Returns the requested Group Placement view in full detail.
rpc GetGroupPlacementView(GetGroupPlacementViewRequest) returns (google.ads.googleads.v1.resources.GroupPlacementView) {
rpc GetGroupPlacementView(GetGroupPlacementViewRequest)
returns (google.ads.googleads.v1.resources.GroupPlacementView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/groupPlacementViews/*}"
};
}
}
// Request message for [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v1.services.GroupPlacementViewService.GetGroupPlacementView].
// Request message for
// [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v1.services.GroupPlacementViewService.GetGroupPlacementView].
message GetGroupPlacementViewRequest {
// The resource name of the Group Placement view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/hotel_group_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Hotel Group Views.
service HotelGroupViewService {
// Returns the requested Hotel Group View in full detail.
rpc GetHotelGroupView(GetHotelGroupViewRequest) returns (google.ads.googleads.v1.resources.HotelGroupView) {
rpc GetHotelGroupView(GetHotelGroupViewRequest)
returns (google.ads.googleads.v1.resources.HotelGroupView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/hotelGroupViews/*}"
};
}
}
// Request message for [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v1.services.HotelGroupViewService.GetHotelGroupView].
// Request message for
// [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v1.services.HotelGroupViewService.GetHotelGroupView].
message GetHotelGroupViewRequest {
// Resource name of the Hotel Group View to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/hotel_performance_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Hotel Performance Views.
service HotelPerformanceViewService {
// Returns the requested Hotel Performance View in full detail.
rpc GetHotelPerformanceView(GetHotelPerformanceViewRequest) returns (google.ads.googleads.v1.resources.HotelPerformanceView) {
rpc GetHotelPerformanceView(GetHotelPerformanceViewRequest)
returns (google.ads.googleads.v1.resources.HotelPerformanceView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/hotelPerformanceView}"
};
}
}
// Request message for [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v1.services.HotelPerformanceViewService.GetHotelPerformanceView].
// Request message for
// [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v1.services.HotelPerformanceViewService.GetHotelPerformanceView].
message GetHotelPerformanceViewRequest {
// Resource name of the Hotel Performance View to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/keyword_plan_ad_group_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Keyword Plan ad groups.
service KeywordPlanAdGroupService {
// Returns the requested Keyword Plan ad group in full detail.
rpc GetKeywordPlanAdGroup(GetKeywordPlanAdGroupRequest) returns (google.ads.googleads.v1.resources.KeywordPlanAdGroup) {
rpc GetKeywordPlanAdGroup(GetKeywordPlanAdGroupRequest)
returns (google.ads.googleads.v1.resources.KeywordPlanAdGroup) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordPlanAdGroups/*}"
};
@ -45,7 +46,8 @@ service KeywordPlanAdGroupService {
// Creates, updates, or removes Keyword Plan ad groups. Operation statuses are
// returned.
rpc MutateKeywordPlanAdGroups(MutateKeywordPlanAdGroupsRequest) returns (MutateKeywordPlanAdGroupsResponse) {
rpc MutateKeywordPlanAdGroups(MutateKeywordPlanAdGroupsRequest)
returns (MutateKeywordPlanAdGroupsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/keywordPlanAdGroups:mutate"
body: "*"
@ -53,13 +55,15 @@ service KeywordPlanAdGroupService {
}
}
// Request message for [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v1.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup].
// Request message for
// [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v1.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup].
message GetKeywordPlanAdGroupRequest {
// The resource name of the Keyword Plan ad group to fetch.
string resource_name = 1;
}
// Request message for [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v1.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups].
// Request message for
// [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v1.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups].
message MutateKeywordPlanAdGroupsRequest {
// The ID of the customer whose Keyword Plan ad groups are being modified.
string customer_id = 1;

9
google/ads/googleads/v1/services/keyword_plan_campaign_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Keyword Plan campaigns.
service KeywordPlanCampaignService {
// Returns the requested Keyword Plan campaign in full detail.
rpc GetKeywordPlanCampaign(GetKeywordPlanCampaignRequest) returns (google.ads.googleads.v1.resources.KeywordPlanCampaign) {
rpc GetKeywordPlanCampaign(GetKeywordPlanCampaignRequest)
returns (google.ads.googleads.v1.resources.KeywordPlanCampaign) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordPlanCampaigns/*}"
};
@ -45,7 +46,8 @@ service KeywordPlanCampaignService {
// Creates, updates, or removes Keyword Plan campaigns. Operation statuses are
// returned.
rpc MutateKeywordPlanCampaigns(MutateKeywordPlanCampaignsRequest) returns (MutateKeywordPlanCampaignsResponse) {
rpc MutateKeywordPlanCampaigns(MutateKeywordPlanCampaignsRequest)
returns (MutateKeywordPlanCampaignsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/keywordPlanCampaigns:mutate"
body: "*"
@ -53,7 +55,8 @@ service KeywordPlanCampaignService {
}
}
// Request message for [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v1.services.KeywordPlanCampaignService.GetKeywordPlanCampaign].
// Request message for
// [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v1.services.KeywordPlanCampaignService.GetKeywordPlanCampaign].
message GetKeywordPlanCampaignRequest {
// The resource name of the Keyword Plan campaign to fetch.
string resource_name = 1;

9
google/ads/googleads/v1/services/keyword_plan_idea_service.proto
View File

@ -36,7 +36,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to generate keyword ideas.
service KeywordPlanIdeaService {
// Returns a list of keyword ideas.
rpc GenerateKeywordIdeas(GenerateKeywordIdeasRequest) returns (GenerateKeywordIdeaResponse) {
rpc GenerateKeywordIdeas(GenerateKeywordIdeasRequest)
returns (GenerateKeywordIdeaResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}:generateKeywordIdeas"
body: "*"
@ -58,7 +59,8 @@ message GenerateKeywordIdeasRequest {
repeated google.protobuf.StringValue geo_target_constants = 8;
// Targeting network.
google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 9;
google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork
keyword_plan_network = 9;
// The type of seed to generate keyword ideas.
oneof seed {
@ -110,5 +112,6 @@ message GenerateKeywordIdeaResult {
google.protobuf.StringValue text = 2;
// The historical metrics for the keyword
google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_idea_metrics = 3;
google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics
keyword_idea_metrics = 3;
}

12
google/ads/googleads/v1/services/keyword_plan_keyword_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Keyword Plan ad group keywords.
service KeywordPlanKeywordService {
// Returns the requested Keyword Plan keyword in full detail.
rpc GetKeywordPlanKeyword(GetKeywordPlanKeywordRequest) returns (google.ads.googleads.v1.resources.KeywordPlanKeyword) {
rpc GetKeywordPlanKeyword(GetKeywordPlanKeywordRequest)
returns (google.ads.googleads.v1.resources.KeywordPlanKeyword) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordPlanKeywords/*}"
};
@ -45,7 +46,8 @@ service KeywordPlanKeywordService {
// Creates, updates, or removes Keyword Plan keywords. Operation statuses are
// returned.
rpc MutateKeywordPlanKeywords(MutateKeywordPlanKeywordsRequest) returns (MutateKeywordPlanKeywordsResponse) {
rpc MutateKeywordPlanKeywords(MutateKeywordPlanKeywordsRequest)
returns (MutateKeywordPlanKeywordsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/keywordPlanKeywords:mutate"
body: "*"
@ -53,13 +55,15 @@ service KeywordPlanKeywordService {
}
}
// Request message for [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v1.services.KeywordPlanKeywordService.GetKeywordPlanKeyword].
// Request message for
// [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v1.services.KeywordPlanKeywordService.GetKeywordPlanKeyword].
message GetKeywordPlanKeywordRequest {
// The resource name of the ad group keyword to fetch.
string resource_name = 1;
}
// Request message for [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v1.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords].
// Request message for
// [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v1.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords].
message MutateKeywordPlanKeywordsRequest {
// The ID of the customer whose Keyword Plan keywords are being modified.
string customer_id = 1;

7
google/ads/googleads/v1/services/keyword_plan_negative_keyword_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Keyword Plan negative keywords.
service KeywordPlanNegativeKeywordService {
// Returns the requested plan in full detail.
rpc GetKeywordPlanNegativeKeyword(GetKeywordPlanNegativeKeywordRequest) returns (google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword) {
rpc GetKeywordPlanNegativeKeyword(GetKeywordPlanNegativeKeywordRequest)
returns (google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordPlanNegativeKeywords/*}"
};
@ -45,7 +46,9 @@ service KeywordPlanNegativeKeywordService {
// Creates, updates, or removes Keyword Plan negative keywords. Operation
// statuses are returned.
rpc MutateKeywordPlanNegativeKeywords(MutateKeywordPlanNegativeKeywordsRequest) returns (MutateKeywordPlanNegativeKeywordsResponse) {
rpc MutateKeywordPlanNegativeKeywords(
MutateKeywordPlanNegativeKeywordsRequest)
returns (MutateKeywordPlanNegativeKeywordsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/keywordPlanNegativeKeywords:mutate"
body: "*"

33
google/ads/googleads/v1/services/keyword_plan_service.proto
View File

@ -38,7 +38,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage keyword plans.
service KeywordPlanService {
// Returns the requested plan in full detail.
rpc GetKeywordPlan(GetKeywordPlanRequest) returns (google.ads.googleads.v1.resources.KeywordPlan) {
rpc GetKeywordPlan(GetKeywordPlanRequest)
returns (google.ads.googleads.v1.resources.KeywordPlan) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordPlans/*}"
};
@ -46,7 +47,8 @@ service KeywordPlanService {
// Creates, updates, or removes keyword plans. Operation statuses are
// returned.
rpc MutateKeywordPlans(MutateKeywordPlansRequest) returns (MutateKeywordPlansResponse) {
rpc MutateKeywordPlans(MutateKeywordPlansRequest)
returns (MutateKeywordPlansResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/keywordPlans:mutate"
body: "*"
@ -54,7 +56,8 @@ service KeywordPlanService {
}
// Returns the requested Keyword Plan forecasts.
rpc GenerateForecastMetrics(GenerateForecastMetricsRequest) returns (GenerateForecastMetricsResponse) {
rpc GenerateForecastMetrics(GenerateForecastMetricsRequest)
returns (GenerateForecastMetricsResponse) {
option (google.api.http) = {
post: "/v1/{keyword_plan=customers/*/keywordPlans/*}:generateForecastMetrics"
body: "*"
@ -62,7 +65,8 @@ service KeywordPlanService {
}
// Returns the requested Keyword Plan historical metrics.
rpc GenerateHistoricalMetrics(GenerateHistoricalMetricsRequest) returns (GenerateHistoricalMetricsResponse) {
rpc GenerateHistoricalMetrics(GenerateHistoricalMetricsRequest)
returns (GenerateHistoricalMetricsResponse) {
option (google.api.http) = {
post: "/v1/{keyword_plan=customers/*/keywordPlans/*}:generateHistoricalMetrics"
body: "*"
@ -70,13 +74,15 @@ service KeywordPlanService {
}
}
// Request message for [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v1.services.KeywordPlanService.GetKeywordPlan].
// Request message for
// [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v1.services.KeywordPlanService.GetKeywordPlan].
message GetKeywordPlanRequest {
// The resource name of the plan to fetch.
string resource_name = 1;
}
// Request message for [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v1.services.KeywordPlanService.MutateKeywordPlans].
// Request message for
// [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v1.services.KeywordPlanService.MutateKeywordPlans].
message MutateKeywordPlansRequest {
// The ID of the customer whose keyword plans are being modified.
string customer_id = 1;
@ -136,13 +142,15 @@ message MutateKeywordPlansResult {
string resource_name = 1;
}
// Request message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics].
// Request message for
// [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics].
message GenerateForecastMetricsRequest {
// The resource name of the keyword plan to be forecasted.
string keyword_plan = 1;
}
// Response message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics].
// Response message for
// [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics].
message GenerateForecastMetricsResponse {
// List of campaign forecasts.
// One maximum.
@ -207,14 +215,16 @@ message ForecastMetrics {
google.protobuf.Int64Value cost_micros = 6;
}
// Request message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics].
// Request message for
// [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics].
message GenerateHistoricalMetricsRequest {
// The resource name of the keyword plan of which historical metrics are
// requested.
string keyword_plan = 1;
}
// Response message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics].
// Response message for
// [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics].
message GenerateHistoricalMetricsResponse {
// List of keyword historical metrics.
repeated KeywordPlanKeywordHistoricalMetrics metrics = 1;
@ -233,5 +243,6 @@ message KeywordPlanKeywordHistoricalMetrics {
// The historical metrics for the query associated with one or more
// ad_group_keywords in the plan.
google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_metrics = 2;
google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_metrics =
2;
}

6
google/ads/googleads/v1/services/keyword_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage keyword views.
service KeywordViewService {
// Returns the requested keyword view in full detail.
rpc GetKeywordView(GetKeywordViewRequest) returns (google.ads.googleads.v1.resources.KeywordView) {
rpc GetKeywordView(GetKeywordViewRequest)
returns (google.ads.googleads.v1.resources.KeywordView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/keywordViews/*}"
};
}
}
// Request message for [KeywordViewService.GetKeywordView][google.ads.googleads.v1.services.KeywordViewService.GetKeywordView].
// Request message for
// [KeywordViewService.GetKeywordView][google.ads.googleads.v1.services.KeywordViewService.GetKeywordView].
message GetKeywordViewRequest {
// The resource name of the keyword view to fetch.
string resource_name = 1;

9
google/ads/googleads/v1/services/label_service.proto
View File

@ -35,7 +35,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage labels.
service LabelService {
// Returns the requested label in full detail.
rpc GetLabel(GetLabelRequest) returns (google.ads.googleads.v1.resources.Label) {
rpc GetLabel(GetLabelRequest)
returns (google.ads.googleads.v1.resources.Label) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/labels/*}"
};
@ -50,13 +51,15 @@ service LabelService {
}
}
// Request message for [LabelService.GetLabel][google.ads.googleads.v1.services.LabelService.GetLabel].
// Request message for
// [LabelService.GetLabel][google.ads.googleads.v1.services.LabelService.GetLabel].
message GetLabelRequest {
// The resource name of the label to fetch.
string resource_name = 1;
}
// Request message for [LabelService.MutateLabels][google.ads.googleads.v1.services.LabelService.MutateLabels].
// Request message for
// [LabelService.MutateLabels][google.ads.googleads.v1.services.LabelService.MutateLabels].
message MutateLabelsRequest {
// ID of the customer whose labels are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/landing_page_view_service.proto
View File

@ -35,14 +35,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch landing page views.
service LandingPageViewService {
// Returns the requested landing page view in full detail.
rpc GetLandingPageView(GetLandingPageViewRequest) returns (google.ads.googleads.v1.resources.LandingPageView) {
rpc GetLandingPageView(GetLandingPageViewRequest)
returns (google.ads.googleads.v1.resources.LandingPageView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/landingPageViews/*}"
};
}
}
// Request message for [LandingPageViewService.GetLandingPageView][google.ads.googleads.v1.services.LandingPageViewService.GetLandingPageView].
// Request message for
// [LandingPageViewService.GetLandingPageView][google.ads.googleads.v1.services.LandingPageViewService.GetLandingPageView].
message GetLandingPageViewRequest {
// The resource name of the landing page view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/language_constant_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch language constants.
service LanguageConstantService {
// Returns the requested language constant.
rpc GetLanguageConstant(GetLanguageConstantRequest) returns (google.ads.googleads.v1.resources.LanguageConstant) {
rpc GetLanguageConstant(GetLanguageConstantRequest)
returns (google.ads.googleads.v1.resources.LanguageConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=languageConstants/*}"
};
}
}
// Request message for [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v1.services.LanguageConstantService.GetLanguageConstant].
// Request message for
// [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v1.services.LanguageConstantService.GetLanguageConstant].
message GetLanguageConstantRequest {
// Resource name of the language constant to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/location_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch location views.
service LocationViewService {
// Returns the requested location view in full detail.
rpc GetLocationView(GetLocationViewRequest) returns (google.ads.googleads.v1.resources.LocationView) {
rpc GetLocationView(GetLocationViewRequest)
returns (google.ads.googleads.v1.resources.LocationView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/locationViews/*}"
};
}
}
// Request message for [LocationViewService.GetLocationView][google.ads.googleads.v1.services.LocationViewService.GetLocationView].
// Request message for
// [LocationViewService.GetLocationView][google.ads.googleads.v1.services.LocationViewService.GetLocationView].
message GetLocationViewRequest {
// The resource name of the location view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/managed_placement_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage Managed Placement views.
service ManagedPlacementViewService {
// Returns the requested Managed Placement view in full detail.
rpc GetManagedPlacementView(GetManagedPlacementViewRequest) returns (google.ads.googleads.v1.resources.ManagedPlacementView) {
rpc GetManagedPlacementView(GetManagedPlacementViewRequest)
returns (google.ads.googleads.v1.resources.ManagedPlacementView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/managedPlacementViews/*}"
};
}
}
// Request message for [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v1.services.ManagedPlacementViewService.GetManagedPlacementView].
// Request message for
// [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v1.services.ManagedPlacementViewService.GetManagedPlacementView].
message GetManagedPlacementViewRequest {
// The resource name of the Managed Placement View to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/media_file_service.proto
View File

@ -36,14 +36,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage media files.
service MediaFileService {
// Returns the requested media file in full detail.
rpc GetMediaFile(GetMediaFileRequest) returns (google.ads.googleads.v1.resources.MediaFile) {
rpc GetMediaFile(GetMediaFileRequest)
returns (google.ads.googleads.v1.resources.MediaFile) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/mediaFiles/*}"
};
}
// Creates media files. Operation statuses are returned.
rpc MutateMediaFiles(MutateMediaFilesRequest) returns (MutateMediaFilesResponse) {
rpc MutateMediaFiles(MutateMediaFilesRequest)
returns (MutateMediaFilesResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/mediaFiles:mutate"
body: "*"
@ -51,13 +53,15 @@ service MediaFileService {
}
}
// Request message for [MediaFileService.GetMediaFile][google.ads.googleads.v1.services.MediaFileService.GetMediaFile]
// Request message for
// [MediaFileService.GetMediaFile][google.ads.googleads.v1.services.MediaFileService.GetMediaFile]
message GetMediaFileRequest {
// The resource name of the media file to fetch.
string resource_name = 1;
}
// Request message for [MediaFileService.MutateMediaFiles][google.ads.googleads.v1.services.MediaFileService.MutateMediaFiles]
// Request message for
// [MediaFileService.MutateMediaFiles][google.ads.googleads.v1.services.MediaFileService.MutateMediaFiles]
message MutateMediaFilesRequest {
// The ID of the customer whose media files are being modified.
string customer_id = 1;

24
google/ads/googleads/v1/services/merchant_center_link_service.proto
View File

@ -36,21 +36,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Merchant Center.
service MerchantCenterLinkService {
// Returns Merchant Center links available tor this customer.
rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest) returns (ListMerchantCenterLinksResponse) {
rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest)
returns (ListMerchantCenterLinksResponse) {
option (google.api.http) = {
get: "/v1/customers/{customer_id=*}/merchantCenterLinks"
};
}
// Returns the Merchant Center link in full detail.
rpc GetMerchantCenterLink(GetMerchantCenterLinkRequest) returns (google.ads.googleads.v1.resources.MerchantCenterLink) {
rpc GetMerchantCenterLink(GetMerchantCenterLinkRequest)
returns (google.ads.googleads.v1.resources.MerchantCenterLink) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/merchantCenterLinks/*}"
};
}
// Updates status or removes a Merchant Center link.
rpc MutateMerchantCenterLink(MutateMerchantCenterLinkRequest) returns (MutateMerchantCenterLinkResponse) {
rpc MutateMerchantCenterLink(MutateMerchantCenterLinkRequest)
returns (MutateMerchantCenterLinkResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/merchantCenterLinks:mutate"
body: "*"
@ -58,26 +61,31 @@ service MerchantCenterLinkService {
}
}
// Request message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks].
// Request message for
// [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks].
message ListMerchantCenterLinksRequest {
// The ID of the customer onto which to apply the Merchant Center link list
// operation.
string customer_id = 1;
}
// Response message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks].
// Response message for
// [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks].
message ListMerchantCenterLinksResponse {
// Merchant Center links available for the requested customer
repeated google.ads.googleads.v1.resources.MerchantCenterLink merchant_center_links = 1;
repeated google.ads.googleads.v1.resources.MerchantCenterLink
merchant_center_links = 1;
}
// Request message for [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.GetMerchantCenterLink].
// Request message for
// [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.GetMerchantCenterLink].
message GetMerchantCenterLinkRequest {
// Resource name of the Merchant Center link.
string resource_name = 1;
}
// Request message for [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.MutateMerchantCenterLink].
// Request message for
// [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.MutateMerchantCenterLink].
message MutateMerchantCenterLinkRequest {
// The ID of the customer being modified.
string customer_id = 1;

3
google/ads/googleads/v1/services/mobile_app_category_constant_service.proto
View File

@ -32,7 +32,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch mobile app category constants.
service MobileAppCategoryConstantService {
// Returns the requested mobile app category constant.
rpc GetMobileAppCategoryConstant(GetMobileAppCategoryConstantRequest) returns (google.ads.googleads.v1.resources.MobileAppCategoryConstant) {
rpc GetMobileAppCategoryConstant(GetMobileAppCategoryConstantRequest)
returns (google.ads.googleads.v1.resources.MobileAppCategoryConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=mobileAppCategoryConstants/*}"
};

6
google/ads/googleads/v1/services/mobile_device_constant_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch mobile device constants.
service MobileDeviceConstantService {
// Returns the requested mobile device constant in full detail.
rpc GetMobileDeviceConstant(GetMobileDeviceConstantRequest) returns (google.ads.googleads.v1.resources.MobileDeviceConstant) {
rpc GetMobileDeviceConstant(GetMobileDeviceConstantRequest)
returns (google.ads.googleads.v1.resources.MobileDeviceConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=mobileDeviceConstants/*}"
};
}
}
// Request message for [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v1.services.MobileDeviceConstantService.GetMobileDeviceConstant].
// Request message for
// [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v1.services.MobileDeviceConstantService.GetMobileDeviceConstant].
message GetMobileDeviceConstantRequest {
// Resource name of the mobile device to fetch.
string resource_name = 1;

30
google/ads/googleads/v1/services/mutate_job_service.proto
View File

@ -37,7 +37,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage mutate jobs.
service MutateJobService {
// Creates a mutate job.
rpc CreateMutateJob(CreateMutateJobRequest) returns (CreateMutateJobResponse) {
rpc CreateMutateJob(CreateMutateJobRequest)
returns (CreateMutateJobResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/mutateJobs:create"
body: "*"
@ -45,7 +46,8 @@ service MutateJobService {
}
// Returns the mutate job.
rpc GetMutateJob(GetMutateJobRequest) returns (google.ads.googleads.v1.resources.MutateJob) {
rpc GetMutateJob(GetMutateJobRequest)
returns (google.ads.googleads.v1.resources.MutateJob) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/mutateJobs/*}"
};
@ -53,7 +55,8 @@ service MutateJobService {
// Returns the results of the mutate job. The job must be done.
// Supports standard list paging.
rpc ListMutateJobResults(ListMutateJobResultsRequest) returns (ListMutateJobResultsResponse) {
rpc ListMutateJobResults(ListMutateJobResultsRequest)
returns (ListMutateJobResultsResponse) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/mutateJobs/*}:listResults"
};
@ -72,7 +75,8 @@ service MutateJobService {
}
// Add operations to the mutate job.
rpc AddMutateJobOperations(AddMutateJobOperationsRequest) returns (AddMutateJobOperationsResponse) {
rpc AddMutateJobOperations(AddMutateJobOperationsRequest)
returns (AddMutateJobOperationsResponse) {
option (google.api.http) = {
post: "/v1/{resource_name=customers/*/mutateJobs/*}:addOperations"
body: "*"
@ -92,19 +96,22 @@ message CreateMutateJobResponse {
string resource_name = 1;
}
// Request message for [MutateJobService.GetMutateJob][google.ads.googleads.v1.services.MutateJobService.GetMutateJob]
// Request message for
// [MutateJobService.GetMutateJob][google.ads.googleads.v1.services.MutateJobService.GetMutateJob]
message GetMutateJobRequest {
// The resource name of the MutateJob to get.
string resource_name = 1;
}
// Request message for [MutateJobService.RunMutateJob][google.ads.googleads.v1.services.MutateJobService.RunMutateJob]
// Request message for
// [MutateJobService.RunMutateJob][google.ads.googleads.v1.services.MutateJobService.RunMutateJob]
message RunMutateJobRequest {
// The resource name of the MutateJob to run.
string resource_name = 1;
}
// Request message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations]
// Request message for
// [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations]
message AddMutateJobOperationsRequest {
// The resource name of the MutateJob.
string resource_name = 1;
@ -129,7 +136,8 @@ message AddMutateJobOperationsRequest {
repeated MutateOperation mutate_operations = 3;
}
// Response message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations]
// Response message for
// [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations]
message AddMutateJobOperationsResponse {
// The total number of operations added so far for this job.
int64 total_operations = 1;
@ -140,7 +148,8 @@ message AddMutateJobOperationsResponse {
string next_sequence_token = 2;
}
// Request message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults].
// Request message for
// [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults].
message ListMutateJobResultsRequest {
// The resource name of the MutateJob whose results are being listed.
string resource_name = 1;
@ -157,7 +166,8 @@ message ListMutateJobResultsRequest {
int32 page_size = 3;
}
// Response message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults].
// Response message for
// [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults].
message ListMutateJobResultsResponse {
// The list of rows that matched the query.
repeated MutateJobResult results = 1;

5
google/ads/googleads/v1/services/operating_system_version_constant_service.proto
View File

@ -34,7 +34,10 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Operating System Version constants.
service OperatingSystemVersionConstantService {
// Returns the requested OS version constant in full detail.
rpc GetOperatingSystemVersionConstant(GetOperatingSystemVersionConstantRequest) returns (google.ads.googleads.v1.resources.OperatingSystemVersionConstant) {
rpc GetOperatingSystemVersionConstant(
GetOperatingSystemVersionConstantRequest)
returns (
google.ads.googleads.v1.resources.OperatingSystemVersionConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=operatingSystemVersionConstants/*}"
};

3
google/ads/googleads/v1/services/paid_organic_search_term_view_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch paid organic search term views.
service PaidOrganicSearchTermViewService {
// Returns the requested paid organic search term view in full detail.
rpc GetPaidOrganicSearchTermView(GetPaidOrganicSearchTermViewRequest) returns (google.ads.googleads.v1.resources.PaidOrganicSearchTermView) {
rpc GetPaidOrganicSearchTermView(GetPaidOrganicSearchTermViewRequest)
returns (google.ads.googleads.v1.resources.PaidOrganicSearchTermView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/paidOrganicSearchTermViews/*}"
};

6
google/ads/googleads/v1/services/parental_status_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage parental status views.
service ParentalStatusViewService {
// Returns the requested parental status view in full detail.
rpc GetParentalStatusView(GetParentalStatusViewRequest) returns (google.ads.googleads.v1.resources.ParentalStatusView) {
rpc GetParentalStatusView(GetParentalStatusViewRequest)
returns (google.ads.googleads.v1.resources.ParentalStatusView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/parentalStatusViews/*}"
};
}
}
// Request message for [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v1.services.ParentalStatusViewService.GetParentalStatusView].
// Request message for
// [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v1.services.ParentalStatusViewService.GetParentalStatusView].
message GetParentalStatusViewRequest {
// The resource name of the parental status view to fetch.
string resource_name = 1;

9
google/ads/googleads/v1/services/payments_account_service.proto
View File

@ -37,7 +37,8 @@ service PaymentsAccountService {
// Returns all Payments accounts associated with all managers
// between the login customer ID and specified serving customer in the
// hierarchy, inclusive.
rpc ListPaymentsAccounts(ListPaymentsAccountsRequest) returns (ListPaymentsAccountsResponse) {
rpc ListPaymentsAccounts(ListPaymentsAccountsRequest)
returns (ListPaymentsAccountsResponse) {
option (google.api.http) = {
get: "/v1/customers/{customer_id=*}/paymentsAccounts"
};
@ -50,8 +51,10 @@ message ListPaymentsAccountsRequest {
string customer_id = 1;
}
// Response message for [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v1.services.PaymentsAccountService.ListPaymentsAccounts].
// Response message for
// [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v1.services.PaymentsAccountService.ListPaymentsAccounts].
message ListPaymentsAccountsResponse {
// The list of accessible Payments accounts.
repeated google.ads.googleads.v1.resources.PaymentsAccount payments_accounts = 1;
repeated google.ads.googleads.v1.resources.PaymentsAccount payments_accounts =
1;
}

5
google/ads/googleads/v1/services/product_bidding_category_constant_service.proto
View File

@ -34,7 +34,10 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Product Bidding Categories.
service ProductBiddingCategoryConstantService {
// Returns the requested Product Bidding Category in full detail.
rpc GetProductBiddingCategoryConstant(GetProductBiddingCategoryConstantRequest) returns (google.ads.googleads.v1.resources.ProductBiddingCategoryConstant) {
rpc GetProductBiddingCategoryConstant(
GetProductBiddingCategoryConstantRequest)
returns (
google.ads.googleads.v1.resources.ProductBiddingCategoryConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=productBiddingCategoryConstants/*}"
};

6
google/ads/googleads/v1/services/product_group_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage product group views.
service ProductGroupViewService {
// Returns the requested product group view in full detail.
rpc GetProductGroupView(GetProductGroupViewRequest) returns (google.ads.googleads.v1.resources.ProductGroupView) {
rpc GetProductGroupView(GetProductGroupViewRequest)
returns (google.ads.googleads.v1.resources.ProductGroupView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/productGroupViews/*}"
};
}
}
// Request message for [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v1.services.ProductGroupViewService.GetProductGroupView].
// Request message for
// [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v1.services.ProductGroupViewService.GetProductGroupView].
message GetProductGroupViewRequest {
// The resource name of the product group view to fetch.
string resource_name = 1;

33
google/ads/googleads/v1/services/recommendation_service.proto
View File

@ -39,14 +39,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage recommendations.
service RecommendationService {
// Returns the requested recommendation in full detail.
rpc GetRecommendation(GetRecommendationRequest) returns (google.ads.googleads.v1.resources.Recommendation) {
rpc GetRecommendation(GetRecommendationRequest)
returns (google.ads.googleads.v1.resources.Recommendation) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/recommendations/*}"
};
}
// Applies given recommendations with corresponding apply parameters.
rpc ApplyRecommendation(ApplyRecommendationRequest) returns (ApplyRecommendationResponse) {
rpc ApplyRecommendation(ApplyRecommendationRequest)
returns (ApplyRecommendationResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/recommendations:apply"
body: "*"
@ -54,7 +56,8 @@ service RecommendationService {
}
// Dismisses given recommendations.
rpc DismissRecommendation(DismissRecommendationRequest) returns (DismissRecommendationResponse) {
rpc DismissRecommendation(DismissRecommendationRequest)
returns (DismissRecommendationResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/recommendations:dismiss"
body: "*"
@ -62,13 +65,15 @@ service RecommendationService {
}
}
// Request message for [RecommendationService.GetRecommendation][google.ads.googleads.v1.services.RecommendationService.GetRecommendation].
// Request message for
// [RecommendationService.GetRecommendation][google.ads.googleads.v1.services.RecommendationService.GetRecommendation].
message GetRecommendationRequest {
// The resource name of the recommendation to fetch.
string resource_name = 1;
}
// Request message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation].
// Request message for
// [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation].
message ApplyRecommendationRequest {
// The ID of the customer with the recommendation.
string customer_id = 1;
@ -108,7 +113,8 @@ message ApplyRecommendationOperation {
google.protobuf.StringValue ad_group = 1;
// The match type of the keyword. This is a required field.
google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2;
google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType
match_type = 2;
// Optional, CPC bid to set for the keyword. If not set, keyword will use
// bid based on bidding strategy used by target ad group.
@ -128,7 +134,8 @@ message ApplyRecommendationOperation {
// Parameters to use when applying callout extension recommendation.
message CalloutExtensionParameters {
// Callout extensions to be added. This is a required field.
repeated google.ads.googleads.v1.common.CalloutFeedItem callout_extensions = 1;
repeated google.ads.googleads.v1.common.CalloutFeedItem callout_extensions =
1;
}
// Parameters to use when applying call extension recommendation.
@ -140,7 +147,8 @@ message ApplyRecommendationOperation {
// Parameters to use when applying sitelink extension recommendation.
message SitelinkExtensionParameters {
// Sitelink extensions to be added. This is a required field.
repeated google.ads.googleads.v1.common.SitelinkFeedItem sitelink_extensions = 1;
repeated google.ads.googleads.v1.common.SitelinkFeedItem
sitelink_extensions = 1;
}
// Parameters to use when applying move unused budget recommendation.
@ -183,7 +191,8 @@ message ApplyRecommendationOperation {
}
}
// Response message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation].
// Response message for
// [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation].
message ApplyRecommendationResponse {
// Results of operations to apply recommendations.
repeated ApplyRecommendationResult results = 1;
@ -201,7 +210,8 @@ message ApplyRecommendationResult {
string resource_name = 1;
}
// Request message for [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation].
// Request message for
// [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation].
message DismissRecommendationRequest {
// Operation to dismiss a single recommendation identified by resource_name.
message DismissRecommendationOperation {
@ -224,7 +234,8 @@ message DismissRecommendationRequest {
bool partial_failure = 2;
}
// Response message for [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation].
// Response message for
// [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation].
message DismissRecommendationResponse {
// The result of dismissing a recommendation.
message DismissRecommendationResult {

12
google/ads/googleads/v1/services/remarketing_action_service.proto
View File

@ -37,14 +37,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage remarketing actions.
service RemarketingActionService {
// Returns the requested remarketing action in full detail.
rpc GetRemarketingAction(GetRemarketingActionRequest) returns (google.ads.googleads.v1.resources.RemarketingAction) {
rpc GetRemarketingAction(GetRemarketingActionRequest)
returns (google.ads.googleads.v1.resources.RemarketingAction) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/remarketingActions/*}"
};
}
// Creates or updates remarketing actions. Operation statuses are returned.
rpc MutateRemarketingActions(MutateRemarketingActionsRequest) returns (MutateRemarketingActionsResponse) {
rpc MutateRemarketingActions(MutateRemarketingActionsRequest)
returns (MutateRemarketingActionsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/remarketingActions:mutate"
body: "*"
@ -52,13 +54,15 @@ service RemarketingActionService {
}
}
// Request message for [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v1.services.RemarketingActionService.GetRemarketingAction].
// Request message for
// [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v1.services.RemarketingActionService.GetRemarketingAction].
message GetRemarketingActionRequest {
// The resource name of the remarketing action to fetch.
string resource_name = 1;
}
// Request message for [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v1.services.RemarketingActionService.MutateRemarketingActions].
// Request message for
// [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v1.services.RemarketingActionService.MutateRemarketingActions].
message MutateRemarketingActionsRequest {
// The ID of the customer whose remarketing actions are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/search_term_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage search term views.
service SearchTermViewService {
// Returns the attributes of the requested search term view.
rpc GetSearchTermView(GetSearchTermViewRequest) returns (google.ads.googleads.v1.resources.SearchTermView) {
rpc GetSearchTermView(GetSearchTermViewRequest)
returns (google.ads.googleads.v1.resources.SearchTermView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/searchTermViews/*}"
};
}
}
// Request message for [SearchTermViewService.GetSearchTermView][google.ads.googleads.v1.services.SearchTermViewService.GetSearchTermView].
// Request message for
// [SearchTermViewService.GetSearchTermView][google.ads.googleads.v1.services.SearchTermViewService.GetSearchTermView].
message GetSearchTermViewRequest {
// The resource name of the search term view to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/shared_criterion_service.proto
View File

@ -36,14 +36,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage shared criteria.
service SharedCriterionService {
// Returns the requested shared criterion in full detail.
rpc GetSharedCriterion(GetSharedCriterionRequest) returns (google.ads.googleads.v1.resources.SharedCriterion) {
rpc GetSharedCriterion(GetSharedCriterionRequest)
returns (google.ads.googleads.v1.resources.SharedCriterion) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/sharedCriteria/*}"
};
}
// Creates or removes shared criteria. Operation statuses are returned.
rpc MutateSharedCriteria(MutateSharedCriteriaRequest) returns (MutateSharedCriteriaResponse) {
rpc MutateSharedCriteria(MutateSharedCriteriaRequest)
returns (MutateSharedCriteriaResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/sharedCriteria:mutate"
body: "*"
@ -51,13 +53,15 @@ service SharedCriterionService {
}
}
// Request message for [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v1.services.SharedCriterionService.GetSharedCriterion].
// Request message for
// [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v1.services.SharedCriterionService.GetSharedCriterion].
message GetSharedCriterionRequest {
// The resource name of the shared criterion to fetch.
string resource_name = 1;
}
// Request message for [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v1.services.SharedCriterionService.MutateSharedCriteria].
// Request message for
// [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v1.services.SharedCriterionService.MutateSharedCriteria].
message MutateSharedCriteriaRequest {
// The ID of the customer whose shared criteria are being modified.
string customer_id = 1;

12
google/ads/googleads/v1/services/shared_set_service.proto
View File

@ -37,14 +37,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage shared sets.
service SharedSetService {
// Returns the requested shared set in full detail.
rpc GetSharedSet(GetSharedSetRequest) returns (google.ads.googleads.v1.resources.SharedSet) {
rpc GetSharedSet(GetSharedSetRequest)
returns (google.ads.googleads.v1.resources.SharedSet) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/sharedSets/*}"
};
}
// Creates, updates, or removes shared sets. Operation statuses are returned.
rpc MutateSharedSets(MutateSharedSetsRequest) returns (MutateSharedSetsResponse) {
rpc MutateSharedSets(MutateSharedSetsRequest)
returns (MutateSharedSetsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/sharedSets:mutate"
body: "*"
@ -52,13 +54,15 @@ service SharedSetService {
}
}
// Request message for [SharedSetService.GetSharedSet][google.ads.googleads.v1.services.SharedSetService.GetSharedSet].
// Request message for
// [SharedSetService.GetSharedSet][google.ads.googleads.v1.services.SharedSetService.GetSharedSet].
message GetSharedSetRequest {
// The resource name of the shared set to fetch.
string resource_name = 1;
}
// Request message for [SharedSetService.MutateSharedSets][google.ads.googleads.v1.services.SharedSetService.MutateSharedSets].
// Request message for
// [SharedSetService.MutateSharedSets][google.ads.googleads.v1.services.SharedSetService.MutateSharedSets].
message MutateSharedSetsRequest {
// The ID of the customer whose shared sets are being modified.
string customer_id = 1;

3
google/ads/googleads/v1/services/shopping_performance_view_service.proto
View File

@ -34,7 +34,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Shopping performance views.
service ShoppingPerformanceViewService {
// Returns the requested Shopping performance view in full detail.
rpc GetShoppingPerformanceView(GetShoppingPerformanceViewRequest) returns (google.ads.googleads.v1.resources.ShoppingPerformanceView) {
rpc GetShoppingPerformanceView(GetShoppingPerformanceViewRequest)
returns (google.ads.googleads.v1.resources.ShoppingPerformanceView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/shoppingPerformanceView}"
};

6
google/ads/googleads/v1/services/topic_constant_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch topic constants.
service TopicConstantService {
// Returns the requested topic constant in full detail.
rpc GetTopicConstant(GetTopicConstantRequest) returns (google.ads.googleads.v1.resources.TopicConstant) {
rpc GetTopicConstant(GetTopicConstantRequest)
returns (google.ads.googleads.v1.resources.TopicConstant) {
option (google.api.http) = {
get: "/v1/{resource_name=topicConstants/*}"
};
}
}
// Request message for [TopicConstantService.GetTopicConstant][google.ads.googleads.v1.services.TopicConstantService.GetTopicConstant].
// Request message for
// [TopicConstantService.GetTopicConstant][google.ads.googleads.v1.services.TopicConstantService.GetTopicConstant].
message GetTopicConstantRequest {
// Resource name of the Topic to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/topic_view_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage topic views.
service TopicViewService {
// Returns the requested topic view in full detail.
rpc GetTopicView(GetTopicViewRequest) returns (google.ads.googleads.v1.resources.TopicView) {
rpc GetTopicView(GetTopicViewRequest)
returns (google.ads.googleads.v1.resources.TopicView) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/topicViews/*}"
};
}
}
// Request message for [TopicViewService.GetTopicView][google.ads.googleads.v1.services.TopicViewService.GetTopicView].
// Request message for
// [TopicViewService.GetTopicView][google.ads.googleads.v1.services.TopicViewService.GetTopicView].
message GetTopicViewRequest {
// The resource name of the topic view to fetch.
string resource_name = 1;

6
google/ads/googleads/v1/services/user_interest_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to fetch Google Ads User Interest.
service UserInterestService {
// Returns the requested user interest in full detail
rpc GetUserInterest(GetUserInterestRequest) returns (google.ads.googleads.v1.resources.UserInterest) {
rpc GetUserInterest(GetUserInterestRequest)
returns (google.ads.googleads.v1.resources.UserInterest) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/userInterests/*}"
};
}
}
// Request message for [UserInterestService.GetUserInterest][google.ads.googleads.v1.services.UserInterestService.GetUserInterest].
// Request message for
// [UserInterestService.GetUserInterest][google.ads.googleads.v1.services.UserInterestService.GetUserInterest].
message GetUserInterestRequest {
// Resource name of the UserInterest to fetch.
string resource_name = 1;

12
google/ads/googleads/v1/services/user_list_service.proto
View File

@ -37,14 +37,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage user lists.
service UserListService {
// Returns the requested user list.
rpc GetUserList(GetUserListRequest) returns (google.ads.googleads.v1.resources.UserList) {
rpc GetUserList(GetUserListRequest)
returns (google.ads.googleads.v1.resources.UserList) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/userLists/*}"
};
}
// Creates or updates user lists. Operation statuses are returned.
rpc MutateUserLists(MutateUserListsRequest) returns (MutateUserListsResponse) {
rpc MutateUserLists(MutateUserListsRequest)
returns (MutateUserListsResponse) {
option (google.api.http) = {
post: "/v1/customers/{customer_id=*}/userLists:mutate"
body: "*"
@ -52,13 +54,15 @@ service UserListService {
}
}
// Request message for [UserListService.GetUserList][google.ads.googleads.v1.services.UserListService.GetUserList].
// Request message for
// [UserListService.GetUserList][google.ads.googleads.v1.services.UserListService.GetUserList].
message GetUserListRequest {
// The resource name of the user list to fetch.
string resource_name = 1;
}
// Request message for [UserListService.MutateUserLists][google.ads.googleads.v1.services.UserListService.MutateUserLists].
// Request message for
// [UserListService.MutateUserLists][google.ads.googleads.v1.services.UserListService.MutateUserLists].
message MutateUserListsRequest {
// The ID of the customer whose user lists are being modified.
string customer_id = 1;

6
google/ads/googleads/v1/services/video_service.proto
View File

@ -34,14 +34,16 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services";
// Service to manage videos.
service VideoService {
// Returns the requested video in full detail.
rpc GetVideo(GetVideoRequest) returns (google.ads.googleads.v1.resources.Video) {
rpc GetVideo(GetVideoRequest)
returns (google.ads.googleads.v1.resources.Video) {
option (google.api.http) = {
get: "/v1/{resource_name=customers/*/videos/*}"
};
}
}
// Request message for [VideoService.GetVideo][google.ads.googleads.v1.services.VideoService.GetVideo].
// Request message for
// [VideoService.GetVideo][google.ads.googleads.v1.services.VideoService.GetVideo].
message GetVideoRequest {
// The resource name of the video to fetch.
string resource_name = 1;