@google-ads/admanager 0.1.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.
Files changed (111) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/LICENSE +202 -0
  3. package/README.md +236 -0
  4. package/build/protos/google/ads/admanager/v1/ad_unit_enums.proto +81 -0
  5. package/build/protos/google/ads/admanager/v1/ad_unit_messages.proto +230 -0
  6. package/build/protos/google/ads/admanager/v1/ad_unit_service.proto +195 -0
  7. package/build/protos/google/ads/admanager/v1/admanager_error.proto +52 -0
  8. package/build/protos/google/ads/admanager/v1/applied_label.proto +41 -0
  9. package/build/protos/google/ads/admanager/v1/company_credit_status_enum.proto +97 -0
  10. package/build/protos/google/ads/admanager/v1/company_messages.proto +122 -0
  11. package/build/protos/google/ads/admanager/v1/company_service.proto +126 -0
  12. package/build/protos/google/ads/admanager/v1/company_type_enum.proto +51 -0
  13. package/build/protos/google/ads/admanager/v1/contact_messages.proto +49 -0
  14. package/build/protos/google/ads/admanager/v1/custom_field_enums.proto +110 -0
  15. package/build/protos/google/ads/admanager/v1/custom_field_messages.proto +87 -0
  16. package/build/protos/google/ads/admanager/v1/custom_field_service.proto +127 -0
  17. package/build/protos/google/ads/admanager/v1/custom_field_value.proto +62 -0
  18. package/build/protos/google/ads/admanager/v1/custom_targeting_key_enums.proto +76 -0
  19. package/build/protos/google/ads/admanager/v1/custom_targeting_key_messages.proto +69 -0
  20. package/build/protos/google/ads/admanager/v1/custom_targeting_key_service.proto +129 -0
  21. package/build/protos/google/ads/admanager/v1/custom_targeting_value_enums.proto +90 -0
  22. package/build/protos/google/ads/admanager/v1/custom_targeting_value_messages.proto +66 -0
  23. package/build/protos/google/ads/admanager/v1/custom_targeting_value_service.proto +132 -0
  24. package/build/protos/google/ads/admanager/v1/entity_signals_mapping_messages.proto +64 -0
  25. package/build/protos/google/ads/admanager/v1/entity_signals_mapping_service.proto +252 -0
  26. package/build/protos/google/ads/admanager/v1/environment_type_enum.proto +41 -0
  27. package/build/protos/google/ads/admanager/v1/frequency_cap.proto +39 -0
  28. package/build/protos/google/ads/admanager/v1/label_messages.proto +42 -0
  29. package/build/protos/google/ads/admanager/v1/network_messages.proto +79 -0
  30. package/build/protos/google/ads/admanager/v1/network_service.proto +72 -0
  31. package/build/protos/google/ads/admanager/v1/order_enums.proto +59 -0
  32. package/build/protos/google/ads/admanager/v1/order_messages.proto +209 -0
  33. package/build/protos/google/ads/admanager/v1/order_service.proto +129 -0
  34. package/build/protos/google/ads/admanager/v1/placement_enums.proto +44 -0
  35. package/build/protos/google/ads/admanager/v1/placement_messages.proto +77 -0
  36. package/build/protos/google/ads/admanager/v1/placement_service.proto +126 -0
  37. package/build/protos/google/ads/admanager/v1/report_service.proto +3526 -0
  38. package/build/protos/google/ads/admanager/v1/role_enums.proto +41 -0
  39. package/build/protos/google/ads/admanager/v1/role_messages.proto +59 -0
  40. package/build/protos/google/ads/admanager/v1/role_service.proto +122 -0
  41. package/build/protos/google/ads/admanager/v1/size.proto +47 -0
  42. package/build/protos/google/ads/admanager/v1/size_type_enum.proto +62 -0
  43. package/build/protos/google/ads/admanager/v1/taxonomy_category_messages.proto +70 -0
  44. package/build/protos/google/ads/admanager/v1/taxonomy_category_service.proto +128 -0
  45. package/build/protos/google/ads/admanager/v1/taxonomy_type_enum.proto +51 -0
  46. package/build/protos/google/ads/admanager/v1/team_messages.proto +46 -0
  47. package/build/protos/google/ads/admanager/v1/time_unit_enum.proto +59 -0
  48. package/build/protos/google/ads/admanager/v1/user_messages.proto +78 -0
  49. package/build/protos/google/ads/admanager/v1/user_service.proto +57 -0
  50. package/build/protos/protos.d.ts +23491 -0
  51. package/build/protos/protos.js +69798 -0
  52. package/build/protos/protos.json +7273 -0
  53. package/build/src/index.d.ts +47 -0
  54. package/build/src/index.js +67 -0
  55. package/build/src/index.js.map +1 -0
  56. package/build/src/v1/ad_unit_service_client.d.ts +794 -0
  57. package/build/src/v1/ad_unit_service_client.js +1136 -0
  58. package/build/src/v1/ad_unit_service_client.js.map +1 -0
  59. package/build/src/v1/ad_unit_service_client_config.json +38 -0
  60. package/build/src/v1/company_service_client.d.ts +663 -0
  61. package/build/src/v1/company_service_client.js +999 -0
  62. package/build/src/v1/company_service_client.js.map +1 -0
  63. package/build/src/v1/company_service_client_config.json +34 -0
  64. package/build/src/v1/custom_field_service_client.d.ts +663 -0
  65. package/build/src/v1/custom_field_service_client.js +1002 -0
  66. package/build/src/v1/custom_field_service_client.js.map +1 -0
  67. package/build/src/v1/custom_field_service_client_config.json +34 -0
  68. package/build/src/v1/custom_targeting_key_service_client.d.ts +664 -0
  69. package/build/src/v1/custom_targeting_key_service_client.js +1004 -0
  70. package/build/src/v1/custom_targeting_key_service_client.js.map +1 -0
  71. package/build/src/v1/custom_targeting_key_service_client_config.json +34 -0
  72. package/build/src/v1/custom_targeting_value_service_client.d.ts +673 -0
  73. package/build/src/v1/custom_targeting_value_service_client.js +1010 -0
  74. package/build/src/v1/custom_targeting_value_service_client.js.map +1 -0
  75. package/build/src/v1/custom_targeting_value_service_client_config.json +34 -0
  76. package/build/src/v1/entity_signals_mapping_service_client.d.ts +782 -0
  77. package/build/src/v1/entity_signals_mapping_service_client.js +1096 -0
  78. package/build/src/v1/entity_signals_mapping_service_client.js.map +1 -0
  79. package/build/src/v1/entity_signals_mapping_service_client_config.json +50 -0
  80. package/build/src/v1/index.d.ts +13 -0
  81. package/build/src/v1/index.js +47 -0
  82. package/build/src/v1/index.js.map +1 -0
  83. package/build/src/v1/network_service_client.d.ts +552 -0
  84. package/build/src/v1/network_service_client.js +877 -0
  85. package/build/src/v1/network_service_client.js.map +1 -0
  86. package/build/src/v1/network_service_client_config.json +34 -0
  87. package/build/src/v1/order_service_client.d.ts +668 -0
  88. package/build/src/v1/order_service_client.js +999 -0
  89. package/build/src/v1/order_service_client.js.map +1 -0
  90. package/build/src/v1/order_service_client_config.json +48 -0
  91. package/build/src/v1/placement_service_client.d.ts +663 -0
  92. package/build/src/v1/placement_service_client.js +999 -0
  93. package/build/src/v1/placement_service_client.js.map +1 -0
  94. package/build/src/v1/placement_service_client_config.json +34 -0
  95. package/build/src/v1/report_service_client.d.ts +975 -0
  96. package/build/src/v1/report_service_client.js +1352 -0
  97. package/build/src/v1/report_service_client.js.map +1 -0
  98. package/build/src/v1/report_service_client_config.json +50 -0
  99. package/build/src/v1/role_service_client.d.ts +660 -0
  100. package/build/src/v1/role_service_client.js +997 -0
  101. package/build/src/v1/role_service_client.js.map +1 -0
  102. package/build/src/v1/role_service_client_config.json +34 -0
  103. package/build/src/v1/taxonomy_category_service_client.d.ts +663 -0
  104. package/build/src/v1/taxonomy_category_service_client.js +1003 -0
  105. package/build/src/v1/taxonomy_category_service_client.js.map +1 -0
  106. package/build/src/v1/taxonomy_category_service_client_config.json +34 -0
  107. package/build/src/v1/user_service_client.d.ts +534 -0
  108. package/build/src/v1/user_service_client.js +861 -0
  109. package/build/src/v1/user_service_client.js.map +1 -0
  110. package/build/src/v1/user_service_client_config.json +30 -0
  111. package/package.json +70 -0
@@ -0,0 +1,794 @@
1
+ import type * as gax from 'google-gax';
2
+ import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback } from 'google-gax';
3
+ import { Transform } from 'stream';
4
+ import * as protos from '../../protos/protos';
5
+ /**
6
+ * Provides methods for handling AdUnit objects.
7
+ * @class
8
+ * @memberof v1
9
+ */
10
+ export declare class AdUnitServiceClient {
11
+ private _terminated;
12
+ private _opts;
13
+ private _providedCustomServicePath;
14
+ private _gaxModule;
15
+ private _gaxGrpc;
16
+ private _protos;
17
+ private _defaults;
18
+ private _universeDomain;
19
+ private _servicePath;
20
+ auth: gax.GoogleAuth;
21
+ descriptors: Descriptors;
22
+ warn: (code: string, message: string, warnType?: string) => void;
23
+ innerApiCalls: {
24
+ [name: string]: Function;
25
+ };
26
+ pathTemplates: {
27
+ [name: string]: gax.PathTemplate;
28
+ };
29
+ adUnitServiceStub?: Promise<{
30
+ [name: string]: Function;
31
+ }>;
32
+ /**
33
+ * Construct an instance of AdUnitServiceClient.
34
+ *
35
+ * @param {object} [options] - The configuration object.
36
+ * The options accepted by the constructor are described in detail
37
+ * in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
38
+ * The common options are:
39
+ * @param {object} [options.credentials] - Credentials object.
40
+ * @param {string} [options.credentials.client_email]
41
+ * @param {string} [options.credentials.private_key]
42
+ * @param {string} [options.email] - Account email address. Required when
43
+ * using a .pem or .p12 keyFilename.
44
+ * @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
45
+ * .p12 key downloaded from the Google Developers Console. If you provide
46
+ * a path to a JSON file, the projectId option below is not necessary.
47
+ * NOTE: .pem and .p12 require you to specify options.email as well.
48
+ * @param {number} [options.port] - The port on which to connect to
49
+ * the remote host.
50
+ * @param {string} [options.projectId] - The project ID from the Google
51
+ * Developer's Console, e.g. 'grape-spaceship-123'. We will also check
52
+ * the environment variable GCLOUD_PROJECT for your project ID. If your
53
+ * app is running in an environment which supports
54
+ * {@link https://developers.google.com/identity/protocols/application-default-credentials Application Default Credentials},
55
+ * your project ID will be detected automatically.
56
+ * @param {string} [options.apiEndpoint] - The domain name of the
57
+ * API remote host.
58
+ * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
59
+ * Follows the structure of {@link gapicConfig}.
60
+ * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
61
+ * For more information, please check the
62
+ * {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
63
+ * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
64
+ * need to avoid loading the default gRPC version and want to use the fallback
65
+ * HTTP implementation. Load only fallback version and pass it to the constructor:
66
+ * ```
67
+ * const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
68
+ * const client = new AdUnitServiceClient({fallback: true}, gax);
69
+ * ```
70
+ */
71
+ constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
72
+ /**
73
+ * Initialize the client.
74
+ * Performs asynchronous operations (such as authentication) and prepares the client.
75
+ * This function will be called automatically when any class method is called for the
76
+ * first time, but if you need to initialize it before calling an actual method,
77
+ * feel free to call initialize() directly.
78
+ *
79
+ * You can await on this method if you want to make sure the client is initialized.
80
+ *
81
+ * @returns {Promise} A promise that resolves to an authenticated service stub.
82
+ */
83
+ initialize(): Promise<{
84
+ [name: string]: Function;
85
+ }>;
86
+ /**
87
+ * The DNS address for this API service.
88
+ * @deprecated Use the apiEndpoint method of the client instance.
89
+ * @returns {string} The DNS address for this service.
90
+ */
91
+ static get servicePath(): string;
92
+ /**
93
+ * The DNS address for this API service - same as servicePath.
94
+ * @deprecated Use the apiEndpoint method of the client instance.
95
+ * @returns {string} The DNS address for this service.
96
+ */
97
+ static get apiEndpoint(): string;
98
+ /**
99
+ * The DNS address for this API service.
100
+ * @returns {string} The DNS address for this service.
101
+ */
102
+ get apiEndpoint(): string;
103
+ get universeDomain(): string;
104
+ /**
105
+ * The port for this API service.
106
+ * @returns {number} The default port for this service.
107
+ */
108
+ static get port(): number;
109
+ /**
110
+ * The scopes needed to make gRPC calls for every method defined
111
+ * in this service.
112
+ * @returns {string[]} List of default scopes.
113
+ */
114
+ static get scopes(): never[];
115
+ getProjectId(): Promise<string>;
116
+ getProjectId(callback: Callback<string, undefined, undefined>): void;
117
+ /**
118
+ * API to retrieve an AdUnit object.
119
+ *
120
+ * @param {Object} request
121
+ * The request object that will be sent.
122
+ * @param {string} request.name
123
+ * Required. The resource name of the AdUnit.
124
+ * Format: `networks/{network_code}/adUnits/{ad_unit_id}`
125
+ * @param {object} [options]
126
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
127
+ * @returns {Promise} - The promise which resolves to an array.
128
+ * The first element of the array is an object representing {@link protos.google.ads.admanager.v1.AdUnit|AdUnit}.
129
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
130
+ * for more details and examples.
131
+ * @example <caption>include:samples/generated/v1/ad_unit_service.get_ad_unit.js</caption>
132
+ * region_tag:admanager_v1_generated_AdUnitService_GetAdUnit_async
133
+ */
134
+ getAdUnit(request?: protos.google.ads.admanager.v1.IGetAdUnitRequest, options?: CallOptions): Promise<[
135
+ protos.google.ads.admanager.v1.IAdUnit,
136
+ protos.google.ads.admanager.v1.IGetAdUnitRequest | undefined,
137
+ {} | undefined
138
+ ]>;
139
+ getAdUnit(request: protos.google.ads.admanager.v1.IGetAdUnitRequest, options: CallOptions, callback: Callback<protos.google.ads.admanager.v1.IAdUnit, protos.google.ads.admanager.v1.IGetAdUnitRequest | null | undefined, {} | null | undefined>): void;
140
+ getAdUnit(request: protos.google.ads.admanager.v1.IGetAdUnitRequest, callback: Callback<protos.google.ads.admanager.v1.IAdUnit, protos.google.ads.admanager.v1.IGetAdUnitRequest | null | undefined, {} | null | undefined>): void;
141
+ /**
142
+ * API to retrieve a list of AdUnit objects.
143
+ *
144
+ * @param {Object} request
145
+ * The request object that will be sent.
146
+ * @param {string} request.parent
147
+ * Required. The parent, which owns this collection of AdUnits.
148
+ * Format: `networks/{network_code}`
149
+ * @param {number} [request.pageSize]
150
+ * Optional. The maximum number of AdUnits to return. The service may return
151
+ * fewer than this value. If unspecified, at most 50 ad units will be
152
+ * returned. The maximum value is 1000; values above 1000 will be coerced to
153
+ * 1000.
154
+ * @param {string} [request.pageToken]
155
+ * Optional. A page token, received from a previous `ListAdUnits` call.
156
+ * Provide this to retrieve the subsequent page.
157
+ *
158
+ * When paginating, all other parameters provided to `ListAdUnits` must match
159
+ * the call that provided the page token.
160
+ * @param {string} [request.filter]
161
+ * Optional. Expression to filter the response.
162
+ * See syntax details at
163
+ * https://developers.google.com/ad-manager/api/beta/filters
164
+ * @param {string} [request.orderBy]
165
+ * Optional. Expression to specify sorting order.
166
+ * See syntax details at
167
+ * https://developers.google.com/ad-manager/api/beta/filters#order
168
+ * @param {number} [request.skip]
169
+ * Optional. Number of individual resources to skip while paginating.
170
+ * @param {object} [options]
171
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
172
+ * @returns {Promise} - The promise which resolves to an array.
173
+ * The first element of the array is Array of {@link protos.google.ads.admanager.v1.AdUnit|AdUnit}.
174
+ * The client library will perform auto-pagination by default: it will call the API as many
175
+ * times as needed and will merge results from all the pages into this array.
176
+ * Note that it can affect your quota.
177
+ * We recommend using `listAdUnitsAsync()`
178
+ * method described below for async iteration which you can stop as needed.
179
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
180
+ * for more details and examples.
181
+ */
182
+ listAdUnits(request?: protos.google.ads.admanager.v1.IListAdUnitsRequest, options?: CallOptions): Promise<[
183
+ protos.google.ads.admanager.v1.IAdUnit[],
184
+ protos.google.ads.admanager.v1.IListAdUnitsRequest | null,
185
+ protos.google.ads.admanager.v1.IListAdUnitsResponse
186
+ ]>;
187
+ listAdUnits(request: protos.google.ads.admanager.v1.IListAdUnitsRequest, options: CallOptions, callback: PaginationCallback<protos.google.ads.admanager.v1.IListAdUnitsRequest, protos.google.ads.admanager.v1.IListAdUnitsResponse | null | undefined, protos.google.ads.admanager.v1.IAdUnit>): void;
188
+ listAdUnits(request: protos.google.ads.admanager.v1.IListAdUnitsRequest, callback: PaginationCallback<protos.google.ads.admanager.v1.IListAdUnitsRequest, protos.google.ads.admanager.v1.IListAdUnitsResponse | null | undefined, protos.google.ads.admanager.v1.IAdUnit>): void;
189
+ /**
190
+ * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
191
+ * @param {Object} request
192
+ * The request object that will be sent.
193
+ * @param {string} request.parent
194
+ * Required. The parent, which owns this collection of AdUnits.
195
+ * Format: `networks/{network_code}`
196
+ * @param {number} [request.pageSize]
197
+ * Optional. The maximum number of AdUnits to return. The service may return
198
+ * fewer than this value. If unspecified, at most 50 ad units will be
199
+ * returned. The maximum value is 1000; values above 1000 will be coerced to
200
+ * 1000.
201
+ * @param {string} [request.pageToken]
202
+ * Optional. A page token, received from a previous `ListAdUnits` call.
203
+ * Provide this to retrieve the subsequent page.
204
+ *
205
+ * When paginating, all other parameters provided to `ListAdUnits` must match
206
+ * the call that provided the page token.
207
+ * @param {string} [request.filter]
208
+ * Optional. Expression to filter the response.
209
+ * See syntax details at
210
+ * https://developers.google.com/ad-manager/api/beta/filters
211
+ * @param {string} [request.orderBy]
212
+ * Optional. Expression to specify sorting order.
213
+ * See syntax details at
214
+ * https://developers.google.com/ad-manager/api/beta/filters#order
215
+ * @param {number} [request.skip]
216
+ * Optional. Number of individual resources to skip while paginating.
217
+ * @param {object} [options]
218
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
219
+ * @returns {Stream}
220
+ * An object stream which emits an object representing {@link protos.google.ads.admanager.v1.AdUnit|AdUnit} on 'data' event.
221
+ * The client library will perform auto-pagination by default: it will call the API as many
222
+ * times as needed. Note that it can affect your quota.
223
+ * We recommend using `listAdUnitsAsync()`
224
+ * method described below for async iteration which you can stop as needed.
225
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
226
+ * for more details and examples.
227
+ */
228
+ listAdUnitsStream(request?: protos.google.ads.admanager.v1.IListAdUnitsRequest, options?: CallOptions): Transform;
229
+ /**
230
+ * Equivalent to `listAdUnits`, but returns an iterable object.
231
+ *
232
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
233
+ * @param {Object} request
234
+ * The request object that will be sent.
235
+ * @param {string} request.parent
236
+ * Required. The parent, which owns this collection of AdUnits.
237
+ * Format: `networks/{network_code}`
238
+ * @param {number} [request.pageSize]
239
+ * Optional. The maximum number of AdUnits to return. The service may return
240
+ * fewer than this value. If unspecified, at most 50 ad units will be
241
+ * returned. The maximum value is 1000; values above 1000 will be coerced to
242
+ * 1000.
243
+ * @param {string} [request.pageToken]
244
+ * Optional. A page token, received from a previous `ListAdUnits` call.
245
+ * Provide this to retrieve the subsequent page.
246
+ *
247
+ * When paginating, all other parameters provided to `ListAdUnits` must match
248
+ * the call that provided the page token.
249
+ * @param {string} [request.filter]
250
+ * Optional. Expression to filter the response.
251
+ * See syntax details at
252
+ * https://developers.google.com/ad-manager/api/beta/filters
253
+ * @param {string} [request.orderBy]
254
+ * Optional. Expression to specify sorting order.
255
+ * See syntax details at
256
+ * https://developers.google.com/ad-manager/api/beta/filters#order
257
+ * @param {number} [request.skip]
258
+ * Optional. Number of individual resources to skip while paginating.
259
+ * @param {object} [options]
260
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
261
+ * @returns {Object}
262
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
263
+ * When you iterate the returned iterable, each element will be an object representing
264
+ * {@link protos.google.ads.admanager.v1.AdUnit|AdUnit}. The API will be called under the hood as needed, once per the page,
265
+ * so you can stop the iteration when you don't need more results.
266
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
267
+ * for more details and examples.
268
+ * @example <caption>include:samples/generated/v1/ad_unit_service.list_ad_units.js</caption>
269
+ * region_tag:admanager_v1_generated_AdUnitService_ListAdUnits_async
270
+ */
271
+ listAdUnitsAsync(request?: protos.google.ads.admanager.v1.IListAdUnitsRequest, options?: CallOptions): AsyncIterable<protos.google.ads.admanager.v1.IAdUnit>;
272
+ /**
273
+ * API to retrieve a list of AdUnitSize objects.
274
+ *
275
+ * @param {Object} request
276
+ * The request object that will be sent.
277
+ * @param {string} request.parent
278
+ * Required. The parent, which owns this collection of AdUnitSizes.
279
+ * Format: `networks/{network_code}`
280
+ * @param {number} [request.pageSize]
281
+ * Optional. The maximum number of AdUnitSizes to return. The service may
282
+ * return fewer than this value. If unspecified, at most 50 ad unit sizes will
283
+ * be returned. The maximum value is 1000; values above 1000 will be coerced
284
+ * to 1000.
285
+ * @param {string} [request.pageToken]
286
+ * Optional. A page token, received from a previous `ListAdUnitSizes` call.
287
+ * Provide this to retrieve the subsequent page.
288
+ *
289
+ * When paginating, all other parameters provided to `ListAdUnitSizes` must
290
+ * match the call that provided the page token.
291
+ * @param {string} [request.filter]
292
+ * Optional. Expression to filter the response.
293
+ * See syntax details at
294
+ * https://developers.google.com/ad-manager/api/beta/filters
295
+ * @param {string} [request.orderBy]
296
+ * Optional. Expression to specify sorting order.
297
+ * See syntax details at
298
+ * https://developers.google.com/ad-manager/api/beta/filters#order
299
+ * @param {number} [request.skip]
300
+ * Optional. Number of individual resources to skip while paginating.
301
+ * @param {object} [options]
302
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
303
+ * @returns {Promise} - The promise which resolves to an array.
304
+ * The first element of the array is Array of {@link protos.google.ads.admanager.v1.AdUnitSize|AdUnitSize}.
305
+ * The client library will perform auto-pagination by default: it will call the API as many
306
+ * times as needed and will merge results from all the pages into this array.
307
+ * Note that it can affect your quota.
308
+ * We recommend using `listAdUnitSizesAsync()`
309
+ * method described below for async iteration which you can stop as needed.
310
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
311
+ * for more details and examples.
312
+ */
313
+ listAdUnitSizes(request?: protos.google.ads.admanager.v1.IListAdUnitSizesRequest, options?: CallOptions): Promise<[
314
+ protos.google.ads.admanager.v1.IAdUnitSize[],
315
+ protos.google.ads.admanager.v1.IListAdUnitSizesRequest | null,
316
+ protos.google.ads.admanager.v1.IListAdUnitSizesResponse
317
+ ]>;
318
+ listAdUnitSizes(request: protos.google.ads.admanager.v1.IListAdUnitSizesRequest, options: CallOptions, callback: PaginationCallback<protos.google.ads.admanager.v1.IListAdUnitSizesRequest, protos.google.ads.admanager.v1.IListAdUnitSizesResponse | null | undefined, protos.google.ads.admanager.v1.IAdUnitSize>): void;
319
+ listAdUnitSizes(request: protos.google.ads.admanager.v1.IListAdUnitSizesRequest, callback: PaginationCallback<protos.google.ads.admanager.v1.IListAdUnitSizesRequest, protos.google.ads.admanager.v1.IListAdUnitSizesResponse | null | undefined, protos.google.ads.admanager.v1.IAdUnitSize>): void;
320
+ /**
321
+ * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
322
+ * @param {Object} request
323
+ * The request object that will be sent.
324
+ * @param {string} request.parent
325
+ * Required. The parent, which owns this collection of AdUnitSizes.
326
+ * Format: `networks/{network_code}`
327
+ * @param {number} [request.pageSize]
328
+ * Optional. The maximum number of AdUnitSizes to return. The service may
329
+ * return fewer than this value. If unspecified, at most 50 ad unit sizes will
330
+ * be returned. The maximum value is 1000; values above 1000 will be coerced
331
+ * to 1000.
332
+ * @param {string} [request.pageToken]
333
+ * Optional. A page token, received from a previous `ListAdUnitSizes` call.
334
+ * Provide this to retrieve the subsequent page.
335
+ *
336
+ * When paginating, all other parameters provided to `ListAdUnitSizes` must
337
+ * match the call that provided the page token.
338
+ * @param {string} [request.filter]
339
+ * Optional. Expression to filter the response.
340
+ * See syntax details at
341
+ * https://developers.google.com/ad-manager/api/beta/filters
342
+ * @param {string} [request.orderBy]
343
+ * Optional. Expression to specify sorting order.
344
+ * See syntax details at
345
+ * https://developers.google.com/ad-manager/api/beta/filters#order
346
+ * @param {number} [request.skip]
347
+ * Optional. Number of individual resources to skip while paginating.
348
+ * @param {object} [options]
349
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
350
+ * @returns {Stream}
351
+ * An object stream which emits an object representing {@link protos.google.ads.admanager.v1.AdUnitSize|AdUnitSize} on 'data' event.
352
+ * The client library will perform auto-pagination by default: it will call the API as many
353
+ * times as needed. Note that it can affect your quota.
354
+ * We recommend using `listAdUnitSizesAsync()`
355
+ * method described below for async iteration which you can stop as needed.
356
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
357
+ * for more details and examples.
358
+ */
359
+ listAdUnitSizesStream(request?: protos.google.ads.admanager.v1.IListAdUnitSizesRequest, options?: CallOptions): Transform;
360
+ /**
361
+ * Equivalent to `listAdUnitSizes`, but returns an iterable object.
362
+ *
363
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
364
+ * @param {Object} request
365
+ * The request object that will be sent.
366
+ * @param {string} request.parent
367
+ * Required. The parent, which owns this collection of AdUnitSizes.
368
+ * Format: `networks/{network_code}`
369
+ * @param {number} [request.pageSize]
370
+ * Optional. The maximum number of AdUnitSizes to return. The service may
371
+ * return fewer than this value. If unspecified, at most 50 ad unit sizes will
372
+ * be returned. The maximum value is 1000; values above 1000 will be coerced
373
+ * to 1000.
374
+ * @param {string} [request.pageToken]
375
+ * Optional. A page token, received from a previous `ListAdUnitSizes` call.
376
+ * Provide this to retrieve the subsequent page.
377
+ *
378
+ * When paginating, all other parameters provided to `ListAdUnitSizes` must
379
+ * match the call that provided the page token.
380
+ * @param {string} [request.filter]
381
+ * Optional. Expression to filter the response.
382
+ * See syntax details at
383
+ * https://developers.google.com/ad-manager/api/beta/filters
384
+ * @param {string} [request.orderBy]
385
+ * Optional. Expression to specify sorting order.
386
+ * See syntax details at
387
+ * https://developers.google.com/ad-manager/api/beta/filters#order
388
+ * @param {number} [request.skip]
389
+ * Optional. Number of individual resources to skip while paginating.
390
+ * @param {object} [options]
391
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
392
+ * @returns {Object}
393
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
394
+ * When you iterate the returned iterable, each element will be an object representing
395
+ * {@link protos.google.ads.admanager.v1.AdUnitSize|AdUnitSize}. The API will be called under the hood as needed, once per the page,
396
+ * so you can stop the iteration when you don't need more results.
397
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
398
+ * for more details and examples.
399
+ * @example <caption>include:samples/generated/v1/ad_unit_service.list_ad_unit_sizes.js</caption>
400
+ * region_tag:admanager_v1_generated_AdUnitService_ListAdUnitSizes_async
401
+ */
402
+ listAdUnitSizesAsync(request?: protos.google.ads.admanager.v1.IListAdUnitSizesRequest, options?: CallOptions): AsyncIterable<protos.google.ads.admanager.v1.IAdUnitSize>;
403
+ /**
404
+ * Return a fully-qualified adUnit resource name string.
405
+ *
406
+ * @param {string} network_code
407
+ * @param {string} ad_unit
408
+ * @returns {string} Resource name string.
409
+ */
410
+ adUnitPath(networkCode: string, adUnit: string): string;
411
+ /**
412
+ * Parse the network_code from AdUnit resource.
413
+ *
414
+ * @param {string} adUnitName
415
+ * A fully-qualified path representing AdUnit resource.
416
+ * @returns {string} A string representing the network_code.
417
+ */
418
+ matchNetworkCodeFromAdUnitName(adUnitName: string): string | number;
419
+ /**
420
+ * Parse the ad_unit from AdUnit resource.
421
+ *
422
+ * @param {string} adUnitName
423
+ * A fully-qualified path representing AdUnit resource.
424
+ * @returns {string} A string representing the ad_unit.
425
+ */
426
+ matchAdUnitFromAdUnitName(adUnitName: string): string | number;
427
+ /**
428
+ * Return a fully-qualified company resource name string.
429
+ *
430
+ * @param {string} network_code
431
+ * @param {string} company
432
+ * @returns {string} Resource name string.
433
+ */
434
+ companyPath(networkCode: string, company: string): string;
435
+ /**
436
+ * Parse the network_code from Company resource.
437
+ *
438
+ * @param {string} companyName
439
+ * A fully-qualified path representing Company resource.
440
+ * @returns {string} A string representing the network_code.
441
+ */
442
+ matchNetworkCodeFromCompanyName(companyName: string): string | number;
443
+ /**
444
+ * Parse the company from Company resource.
445
+ *
446
+ * @param {string} companyName
447
+ * A fully-qualified path representing Company resource.
448
+ * @returns {string} A string representing the company.
449
+ */
450
+ matchCompanyFromCompanyName(companyName: string): string | number;
451
+ /**
452
+ * Return a fully-qualified contact resource name string.
453
+ *
454
+ * @param {string} network_code
455
+ * @param {string} contact
456
+ * @returns {string} Resource name string.
457
+ */
458
+ contactPath(networkCode: string, contact: string): string;
459
+ /**
460
+ * Parse the network_code from Contact resource.
461
+ *
462
+ * @param {string} contactName
463
+ * A fully-qualified path representing Contact resource.
464
+ * @returns {string} A string representing the network_code.
465
+ */
466
+ matchNetworkCodeFromContactName(contactName: string): string | number;
467
+ /**
468
+ * Parse the contact from Contact resource.
469
+ *
470
+ * @param {string} contactName
471
+ * A fully-qualified path representing Contact resource.
472
+ * @returns {string} A string representing the contact.
473
+ */
474
+ matchContactFromContactName(contactName: string): string | number;
475
+ /**
476
+ * Return a fully-qualified customField resource name string.
477
+ *
478
+ * @param {string} network_code
479
+ * @param {string} custom_field
480
+ * @returns {string} Resource name string.
481
+ */
482
+ customFieldPath(networkCode: string, customField: string): string;
483
+ /**
484
+ * Parse the network_code from CustomField resource.
485
+ *
486
+ * @param {string} customFieldName
487
+ * A fully-qualified path representing CustomField resource.
488
+ * @returns {string} A string representing the network_code.
489
+ */
490
+ matchNetworkCodeFromCustomFieldName(customFieldName: string): string | number;
491
+ /**
492
+ * Parse the custom_field from CustomField resource.
493
+ *
494
+ * @param {string} customFieldName
495
+ * A fully-qualified path representing CustomField resource.
496
+ * @returns {string} A string representing the custom_field.
497
+ */
498
+ matchCustomFieldFromCustomFieldName(customFieldName: string): string | number;
499
+ /**
500
+ * Return a fully-qualified customTargetingKey resource name string.
501
+ *
502
+ * @param {string} network_code
503
+ * @param {string} custom_targeting_key
504
+ * @returns {string} Resource name string.
505
+ */
506
+ customTargetingKeyPath(networkCode: string, customTargetingKey: string): string;
507
+ /**
508
+ * Parse the network_code from CustomTargetingKey resource.
509
+ *
510
+ * @param {string} customTargetingKeyName
511
+ * A fully-qualified path representing CustomTargetingKey resource.
512
+ * @returns {string} A string representing the network_code.
513
+ */
514
+ matchNetworkCodeFromCustomTargetingKeyName(customTargetingKeyName: string): string | number;
515
+ /**
516
+ * Parse the custom_targeting_key from CustomTargetingKey resource.
517
+ *
518
+ * @param {string} customTargetingKeyName
519
+ * A fully-qualified path representing CustomTargetingKey resource.
520
+ * @returns {string} A string representing the custom_targeting_key.
521
+ */
522
+ matchCustomTargetingKeyFromCustomTargetingKeyName(customTargetingKeyName: string): string | number;
523
+ /**
524
+ * Return a fully-qualified customTargetingValue resource name string.
525
+ *
526
+ * @param {string} network_code
527
+ * @param {string} custom_targeting_key
528
+ * @param {string} custom_targeting_value
529
+ * @returns {string} Resource name string.
530
+ */
531
+ customTargetingValuePath(networkCode: string, customTargetingKey: string, customTargetingValue: string): string;
532
+ /**
533
+ * Parse the network_code from CustomTargetingValue resource.
534
+ *
535
+ * @param {string} customTargetingValueName
536
+ * A fully-qualified path representing CustomTargetingValue resource.
537
+ * @returns {string} A string representing the network_code.
538
+ */
539
+ matchNetworkCodeFromCustomTargetingValueName(customTargetingValueName: string): string | number;
540
+ /**
541
+ * Parse the custom_targeting_key from CustomTargetingValue resource.
542
+ *
543
+ * @param {string} customTargetingValueName
544
+ * A fully-qualified path representing CustomTargetingValue resource.
545
+ * @returns {string} A string representing the custom_targeting_key.
546
+ */
547
+ matchCustomTargetingKeyFromCustomTargetingValueName(customTargetingValueName: string): string | number;
548
+ /**
549
+ * Parse the custom_targeting_value from CustomTargetingValue resource.
550
+ *
551
+ * @param {string} customTargetingValueName
552
+ * A fully-qualified path representing CustomTargetingValue resource.
553
+ * @returns {string} A string representing the custom_targeting_value.
554
+ */
555
+ matchCustomTargetingValueFromCustomTargetingValueName(customTargetingValueName: string): string | number;
556
+ /**
557
+ * Return a fully-qualified entitySignalsMapping resource name string.
558
+ *
559
+ * @param {string} network_code
560
+ * @param {string} entity_signals_mapping
561
+ * @returns {string} Resource name string.
562
+ */
563
+ entitySignalsMappingPath(networkCode: string, entitySignalsMapping: string): string;
564
+ /**
565
+ * Parse the network_code from EntitySignalsMapping resource.
566
+ *
567
+ * @param {string} entitySignalsMappingName
568
+ * A fully-qualified path representing EntitySignalsMapping resource.
569
+ * @returns {string} A string representing the network_code.
570
+ */
571
+ matchNetworkCodeFromEntitySignalsMappingName(entitySignalsMappingName: string): string | number;
572
+ /**
573
+ * Parse the entity_signals_mapping from EntitySignalsMapping resource.
574
+ *
575
+ * @param {string} entitySignalsMappingName
576
+ * A fully-qualified path representing EntitySignalsMapping resource.
577
+ * @returns {string} A string representing the entity_signals_mapping.
578
+ */
579
+ matchEntitySignalsMappingFromEntitySignalsMappingName(entitySignalsMappingName: string): string | number;
580
+ /**
581
+ * Return a fully-qualified label resource name string.
582
+ *
583
+ * @param {string} network_code
584
+ * @param {string} label
585
+ * @returns {string} Resource name string.
586
+ */
587
+ labelPath(networkCode: string, label: string): string;
588
+ /**
589
+ * Parse the network_code from Label resource.
590
+ *
591
+ * @param {string} labelName
592
+ * A fully-qualified path representing Label resource.
593
+ * @returns {string} A string representing the network_code.
594
+ */
595
+ matchNetworkCodeFromLabelName(labelName: string): string | number;
596
+ /**
597
+ * Parse the label from Label resource.
598
+ *
599
+ * @param {string} labelName
600
+ * A fully-qualified path representing Label resource.
601
+ * @returns {string} A string representing the label.
602
+ */
603
+ matchLabelFromLabelName(labelName: string): string | number;
604
+ /**
605
+ * Return a fully-qualified network resource name string.
606
+ *
607
+ * @param {string} network_code
608
+ * @returns {string} Resource name string.
609
+ */
610
+ networkPath(networkCode: string): string;
611
+ /**
612
+ * Parse the network_code from Network resource.
613
+ *
614
+ * @param {string} networkName
615
+ * A fully-qualified path representing Network resource.
616
+ * @returns {string} A string representing the network_code.
617
+ */
618
+ matchNetworkCodeFromNetworkName(networkName: string): string | number;
619
+ /**
620
+ * Return a fully-qualified order resource name string.
621
+ *
622
+ * @param {string} network_code
623
+ * @param {string} order
624
+ * @returns {string} Resource name string.
625
+ */
626
+ orderPath(networkCode: string, order: string): string;
627
+ /**
628
+ * Parse the network_code from Order resource.
629
+ *
630
+ * @param {string} orderName
631
+ * A fully-qualified path representing Order resource.
632
+ * @returns {string} A string representing the network_code.
633
+ */
634
+ matchNetworkCodeFromOrderName(orderName: string): string | number;
635
+ /**
636
+ * Parse the order from Order resource.
637
+ *
638
+ * @param {string} orderName
639
+ * A fully-qualified path representing Order resource.
640
+ * @returns {string} A string representing the order.
641
+ */
642
+ matchOrderFromOrderName(orderName: string): string | number;
643
+ /**
644
+ * Return a fully-qualified placement resource name string.
645
+ *
646
+ * @param {string} network_code
647
+ * @param {string} placement
648
+ * @returns {string} Resource name string.
649
+ */
650
+ placementPath(networkCode: string, placement: string): string;
651
+ /**
652
+ * Parse the network_code from Placement resource.
653
+ *
654
+ * @param {string} placementName
655
+ * A fully-qualified path representing Placement resource.
656
+ * @returns {string} A string representing the network_code.
657
+ */
658
+ matchNetworkCodeFromPlacementName(placementName: string): string | number;
659
+ /**
660
+ * Parse the placement from Placement resource.
661
+ *
662
+ * @param {string} placementName
663
+ * A fully-qualified path representing Placement resource.
664
+ * @returns {string} A string representing the placement.
665
+ */
666
+ matchPlacementFromPlacementName(placementName: string): string | number;
667
+ /**
668
+ * Return a fully-qualified report resource name string.
669
+ *
670
+ * @param {string} network_code
671
+ * @param {string} report
672
+ * @returns {string} Resource name string.
673
+ */
674
+ reportPath(networkCode: string, report: string): string;
675
+ /**
676
+ * Parse the network_code from Report resource.
677
+ *
678
+ * @param {string} reportName
679
+ * A fully-qualified path representing Report resource.
680
+ * @returns {string} A string representing the network_code.
681
+ */
682
+ matchNetworkCodeFromReportName(reportName: string): string | number;
683
+ /**
684
+ * Parse the report from Report resource.
685
+ *
686
+ * @param {string} reportName
687
+ * A fully-qualified path representing Report resource.
688
+ * @returns {string} A string representing the report.
689
+ */
690
+ matchReportFromReportName(reportName: string): string | number;
691
+ /**
692
+ * Return a fully-qualified role resource name string.
693
+ *
694
+ * @param {string} network_code
695
+ * @param {string} role
696
+ * @returns {string} Resource name string.
697
+ */
698
+ rolePath(networkCode: string, role: string): string;
699
+ /**
700
+ * Parse the network_code from Role resource.
701
+ *
702
+ * @param {string} roleName
703
+ * A fully-qualified path representing Role resource.
704
+ * @returns {string} A string representing the network_code.
705
+ */
706
+ matchNetworkCodeFromRoleName(roleName: string): string | number;
707
+ /**
708
+ * Parse the role from Role resource.
709
+ *
710
+ * @param {string} roleName
711
+ * A fully-qualified path representing Role resource.
712
+ * @returns {string} A string representing the role.
713
+ */
714
+ matchRoleFromRoleName(roleName: string): string | number;
715
+ /**
716
+ * Return a fully-qualified taxonomyCategory resource name string.
717
+ *
718
+ * @param {string} network_code
719
+ * @param {string} taxonomy_category
720
+ * @returns {string} Resource name string.
721
+ */
722
+ taxonomyCategoryPath(networkCode: string, taxonomyCategory: string): string;
723
+ /**
724
+ * Parse the network_code from TaxonomyCategory resource.
725
+ *
726
+ * @param {string} taxonomyCategoryName
727
+ * A fully-qualified path representing TaxonomyCategory resource.
728
+ * @returns {string} A string representing the network_code.
729
+ */
730
+ matchNetworkCodeFromTaxonomyCategoryName(taxonomyCategoryName: string): string | number;
731
+ /**
732
+ * Parse the taxonomy_category from TaxonomyCategory resource.
733
+ *
734
+ * @param {string} taxonomyCategoryName
735
+ * A fully-qualified path representing TaxonomyCategory resource.
736
+ * @returns {string} A string representing the taxonomy_category.
737
+ */
738
+ matchTaxonomyCategoryFromTaxonomyCategoryName(taxonomyCategoryName: string): string | number;
739
+ /**
740
+ * Return a fully-qualified team resource name string.
741
+ *
742
+ * @param {string} network_code
743
+ * @param {string} team
744
+ * @returns {string} Resource name string.
745
+ */
746
+ teamPath(networkCode: string, team: string): string;
747
+ /**
748
+ * Parse the network_code from Team resource.
749
+ *
750
+ * @param {string} teamName
751
+ * A fully-qualified path representing Team resource.
752
+ * @returns {string} A string representing the network_code.
753
+ */
754
+ matchNetworkCodeFromTeamName(teamName: string): string | number;
755
+ /**
756
+ * Parse the team from Team resource.
757
+ *
758
+ * @param {string} teamName
759
+ * A fully-qualified path representing Team resource.
760
+ * @returns {string} A string representing the team.
761
+ */
762
+ matchTeamFromTeamName(teamName: string): string | number;
763
+ /**
764
+ * Return a fully-qualified user resource name string.
765
+ *
766
+ * @param {string} network_code
767
+ * @param {string} user
768
+ * @returns {string} Resource name string.
769
+ */
770
+ userPath(networkCode: string, user: string): string;
771
+ /**
772
+ * Parse the network_code from User resource.
773
+ *
774
+ * @param {string} userName
775
+ * A fully-qualified path representing User resource.
776
+ * @returns {string} A string representing the network_code.
777
+ */
778
+ matchNetworkCodeFromUserName(userName: string): string | number;
779
+ /**
780
+ * Parse the user from User resource.
781
+ *
782
+ * @param {string} userName
783
+ * A fully-qualified path representing User resource.
784
+ * @returns {string} A string representing the user.
785
+ */
786
+ matchUserFromUserName(userName: string): string | number;
787
+ /**
788
+ * Terminate the gRPC channel and close the client.
789
+ *
790
+ * The client will no longer be usable and all future behavior is undefined.
791
+ * @returns {Promise} A promise that resolves when the client is closed.
792
+ */
793
+ close(): Promise<void>;
794
+ }