@google-ads/admanager 0.5.0 → 0.5.1

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.
Files changed (198) hide show
  1. package/README.md +15 -0
  2. package/build/protos/google/ads/admanager/v1/ad_review_center_ad_service.proto +4 -3
  3. package/build/protos/google/ads/admanager/v1/ad_unit_service.proto +216 -0
  4. package/build/protos/google/ads/admanager/v1/cms_metadata_value_service.proto +2 -2
  5. package/build/protos/google/ads/admanager/v1/custom_targeting_key_service.proto +190 -0
  6. package/build/protos/google/ads/admanager/v1/goal.proto +57 -0
  7. package/build/protos/google/ads/admanager/v1/goal_enums.proto +129 -0
  8. package/build/protos/google/ads/admanager/v1/line_item_enums.proto +86 -0
  9. package/build/protos/google/ads/admanager/v1/line_item_messages.proto +93 -0
  10. package/build/protos/google/ads/admanager/v1/line_item_service.proto +128 -0
  11. package/build/protos/google/ads/admanager/v1/network_messages.proto +8 -8
  12. package/build/protos/google/ads/admanager/v1/network_service.proto +32 -1
  13. package/build/protos/google/ads/admanager/v1/order_messages.proto +4 -2
  14. package/build/protos/google/ads/admanager/v1/report_definition.proto +927 -58
  15. package/build/protos/google/ads/admanager/v1/report_messages.proto +7 -2
  16. package/build/protos/protos.d.ts +9435 -5893
  17. package/build/protos/protos.js +29871 -20651
  18. package/build/protos/protos.json +1191 -105
  19. package/build/src/index.d.ts +4 -1
  20. package/build/src/index.js +5 -3
  21. package/build/src/index.js.map +1 -1
  22. package/build/src/v1/ad_break_service_client.d.ts +24 -0
  23. package/build/src/v1/ad_break_service_client.js +35 -1
  24. package/build/src/v1/ad_break_service_client.js.map +1 -1
  25. package/build/src/v1/ad_break_service_proto_list.json +5 -0
  26. package/build/src/v1/ad_review_center_ad_service_client.d.ts +36 -9
  27. package/build/src/v1/ad_review_center_ad_service_client.js +43 -7
  28. package/build/src/v1/ad_review_center_ad_service_client.js.map +1 -1
  29. package/build/src/v1/ad_review_center_ad_service_proto_list.json +5 -0
  30. package/build/src/v1/ad_unit_service_client.d.ts +214 -0
  31. package/build/src/v1/ad_unit_service_client.js +288 -2
  32. package/build/src/v1/ad_unit_service_client.js.map +1 -1
  33. package/build/src/v1/ad_unit_service_client_config.json +28 -0
  34. package/build/src/v1/ad_unit_service_proto_list.json +5 -0
  35. package/build/src/v1/application_service_client.d.ts +24 -0
  36. package/build/src/v1/application_service_client.js +35 -1
  37. package/build/src/v1/application_service_client.js.map +1 -1
  38. package/build/src/v1/application_service_proto_list.json +5 -0
  39. package/build/src/v1/audience_segment_service_client.d.ts +24 -0
  40. package/build/src/v1/audience_segment_service_client.js +35 -1
  41. package/build/src/v1/audience_segment_service_client.js.map +1 -1
  42. package/build/src/v1/audience_segment_service_proto_list.json +5 -0
  43. package/build/src/v1/bandwidth_group_service_client.d.ts +24 -0
  44. package/build/src/v1/bandwidth_group_service_client.js +35 -1
  45. package/build/src/v1/bandwidth_group_service_client.js.map +1 -1
  46. package/build/src/v1/bandwidth_group_service_proto_list.json +5 -0
  47. package/build/src/v1/browser_language_service_client.d.ts +24 -0
  48. package/build/src/v1/browser_language_service_client.js +35 -1
  49. package/build/src/v1/browser_language_service_client.js.map +1 -1
  50. package/build/src/v1/browser_language_service_proto_list.json +5 -0
  51. package/build/src/v1/browser_service_client.d.ts +24 -0
  52. package/build/src/v1/browser_service_client.js +35 -1
  53. package/build/src/v1/browser_service_client.js.map +1 -1
  54. package/build/src/v1/browser_service_proto_list.json +5 -0
  55. package/build/src/v1/cms_metadata_key_service_client.d.ts +24 -0
  56. package/build/src/v1/cms_metadata_key_service_client.js +35 -1
  57. package/build/src/v1/cms_metadata_key_service_client.js.map +1 -1
  58. package/build/src/v1/cms_metadata_key_service_proto_list.json +5 -0
  59. package/build/src/v1/cms_metadata_value_service_client.d.ts +26 -2
  60. package/build/src/v1/cms_metadata_value_service_client.js +35 -1
  61. package/build/src/v1/cms_metadata_value_service_client.js.map +1 -1
  62. package/build/src/v1/cms_metadata_value_service_proto_list.json +5 -0
  63. package/build/src/v1/company_service_client.d.ts +24 -0
  64. package/build/src/v1/company_service_client.js +35 -1
  65. package/build/src/v1/company_service_client.js.map +1 -1
  66. package/build/src/v1/company_service_proto_list.json +5 -0
  67. package/build/src/v1/contact_service_client.d.ts +24 -0
  68. package/build/src/v1/contact_service_client.js +35 -1
  69. package/build/src/v1/contact_service_client.js.map +1 -1
  70. package/build/src/v1/contact_service_proto_list.json +5 -0
  71. package/build/src/v1/content_bundle_service_client.d.ts +24 -0
  72. package/build/src/v1/content_bundle_service_client.js +35 -1
  73. package/build/src/v1/content_bundle_service_client.js.map +1 -1
  74. package/build/src/v1/content_bundle_service_proto_list.json +5 -0
  75. package/build/src/v1/content_label_service_client.d.ts +24 -0
  76. package/build/src/v1/content_label_service_client.js +35 -1
  77. package/build/src/v1/content_label_service_client.js.map +1 -1
  78. package/build/src/v1/content_label_service_proto_list.json +5 -0
  79. package/build/src/v1/content_service_client.d.ts +24 -0
  80. package/build/src/v1/content_service_client.js +35 -1
  81. package/build/src/v1/content_service_client.js.map +1 -1
  82. package/build/src/v1/content_service_proto_list.json +5 -0
  83. package/build/src/v1/creative_template_service_client.d.ts +24 -0
  84. package/build/src/v1/creative_template_service_client.js +35 -1
  85. package/build/src/v1/creative_template_service_client.js.map +1 -1
  86. package/build/src/v1/creative_template_service_proto_list.json +5 -0
  87. package/build/src/v1/custom_field_service_client.d.ts +24 -0
  88. package/build/src/v1/custom_field_service_client.js +35 -1
  89. package/build/src/v1/custom_field_service_client.js.map +1 -1
  90. package/build/src/v1/custom_field_service_proto_list.json +5 -0
  91. package/build/src/v1/custom_targeting_key_service_client.d.ts +190 -0
  92. package/build/src/v1/custom_targeting_key_service_client.js +252 -2
  93. package/build/src/v1/custom_targeting_key_service_client.js.map +1 -1
  94. package/build/src/v1/custom_targeting_key_service_client_config.json +24 -0
  95. package/build/src/v1/custom_targeting_key_service_proto_list.json +5 -0
  96. package/build/src/v1/custom_targeting_value_service_client.d.ts +24 -0
  97. package/build/src/v1/custom_targeting_value_service_client.js +35 -1
  98. package/build/src/v1/custom_targeting_value_service_client.js.map +1 -1
  99. package/build/src/v1/custom_targeting_value_service_proto_list.json +5 -0
  100. package/build/src/v1/device_capability_service_client.d.ts +24 -0
  101. package/build/src/v1/device_capability_service_client.js +35 -1
  102. package/build/src/v1/device_capability_service_client.js.map +1 -1
  103. package/build/src/v1/device_capability_service_proto_list.json +5 -0
  104. package/build/src/v1/device_category_service_client.d.ts +24 -0
  105. package/build/src/v1/device_category_service_client.js +35 -1
  106. package/build/src/v1/device_category_service_client.js.map +1 -1
  107. package/build/src/v1/device_category_service_proto_list.json +5 -0
  108. package/build/src/v1/device_manufacturer_service_client.d.ts +24 -0
  109. package/build/src/v1/device_manufacturer_service_client.js +35 -1
  110. package/build/src/v1/device_manufacturer_service_client.js.map +1 -1
  111. package/build/src/v1/device_manufacturer_service_proto_list.json +5 -0
  112. package/build/src/v1/entity_signals_mapping_service_client.d.ts +24 -0
  113. package/build/src/v1/entity_signals_mapping_service_client.js +35 -1
  114. package/build/src/v1/entity_signals_mapping_service_client.js.map +1 -1
  115. package/build/src/v1/entity_signals_mapping_service_proto_list.json +5 -0
  116. package/build/src/v1/gapic_metadata.json +174 -2
  117. package/build/src/v1/geo_target_service_client.d.ts +24 -0
  118. package/build/src/v1/geo_target_service_client.js +35 -1
  119. package/build/src/v1/geo_target_service_client.js.map +1 -1
  120. package/build/src/v1/geo_target_service_proto_list.json +5 -0
  121. package/build/src/v1/index.d.ts +1 -0
  122. package/build/src/v1/index.js +4 -2
  123. package/build/src/v1/index.js.map +1 -1
  124. package/build/src/v1/line_item_service_client.d.ts +1369 -0
  125. package/build/src/v1/line_item_service_client.js +2027 -0
  126. package/build/src/v1/line_item_service_client.js.map +1 -0
  127. package/build/src/v1/line_item_service_client_config.json +34 -0
  128. package/build/src/v1/line_item_service_proto_list.json +127 -0
  129. package/build/src/v1/mobile_carrier_service_client.d.ts +24 -0
  130. package/build/src/v1/mobile_carrier_service_client.js +35 -1
  131. package/build/src/v1/mobile_carrier_service_client.js.map +1 -1
  132. package/build/src/v1/mobile_carrier_service_proto_list.json +5 -0
  133. package/build/src/v1/mobile_device_service_client.d.ts +24 -0
  134. package/build/src/v1/mobile_device_service_client.js +35 -1
  135. package/build/src/v1/mobile_device_service_client.js.map +1 -1
  136. package/build/src/v1/mobile_device_service_proto_list.json +5 -0
  137. package/build/src/v1/mobile_device_submodel_service_client.d.ts +24 -0
  138. package/build/src/v1/mobile_device_submodel_service_client.js +35 -1
  139. package/build/src/v1/mobile_device_submodel_service_client.js.map +1 -1
  140. package/build/src/v1/mobile_device_submodel_service_proto_list.json +5 -0
  141. package/build/src/v1/network_service_client.d.ts +114 -12
  142. package/build/src/v1/network_service_client.js +133 -16
  143. package/build/src/v1/network_service_client.js.map +1 -1
  144. package/build/src/v1/network_service_proto_list.json +5 -0
  145. package/build/src/v1/operating_system_service_client.d.ts +24 -0
  146. package/build/src/v1/operating_system_service_client.js +35 -1
  147. package/build/src/v1/operating_system_service_client.js.map +1 -1
  148. package/build/src/v1/operating_system_service_proto_list.json +5 -0
  149. package/build/src/v1/operating_system_version_service_client.d.ts +24 -0
  150. package/build/src/v1/operating_system_version_service_client.js +35 -1
  151. package/build/src/v1/operating_system_version_service_client.js.map +1 -1
  152. package/build/src/v1/operating_system_version_service_proto_list.json +5 -0
  153. package/build/src/v1/order_service_client.d.ts +24 -0
  154. package/build/src/v1/order_service_client.js +35 -1
  155. package/build/src/v1/order_service_client.js.map +1 -1
  156. package/build/src/v1/order_service_proto_list.json +5 -0
  157. package/build/src/v1/placement_service_client.d.ts +24 -0
  158. package/build/src/v1/placement_service_client.js +35 -1
  159. package/build/src/v1/placement_service_client.js.map +1 -1
  160. package/build/src/v1/placement_service_proto_list.json +5 -0
  161. package/build/src/v1/private_auction_deal_service_client.d.ts +24 -0
  162. package/build/src/v1/private_auction_deal_service_client.js +35 -1
  163. package/build/src/v1/private_auction_deal_service_client.js.map +1 -1
  164. package/build/src/v1/private_auction_deal_service_proto_list.json +5 -0
  165. package/build/src/v1/private_auction_service_client.d.ts +24 -0
  166. package/build/src/v1/private_auction_service_client.js +35 -1
  167. package/build/src/v1/private_auction_service_client.js.map +1 -1
  168. package/build/src/v1/private_auction_service_proto_list.json +5 -0
  169. package/build/src/v1/programmatic_buyer_service_client.d.ts +24 -0
  170. package/build/src/v1/programmatic_buyer_service_client.js +35 -1
  171. package/build/src/v1/programmatic_buyer_service_client.js.map +1 -1
  172. package/build/src/v1/programmatic_buyer_service_proto_list.json +5 -0
  173. package/build/src/v1/report_service_client.d.ts +24 -0
  174. package/build/src/v1/report_service_client.js +35 -1
  175. package/build/src/v1/report_service_client.js.map +1 -1
  176. package/build/src/v1/report_service_proto_list.json +5 -0
  177. package/build/src/v1/role_service_client.d.ts +24 -0
  178. package/build/src/v1/role_service_client.js +35 -1
  179. package/build/src/v1/role_service_client.js.map +1 -1
  180. package/build/src/v1/role_service_proto_list.json +5 -0
  181. package/build/src/v1/site_service_client.d.ts +24 -0
  182. package/build/src/v1/site_service_client.js +35 -1
  183. package/build/src/v1/site_service_client.js.map +1 -1
  184. package/build/src/v1/site_service_proto_list.json +5 -0
  185. package/build/src/v1/taxonomy_category_service_client.d.ts +24 -0
  186. package/build/src/v1/taxonomy_category_service_client.js +35 -1
  187. package/build/src/v1/taxonomy_category_service_client.js.map +1 -1
  188. package/build/src/v1/taxonomy_category_service_proto_list.json +5 -0
  189. package/build/src/v1/team_service_client.d.ts +24 -0
  190. package/build/src/v1/team_service_client.js +35 -1
  191. package/build/src/v1/team_service_client.js.map +1 -1
  192. package/build/src/v1/team_service_proto_list.json +5 -0
  193. package/build/src/v1/user_service_client.d.ts +24 -0
  194. package/build/src/v1/user_service_client.js +35 -1
  195. package/build/src/v1/user_service_client.js.map +1 -1
  196. package/build/src/v1/user_service_proto_list.json +5 -0
  197. package/package.json +10 -2
  198. package/LICENSE +0 -202
package/README.md CHANGED
@@ -65,9 +65,16 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
65
65
  | batch allow ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.batch_allow_ad_review_center_ads.js) |
66
66
  | batch block ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.batch_block_ad_review_center_ads.js) |
67
67
  | search ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.search_ad_review_center_ads.js) |
68
+ | batch activate ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_activate_ad_units.js) |
69
+ | batch archive ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_archive_ad_units.js) |
70
+ | batch create ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_create_ad_units.js) |
71
+ | batch deactivate ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_deactivate_ad_units.js) |
72
+ | batch update ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_update_ad_units.js) |
73
+ | create ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.create_ad_unit.js) |
68
74
  | get ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.get_ad_unit.js) |
69
75
  | list ad unit sizes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.list_ad_unit_sizes.js) |
70
76
  | list ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.list_ad_units.js) |
77
+ | update ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.update_ad_unit.js) |
71
78
  | get application | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/application_service.get_application.js) |
72
79
  | list applications | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/application_service.list_applications.js) |
73
80
  | get audience segment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/audience_segment_service.get_audience_segment.js) |
@@ -106,8 +113,14 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
106
113
  | get custom field | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.get_custom_field.js) |
107
114
  | list custom fields | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.list_custom_fields.js) |
108
115
  | update custom field | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.update_custom_field.js) |
116
+ | batch activate custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_activate_custom_targeting_keys.js) |
117
+ | batch create custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_create_custom_targeting_keys.js) |
118
+ | batch deactivate custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_deactivate_custom_targeting_keys.js) |
119
+ | batch update custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_update_custom_targeting_keys.js) |
120
+ | create custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.create_custom_targeting_key.js) |
109
121
  | get custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.get_custom_targeting_key.js) |
110
122
  | list custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.list_custom_targeting_keys.js) |
123
+ | update custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.update_custom_targeting_key.js) |
111
124
  | get custom targeting value | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_value_service.get_custom_targeting_value.js) |
112
125
  | list custom targeting values | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_value_service.list_custom_targeting_values.js) |
113
126
  | get device capability | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/device_capability_service.get_device_capability.js) |
@@ -124,6 +137,8 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
124
137
  | update entity signals mapping | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/entity_signals_mapping_service.update_entity_signals_mapping.js) |
125
138
  | get geo target | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/geo_target_service.get_geo_target.js) |
126
139
  | list geo targets | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/geo_target_service.list_geo_targets.js) |
140
+ | get line item | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/line_item_service.get_line_item.js) |
141
+ | list line items | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/line_item_service.list_line_items.js) |
127
142
  | get mobile carrier | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_carrier_service.get_mobile_carrier.js) |
128
143
  | list mobile carriers | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_carrier_service.list_mobile_carriers.js) |
129
144
  | get mobile device | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_device_service.get_mobile_device.js) |
@@ -117,11 +117,12 @@ message SearchAdReviewCenterAdsRequest {
117
117
  // is the value returned from a previous Search request, or empty.
118
118
  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
119
119
 
120
- // Required. Only return ads with the given status.
120
+ // Optional. Only return ads with the given status.
121
121
  AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus status = 4
122
- [(google.api.field_behavior) = REQUIRED];
122
+ [(google.api.field_behavior) = OPTIONAL];
123
123
 
124
- // Optional. If provided, only return ads with the given AdReviewCenterAd IDs.
124
+ // Optional. Only return ads with the given AdReviewCenterAd IDs. If provided,
125
+ // no other filter can be set (other than page size and page token).
125
126
  repeated string ad_review_center_ad_id = 5
126
127
  [(google.api.field_behavior) = OPTIONAL];
127
128
 
@@ -21,6 +21,7 @@ import "google/api/annotations.proto";
21
21
  import "google/api/client.proto";
22
22
  import "google/api/field_behavior.proto";
23
23
  import "google/api/resource.proto";
24
+ import "google/protobuf/field_mask.proto";
24
25
 
25
26
  option csharp_namespace = "Google.Ads.AdManager.V1";
26
27
  option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
@@ -60,6 +61,74 @@ service AdUnitService {
60
61
  };
61
62
  option (google.api.method_signature) = "parent";
62
63
  }
64
+
65
+ // API to create an `AdUnit` object.
66
+ rpc CreateAdUnit(CreateAdUnitRequest) returns (AdUnit) {
67
+ option (google.api.http) = {
68
+ post: "/v1/{parent=networks/*}/adUnits"
69
+ body: "ad_unit"
70
+ };
71
+ option (google.api.method_signature) = "parent,ad_unit";
72
+ }
73
+
74
+ // API to update an `AdUnit` object.
75
+ rpc UpdateAdUnit(UpdateAdUnitRequest) returns (AdUnit) {
76
+ option (google.api.http) = {
77
+ patch: "/v1/{ad_unit.name=networks/*/adUnits/*}"
78
+ body: "ad_unit"
79
+ };
80
+ option (google.api.method_signature) = "ad_unit,update_mask";
81
+ }
82
+
83
+ // API to batch create `AdUnit` objects.
84
+ rpc BatchCreateAdUnits(BatchCreateAdUnitsRequest)
85
+ returns (BatchCreateAdUnitsResponse) {
86
+ option (google.api.http) = {
87
+ post: "/v1/{parent=networks/*}/adUnits:batchCreate"
88
+ body: "*"
89
+ };
90
+ option (google.api.method_signature) = "parent,requests";
91
+ }
92
+
93
+ // API to batch update `AdUnit` objects.
94
+ rpc BatchUpdateAdUnits(BatchUpdateAdUnitsRequest)
95
+ returns (BatchUpdateAdUnitsResponse) {
96
+ option (google.api.http) = {
97
+ post: "/v1/{parent=networks/*}/adUnits:batchUpdate"
98
+ body: "*"
99
+ };
100
+ option (google.api.method_signature) = "parent,requests";
101
+ }
102
+
103
+ // API to batch activate `AdUnit` objects.
104
+ rpc BatchActivateAdUnits(BatchActivateAdUnitsRequest)
105
+ returns (BatchActivateAdUnitsResponse) {
106
+ option (google.api.http) = {
107
+ post: "/v1/{parent=networks/*}/adUnits:batchActivate"
108
+ body: "*"
109
+ };
110
+ option (google.api.method_signature) = "parent,names";
111
+ }
112
+
113
+ // Deactivates a list of `AdUnit` objects.
114
+ rpc BatchDeactivateAdUnits(BatchDeactivateAdUnitsRequest)
115
+ returns (BatchDeactivateAdUnitsResponse) {
116
+ option (google.api.http) = {
117
+ post: "/v1/{parent=networks/*}/adUnits:batchDeactivate"
118
+ body: "*"
119
+ };
120
+ option (google.api.method_signature) = "parent,names";
121
+ }
122
+
123
+ // Archives a list of `AdUnit` objects.
124
+ rpc BatchArchiveAdUnits(BatchArchiveAdUnitsRequest)
125
+ returns (BatchArchiveAdUnitsResponse) {
126
+ option (google.api.http) = {
127
+ post: "/v1/{parent=networks/*}/adUnits:batchArchive"
128
+ body: "*"
129
+ };
130
+ option (google.api.method_signature) = "parent,names";
131
+ }
63
132
  }
64
133
 
65
134
  // Request object for GetAdUnit method.
@@ -135,6 +204,84 @@ message ListAdUnitsResponse {
135
204
  int32 total_size = 3;
136
205
  }
137
206
 
207
+ // Request object for `CreateAdUnit` method.
208
+ message CreateAdUnitRequest {
209
+ // Required. The parent resource where this `AdUnit` will be created.
210
+ // Format: `networks/{network_code}`
211
+ string parent = 1 [
212
+ (google.api.field_behavior) = REQUIRED,
213
+ (google.api.resource_reference) = {
214
+ type: "admanager.googleapis.com/Network"
215
+ }
216
+ ];
217
+
218
+ // Required. The `AdUnit` to create.
219
+ AdUnit ad_unit = 2 [(google.api.field_behavior) = REQUIRED];
220
+ }
221
+
222
+ // Request object for `UpdateAdUnit` method.
223
+ message UpdateAdUnitRequest {
224
+ // Required. The `AdUnit` to update.
225
+ //
226
+ // The `AdUnit`'s name is used to identify the `AdUnit` to update. Format:
227
+ // `networks/{network_code}/adUnits/{ad_unit_id}`
228
+ AdUnit ad_unit = 1 [(google.api.field_behavior) = REQUIRED];
229
+
230
+ // Required. The list of fields to update.
231
+ google.protobuf.FieldMask update_mask = 2
232
+ [(google.api.field_behavior) = REQUIRED];
233
+ }
234
+
235
+ // Request object for `BatchCreateAdUnits` method.
236
+ message BatchCreateAdUnitsRequest {
237
+ // Required. The parent resource where `AdUnits` will be created.
238
+ // Format: `networks/{network_code}`
239
+ // The parent field in the CreateAdUnitRequest must match this
240
+ // field.
241
+ string parent = 1 [
242
+ (google.api.field_behavior) = REQUIRED,
243
+ (google.api.resource_reference) = {
244
+ type: "admanager.googleapis.com/Network"
245
+ }
246
+ ];
247
+
248
+ // Required. The `AdUnit` objects to create.
249
+ // A maximum of 100 objects can be created in a batch.
250
+ repeated CreateAdUnitRequest requests = 2
251
+ [(google.api.field_behavior) = REQUIRED];
252
+ }
253
+
254
+ // Response object for `BatchCreateAdUnits` method.
255
+ message BatchCreateAdUnitsResponse {
256
+ // The `AdUnit` objects created.
257
+ repeated AdUnit ad_units = 1;
258
+ }
259
+
260
+ // Request object for `BatchUpdateAdUnits` method.
261
+ message BatchUpdateAdUnitsRequest {
262
+ // Required. The parent resource where `AdUnits` will be updated.
263
+ // Format: `networks/{network_code}`
264
+ // The parent field in the UpdateAdUnitRequest must match this
265
+ // field.
266
+ string parent = 1 [
267
+ (google.api.field_behavior) = REQUIRED,
268
+ (google.api.resource_reference) = {
269
+ type: "admanager.googleapis.com/Network"
270
+ }
271
+ ];
272
+
273
+ // Required. The `AdUnit` objects to update.
274
+ // A maximum of 100 objects can be updated in a batch.
275
+ repeated UpdateAdUnitRequest requests = 2
276
+ [(google.api.field_behavior) = REQUIRED];
277
+ }
278
+
279
+ // Response object for `BatchUpdateAdUnits` method.
280
+ message BatchUpdateAdUnitsResponse {
281
+ // The `AdUnit` objects updated.
282
+ repeated AdUnit ad_units = 1;
283
+ }
284
+
138
285
  // Request object for ListAdUnitSizes method.
139
286
  message ListAdUnitSizesRequest {
140
287
  // Required. The parent, which owns this collection of AdUnitSizes.
@@ -195,3 +342,72 @@ message ListAdUnitSizesResponse {
195
342
  // https://developers.google.com/ad-manager/api/beta/field-masks
196
343
  int32 total_size = 3;
197
344
  }
345
+
346
+ // Request object for `BatchActivateAdUnits` method.
347
+ message BatchActivateAdUnitsRequest {
348
+ // Required. Format: `networks/{network_code}`
349
+ string parent = 1 [
350
+ (google.api.field_behavior) = REQUIRED,
351
+ (google.api.resource_reference) = {
352
+ type: "admanager.googleapis.com/Network"
353
+ }
354
+ ];
355
+
356
+ // Required. The resource names of the `AdUnit`s to activate.
357
+ // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
358
+ repeated string names = 2 [
359
+ (google.api.field_behavior) = REQUIRED,
360
+ (google.api.resource_reference) = {
361
+ type: "admanager.googleapis.com/AdUnit"
362
+ }
363
+ ];
364
+ }
365
+
366
+ // Response object for `BatchActivateAdUnits` method.
367
+ message BatchActivateAdUnitsResponse {}
368
+
369
+ // Request object for `BatchDeactivateAdUnits` method.
370
+ message BatchDeactivateAdUnitsRequest {
371
+ // Required. Format: `networks/{network_code}`
372
+ string parent = 1 [
373
+ (google.api.field_behavior) = REQUIRED,
374
+ (google.api.resource_reference) = {
375
+ type: "admanager.googleapis.com/Network"
376
+ }
377
+ ];
378
+
379
+ // Required. The resource names of the `AdUnit`s to deactivate.
380
+ // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
381
+ repeated string names = 2 [
382
+ (google.api.field_behavior) = REQUIRED,
383
+ (google.api.resource_reference) = {
384
+ type: "admanager.googleapis.com/AdUnit"
385
+ }
386
+ ];
387
+ }
388
+
389
+ // Response object for `BatchDeactivateAdUnits` method.
390
+ message BatchDeactivateAdUnitsResponse {}
391
+
392
+ // Request object for `BatchArchiveAdUnits` method.
393
+ message BatchArchiveAdUnitsRequest {
394
+ // Required. Format: `networks/{network_code}`
395
+ string parent = 1 [
396
+ (google.api.field_behavior) = REQUIRED,
397
+ (google.api.resource_reference) = {
398
+ type: "admanager.googleapis.com/Network"
399
+ }
400
+ ];
401
+
402
+ // Required. The resource names of the `AdUnit`s to archive.
403
+ // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
404
+ repeated string names = 2 [
405
+ (google.api.field_behavior) = REQUIRED,
406
+ (google.api.resource_reference) = {
407
+ type: "admanager.googleapis.com/AdUnit"
408
+ }
409
+ ];
410
+ }
411
+
412
+ // Response object for `BatchArchiveAdUnits` method.
413
+ message BatchArchiveAdUnitsResponse {}
@@ -36,7 +36,7 @@ service CmsMetadataValueService {
36
36
  option (google.api.oauth_scopes) =
37
37
  "https://www.googleapis.com/auth/admanager";
38
38
 
39
- // API to retrieve a `CmsMetadataKey` object.
39
+ // API to retrieve a `CmsMetadataValue` object.
40
40
  rpc GetCmsMetadataValue(GetCmsMetadataValueRequest)
41
41
  returns (CmsMetadataValue) {
42
42
  option (google.api.http) = {
@@ -57,7 +57,7 @@ service CmsMetadataValueService {
57
57
 
58
58
  // Request object for `GetCmsMetadataValue` method.
59
59
  message GetCmsMetadataValueRequest {
60
- // Required. The resource name of the CmsMetadataKey.
60
+ // Required. The resource name of the CmsMetadataValue.
61
61
  // Format: `networks/{network_code}/cmsMetadataValues/{cms_metadata_value_id}`
62
62
  string name = 1 [
63
63
  (google.api.field_behavior) = REQUIRED,
@@ -21,6 +21,7 @@ import "google/api/annotations.proto";
21
21
  import "google/api/client.proto";
22
22
  import "google/api/field_behavior.proto";
23
23
  import "google/api/resource.proto";
24
+ import "google/protobuf/field_mask.proto";
24
25
 
25
26
  option csharp_namespace = "Google.Ads.AdManager.V1";
26
27
  option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
@@ -53,6 +54,67 @@ service CustomTargetingKeyService {
53
54
  };
54
55
  option (google.api.method_signature) = "parent";
55
56
  }
57
+
58
+ // API to create a `CustomTargetingKey` object.
59
+ rpc CreateCustomTargetingKey(CreateCustomTargetingKeyRequest)
60
+ returns (CustomTargetingKey) {
61
+ option (google.api.http) = {
62
+ post: "/v1/{parent=networks/*}/customTargetingKeys"
63
+ body: "custom_targeting_key"
64
+ };
65
+ option (google.api.method_signature) = "parent,custom_targeting_key";
66
+ }
67
+
68
+ // API to batch create `CustomTargetingKey` objects.
69
+ rpc BatchCreateCustomTargetingKeys(BatchCreateCustomTargetingKeysRequest)
70
+ returns (BatchCreateCustomTargetingKeysResponse) {
71
+ option (google.api.http) = {
72
+ post: "/v1/{parent=networks/*}/customTargetingKeys:batchCreate"
73
+ body: "*"
74
+ };
75
+ option (google.api.method_signature) = "parent,requests";
76
+ }
77
+
78
+ // API to update a `CustomTargetingKey` object.
79
+ rpc UpdateCustomTargetingKey(UpdateCustomTargetingKeyRequest)
80
+ returns (CustomTargetingKey) {
81
+ option (google.api.http) = {
82
+ patch: "/v1/{custom_targeting_key.name=networks/*/customTargetingKeys/*}"
83
+ body: "custom_targeting_key"
84
+ };
85
+ option (google.api.method_signature) = "custom_targeting_key,update_mask";
86
+ }
87
+
88
+ // API to batch update `CustomTargetingKey` objects.
89
+ rpc BatchUpdateCustomTargetingKeys(BatchUpdateCustomTargetingKeysRequest)
90
+ returns (BatchUpdateCustomTargetingKeysResponse) {
91
+ option (google.api.http) = {
92
+ post: "/v1/{parent=networks/*}/customTargetingKeys:batchUpdate"
93
+ body: "*"
94
+ };
95
+ option (google.api.method_signature) = "parent,requests";
96
+ }
97
+
98
+ // API to batch activate `CustomTargetingKey` objects.
99
+ rpc BatchActivateCustomTargetingKeys(BatchActivateCustomTargetingKeysRequest)
100
+ returns (BatchActivateCustomTargetingKeysResponse) {
101
+ option (google.api.http) = {
102
+ post: "/v1/{parent=networks/*}/customTargetingKeys:batchActivate"
103
+ body: "*"
104
+ };
105
+ option (google.api.method_signature) = "parent,names";
106
+ }
107
+
108
+ // Deactivates a list of `CustomTargetingKey` objects.
109
+ rpc BatchDeactivateCustomTargetingKeys(
110
+ BatchDeactivateCustomTargetingKeysRequest)
111
+ returns (BatchDeactivateCustomTargetingKeysResponse) {
112
+ option (google.api.http) = {
113
+ post: "/v1/{parent=networks/*}/customTargetingKeys:batchDeactivate"
114
+ body: "*"
115
+ };
116
+ option (google.api.method_signature) = "parent,names";
117
+ }
56
118
  }
57
119
 
58
120
  // Request object for `GetCustomTargetingKey` method.
@@ -129,3 +191,131 @@ message ListCustomTargetingKeysResponse {
129
191
  // https://developers.google.com/ad-manager/api/beta/field-masks
130
192
  int32 total_size = 3;
131
193
  }
194
+
195
+ // Request object for `CreateCustomTargetingKey` method.
196
+ message CreateCustomTargetingKeyRequest {
197
+ // Required. The parent resource where this `CustomTargetingKey` will be
198
+ // created. Format: `networks/{network_code}`
199
+ string parent = 1 [
200
+ (google.api.field_behavior) = REQUIRED,
201
+ (google.api.resource_reference) = {
202
+ type: "admanager.googleapis.com/Network"
203
+ }
204
+ ];
205
+
206
+ // Required. The `CustomTargetingKey` to create.
207
+ CustomTargetingKey custom_targeting_key = 2
208
+ [(google.api.field_behavior) = REQUIRED];
209
+ }
210
+
211
+ // Request object for `BatchCreateCustomTargetingKeys` method.
212
+ message BatchCreateCustomTargetingKeysRequest {
213
+ // Required. The parent resource where `CustomTargetingKeys` will be created.
214
+ // Format: `networks/{network_code}`
215
+ // The parent field in the CreateCustomTargetingKeyRequest must match this
216
+ // field.
217
+ string parent = 1 [
218
+ (google.api.field_behavior) = REQUIRED,
219
+ (google.api.resource_reference) = {
220
+ type: "admanager.googleapis.com/Network"
221
+ }
222
+ ];
223
+
224
+ // Required. The `CustomTargetingKey` objects to create.
225
+ // A maximum of 100 objects can be created in a batch.
226
+ repeated CreateCustomTargetingKeyRequest requests = 2
227
+ [(google.api.field_behavior) = REQUIRED];
228
+ }
229
+
230
+ // Response object for `BatchCreateCustomTargetingKeys` method.
231
+ message BatchCreateCustomTargetingKeysResponse {
232
+ // The `CustomTargetingKey` objects created.
233
+ repeated CustomTargetingKey custom_targeting_keys = 1;
234
+ }
235
+
236
+ // Request object for `UpdateCustomTargetingKey` method.
237
+ message UpdateCustomTargetingKeyRequest {
238
+ // Required. The `CustomTargetingKey` to update.
239
+ //
240
+ // The `CustomTargetingKey`'s `name` is used to identify the
241
+ // `CustomTargetingKey` to update.
242
+ CustomTargetingKey custom_targeting_key = 1
243
+ [(google.api.field_behavior) = REQUIRED];
244
+
245
+ // Required. The list of fields to update.
246
+ google.protobuf.FieldMask update_mask = 2
247
+ [(google.api.field_behavior) = REQUIRED];
248
+ }
249
+
250
+ // Request object for `BatchUpdateCustomTargetingKeys` method.
251
+ message BatchUpdateCustomTargetingKeysRequest {
252
+ // Required. The parent resource where `CustomTargetingKeys` will be updated.
253
+ // Format: `networks/{network_code}`
254
+ // The parent field in the UpdateCustomTargetingKeyRequest must match this
255
+ // field.
256
+ string parent = 1 [
257
+ (google.api.field_behavior) = REQUIRED,
258
+ (google.api.resource_reference) = {
259
+ type: "admanager.googleapis.com/Network"
260
+ }
261
+ ];
262
+
263
+ // Required. The `CustomTargetingKey` objects to update.
264
+ // A maximum of 100 objects can be updated in a batch.
265
+ repeated UpdateCustomTargetingKeyRequest requests = 2
266
+ [(google.api.field_behavior) = REQUIRED];
267
+ }
268
+
269
+ // Response object for `BatchUpdateCustomTargetingKeys` method.
270
+ message BatchUpdateCustomTargetingKeysResponse {
271
+ // The `CustomTargetingKey` objects updated.
272
+ repeated CustomTargetingKey custom_targeting_keys = 1;
273
+ }
274
+
275
+ // Request object for `BatchActivateCustomTargetingKeys` method.
276
+ message BatchActivateCustomTargetingKeysRequest {
277
+ // Required. Format: `networks/{network_code}`
278
+ string parent = 1 [
279
+ (google.api.field_behavior) = REQUIRED,
280
+ (google.api.resource_reference) = {
281
+ type: "admanager.googleapis.com/Network"
282
+ }
283
+ ];
284
+
285
+ // Required. The resource names of the `CustomTargetingKey`s to activate.
286
+ // Format:
287
+ // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}`
288
+ repeated string names = 2 [
289
+ (google.api.field_behavior) = REQUIRED,
290
+ (google.api.resource_reference) = {
291
+ type: "admanager.googleapis.com/CustomTargetingKey"
292
+ }
293
+ ];
294
+ }
295
+
296
+ // Response object for `BatchActivateCustomTargetingKeys` method.
297
+ message BatchActivateCustomTargetingKeysResponse {}
298
+
299
+ // Request message for `BatchDeactivateCustomTargetingKeys` method.
300
+ message BatchDeactivateCustomTargetingKeysRequest {
301
+ // Required. Format: `networks/{network_code}`
302
+ string parent = 1 [
303
+ (google.api.field_behavior) = REQUIRED,
304
+ (google.api.resource_reference) = {
305
+ type: "admanager.googleapis.com/Network"
306
+ }
307
+ ];
308
+
309
+ // Required. The resource names of the `CustomTargetingKey`s to deactivate.
310
+ // Format:
311
+ // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}`
312
+ repeated string names = 2 [
313
+ (google.api.field_behavior) = REQUIRED,
314
+ (google.api.resource_reference) = {
315
+ type: "admanager.googleapis.com/CustomTargetingKey"
316
+ }
317
+ ];
318
+ }
319
+
320
+ // Response object for `BatchDeactivateCustomTargetingKeys` method.
321
+ message BatchDeactivateCustomTargetingKeysResponse {}
@@ -0,0 +1,57 @@
1
+ // Copyright 2025 Google LLC
2
+ //
3
+ // Licensed under the Apache License, Version 2.0 (the "License");
4
+ // you may not use this file except in compliance with the License.
5
+ // You may obtain a copy of the License at
6
+ //
7
+ // http://www.apache.org/licenses/LICENSE-2.0
8
+ //
9
+ // Unless required by applicable law or agreed to in writing, software
10
+ // distributed under the License is distributed on an "AS IS" BASIS,
11
+ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ // See the License for the specific language governing permissions and
13
+ // limitations under the License.
14
+
15
+ syntax = "proto3";
16
+
17
+ package google.ads.admanager.v1;
18
+
19
+ import "google/ads/admanager/v1/goal_enums.proto";
20
+
21
+ option csharp_namespace = "Google.Ads.AdManager.V1";
22
+ option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
23
+ option java_multiple_files = true;
24
+ option java_outer_classname = "GoalProto";
25
+ option java_package = "com.google.ads.admanager.v1";
26
+ option php_namespace = "Google\\Ads\\AdManager\\V1";
27
+ option ruby_package = "Google::Ads::AdManager::V1";
28
+
29
+ // Defines the criteria a [LineItem][google.ads.admanager.v1.LineItem] needs to
30
+ // satisfy to meet its delivery goal.
31
+ message Goal {
32
+ // The type of the goal for the LineItem. It defines the period over which the
33
+ // goal should be reached.
34
+ optional GoalTypeEnum.GoalType goal_type = 1;
35
+
36
+ // The type of the goal unit for the LineItem.
37
+ optional UnitTypeEnum.UnitType unit_type = 2;
38
+
39
+ // If this is a primary goal, it represents the number or percentage of
40
+ // impressions or clicks that will be reserved. If the line item is of type
41
+ // [LineItemTypeEnum.LineItemType.SPONSORSHIP][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.SPONSORSHIP],
42
+ // it represents the percentage of available impressions reserved. If the line
43
+ // item is of type
44
+ // [LineItemTypeEnum.LineItemType.BULK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.BULK]
45
+ // or
46
+ // [LineItemTypeEnum.LineItemType.PRICE_PRIORITY][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.PRICE_PRIORITY],
47
+ // it represents the number of remaining impressions reserved. If the line
48
+ // item is of type
49
+ // [LineItemTypeEnum.LineItemType.NETWORK][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.NETWORK]
50
+ // or
51
+ // [LineItemTypeEnum.LineItemType.HOUSE][google.ads.admanager.v1.LineItemTypeEnum.LineItemType.HOUSE],
52
+ // it represents the percentage of remaining impressions reserved. <p>If this
53
+ // is an impression cap goal, it represents the number of impressions or
54
+ // conversions that the line item will stop serving at if reached. For valid
55
+ // line item types, see [LineItem.impressions_cap][].
56
+ optional int64 units = 3;
57
+ }