google-ads-api 8.1.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,9 @@
1
1
  "use strict";
2
2
  /* Autogenerated File! Do Not Edit */
3
3
  Object.defineProperty(exports, "__esModule", { value: true });
4
- exports.combinedAudience = exports.clickView = exports.changeStatus = exports.changeEvent = exports.carrierConstant = exports.campaignSimulation = exports.campaignSharedSet = exports.campaignLabel = exports.campaignFeed = exports.campaignExtensionSetting = exports.campaignExperiment = exports.campaignDraft = exports.campaignCriterionSimulation = exports.campaignCriterion = exports.campaignBudget = exports.campaignBidModifier = exports.campaignAudienceView = exports.campaignAsset = exports.campaign = exports.callView = exports.billingSetup = exports.biddingStrategySimulation = exports.biddingStrategy = exports.biddingSeasonalityAdjustment = exports.biddingDataExclusion = exports.batchJob = exports.assetFieldTypeView = exports.asset = exports.ageRangeView = exports.adScheduleView = exports.adParameter = exports.adGroupSimulation = exports.adGroupLabel = exports.adGroupFeed = exports.adGroupExtensionSetting = exports.adGroupCriterionSimulation = exports.adGroupCriterionLabel = exports.adGroupCriterion = exports.adGroupBidModifier = exports.adGroupAudienceView = exports.adGroupAsset = exports.adGroupAdLabel = exports.adGroupAdAssetView = exports.adGroupAd = exports.adGroup = exports.ad = exports.accountLink = exports.accountBudgetProposal = exports.accountBudget = exports.accessibleBiddingStrategy = void 0;
5
- exports.label = exports.keywordView = exports.keywordThemeConstant = exports.keywordPlanCampaignKeyword = exports.keywordPlanCampaign = exports.keywordPlanAdGroupKeyword = exports.keywordPlanAdGroup = exports.keywordPlan = exports.invoice = exports.incomeRangeView = exports.hotelPerformanceView = exports.hotelGroupView = exports.groupPlacementView = exports.googleAdsField = exports.geographicView = exports.geoTargetConstant = exports.genderView = exports.feedPlaceholderView = exports.feedMapping = exports.feedItemTarget = exports.feedItemSetLink = exports.feedItemSet = exports.feedItem = exports.feed = exports.extensionFeedItem = exports.expandedLandingPageView = exports.dynamicSearchAdsSearchTermView = exports.domainCategory = exports.distanceView = exports.displayKeywordView = exports.detailedDemographic = exports.detailPlacementView = exports.customerUserAccessInvitation = exports.customerUserAccess = exports.customerNegativeCriterion = exports.customerManagerLink = exports.customerLabel = exports.customerFeed = exports.customerExtensionSetting = exports.customerClientLink = exports.customerClient = exports.customerAsset = exports.customer = exports.customInterest = exports.customAudience = exports.currencyConstant = exports.conversionValueRuleSet = exports.conversionValueRule = exports.conversionCustomVariable = exports.conversionAction = void 0;
6
- exports.webpageView = exports.video = exports.userLocationView = exports.userList = exports.userInterest = exports.topicView = exports.topicConstant = exports.thirdPartyAppAnalyticsLink = exports.smartCampaignSetting = exports.smartCampaignSearchTermView = exports.shoppingPerformanceView = exports.sharedSet = exports.sharedCriterion = exports.searchTermView = exports.remarketingAction = exports.recommendation = exports.productGroupView = exports.productBiddingCategoryConstant = exports.paymentsAccount = exports.parentalStatusView = exports.paidOrganicSearchTermView = exports.operatingSystemVersionConstant = exports.offlineUserDataJob = exports.mobileDeviceConstant = exports.mobileAppCategoryConstant = exports.merchantCenterLink = exports.mediaFile = exports.managedPlacementView = exports.locationView = exports.lifeEvent = exports.languageConstant = exports.landingPageView = void 0;
4
+ exports.campaignDraft = exports.campaignCustomizer = exports.campaignCriterionSimulation = exports.campaignCriterion = exports.campaignConversionGoal = exports.campaignBudget = exports.campaignBidModifier = exports.campaignAudienceView = exports.campaignAssetSet = exports.campaignAsset = exports.campaign = exports.callView = exports.billingSetup = exports.biddingStrategySimulation = exports.biddingStrategy = exports.biddingSeasonalityAdjustment = exports.biddingDataExclusion = exports.batchJob = exports.assetSetAsset = exports.assetSet = exports.assetGroupProductGroupView = exports.assetGroupListingGroupFilter = exports.assetGroupAsset = exports.assetGroup = exports.assetFieldTypeView = exports.asset = exports.ageRangeView = exports.adScheduleView = exports.adParameter = exports.adGroupSimulation = exports.adGroupLabel = exports.adGroupFeed = exports.adGroupExtensionSetting = exports.adGroupCustomizer = exports.adGroupCriterionSimulation = exports.adGroupCriterionLabel = exports.adGroupCriterionCustomizer = exports.adGroupCriterion = exports.adGroupBidModifier = exports.adGroupAudienceView = exports.adGroupAsset = exports.adGroupAdLabel = exports.adGroupAdAssetView = exports.adGroupAd = exports.adGroup = exports.ad = exports.accountLink = exports.accountBudgetProposal = exports.accountBudget = exports.accessibleBiddingStrategy = void 0;
5
+ exports.genderView = exports.feedPlaceholderView = exports.feedMapping = exports.feedItemTarget = exports.feedItemSetLink = exports.feedItemSet = exports.feedItem = exports.feed = exports.extensionFeedItem = exports.expandedLandingPageView = exports.dynamicSearchAdsSearchTermView = exports.domainCategory = exports.distanceView = exports.displayKeywordView = exports.detailedDemographic = exports.detailPlacementView = exports.customizerAttribute = exports.customerUserAccessInvitation = exports.customerUserAccess = exports.customerNegativeCriterion = exports.customerManagerLink = exports.customerLabel = exports.customerFeed = exports.customerExtensionSetting = exports.customerCustomizer = exports.customerConversionGoal = exports.customerClientLink = exports.customerClient = exports.customerAsset = exports.customer = exports.customInterest = exports.customConversionGoal = exports.customAudience = exports.currencyConstant = exports.conversionValueRuleSet = exports.conversionValueRule = exports.conversionGoalCampaignConfig = exports.conversionCustomVariable = exports.conversionAction = exports.combinedAudience = exports.clickView = exports.changeStatus = exports.changeEvent = exports.carrierConstant = exports.campaignSimulation = exports.campaignSharedSet = exports.campaignLabel = exports.campaignFeed = exports.campaignExtensionSetting = exports.campaignExperiment = void 0;
6
+ exports.webpageView = exports.video = exports.userLocationView = exports.userList = exports.userInterest = exports.topicView = exports.topicConstant = exports.thirdPartyAppAnalyticsLink = exports.smartCampaignSetting = exports.smartCampaignSearchTermView = exports.shoppingPerformanceView = exports.sharedSet = exports.sharedCriterion = exports.searchTermView = exports.remarketingAction = exports.recommendation = exports.productGroupView = exports.productBiddingCategoryConstant = exports.paymentsAccount = exports.parentalStatusView = exports.paidOrganicSearchTermView = exports.operatingSystemVersionConstant = exports.offlineUserDataJob = exports.mobileDeviceConstant = exports.mobileAppCategoryConstant = exports.merchantCenterLink = exports.mediaFile = exports.managedPlacementView = exports.locationView = exports.lifeEvent = exports.languageConstant = exports.landingPageView = exports.label = exports.keywordView = exports.keywordThemeConstant = exports.keywordPlanCampaignKeyword = exports.keywordPlanCampaign = exports.keywordPlanAdGroupKeyword = exports.keywordPlanAdGroup = exports.keywordPlan = exports.invoice = exports.incomeRangeView = exports.hotelReconciliation = exports.hotelPerformanceView = exports.hotelGroupView = exports.groupPlacementView = exports.googleAdsField = exports.geographicView = exports.geoTargetConstant = void 0;
7
7
  /**
8
8
  * @param {string | number} customerId
9
9
  * @param {string | number} biddingStrategyId
@@ -145,6 +145,18 @@ function adGroupCriterion(customerId, adGroupId, criterionId) {
145
145
  return "customers/" + customerId + "/adGroupCriteria/" + adGroupId + "~" + criterionId;
146
146
  }
147
147
  exports.adGroupCriterion = adGroupCriterion;
148
+ /**
149
+ * @param {string | number} customerId
150
+ * @param {string | number} adGroupId
151
+ * @param {string | number} criterionId
152
+ * @param {string | number} customizerAttributeId
153
+ * @returns `AdGroupCriterionCustomizerResourceName`
154
+ * @example const adGroupCriterionCustomizer: ResourceNames.AdGroupCriterionCustomizerResourceName = ResourceNames.adGroupCriterionCustomizer(10987417, 21974834, 43949668, 87899336)
155
+ */
156
+ function adGroupCriterionCustomizer(customerId, adGroupId, criterionId, customizerAttributeId) {
157
+ return "customers/" + customerId + "/adGroupCriterionCustomizers/" + adGroupId + "~" + criterionId + "~" + customizerAttributeId;
158
+ }
159
+ exports.adGroupCriterionCustomizer = adGroupCriterionCustomizer;
148
160
  /**
149
161
  * @param {string | number} customerId
150
162
  * @param {string | number} adGroupId
@@ -172,6 +184,17 @@ function adGroupCriterionSimulation(customerId, adGroupId, criterionId, type, mo
172
184
  return "customers/" + customerId + "/adGroupCriterionSimulations/" + adGroupId + "~" + criterionId + "~" + type + "~" + modificationMethod + "~" + startDate + "~" + endDate;
173
185
  }
174
186
  exports.adGroupCriterionSimulation = adGroupCriterionSimulation;
187
+ /**
188
+ * @param {string | number} customerId
189
+ * @param {string | number} adGroupId
190
+ * @param {string | number} customizerAttributeId
191
+ * @returns `AdGroupCustomizerResourceName`
192
+ * @example const adGroupCustomizer: ResourceNames.AdGroupCustomizerResourceName = ResourceNames.adGroupCustomizer(10987417, 21974834, 43949668)
193
+ */
194
+ function adGroupCustomizer(customerId, adGroupId, customizerAttributeId) {
195
+ return "customers/" + customerId + "/adGroupCustomizers/" + adGroupId + "~" + customizerAttributeId;
196
+ }
197
+ exports.adGroupCustomizer = adGroupCustomizer;
175
198
  /**
176
199
  * @param {string | number} customerId
177
200
  * @param {string | number} adGroupId
@@ -273,6 +296,71 @@ function assetFieldTypeView(customerId, fieldType) {
273
296
  return "customers/" + customerId + "/assetFieldTypeViews/" + fieldType;
274
297
  }
275
298
  exports.assetFieldTypeView = assetFieldTypeView;
299
+ /**
300
+ * @param {string | number} customerId
301
+ * @param {string | number} assetGroupId
302
+ * @returns `AssetGroupResourceName`
303
+ * @example const assetGroup: ResourceNames.AssetGroupResourceName = ResourceNames.assetGroup(10987417, 21974834)
304
+ */
305
+ function assetGroup(customerId, assetGroupId) {
306
+ return "customers/" + customerId + "/assetGroups/" + assetGroupId;
307
+ }
308
+ exports.assetGroup = assetGroup;
309
+ /**
310
+ * @param {string | number} customerId
311
+ * @param {string | number} assetGroupId
312
+ * @param {string | number} assetId
313
+ * @param {string | number} fieldType
314
+ * @returns `AssetGroupAssetResourceName`
315
+ * @example const assetGroupAsset: ResourceNames.AssetGroupAssetResourceName = ResourceNames.assetGroupAsset(10987417, 21974834, 43949668, 87899336)
316
+ */
317
+ function assetGroupAsset(customerId, assetGroupId, assetId, fieldType) {
318
+ return "customers/" + customerId + "/assetGroupAssets/" + assetGroupId + "~" + assetId + "~" + fieldType;
319
+ }
320
+ exports.assetGroupAsset = assetGroupAsset;
321
+ /**
322
+ * @param {string | number} customerId
323
+ * @param {string | number} assetGroupId
324
+ * @param {string | number} listingGroupFilterId
325
+ * @returns `AssetGroupListingGroupFilterResourceName`
326
+ * @example const assetGroupListingGroupFilter: ResourceNames.AssetGroupListingGroupFilterResourceName = ResourceNames.assetGroupListingGroupFilter(10987417, 21974834, 43949668)
327
+ */
328
+ function assetGroupListingGroupFilter(customerId, assetGroupId, listingGroupFilterId) {
329
+ return "customers/" + customerId + "/assetGroupListingGroupFilters/" + assetGroupId + "~" + listingGroupFilterId;
330
+ }
331
+ exports.assetGroupListingGroupFilter = assetGroupListingGroupFilter;
332
+ /**
333
+ * @param {string | number} customerId
334
+ * @param {string | number} assetGroupId
335
+ * @param {string | number} listingGroupFilterId
336
+ * @returns `AssetGroupProductGroupViewResourceName`
337
+ * @example const assetGroupProductGroupView: ResourceNames.AssetGroupProductGroupViewResourceName = ResourceNames.assetGroupProductGroupView(10987417, 21974834, 43949668)
338
+ */
339
+ function assetGroupProductGroupView(customerId, assetGroupId, listingGroupFilterId) {
340
+ return "customers/" + customerId + "/assetGroupProductGroupViews/" + assetGroupId + "~" + listingGroupFilterId;
341
+ }
342
+ exports.assetGroupProductGroupView = assetGroupProductGroupView;
343
+ /**
344
+ * @param {string | number} customerId
345
+ * @param {string | number} assetSetId
346
+ * @returns `AssetSetResourceName`
347
+ * @example const assetSet: ResourceNames.AssetSetResourceName = ResourceNames.assetSet(10987417, 21974834)
348
+ */
349
+ function assetSet(customerId, assetSetId) {
350
+ return "customers/" + customerId + "/assetSets/" + assetSetId;
351
+ }
352
+ exports.assetSet = assetSet;
353
+ /**
354
+ * @param {string | number} customerId
355
+ * @param {string | number} assetSetId
356
+ * @param {string | number} assetId
357
+ * @returns `AssetSetAssetResourceName`
358
+ * @example const assetSetAsset: ResourceNames.AssetSetAssetResourceName = ResourceNames.assetSetAsset(10987417, 21974834, 43949668)
359
+ */
360
+ function assetSetAsset(customerId, assetSetId, assetId) {
361
+ return "customers/" + customerId + "/assetSetAssets/" + assetSetId + "~" + assetId;
362
+ }
363
+ exports.assetSetAsset = assetSetAsset;
276
364
  /**
277
365
  * @param {string | number} customerId
278
366
  * @param {string | number} batchJobId
@@ -369,6 +457,17 @@ function campaignAsset(customerId, campaignId, assetId, fieldType) {
369
457
  return "customers/" + customerId + "/campaignAssets/" + campaignId + "~" + assetId + "~" + fieldType;
370
458
  }
371
459
  exports.campaignAsset = campaignAsset;
460
+ /**
461
+ * @param {string | number} customerId
462
+ * @param {string | number} campaignId
463
+ * @param {string | number} assetSetId
464
+ * @returns `CampaignAssetSetResourceName`
465
+ * @example const campaignAssetSet: ResourceNames.CampaignAssetSetResourceName = ResourceNames.campaignAssetSet(10987417, 21974834, 43949668)
466
+ */
467
+ function campaignAssetSet(customerId, campaignId, assetSetId) {
468
+ return "customers/" + customerId + "/campaignAssetSets/" + campaignId + "~" + assetSetId;
469
+ }
470
+ exports.campaignAssetSet = campaignAssetSet;
372
471
  /**
373
472
  * @param {string | number} customerId
374
473
  * @param {string | number} campaignId
@@ -401,6 +500,18 @@ function campaignBudget(customerId, campaignBudgetId) {
401
500
  return "customers/" + customerId + "/campaignBudgets/" + campaignBudgetId;
402
501
  }
403
502
  exports.campaignBudget = campaignBudget;
503
+ /**
504
+ * @param {string | number} customerId
505
+ * @param {string | number} campaignId
506
+ * @param {string | number} category
507
+ * @param {string | number} source
508
+ * @returns `CampaignConversionGoalResourceName`
509
+ * @example const campaignConversionGoal: ResourceNames.CampaignConversionGoalResourceName = ResourceNames.campaignConversionGoal(10987417, 21974834, 43949668, 87899336)
510
+ */
511
+ function campaignConversionGoal(customerId, campaignId, category, source) {
512
+ return "customers/" + customerId + "/campaignConversionGoals/" + campaignId + "~" + category + "~" + source;
513
+ }
514
+ exports.campaignConversionGoal = campaignConversionGoal;
404
515
  /**
405
516
  * @param {string | number} customerId
406
517
  * @param {string | number} campaignId
@@ -427,6 +538,17 @@ function campaignCriterionSimulation(customerId, campaignId, criterionId, type,
427
538
  return "customers/" + customerId + "/campaignCriterionSimulations/" + campaignId + "~" + criterionId + "~" + type + "~" + modificationMethod + "~" + startDate + "~" + endDate;
428
539
  }
429
540
  exports.campaignCriterionSimulation = campaignCriterionSimulation;
541
+ /**
542
+ * @param {string | number} customerId
543
+ * @param {string | number} campaignId
544
+ * @param {string | number} customizerAttributeId
545
+ * @returns `CampaignCustomizerResourceName`
546
+ * @example const campaignCustomizer: ResourceNames.CampaignCustomizerResourceName = ResourceNames.campaignCustomizer(10987417, 21974834, 43949668)
547
+ */
548
+ function campaignCustomizer(customerId, campaignId, customizerAttributeId) {
549
+ return "customers/" + customerId + "/campaignCustomizers/" + campaignId + "~" + customizerAttributeId;
550
+ }
551
+ exports.campaignCustomizer = campaignCustomizer;
430
552
  /**
431
553
  * @param {string | number} customerId
432
554
  * @param {string | number} baseCampaignId
@@ -578,6 +700,16 @@ function conversionCustomVariable(customerId, conversionCustomVariableId) {
578
700
  return "customers/" + customerId + "/conversionCustomVariables/" + conversionCustomVariableId;
579
701
  }
580
702
  exports.conversionCustomVariable = conversionCustomVariable;
703
+ /**
704
+ * @param {string | number} customerId
705
+ * @param {string | number} campaignId
706
+ * @returns `ConversionGoalCampaignConfigResourceName`
707
+ * @example const conversionGoalCampaignConfig: ResourceNames.ConversionGoalCampaignConfigResourceName = ResourceNames.conversionGoalCampaignConfig(10987417, 21974834)
708
+ */
709
+ function conversionGoalCampaignConfig(customerId, campaignId) {
710
+ return "customers/" + customerId + "/conversionGoalCampaignConfigs/" + campaignId;
711
+ }
712
+ exports.conversionGoalCampaignConfig = conversionGoalCampaignConfig;
581
713
  /**
582
714
  * @param {string | number} customerId
583
715
  * @param {string | number} conversionValueRuleId
@@ -617,6 +749,16 @@ function customAudience(customerId, customAudienceId) {
617
749
  return "customers/" + customerId + "/customAudiences/" + customAudienceId;
618
750
  }
619
751
  exports.customAudience = customAudience;
752
+ /**
753
+ * @param {string | number} customerId
754
+ * @param {string | number} goalId
755
+ * @returns `CustomConversionGoalResourceName`
756
+ * @example const customConversionGoal: ResourceNames.CustomConversionGoalResourceName = ResourceNames.customConversionGoal(10987417, 21974834)
757
+ */
758
+ function customConversionGoal(customerId, goalId) {
759
+ return "customers/" + customerId + "/customConversionGoals/" + goalId;
760
+ }
761
+ exports.customConversionGoal = customConversionGoal;
620
762
  /**
621
763
  * @param {string | number} customerId
622
764
  * @param {string | number} customInterestId
@@ -668,6 +810,27 @@ function customerClientLink(customerId, clientCustomerId, managerLinkId) {
668
810
  return "customers/" + customerId + "/customerClientLinks/" + clientCustomerId + "~" + managerLinkId;
669
811
  }
670
812
  exports.customerClientLink = customerClientLink;
813
+ /**
814
+ * @param {string | number} customerId
815
+ * @param {string | number} category
816
+ * @param {string | number} source
817
+ * @returns `CustomerConversionGoalResourceName`
818
+ * @example const customerConversionGoal: ResourceNames.CustomerConversionGoalResourceName = ResourceNames.customerConversionGoal(10987417, 21974834, 43949668)
819
+ */
820
+ function customerConversionGoal(customerId, category, source) {
821
+ return "customers/" + customerId + "/customerConversionGoals/" + category + "~" + source;
822
+ }
823
+ exports.customerConversionGoal = customerConversionGoal;
824
+ /**
825
+ * @param {string | number} customerId
826
+ * @param {string | number} customizerAttributeId
827
+ * @returns `CustomerCustomizerResourceName`
828
+ * @example const customerCustomizer: ResourceNames.CustomerCustomizerResourceName = ResourceNames.customerCustomizer(10987417, 21974834)
829
+ */
830
+ function customerCustomizer(customerId, customizerAttributeId) {
831
+ return "customers/" + customerId + "/customerCustomizers/" + customizerAttributeId;
832
+ }
833
+ exports.customerCustomizer = customerCustomizer;
671
834
  /**
672
835
  * @param {string | number} customerId
673
836
  * @param {string | number} extensionType
@@ -739,6 +902,16 @@ function customerUserAccessInvitation(customerId, invitationId) {
739
902
  return "customers/" + customerId + "/customerUserAccessInvitations/" + invitationId;
740
903
  }
741
904
  exports.customerUserAccessInvitation = customerUserAccessInvitation;
905
+ /**
906
+ * @param {string | number} customerId
907
+ * @param {string | number} customizerAttributeId
908
+ * @returns `CustomizerAttributeResourceName`
909
+ * @example const customizerAttribute: ResourceNames.CustomizerAttributeResourceName = ResourceNames.customizerAttribute(10987417, 21974834)
910
+ */
911
+ function customizerAttribute(customerId, customizerAttributeId) {
912
+ return "customers/" + customerId + "/customizerAttributes/" + customizerAttributeId;
913
+ }
914
+ exports.customizerAttribute = customizerAttribute;
742
915
  /**
743
916
  * @param {string | number} customerId
744
917
  * @param {string | number} adGroupId
@@ -977,6 +1150,16 @@ function hotelPerformanceView(customerId) {
977
1150
  return "customers/" + customerId + "/hotelPerformanceView";
978
1151
  }
979
1152
  exports.hotelPerformanceView = hotelPerformanceView;
1153
+ /**
1154
+ * @param {string | number} customerId
1155
+ * @param {string | number} commissionId
1156
+ * @returns `HotelReconciliationResourceName`
1157
+ * @example const hotelReconciliation: ResourceNames.HotelReconciliationResourceName = ResourceNames.hotelReconciliation(10987417, 21974834)
1158
+ */
1159
+ function hotelReconciliation(customerId, commissionId) {
1160
+ return "customers/" + customerId + "/hotelReconciliations/" + commissionId;
1161
+ }
1162
+ exports.hotelReconciliation = hotelReconciliation;
980
1163
  /**
981
1164
  * @param {string | number} customerId
982
1165
  * @param {string | number} adGroupId