@wix/auto_sdk_online-programs_participants 1.0.11 → 1.0.13
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.
- package/build/cjs/index.d.ts +6 -134
- package/build/cjs/index.js +161 -1489
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +691 -12
- package/build/cjs/index.typings.js +174 -1372
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +184 -1274
- package/build/cjs/meta.js +19 -1060
- package/build/cjs/meta.js.map +1 -1
- package/build/es/index.d.mts +6 -134
- package/build/es/index.mjs +144 -1446
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +691 -12
- package/build/es/index.typings.mjs +166 -1337
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +184 -1274
- package/build/es/meta.mjs +10 -1025
- package/build/es/meta.mjs.map +1 -1
- package/build/internal/cjs/index.d.ts +6 -145
- package/build/internal/cjs/index.js +161 -1489
- package/build/internal/cjs/index.js.map +1 -1
- package/build/internal/cjs/index.typings.d.ts +691 -12
- package/build/internal/cjs/index.typings.js +174 -1372
- package/build/internal/cjs/index.typings.js.map +1 -1
- package/build/internal/cjs/meta.d.ts +184 -1274
- package/build/internal/cjs/meta.js +19 -1060
- package/build/internal/cjs/meta.js.map +1 -1
- package/build/internal/es/index.d.mts +6 -145
- package/build/internal/es/index.mjs +144 -1446
- package/build/internal/es/index.mjs.map +1 -1
- package/build/internal/es/index.typings.d.mts +691 -12
- package/build/internal/es/index.typings.mjs +166 -1337
- package/build/internal/es/index.typings.mjs.map +1 -1
- package/build/internal/es/meta.d.mts +184 -1274
- package/build/internal/es/meta.mjs +10 -1025
- package/build/internal/es/meta.mjs.map +1 -1
- package/package.json +2 -2
- package/build/cjs/online-programs-v3-participant-participants.universal-DRubTE1O.d.ts +0 -2228
- package/build/es/online-programs-v3-participant-participants.universal-DRubTE1O.d.mts +0 -2228
- package/build/internal/cjs/online-programs-v3-participant-participants.universal-DUdmZP01.d.ts +0 -2238
- package/build/internal/es/online-programs-v3-participant-participants.universal-DUdmZP01.d.mts +0 -2238
package/build/internal/cjs/online-programs-v3-participant-participants.universal-DUdmZP01.d.ts
DELETED
|
@@ -1,2238 +0,0 @@
|
|
|
1
|
-
import { QuerySpec, SearchSpec, Query, Search, NonNullablePaths } from '@wix/sdk-types';
|
|
2
|
-
|
|
3
|
-
interface Participant {
|
|
4
|
-
/**
|
|
5
|
-
* Participant ID.
|
|
6
|
-
* @format GUID
|
|
7
|
-
* @readonly
|
|
8
|
-
*/
|
|
9
|
-
_id?: string | null;
|
|
10
|
-
/**
|
|
11
|
-
* Participant revision (for optimistic concurrency control).
|
|
12
|
-
* @readonly
|
|
13
|
-
*/
|
|
14
|
-
revision?: string | null;
|
|
15
|
-
/**
|
|
16
|
-
* Participant creation date
|
|
17
|
-
* @readonly
|
|
18
|
-
*/
|
|
19
|
-
_createdDate?: Date | null;
|
|
20
|
-
/**
|
|
21
|
-
* Participant last update date
|
|
22
|
-
* @readonly
|
|
23
|
-
*/
|
|
24
|
-
_updatedDate?: Date | null;
|
|
25
|
-
/**
|
|
26
|
-
* Member ID of participant on site
|
|
27
|
-
* @format GUID
|
|
28
|
-
* @readonly
|
|
29
|
-
*/
|
|
30
|
-
memberId?: string;
|
|
31
|
-
/**
|
|
32
|
-
* Program ID which participant participates in
|
|
33
|
-
* @format GUID
|
|
34
|
-
* @readonly
|
|
35
|
-
*/
|
|
36
|
-
programId?: string;
|
|
37
|
-
/**
|
|
38
|
-
* Program completion progress
|
|
39
|
-
* @readonly
|
|
40
|
-
*/
|
|
41
|
-
progress?: Progress;
|
|
42
|
-
/**
|
|
43
|
-
* status of participation in the program
|
|
44
|
-
* @readonly
|
|
45
|
-
*/
|
|
46
|
-
status?: StatusWithLiterals;
|
|
47
|
-
/**
|
|
48
|
-
* Certificate issued to participant
|
|
49
|
-
* @readonly
|
|
50
|
-
*/
|
|
51
|
-
certificate?: Certificate;
|
|
52
|
-
/** Additional info about when and how participant joined the program and which timeframes participant has to complete program. */
|
|
53
|
-
joinedInfo?: JoinedInfo;
|
|
54
|
-
/**
|
|
55
|
-
* Site member info snapshot for the participant
|
|
56
|
-
* @readonly
|
|
57
|
-
*/
|
|
58
|
-
member?: Member;
|
|
59
|
-
/**
|
|
60
|
-
* Last activity date of the participant in the program (can either be status change or step resolution).
|
|
61
|
-
* @readonly
|
|
62
|
-
*/
|
|
63
|
-
lastActivityDate?: Date | null;
|
|
64
|
-
/** Extended fields for participant (can be used for storing custom data). */
|
|
65
|
-
extendedFields?: ExtendedFields;
|
|
66
|
-
/** Tags for categorizing and organizing participants. */
|
|
67
|
-
tags?: Tags;
|
|
68
|
-
}
|
|
69
|
-
declare enum JoinPath {
|
|
70
|
-
/** Default value. This value is unused. */
|
|
71
|
-
UNKNOWN_JOIN_PATH = "UNKNOWN_JOIN_PATH",
|
|
72
|
-
/** Member joined to the program for free. */
|
|
73
|
-
FREE = "FREE",
|
|
74
|
-
/** Member was added to the program by site owner. */
|
|
75
|
-
ADDED = "ADDED",
|
|
76
|
-
/** Member paid once to join the program. */
|
|
77
|
-
SINGLE_PAYMENT = "SINGLE_PAYMENT",
|
|
78
|
-
/** Member has Paid Plan to join. */
|
|
79
|
-
PAID_PLAN = "PAID_PLAN",
|
|
80
|
-
/** Member joined with the Free Coupon. */
|
|
81
|
-
FREE_COUPON = "FREE_COUPON"
|
|
82
|
-
}
|
|
83
|
-
/** @enumType */
|
|
84
|
-
type JoinPathWithLiterals = JoinPath | 'UNKNOWN_JOIN_PATH' | 'FREE' | 'ADDED' | 'SINGLE_PAYMENT' | 'PAID_PLAN' | 'FREE_COUPON';
|
|
85
|
-
interface SinglePaymentDetails {
|
|
86
|
-
/**
|
|
87
|
-
* ID of the cashier order which was used to pay for joining the program.
|
|
88
|
-
* @format GUID
|
|
89
|
-
* @immutable
|
|
90
|
-
*/
|
|
91
|
-
paymentOrderId?: string;
|
|
92
|
-
/**
|
|
93
|
-
* ID of the offline transaction if offline payment flow from cashier was used.
|
|
94
|
-
* @format GUID
|
|
95
|
-
* @immutable
|
|
96
|
-
*/
|
|
97
|
-
offlineTransactionId?: string | null;
|
|
98
|
-
}
|
|
99
|
-
interface PaidPlanDetails {
|
|
100
|
-
/**
|
|
101
|
-
* ID of the Paid Plan for which member has paid to join the program.
|
|
102
|
-
* @format GUID
|
|
103
|
-
* @immutable
|
|
104
|
-
*/
|
|
105
|
-
paidPlanId?: string;
|
|
106
|
-
}
|
|
107
|
-
interface FreeCouponDetails {
|
|
108
|
-
/**
|
|
109
|
-
* ID of the coupon which was applied and gave 100% discount to join the program for free.
|
|
110
|
-
* @format GUID
|
|
111
|
-
* @immutable
|
|
112
|
-
*/
|
|
113
|
-
freeCouponId?: string;
|
|
114
|
-
}
|
|
115
|
-
interface Progress {
|
|
116
|
-
/** Number of program steps completed by member. */
|
|
117
|
-
totalStepsCompleted?: number;
|
|
118
|
-
/** Total number of program steps available to resolve. */
|
|
119
|
-
totalStepsAvailable?: number;
|
|
120
|
-
/**
|
|
121
|
-
* Completion percentage.
|
|
122
|
-
* @max 100
|
|
123
|
-
*/
|
|
124
|
-
completionPercentage?: number;
|
|
125
|
-
}
|
|
126
|
-
declare enum Status {
|
|
127
|
-
/** Default value. This value is unused. */
|
|
128
|
-
UNKNOWN_STATUS = "UNKNOWN_STATUS",
|
|
129
|
-
/** Member joined the program and became participant. */
|
|
130
|
-
JOINED = "JOINED",
|
|
131
|
-
/** Participant completed the program, and could join again. */
|
|
132
|
-
COMPLETED = "COMPLETED",
|
|
133
|
-
/** Participant failed to complete the program, and could join again. */
|
|
134
|
-
FAILED = "FAILED",
|
|
135
|
-
/** Participant with ended pricing plan (PP), will be joined as renew PP. */
|
|
136
|
-
SUSPENDED = "SUSPENDED",
|
|
137
|
-
/** Participant removed automatically after some program condition. */
|
|
138
|
-
AUTO_REMOVED = "AUTO_REMOVED",
|
|
139
|
-
/** Participant removed by site owner. */
|
|
140
|
-
REMOVED = "REMOVED",
|
|
141
|
-
/** Participant left the program by himself. */
|
|
142
|
-
LEFT = "LEFT"
|
|
143
|
-
}
|
|
144
|
-
/** @enumType */
|
|
145
|
-
type StatusWithLiterals = Status | 'UNKNOWN_STATUS' | 'JOINED' | 'COMPLETED' | 'FAILED' | 'SUSPENDED' | 'AUTO_REMOVED' | 'REMOVED' | 'LEFT';
|
|
146
|
-
interface Certificate {
|
|
147
|
-
/**
|
|
148
|
-
* when certificate was issued, UTC.
|
|
149
|
-
* @readonly
|
|
150
|
-
*/
|
|
151
|
-
issuedDate?: Date | null;
|
|
152
|
-
}
|
|
153
|
-
interface JoinedInfo extends JoinedInfoJoinPathDetailsOneOf {
|
|
154
|
-
/** Details about Single Payment join path. */
|
|
155
|
-
singlePaymentDetails?: SinglePaymentDetails;
|
|
156
|
-
/** Details about Paid Plan join path. */
|
|
157
|
-
paidPlanDetails?: PaidPlanDetails;
|
|
158
|
-
/** Details about Free Coupon join path. */
|
|
159
|
-
freeCouponDetails?: FreeCouponDetails;
|
|
160
|
-
/**
|
|
161
|
-
* Time zone for site on which member joined the program.
|
|
162
|
-
* @maxLength 50
|
|
163
|
-
* @readonly
|
|
164
|
-
*/
|
|
165
|
-
timeZone?: string;
|
|
166
|
-
/**
|
|
167
|
-
* Date when participant starts the program (is the same as join date if program does not have start date, otherwise can be later).
|
|
168
|
-
* @format LOCAL_DATE
|
|
169
|
-
* @readonly
|
|
170
|
-
*/
|
|
171
|
-
startDate?: string;
|
|
172
|
-
/**
|
|
173
|
-
* How participant joined the program.
|
|
174
|
-
* @immutable
|
|
175
|
-
*/
|
|
176
|
-
joinPath?: JoinPathWithLiterals;
|
|
177
|
-
/**
|
|
178
|
-
* Date before which participant has to finish the program (is not empty only if program itself has finish date).
|
|
179
|
-
* @format LOCAL_DATE
|
|
180
|
-
* @readonly
|
|
181
|
-
*/
|
|
182
|
-
finishDate?: string | null;
|
|
183
|
-
}
|
|
184
|
-
/** @oneof */
|
|
185
|
-
interface JoinedInfoJoinPathDetailsOneOf {
|
|
186
|
-
/** Details about Single Payment join path. */
|
|
187
|
-
singlePaymentDetails?: SinglePaymentDetails;
|
|
188
|
-
/** Details about Paid Plan join path. */
|
|
189
|
-
paidPlanDetails?: PaidPlanDetails;
|
|
190
|
-
/** Details about Free Coupon join path. */
|
|
191
|
-
freeCouponDetails?: FreeCouponDetails;
|
|
192
|
-
}
|
|
193
|
-
interface Member {
|
|
194
|
-
/**
|
|
195
|
-
* First name of the site member.
|
|
196
|
-
* @readonly
|
|
197
|
-
* @maxLength 1000
|
|
198
|
-
*/
|
|
199
|
-
firstName?: string | null;
|
|
200
|
-
/**
|
|
201
|
-
* Last name of the site member.
|
|
202
|
-
* @readonly
|
|
203
|
-
* @maxLength 1000
|
|
204
|
-
*/
|
|
205
|
-
lastName?: string | null;
|
|
206
|
-
/**
|
|
207
|
-
* Email of the site member.
|
|
208
|
-
* @readonly
|
|
209
|
-
* @format EMAIL
|
|
210
|
-
*/
|
|
211
|
-
email?: string | null;
|
|
212
|
-
/**
|
|
213
|
-
* Contact ID of the site member.
|
|
214
|
-
* @format GUID
|
|
215
|
-
* @readonly
|
|
216
|
-
*/
|
|
217
|
-
contactId?: string;
|
|
218
|
-
/**
|
|
219
|
-
* Profile image URL of the site member.
|
|
220
|
-
* @readonly
|
|
221
|
-
* @format WEB_URL
|
|
222
|
-
*/
|
|
223
|
-
profileImageUrl?: string | null;
|
|
224
|
-
}
|
|
225
|
-
interface ExtendedFields {
|
|
226
|
-
/**
|
|
227
|
-
* Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
|
|
228
|
-
* The value of each key is structured according to the schema defined when the extended fields were configured.
|
|
229
|
-
*
|
|
230
|
-
* You can only access fields for which you have the appropriate permissions.
|
|
231
|
-
*
|
|
232
|
-
* Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
|
|
233
|
-
*/
|
|
234
|
-
namespaces?: Record<string, Record<string, any>>;
|
|
235
|
-
}
|
|
236
|
-
/**
|
|
237
|
-
* Common object for tags.
|
|
238
|
-
* Should be use as in this example:
|
|
239
|
-
* message Foo {
|
|
240
|
-
* option (.wix.api.decomposite_of) = "wix.commons.v2.tags.Foo";
|
|
241
|
-
* string id = 1;
|
|
242
|
-
* ...
|
|
243
|
-
* Tags tags = 5
|
|
244
|
-
* }
|
|
245
|
-
*
|
|
246
|
-
* example of taggable entity
|
|
247
|
-
* {
|
|
248
|
-
* id: "123"
|
|
249
|
-
* tags: {
|
|
250
|
-
* public_tags: {
|
|
251
|
-
* tag_ids:["11","22"]
|
|
252
|
-
* },
|
|
253
|
-
* private_tags: {
|
|
254
|
-
* tag_ids: ["33", "44"]
|
|
255
|
-
* }
|
|
256
|
-
* }
|
|
257
|
-
* }
|
|
258
|
-
*/
|
|
259
|
-
interface Tags {
|
|
260
|
-
/** Tags that require an additional permission in order to access them, typically restricted from site members and visitors. */
|
|
261
|
-
privateTags?: TagList;
|
|
262
|
-
/** Tags that are exposed to anyone with access to the entity, including site members and visitors. */
|
|
263
|
-
publicTags?: TagList;
|
|
264
|
-
}
|
|
265
|
-
interface TagList {
|
|
266
|
-
/**
|
|
267
|
-
* List of tag IDs.
|
|
268
|
-
* @maxSize 100
|
|
269
|
-
* @maxLength 5
|
|
270
|
-
*/
|
|
271
|
-
tagIds?: string[];
|
|
272
|
-
}
|
|
273
|
-
interface ParticipantAdded {
|
|
274
|
-
/**
|
|
275
|
-
* Program ID which participant was added
|
|
276
|
-
* @format GUID
|
|
277
|
-
*/
|
|
278
|
-
programId?: string;
|
|
279
|
-
/**
|
|
280
|
-
* Member ID of participant on site
|
|
281
|
-
* @format GUID
|
|
282
|
-
*/
|
|
283
|
-
memberId?: string;
|
|
284
|
-
}
|
|
285
|
-
/** Domain event emitted when tags are modified */
|
|
286
|
-
interface TagsModified {
|
|
287
|
-
/** The Participant with updated tags */
|
|
288
|
-
participant?: Participant;
|
|
289
|
-
/** Tags that were assigned */
|
|
290
|
-
assignedTags?: Tags;
|
|
291
|
-
/** Tags that were unassigned */
|
|
292
|
-
unassignedTags?: Tags;
|
|
293
|
-
}
|
|
294
|
-
interface CreateParticipantRequest {
|
|
295
|
-
/** Participant to create */
|
|
296
|
-
participant: Participant;
|
|
297
|
-
}
|
|
298
|
-
interface CreateParticipantResponse {
|
|
299
|
-
/** Created participant */
|
|
300
|
-
participant?: Participant;
|
|
301
|
-
}
|
|
302
|
-
interface BulkCreateParticipantRequest {
|
|
303
|
-
/**
|
|
304
|
-
* List of participants you want to create
|
|
305
|
-
* @minSize 1
|
|
306
|
-
* @maxSize 100
|
|
307
|
-
*/
|
|
308
|
-
participants: Participant[];
|
|
309
|
-
/** Whether to return entities in response or not. */
|
|
310
|
-
returnEntity?: boolean;
|
|
311
|
-
}
|
|
312
|
-
interface BulkCreateParticipantResponse {
|
|
313
|
-
/**
|
|
314
|
-
* Results of bulk action.
|
|
315
|
-
* @minSize 1
|
|
316
|
-
* @maxSize 100
|
|
317
|
-
*/
|
|
318
|
-
results?: BulkParticipantResult[];
|
|
319
|
-
/** Metadata about whole bulk action. */
|
|
320
|
-
bulkActionMetadata?: CommonBulkActionMetadata;
|
|
321
|
-
}
|
|
322
|
-
interface BulkParticipantResult {
|
|
323
|
-
/** Metadata of item. */
|
|
324
|
-
itemMetadata?: CommonItemMetadata;
|
|
325
|
-
/** Item itself (empty if return_entity in request is false). */
|
|
326
|
-
item?: Participant;
|
|
327
|
-
}
|
|
328
|
-
interface CommonItemMetadata {
|
|
329
|
-
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
330
|
-
_id?: string | null;
|
|
331
|
-
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
332
|
-
originalIndex?: number;
|
|
333
|
-
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
334
|
-
success?: boolean;
|
|
335
|
-
/** Details about the error in case of failure. */
|
|
336
|
-
error?: ApplicationError;
|
|
337
|
-
}
|
|
338
|
-
interface ApplicationError {
|
|
339
|
-
/** Error code. */
|
|
340
|
-
code?: string;
|
|
341
|
-
/** Description of the error. */
|
|
342
|
-
description?: string;
|
|
343
|
-
/** Data related to the error. */
|
|
344
|
-
data?: Record<string, any> | null;
|
|
345
|
-
}
|
|
346
|
-
interface CommonBulkActionMetadata {
|
|
347
|
-
/** Number of items that were successfully processed. */
|
|
348
|
-
totalSuccesses?: number;
|
|
349
|
-
/** Number of items that couldn't be processed. */
|
|
350
|
-
totalFailures?: number;
|
|
351
|
-
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
352
|
-
undetailedFailures?: number;
|
|
353
|
-
}
|
|
354
|
-
interface BulkAddAllToProgramRequest {
|
|
355
|
-
/**
|
|
356
|
-
* Program to which bulk add participants.
|
|
357
|
-
* @format GUID
|
|
358
|
-
*/
|
|
359
|
-
programId: string;
|
|
360
|
-
/**
|
|
361
|
-
* Exclude site members.
|
|
362
|
-
* @format GUID
|
|
363
|
-
* @maxSize 100
|
|
364
|
-
*/
|
|
365
|
-
excludeMemberIds?: string[];
|
|
366
|
-
}
|
|
367
|
-
interface BulkAddAllToProgramResponse {
|
|
368
|
-
/**
|
|
369
|
-
* Async infra job id which will process the request.
|
|
370
|
-
* @format GUID
|
|
371
|
-
*/
|
|
372
|
-
jobId?: string;
|
|
373
|
-
}
|
|
374
|
-
interface DeleteParticipantRequest {
|
|
375
|
-
/**
|
|
376
|
-
* Participants to delete
|
|
377
|
-
* @format GUID
|
|
378
|
-
*/
|
|
379
|
-
participantId: string;
|
|
380
|
-
}
|
|
381
|
-
interface DeleteParticipantResponse {
|
|
382
|
-
}
|
|
383
|
-
interface IssueCertificateRequest {
|
|
384
|
-
/**
|
|
385
|
-
* Participant to get certificate
|
|
386
|
-
* @format GUID
|
|
387
|
-
*/
|
|
388
|
-
participantId: string;
|
|
389
|
-
}
|
|
390
|
-
interface IssueCertificateResponse {
|
|
391
|
-
/** Updated participant */
|
|
392
|
-
participant?: Participant;
|
|
393
|
-
}
|
|
394
|
-
interface GetCompletionStatsRequest {
|
|
395
|
-
/**
|
|
396
|
-
* program id to get stats for
|
|
397
|
-
* @format GUID
|
|
398
|
-
*/
|
|
399
|
-
programId: string;
|
|
400
|
-
}
|
|
401
|
-
interface GetCompletionStatsResponse {
|
|
402
|
-
/** Number of participants that completed the program */
|
|
403
|
-
completedAll?: number;
|
|
404
|
-
/** Percentage of participants that completed the program */
|
|
405
|
-
completionRate?: number;
|
|
406
|
-
}
|
|
407
|
-
interface GetPremiumStatsRequest {
|
|
408
|
-
}
|
|
409
|
-
interface GetPremiumStatsResponse {
|
|
410
|
-
/** True if site has Online Programs premium feature */
|
|
411
|
-
hasPremium?: boolean;
|
|
412
|
-
/** Count of active participants on the site */
|
|
413
|
-
activeParticipantsCount?: number;
|
|
414
|
-
/** Limit of active participants on a site without premium */
|
|
415
|
-
activeParticipantsLimit?: number;
|
|
416
|
-
}
|
|
417
|
-
interface GetParticipantRequest {
|
|
418
|
-
/**
|
|
419
|
-
* Participant id to fetch
|
|
420
|
-
* @format GUID
|
|
421
|
-
*/
|
|
422
|
-
participantId: string;
|
|
423
|
-
}
|
|
424
|
-
interface GetParticipantResponse {
|
|
425
|
-
/** existing participant */
|
|
426
|
-
participant?: Participant;
|
|
427
|
-
}
|
|
428
|
-
interface QueryParticipantsRequest {
|
|
429
|
-
/** Platformized query */
|
|
430
|
-
query?: CursorQuery;
|
|
431
|
-
}
|
|
432
|
-
interface CursorQuery extends CursorQueryPagingMethodOneOf {
|
|
433
|
-
/**
|
|
434
|
-
* Cursor paging options.
|
|
435
|
-
*
|
|
436
|
-
* Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
437
|
-
*/
|
|
438
|
-
cursorPaging?: CursorPaging;
|
|
439
|
-
/**
|
|
440
|
-
* Filter object.
|
|
441
|
-
*
|
|
442
|
-
* Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
|
|
443
|
-
*/
|
|
444
|
-
filter?: Record<string, any> | null;
|
|
445
|
-
/**
|
|
446
|
-
* Sort object.
|
|
447
|
-
*
|
|
448
|
-
* Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
|
|
449
|
-
* @maxSize 5
|
|
450
|
-
*/
|
|
451
|
-
sort?: Sorting[];
|
|
452
|
-
}
|
|
453
|
-
/** @oneof */
|
|
454
|
-
interface CursorQueryPagingMethodOneOf {
|
|
455
|
-
/**
|
|
456
|
-
* Cursor paging options.
|
|
457
|
-
*
|
|
458
|
-
* Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
459
|
-
*/
|
|
460
|
-
cursorPaging?: CursorPaging;
|
|
461
|
-
}
|
|
462
|
-
interface Sorting {
|
|
463
|
-
/**
|
|
464
|
-
* Name of the field to sort by.
|
|
465
|
-
* @maxLength 512
|
|
466
|
-
*/
|
|
467
|
-
fieldName?: string;
|
|
468
|
-
/** Sort order. */
|
|
469
|
-
order?: SortOrderWithLiterals;
|
|
470
|
-
}
|
|
471
|
-
declare enum SortOrder {
|
|
472
|
-
ASC = "ASC",
|
|
473
|
-
DESC = "DESC"
|
|
474
|
-
}
|
|
475
|
-
/** @enumType */
|
|
476
|
-
type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
|
|
477
|
-
interface CursorPaging {
|
|
478
|
-
/**
|
|
479
|
-
* Maximum number of items to return in the results.
|
|
480
|
-
* @max 100
|
|
481
|
-
*/
|
|
482
|
-
limit?: number | null;
|
|
483
|
-
/**
|
|
484
|
-
* Pointer to the next or previous page in the list of results.
|
|
485
|
-
*
|
|
486
|
-
* Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
|
|
487
|
-
* Not relevant for the first request.
|
|
488
|
-
* @maxLength 16000
|
|
489
|
-
*/
|
|
490
|
-
cursor?: string | null;
|
|
491
|
-
}
|
|
492
|
-
interface QueryParticipantsResponse {
|
|
493
|
-
/** found participants */
|
|
494
|
-
participants?: Participant[];
|
|
495
|
-
/** paging metadata */
|
|
496
|
-
pagingMetadata?: CursorPagingMetadata;
|
|
497
|
-
}
|
|
498
|
-
interface CursorPagingMetadata {
|
|
499
|
-
/** Number of items returned in current page. */
|
|
500
|
-
count?: number | null;
|
|
501
|
-
/** Cursor strings that point to the next page, previous page, or both. */
|
|
502
|
-
cursors?: Cursors;
|
|
503
|
-
/**
|
|
504
|
-
* Whether there are more pages to retrieve following the current page.
|
|
505
|
-
*
|
|
506
|
-
* + `true`: Another page of results can be retrieved.
|
|
507
|
-
* + `false`: This is the last page.
|
|
508
|
-
*/
|
|
509
|
-
hasNext?: boolean | null;
|
|
510
|
-
}
|
|
511
|
-
interface Cursors {
|
|
512
|
-
/**
|
|
513
|
-
* Cursor string pointing to the next page in the list of results.
|
|
514
|
-
* @maxLength 16000
|
|
515
|
-
*/
|
|
516
|
-
next?: string | null;
|
|
517
|
-
/**
|
|
518
|
-
* Cursor pointing to the previous page in the list of results.
|
|
519
|
-
* @maxLength 16000
|
|
520
|
-
*/
|
|
521
|
-
prev?: string | null;
|
|
522
|
-
}
|
|
523
|
-
interface GetAccessStatusRequest {
|
|
524
|
-
}
|
|
525
|
-
interface GetAccessStatusResponse {
|
|
526
|
-
/** True if participants cannot access online programs due to some limitations */
|
|
527
|
-
blocked?: boolean;
|
|
528
|
-
}
|
|
529
|
-
interface BulkUpdateParticipantTagsRequest {
|
|
530
|
-
/**
|
|
531
|
-
* Participant IDs to update tags for (1-100 items)
|
|
532
|
-
* @minSize 1
|
|
533
|
-
* @maxSize 100
|
|
534
|
-
* @format GUID
|
|
535
|
-
*/
|
|
536
|
-
participantIds: string[];
|
|
537
|
-
/** Tags to assign to the Participants */
|
|
538
|
-
assignTags?: Tags;
|
|
539
|
-
/** Tags to unassign from the Participants */
|
|
540
|
-
unassignTags?: Tags;
|
|
541
|
-
}
|
|
542
|
-
interface BulkUpdateParticipantTagsResponse {
|
|
543
|
-
/**
|
|
544
|
-
* Results for each Participant
|
|
545
|
-
* @minSize 1
|
|
546
|
-
* @maxSize 100
|
|
547
|
-
*/
|
|
548
|
-
results?: BulkUpdateParticipantTagsResult[];
|
|
549
|
-
/** Metadata about the bulk operation */
|
|
550
|
-
bulkActionMetadata?: CommonBulkActionMetadata;
|
|
551
|
-
}
|
|
552
|
-
interface BulkUpdateParticipantTagsResult {
|
|
553
|
-
/** Metadata for this specific item */
|
|
554
|
-
itemMetadata?: CommonItemMetadata;
|
|
555
|
-
}
|
|
556
|
-
interface BulkUpdateParticipantTagsByFilterRequest {
|
|
557
|
-
/** WQL filter to select Participants */
|
|
558
|
-
filter: Record<string, any> | null;
|
|
559
|
-
/** Tags to assign to matching Participants */
|
|
560
|
-
assignTags?: Tags;
|
|
561
|
-
/** Tags to unassign from matching Participants */
|
|
562
|
-
unassignTags?: Tags;
|
|
563
|
-
}
|
|
564
|
-
interface BulkUpdateParticipantTagsByFilterResponse {
|
|
565
|
-
/**
|
|
566
|
-
* Job ID for tracking the async operation
|
|
567
|
-
* @format GUID
|
|
568
|
-
*/
|
|
569
|
-
jobId?: string;
|
|
570
|
-
}
|
|
571
|
-
interface SearchParticipantsRequest {
|
|
572
|
-
/** Query to search programs */
|
|
573
|
-
search?: CursorSearch;
|
|
574
|
-
}
|
|
575
|
-
interface CursorSearch extends CursorSearchPagingMethodOneOf {
|
|
576
|
-
/**
|
|
577
|
-
* Cursor paging options.
|
|
578
|
-
*
|
|
579
|
-
* Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
580
|
-
*/
|
|
581
|
-
cursorPaging?: CursorPaging;
|
|
582
|
-
/**
|
|
583
|
-
* Filter object.
|
|
584
|
-
*
|
|
585
|
-
* Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
|
|
586
|
-
*/
|
|
587
|
-
filter?: Record<string, any> | null;
|
|
588
|
-
/**
|
|
589
|
-
* List of sort objects.
|
|
590
|
-
*
|
|
591
|
-
* Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
|
|
592
|
-
* @maxSize 10
|
|
593
|
-
*/
|
|
594
|
-
sort?: Sorting[];
|
|
595
|
-
/**
|
|
596
|
-
* Logical groupings of data into facets, with summaries for each facet. For example, use aggregations to allow site visitors to narrow down their search results by selecting specific categories.
|
|
597
|
-
* @maxSize 10
|
|
598
|
-
*/
|
|
599
|
-
aggregations?: Aggregation[];
|
|
600
|
-
/** Free text to match in searchable fields. */
|
|
601
|
-
search?: SearchDetails;
|
|
602
|
-
/**
|
|
603
|
-
* Time zone to adjust date-time-based filters and aggregations, in ISO 8601 (including offsets) or IANA time zone database (including time zone IDs) format.
|
|
604
|
-
* Applies to all relevant filters and aggregations, unless overridden by providing timestamps including time zone. For example, "2023-12-20T10:52:34.795Z".
|
|
605
|
-
* @maxLength 50
|
|
606
|
-
*/
|
|
607
|
-
timeZone?: string | null;
|
|
608
|
-
}
|
|
609
|
-
/** @oneof */
|
|
610
|
-
interface CursorSearchPagingMethodOneOf {
|
|
611
|
-
/**
|
|
612
|
-
* Cursor paging options.
|
|
613
|
-
*
|
|
614
|
-
* Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
615
|
-
*/
|
|
616
|
-
cursorPaging?: CursorPaging;
|
|
617
|
-
}
|
|
618
|
-
interface Aggregation extends AggregationKindOneOf {
|
|
619
|
-
/** A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store. */
|
|
620
|
-
value?: ValueAggregation;
|
|
621
|
-
/** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. */
|
|
622
|
-
range?: RangeAggregation;
|
|
623
|
-
/** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
624
|
-
scalar?: ScalarAggregation;
|
|
625
|
-
/** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week. */
|
|
626
|
-
dateHistogram?: DateHistogramAggregation;
|
|
627
|
-
/** A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`. */
|
|
628
|
-
nested?: NestedAggregation;
|
|
629
|
-
/**
|
|
630
|
-
* Aggregation name, returned in `aggregations.results.name`.
|
|
631
|
-
* @maxLength 100
|
|
632
|
-
*/
|
|
633
|
-
name?: string | null;
|
|
634
|
-
/** Type of aggregation to perform. Must align with the corresponding aggregation field. */
|
|
635
|
-
type?: AggregationTypeWithLiterals;
|
|
636
|
-
/**
|
|
637
|
-
* Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
|
|
638
|
-
* @maxLength 200
|
|
639
|
-
*/
|
|
640
|
-
fieldPath?: string;
|
|
641
|
-
/**
|
|
642
|
-
* Deprecated. Use `nested` instead.
|
|
643
|
-
* @deprecated Deprecated. Use `nested` instead.
|
|
644
|
-
* @replacedBy kind.nested
|
|
645
|
-
* @targetRemovalDate 2024-03-30
|
|
646
|
-
*/
|
|
647
|
-
groupBy?: GroupByAggregation;
|
|
648
|
-
}
|
|
649
|
-
/** @oneof */
|
|
650
|
-
interface AggregationKindOneOf {
|
|
651
|
-
/** A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store. */
|
|
652
|
-
value?: ValueAggregation;
|
|
653
|
-
/** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. */
|
|
654
|
-
range?: RangeAggregation;
|
|
655
|
-
/** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
656
|
-
scalar?: ScalarAggregation;
|
|
657
|
-
/** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week. */
|
|
658
|
-
dateHistogram?: DateHistogramAggregation;
|
|
659
|
-
/** A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`. */
|
|
660
|
-
nested?: NestedAggregation;
|
|
661
|
-
}
|
|
662
|
-
interface RangeBucket {
|
|
663
|
-
/** Inclusive lower bound of the range. Required if `to` is not provided. */
|
|
664
|
-
from?: number | null;
|
|
665
|
-
/** Exclusive upper bound of the range. Required if `from` is not provided. */
|
|
666
|
-
to?: number | null;
|
|
667
|
-
}
|
|
668
|
-
declare enum SortType {
|
|
669
|
-
/** Number of matches in the results. */
|
|
670
|
-
COUNT = "COUNT",
|
|
671
|
-
/** Alphabetically by the field value. */
|
|
672
|
-
VALUE = "VALUE"
|
|
673
|
-
}
|
|
674
|
-
/** @enumType */
|
|
675
|
-
type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
|
|
676
|
-
declare enum SortDirection {
|
|
677
|
-
/** Descending order. */
|
|
678
|
-
DESC = "DESC",
|
|
679
|
-
/** Ascending order. */
|
|
680
|
-
ASC = "ASC"
|
|
681
|
-
}
|
|
682
|
-
/** @enumType */
|
|
683
|
-
type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
|
|
684
|
-
declare enum MissingValues {
|
|
685
|
-
/** Exclude missing values from the aggregation results. */
|
|
686
|
-
EXCLUDE = "EXCLUDE",
|
|
687
|
-
/** Include missing values in the aggregation results. */
|
|
688
|
-
INCLUDE = "INCLUDE"
|
|
689
|
-
}
|
|
690
|
-
/** @enumType */
|
|
691
|
-
type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
|
|
692
|
-
interface IncludeMissingValuesOptions {
|
|
693
|
-
/**
|
|
694
|
-
* Specify a custom name for the bucket containing the missing values. Defaults are `"N/A"` for strings, `0` for integers, and `false` for booleans.
|
|
695
|
-
* @maxLength 20
|
|
696
|
-
*/
|
|
697
|
-
addToBucket?: string;
|
|
698
|
-
}
|
|
699
|
-
declare enum ScalarType {
|
|
700
|
-
UNKNOWN_SCALAR_TYPE = "UNKNOWN_SCALAR_TYPE",
|
|
701
|
-
/** Total number of distinct values. */
|
|
702
|
-
COUNT_DISTINCT = "COUNT_DISTINCT",
|
|
703
|
-
/** Minimum value. */
|
|
704
|
-
MIN = "MIN",
|
|
705
|
-
/** Maximum value. */
|
|
706
|
-
MAX = "MAX"
|
|
707
|
-
}
|
|
708
|
-
/** @enumType */
|
|
709
|
-
type ScalarTypeWithLiterals = ScalarType | 'UNKNOWN_SCALAR_TYPE' | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
|
|
710
|
-
interface ValueAggregation extends ValueAggregationOptionsOneOf {
|
|
711
|
-
/** Options for including missing values in results. */
|
|
712
|
-
includeOptions?: IncludeMissingValuesOptions;
|
|
713
|
-
/** Sort type. */
|
|
714
|
-
sortType?: SortTypeWithLiterals;
|
|
715
|
-
/** Sort direction. */
|
|
716
|
-
sortDirection?: SortDirectionWithLiterals;
|
|
717
|
-
/**
|
|
718
|
-
* Number of aggregation results to return.
|
|
719
|
-
* Min: `1`
|
|
720
|
-
* Max: `250`
|
|
721
|
-
* Default: `10`
|
|
722
|
-
*/
|
|
723
|
-
limit?: number | null;
|
|
724
|
-
/**
|
|
725
|
-
* Whether to include or exclude missing values in the aggregation results.
|
|
726
|
-
* Default: `EXCLUDE`.
|
|
727
|
-
*/
|
|
728
|
-
missingValues?: MissingValuesWithLiterals;
|
|
729
|
-
}
|
|
730
|
-
/** @oneof */
|
|
731
|
-
interface ValueAggregationOptionsOneOf {
|
|
732
|
-
/** Options for including missing values in results. */
|
|
733
|
-
includeOptions?: IncludeMissingValuesOptions;
|
|
734
|
-
}
|
|
735
|
-
declare enum NestedAggregationType {
|
|
736
|
-
UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
|
|
737
|
-
/** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
|
|
738
|
-
VALUE = "VALUE",
|
|
739
|
-
/** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
|
|
740
|
-
RANGE = "RANGE",
|
|
741
|
-
/** Calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
742
|
-
SCALAR = "SCALAR",
|
|
743
|
-
/** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
|
|
744
|
-
DATE_HISTOGRAM = "DATE_HISTOGRAM"
|
|
745
|
-
}
|
|
746
|
-
/** @enumType */
|
|
747
|
-
type NestedAggregationTypeWithLiterals = NestedAggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
|
|
748
|
-
interface RangeAggregation {
|
|
749
|
-
/**
|
|
750
|
-
* List of range buckets. During aggregation each entity is placed in the first bucket its value falls into, based on the provided range bounds.
|
|
751
|
-
* @maxSize 50
|
|
752
|
-
*/
|
|
753
|
-
buckets?: RangeBucket[];
|
|
754
|
-
}
|
|
755
|
-
interface ScalarAggregation {
|
|
756
|
-
/** Operator type for the scalar aggregation. */
|
|
757
|
-
type?: ScalarTypeWithLiterals;
|
|
758
|
-
}
|
|
759
|
-
interface DateHistogramAggregation {
|
|
760
|
-
/** Interval for date histogram aggregation. */
|
|
761
|
-
interval?: IntervalWithLiterals;
|
|
762
|
-
}
|
|
763
|
-
declare enum Interval {
|
|
764
|
-
UNKNOWN_INTERVAL = "UNKNOWN_INTERVAL",
|
|
765
|
-
YEAR = "YEAR",
|
|
766
|
-
MONTH = "MONTH",
|
|
767
|
-
WEEK = "WEEK",
|
|
768
|
-
DAY = "DAY",
|
|
769
|
-
HOUR = "HOUR",
|
|
770
|
-
MINUTE = "MINUTE",
|
|
771
|
-
SECOND = "SECOND"
|
|
772
|
-
}
|
|
773
|
-
/** @enumType */
|
|
774
|
-
type IntervalWithLiterals = Interval | 'UNKNOWN_INTERVAL' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
|
|
775
|
-
interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
|
|
776
|
-
/** A value aggregation calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of orders for each order status. */
|
|
777
|
-
value?: ValueAggregation;
|
|
778
|
-
/** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
|
|
779
|
-
range?: RangeAggregation;
|
|
780
|
-
/** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
781
|
-
scalar?: ScalarAggregation;
|
|
782
|
-
/** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). For example, use a date histogram to determine how many reservations have been made at a restaurant each week. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
|
|
783
|
-
dateHistogram?: DateHistogramAggregation;
|
|
784
|
-
/**
|
|
785
|
-
* Unique, caller-defined aggregation name, returned in `aggregations.results`.
|
|
786
|
-
* @maxLength 100
|
|
787
|
-
*/
|
|
788
|
-
name?: string | null;
|
|
789
|
-
/** Type of aggregation to perform. The matching aggregation field must be passed. */
|
|
790
|
-
type?: NestedAggregationTypeWithLiterals;
|
|
791
|
-
/**
|
|
792
|
-
* Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
|
|
793
|
-
* @maxLength 200
|
|
794
|
-
*/
|
|
795
|
-
fieldPath?: string;
|
|
796
|
-
}
|
|
797
|
-
/** @oneof */
|
|
798
|
-
interface NestedAggregationItemKindOneOf {
|
|
799
|
-
/** A value aggregation calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of orders for each order status. */
|
|
800
|
-
value?: ValueAggregation;
|
|
801
|
-
/** A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
|
|
802
|
-
range?: RangeAggregation;
|
|
803
|
-
/** A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
804
|
-
scalar?: ScalarAggregation;
|
|
805
|
-
/** A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). For example, use a date histogram to determine how many reservations have been made at a restaurant each week. If ranges overlap, a record that fits more than one range will only be counted in the first range that matches the criteria. */
|
|
806
|
-
dateHistogram?: DateHistogramAggregation;
|
|
807
|
-
}
|
|
808
|
-
declare enum AggregationType {
|
|
809
|
-
UNKNOWN_AGGREGATION_TYPE = "UNKNOWN_AGGREGATION_TYPE",
|
|
810
|
-
/** Calculates the distribution of a specific field's values within a dataset, providing insights into the overall distribution and key statistics of those values. */
|
|
811
|
-
VALUE = "VALUE",
|
|
812
|
-
/** Calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. */
|
|
813
|
-
RANGE = "RANGE",
|
|
814
|
-
/** Calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`. */
|
|
815
|
-
SCALAR = "SCALAR",
|
|
816
|
-
/** Calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.). */
|
|
817
|
-
DATE_HISTOGRAM = "DATE_HISTOGRAM",
|
|
818
|
-
/** Flattened list of aggregations, where each aggregation is nested within previous one. */
|
|
819
|
-
NESTED = "NESTED"
|
|
820
|
-
}
|
|
821
|
-
/** @enumType */
|
|
822
|
-
type AggregationTypeWithLiterals = AggregationType | 'UNKNOWN_AGGREGATION_TYPE' | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
|
|
823
|
-
/** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one. */
|
|
824
|
-
interface NestedAggregation {
|
|
825
|
-
/**
|
|
826
|
-
* Flattened list of aggregations, where each aggregation is nested within previous one.
|
|
827
|
-
* @minSize 2
|
|
828
|
-
* @maxSize 3
|
|
829
|
-
*/
|
|
830
|
-
nestedAggregations?: NestedAggregationItem[];
|
|
831
|
-
}
|
|
832
|
-
interface GroupByAggregation extends GroupByAggregationKindOneOf {
|
|
833
|
-
/** Value aggregation configuration. */
|
|
834
|
-
value?: ValueAggregation;
|
|
835
|
-
/**
|
|
836
|
-
* Unique, caller-defined aggregation name, returned in `aggregations.results`.
|
|
837
|
-
* @maxLength 100
|
|
838
|
-
*/
|
|
839
|
-
name?: string | null;
|
|
840
|
-
/**
|
|
841
|
-
* Field to aggregate by.
|
|
842
|
-
* @maxLength 200
|
|
843
|
-
*/
|
|
844
|
-
fieldPath?: string;
|
|
845
|
-
}
|
|
846
|
-
/** @oneof */
|
|
847
|
-
interface GroupByAggregationKindOneOf {
|
|
848
|
-
/** Value aggregation configuration. */
|
|
849
|
-
value?: ValueAggregation;
|
|
850
|
-
}
|
|
851
|
-
interface SearchDetails {
|
|
852
|
-
/** Search mode. Defines the search logic for combining multiple terms in the `expression`. */
|
|
853
|
-
mode?: ModeWithLiterals;
|
|
854
|
-
/**
|
|
855
|
-
* Search term or expression.
|
|
856
|
-
* @maxLength 100
|
|
857
|
-
*/
|
|
858
|
-
expression?: string | null;
|
|
859
|
-
/**
|
|
860
|
-
* Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
|
|
861
|
-
* @maxLength 200
|
|
862
|
-
* @maxSize 20
|
|
863
|
-
*/
|
|
864
|
-
fields?: string[];
|
|
865
|
-
/** Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions. */
|
|
866
|
-
fuzzy?: boolean;
|
|
867
|
-
}
|
|
868
|
-
declare enum Mode {
|
|
869
|
-
/** At least one of the search terms must be present. */
|
|
870
|
-
OR = "OR",
|
|
871
|
-
/** All search terms must be present. */
|
|
872
|
-
AND = "AND"
|
|
873
|
-
}
|
|
874
|
-
/** @enumType */
|
|
875
|
-
type ModeWithLiterals = Mode | 'OR' | 'AND';
|
|
876
|
-
interface SearchParticipantsResponse {
|
|
877
|
-
/** Participants matching the search criteria. */
|
|
878
|
-
participants?: Participant[];
|
|
879
|
-
/** Paging metadata. */
|
|
880
|
-
pagingMetadata?: CursorPagingMetadata;
|
|
881
|
-
/** Aggregation data in case aggregations were requested. */
|
|
882
|
-
aggregationData?: AggregationData;
|
|
883
|
-
}
|
|
884
|
-
interface AggregationData {
|
|
885
|
-
/**
|
|
886
|
-
* key = aggregation name (as derived from search request).
|
|
887
|
-
* @maxSize 10000
|
|
888
|
-
*/
|
|
889
|
-
results?: AggregationResults[];
|
|
890
|
-
}
|
|
891
|
-
interface ValueAggregationResult {
|
|
892
|
-
/**
|
|
893
|
-
* Value of the field.
|
|
894
|
-
* @maxLength 100
|
|
895
|
-
*/
|
|
896
|
-
value?: string;
|
|
897
|
-
/** Count of entities with this value. */
|
|
898
|
-
count?: number;
|
|
899
|
-
}
|
|
900
|
-
interface RangeAggregationResult {
|
|
901
|
-
/** Inclusive lower bound of the range. */
|
|
902
|
-
from?: number | null;
|
|
903
|
-
/** Exclusive upper bound of the range. */
|
|
904
|
-
to?: number | null;
|
|
905
|
-
/** Count of entities in this range. */
|
|
906
|
-
count?: number;
|
|
907
|
-
}
|
|
908
|
-
interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
|
|
909
|
-
/** Value aggregation results. */
|
|
910
|
-
values?: ValueResults;
|
|
911
|
-
/** Range aggregation results. */
|
|
912
|
-
ranges?: RangeResults;
|
|
913
|
-
/** Scalar aggregation results. */
|
|
914
|
-
scalar?: AggregationResultsScalarResult;
|
|
915
|
-
/**
|
|
916
|
-
* User-defined name of aggregation, matches the one provided in request.
|
|
917
|
-
* @maxLength 100
|
|
918
|
-
*/
|
|
919
|
-
name?: string;
|
|
920
|
-
/** Type of aggregation that matches result. */
|
|
921
|
-
type?: AggregationTypeWithLiterals;
|
|
922
|
-
/**
|
|
923
|
-
* Field to aggregate by, matches the one provided in request.
|
|
924
|
-
* @maxLength 200
|
|
925
|
-
*/
|
|
926
|
-
fieldPath?: string;
|
|
927
|
-
}
|
|
928
|
-
/** @oneof */
|
|
929
|
-
interface NestedAggregationResultsResultOneOf {
|
|
930
|
-
/** Value aggregation results. */
|
|
931
|
-
values?: ValueResults;
|
|
932
|
-
/** Range aggregation results. */
|
|
933
|
-
ranges?: RangeResults;
|
|
934
|
-
/** Scalar aggregation results. */
|
|
935
|
-
scalar?: AggregationResultsScalarResult;
|
|
936
|
-
}
|
|
937
|
-
interface ValueResults {
|
|
938
|
-
/**
|
|
939
|
-
* List of value aggregations.
|
|
940
|
-
* @maxSize 250
|
|
941
|
-
*/
|
|
942
|
-
results?: ValueAggregationResult[];
|
|
943
|
-
}
|
|
944
|
-
interface RangeResults {
|
|
945
|
-
/**
|
|
946
|
-
* List of ranges returned in same order as requested.
|
|
947
|
-
* @maxSize 50
|
|
948
|
-
*/
|
|
949
|
-
results?: RangeAggregationResult[];
|
|
950
|
-
}
|
|
951
|
-
interface AggregationResultsScalarResult {
|
|
952
|
-
/** Type of scalar aggregation. */
|
|
953
|
-
type?: ScalarTypeWithLiterals;
|
|
954
|
-
/** Value of the scalar aggregation. */
|
|
955
|
-
value?: number;
|
|
956
|
-
}
|
|
957
|
-
interface NestedValueAggregationResult {
|
|
958
|
-
/**
|
|
959
|
-
* Value of the field.
|
|
960
|
-
* @maxLength 1000
|
|
961
|
-
*/
|
|
962
|
-
value?: string;
|
|
963
|
-
/** Nested aggregations. */
|
|
964
|
-
nestedResults?: NestedAggregationResults;
|
|
965
|
-
}
|
|
966
|
-
interface ValueResult {
|
|
967
|
-
/**
|
|
968
|
-
* Value of the field.
|
|
969
|
-
* @maxLength 1000
|
|
970
|
-
*/
|
|
971
|
-
value?: string;
|
|
972
|
-
/** Count of entities with this value. */
|
|
973
|
-
count?: number | null;
|
|
974
|
-
}
|
|
975
|
-
interface RangeResult {
|
|
976
|
-
/** Inclusive lower bound of the range. */
|
|
977
|
-
from?: number | null;
|
|
978
|
-
/** Exclusive upper bound of the range. */
|
|
979
|
-
to?: number | null;
|
|
980
|
-
/** Count of entities in this range. */
|
|
981
|
-
count?: number | null;
|
|
982
|
-
}
|
|
983
|
-
interface ScalarResult {
|
|
984
|
-
/** Value of the scalar aggregation. */
|
|
985
|
-
value?: number;
|
|
986
|
-
}
|
|
987
|
-
interface NestedResultValue extends NestedResultValueResultOneOf {
|
|
988
|
-
/** Value aggregation result. */
|
|
989
|
-
value?: ValueResult;
|
|
990
|
-
/** Range aggregation result. */
|
|
991
|
-
range?: RangeResult;
|
|
992
|
-
/** Scalar aggregation result. */
|
|
993
|
-
scalar?: ScalarResult;
|
|
994
|
-
/** Date histogram aggregation result. */
|
|
995
|
-
dateHistogram?: ValueResult;
|
|
996
|
-
}
|
|
997
|
-
/** @oneof */
|
|
998
|
-
interface NestedResultValueResultOneOf {
|
|
999
|
-
/** Value aggregation result. */
|
|
1000
|
-
value?: ValueResult;
|
|
1001
|
-
/** Range aggregation result. */
|
|
1002
|
-
range?: RangeResult;
|
|
1003
|
-
/** Scalar aggregation result. */
|
|
1004
|
-
scalar?: ScalarResult;
|
|
1005
|
-
/** Date histogram aggregation result. */
|
|
1006
|
-
dateHistogram?: ValueResult;
|
|
1007
|
-
}
|
|
1008
|
-
interface Results {
|
|
1009
|
-
/** List of nested aggregations. */
|
|
1010
|
-
results?: Record<string, NestedResultValue>;
|
|
1011
|
-
}
|
|
1012
|
-
interface DateHistogramResult {
|
|
1013
|
-
/**
|
|
1014
|
-
* Date in ISO 8601 format.
|
|
1015
|
-
* @maxLength 100
|
|
1016
|
-
*/
|
|
1017
|
-
value?: string;
|
|
1018
|
-
/** Count of documents in the bucket. */
|
|
1019
|
-
count?: number;
|
|
1020
|
-
}
|
|
1021
|
-
interface GroupByValueResults {
|
|
1022
|
-
/**
|
|
1023
|
-
* List of value aggregations.
|
|
1024
|
-
* @maxSize 1000
|
|
1025
|
-
*/
|
|
1026
|
-
results?: NestedValueAggregationResult[];
|
|
1027
|
-
}
|
|
1028
|
-
interface DateHistogramResults {
|
|
1029
|
-
/**
|
|
1030
|
-
* List of date histogram aggregations.
|
|
1031
|
-
* @maxSize 200
|
|
1032
|
-
*/
|
|
1033
|
-
results?: DateHistogramResult[];
|
|
1034
|
-
}
|
|
1035
|
-
/**
|
|
1036
|
-
* Results of `NESTED` aggregation type in a flattened form.
|
|
1037
|
-
* Aggregations in resulting array are keyed by requested aggregation `name`.
|
|
1038
|
-
*/
|
|
1039
|
-
interface NestedResults {
|
|
1040
|
-
/**
|
|
1041
|
-
* List of nested aggregations.
|
|
1042
|
-
* @maxSize 1000
|
|
1043
|
-
*/
|
|
1044
|
-
results?: Results[];
|
|
1045
|
-
}
|
|
1046
|
-
interface AggregationResults extends AggregationResultsResultOneOf {
|
|
1047
|
-
/** Value aggregation results. */
|
|
1048
|
-
values?: ValueResults;
|
|
1049
|
-
/** Range aggregation results. */
|
|
1050
|
-
ranges?: RangeResults;
|
|
1051
|
-
/** Scalar aggregation results. */
|
|
1052
|
-
scalar?: AggregationResultsScalarResult;
|
|
1053
|
-
/** Group by value aggregation results. */
|
|
1054
|
-
groupedByValue?: GroupByValueResults;
|
|
1055
|
-
/** Date histogram aggregation results. */
|
|
1056
|
-
dateHistogram?: DateHistogramResults;
|
|
1057
|
-
/** Nested aggregation results. */
|
|
1058
|
-
nested?: NestedResults;
|
|
1059
|
-
/**
|
|
1060
|
-
* User-defined name of aggregation as derived from search request.
|
|
1061
|
-
* @maxLength 100
|
|
1062
|
-
*/
|
|
1063
|
-
name?: string;
|
|
1064
|
-
/** Type of aggregation that must match provided kind as derived from search request. */
|
|
1065
|
-
type?: AggregationTypeWithLiterals;
|
|
1066
|
-
/**
|
|
1067
|
-
* Field to aggregate by as derived from search request.
|
|
1068
|
-
* @maxLength 200
|
|
1069
|
-
*/
|
|
1070
|
-
fieldPath?: string;
|
|
1071
|
-
}
|
|
1072
|
-
/** @oneof */
|
|
1073
|
-
interface AggregationResultsResultOneOf {
|
|
1074
|
-
/** Value aggregation results. */
|
|
1075
|
-
values?: ValueResults;
|
|
1076
|
-
/** Range aggregation results. */
|
|
1077
|
-
ranges?: RangeResults;
|
|
1078
|
-
/** Scalar aggregation results. */
|
|
1079
|
-
scalar?: AggregationResultsScalarResult;
|
|
1080
|
-
/** Group by value aggregation results. */
|
|
1081
|
-
groupedByValue?: GroupByValueResults;
|
|
1082
|
-
/** Date histogram aggregation results. */
|
|
1083
|
-
dateHistogram?: DateHistogramResults;
|
|
1084
|
-
/** Nested aggregation results. */
|
|
1085
|
-
nested?: NestedResults;
|
|
1086
|
-
}
|
|
1087
|
-
interface DomainEvent extends DomainEventBodyOneOf {
|
|
1088
|
-
createdEvent?: EntityCreatedEvent;
|
|
1089
|
-
updatedEvent?: EntityUpdatedEvent;
|
|
1090
|
-
deletedEvent?: EntityDeletedEvent;
|
|
1091
|
-
actionEvent?: ActionEvent;
|
|
1092
|
-
/** Event ID. With this ID you can easily spot duplicated events and ignore them. */
|
|
1093
|
-
_id?: string;
|
|
1094
|
-
/**
|
|
1095
|
-
* Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
|
|
1096
|
-
* For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
|
|
1097
|
-
*/
|
|
1098
|
-
entityFqdn?: string;
|
|
1099
|
-
/**
|
|
1100
|
-
* Event action name, placed at the top level to make it easier for users to dispatch messages.
|
|
1101
|
-
* For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
|
|
1102
|
-
*/
|
|
1103
|
-
slug?: string;
|
|
1104
|
-
/** ID of the entity associated with the event. */
|
|
1105
|
-
entityId?: string;
|
|
1106
|
-
/** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
|
|
1107
|
-
eventTime?: Date | null;
|
|
1108
|
-
/**
|
|
1109
|
-
* Whether the event was triggered as a result of a privacy regulation application
|
|
1110
|
-
* (for example, GDPR).
|
|
1111
|
-
*/
|
|
1112
|
-
triggeredByAnonymizeRequest?: boolean | null;
|
|
1113
|
-
/** If present, indicates the action that triggered the event. */
|
|
1114
|
-
originatedFrom?: string | null;
|
|
1115
|
-
/**
|
|
1116
|
-
* A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
|
|
1117
|
-
* You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
|
|
1118
|
-
*/
|
|
1119
|
-
entityEventSequence?: string | null;
|
|
1120
|
-
}
|
|
1121
|
-
/** @oneof */
|
|
1122
|
-
interface DomainEventBodyOneOf {
|
|
1123
|
-
createdEvent?: EntityCreatedEvent;
|
|
1124
|
-
updatedEvent?: EntityUpdatedEvent;
|
|
1125
|
-
deletedEvent?: EntityDeletedEvent;
|
|
1126
|
-
actionEvent?: ActionEvent;
|
|
1127
|
-
}
|
|
1128
|
-
interface EntityCreatedEvent {
|
|
1129
|
-
entity?: string;
|
|
1130
|
-
}
|
|
1131
|
-
interface RestoreInfo {
|
|
1132
|
-
deletedDate?: Date | null;
|
|
1133
|
-
}
|
|
1134
|
-
interface EntityUpdatedEvent {
|
|
1135
|
-
/**
|
|
1136
|
-
* Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
|
|
1137
|
-
* This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
|
|
1138
|
-
* We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
|
|
1139
|
-
*/
|
|
1140
|
-
currentEntity?: string;
|
|
1141
|
-
}
|
|
1142
|
-
interface EntityDeletedEvent {
|
|
1143
|
-
/** Entity that was deleted. */
|
|
1144
|
-
deletedEntity?: string | null;
|
|
1145
|
-
}
|
|
1146
|
-
interface ActionEvent {
|
|
1147
|
-
body?: string;
|
|
1148
|
-
}
|
|
1149
|
-
interface Empty {
|
|
1150
|
-
}
|
|
1151
|
-
interface BenefitNotification {
|
|
1152
|
-
/**
|
|
1153
|
-
* Plan unique ID
|
|
1154
|
-
* @format GUID
|
|
1155
|
-
*/
|
|
1156
|
-
planId?: string;
|
|
1157
|
-
/**
|
|
1158
|
-
* App def ID
|
|
1159
|
-
* @format GUID
|
|
1160
|
-
*/
|
|
1161
|
-
appDefId?: string;
|
|
1162
|
-
/** Current benefit details */
|
|
1163
|
-
benefit?: Benefit;
|
|
1164
|
-
/** Previous benefit */
|
|
1165
|
-
prevBenefit?: Benefit;
|
|
1166
|
-
/** Notification event */
|
|
1167
|
-
event?: EventWithLiterals;
|
|
1168
|
-
}
|
|
1169
|
-
interface Benefit {
|
|
1170
|
-
/**
|
|
1171
|
-
* Benefit unique ID
|
|
1172
|
-
* @format GUID
|
|
1173
|
-
* @readonly
|
|
1174
|
-
*/
|
|
1175
|
-
_id?: string | null;
|
|
1176
|
-
/** Benefit Type */
|
|
1177
|
-
benefitType?: BenefitTypeWithLiterals;
|
|
1178
|
-
/**
|
|
1179
|
-
* Resource IDs that serves by this benefit
|
|
1180
|
-
* @format GUID
|
|
1181
|
-
*/
|
|
1182
|
-
resourceIds?: string[];
|
|
1183
|
-
/** Amount of credits that provided by this benefit */
|
|
1184
|
-
creditAmount?: number | null;
|
|
1185
|
-
/**
|
|
1186
|
-
* additional details related to benefit; limited to 20 entries, 20 symbols for key and 20 symbols for value
|
|
1187
|
-
* @maxSize 20
|
|
1188
|
-
*/
|
|
1189
|
-
customFields?: Record<string, string>;
|
|
1190
|
-
/** return value only in case it required in the ListRequest, true means that benefit's type could be updated */
|
|
1191
|
-
editable?: boolean | null;
|
|
1192
|
-
/** Benefit behavior */
|
|
1193
|
-
behavior?: Behavior;
|
|
1194
|
-
/**
|
|
1195
|
-
* Id of the app associated with this benefit
|
|
1196
|
-
* @format GUID
|
|
1197
|
-
* @readonly
|
|
1198
|
-
*/
|
|
1199
|
-
appDefId?: string | null;
|
|
1200
|
-
}
|
|
1201
|
-
interface EntryPass {
|
|
1202
|
-
}
|
|
1203
|
-
interface Discount extends DiscountDiscountOneOf {
|
|
1204
|
-
/**
|
|
1205
|
-
* Fixed-rate percent off discount
|
|
1206
|
-
* @decimalValue options { gt:0, lte:100, maxScale:2 }
|
|
1207
|
-
*/
|
|
1208
|
-
percentOffRate?: string;
|
|
1209
|
-
/**
|
|
1210
|
-
* Absolute amount discount
|
|
1211
|
-
* @decimalValue options { gt:0, maxScale:2 }
|
|
1212
|
-
*/
|
|
1213
|
-
moneyOffAmount?: string;
|
|
1214
|
-
}
|
|
1215
|
-
/** @oneof */
|
|
1216
|
-
interface DiscountDiscountOneOf {
|
|
1217
|
-
/**
|
|
1218
|
-
* Fixed-rate percent off discount
|
|
1219
|
-
* @decimalValue options { gt:0, lte:100, maxScale:2 }
|
|
1220
|
-
*/
|
|
1221
|
-
percentOffRate?: string;
|
|
1222
|
-
/**
|
|
1223
|
-
* Absolute amount discount
|
|
1224
|
-
* @decimalValue options { gt:0, maxScale:2 }
|
|
1225
|
-
*/
|
|
1226
|
-
moneyOffAmount?: string;
|
|
1227
|
-
}
|
|
1228
|
-
declare enum BenefitType {
|
|
1229
|
-
/** Should never be used */
|
|
1230
|
-
UNDEFINED = "UNDEFINED",
|
|
1231
|
-
/** Limited benefit type */
|
|
1232
|
-
LIMITED = "LIMITED",
|
|
1233
|
-
/** Unlimited benefit type */
|
|
1234
|
-
UNLIMITED = "UNLIMITED"
|
|
1235
|
-
}
|
|
1236
|
-
/** @enumType */
|
|
1237
|
-
type BenefitTypeWithLiterals = BenefitType | 'UNDEFINED' | 'LIMITED' | 'UNLIMITED';
|
|
1238
|
-
interface Behavior extends BehaviorBehaviorOneOf {
|
|
1239
|
-
/** Entry pass for resources, e.g. a ticket for Bookings service or a ticket for Events. */
|
|
1240
|
-
defaultBehavior?: EntryPass;
|
|
1241
|
-
/** Discount applied to paid resources */
|
|
1242
|
-
discount?: Discount;
|
|
1243
|
-
}
|
|
1244
|
-
/** @oneof */
|
|
1245
|
-
interface BehaviorBehaviorOneOf {
|
|
1246
|
-
/** Entry pass for resources, e.g. a ticket for Bookings service or a ticket for Events. */
|
|
1247
|
-
defaultBehavior?: EntryPass;
|
|
1248
|
-
/** Discount applied to paid resources */
|
|
1249
|
-
discount?: Discount;
|
|
1250
|
-
}
|
|
1251
|
-
declare enum Event {
|
|
1252
|
-
Updated = "Updated",
|
|
1253
|
-
Deleted = "Deleted",
|
|
1254
|
-
Created = "Created"
|
|
1255
|
-
}
|
|
1256
|
-
/** @enumType */
|
|
1257
|
-
type EventWithLiterals = Event | 'Updated' | 'Deleted' | 'Created';
|
|
1258
|
-
interface MessageEnvelope {
|
|
1259
|
-
/**
|
|
1260
|
-
* App instance ID.
|
|
1261
|
-
* @format GUID
|
|
1262
|
-
*/
|
|
1263
|
-
instanceId?: string | null;
|
|
1264
|
-
/**
|
|
1265
|
-
* Event type.
|
|
1266
|
-
* @maxLength 150
|
|
1267
|
-
*/
|
|
1268
|
-
eventType?: string;
|
|
1269
|
-
/** The identification type and identity data. */
|
|
1270
|
-
identity?: IdentificationData;
|
|
1271
|
-
/** Stringify payload. */
|
|
1272
|
-
data?: string;
|
|
1273
|
-
}
|
|
1274
|
-
interface IdentificationData extends IdentificationDataIdOneOf {
|
|
1275
|
-
/**
|
|
1276
|
-
* ID of a site visitor that has not logged in to the site.
|
|
1277
|
-
* @format GUID
|
|
1278
|
-
*/
|
|
1279
|
-
anonymousVisitorId?: string;
|
|
1280
|
-
/**
|
|
1281
|
-
* ID of a site visitor that has logged in to the site.
|
|
1282
|
-
* @format GUID
|
|
1283
|
-
*/
|
|
1284
|
-
memberId?: string;
|
|
1285
|
-
/**
|
|
1286
|
-
* ID of a Wix user (site owner, contributor, etc.).
|
|
1287
|
-
* @format GUID
|
|
1288
|
-
*/
|
|
1289
|
-
wixUserId?: string;
|
|
1290
|
-
/**
|
|
1291
|
-
* ID of an app.
|
|
1292
|
-
* @format GUID
|
|
1293
|
-
*/
|
|
1294
|
-
appId?: string;
|
|
1295
|
-
/** @readonly */
|
|
1296
|
-
identityType?: WebhookIdentityTypeWithLiterals;
|
|
1297
|
-
}
|
|
1298
|
-
/** @oneof */
|
|
1299
|
-
interface IdentificationDataIdOneOf {
|
|
1300
|
-
/**
|
|
1301
|
-
* ID of a site visitor that has not logged in to the site.
|
|
1302
|
-
* @format GUID
|
|
1303
|
-
*/
|
|
1304
|
-
anonymousVisitorId?: string;
|
|
1305
|
-
/**
|
|
1306
|
-
* ID of a site visitor that has logged in to the site.
|
|
1307
|
-
* @format GUID
|
|
1308
|
-
*/
|
|
1309
|
-
memberId?: string;
|
|
1310
|
-
/**
|
|
1311
|
-
* ID of a Wix user (site owner, contributor, etc.).
|
|
1312
|
-
* @format GUID
|
|
1313
|
-
*/
|
|
1314
|
-
wixUserId?: string;
|
|
1315
|
-
/**
|
|
1316
|
-
* ID of an app.
|
|
1317
|
-
* @format GUID
|
|
1318
|
-
*/
|
|
1319
|
-
appId?: string;
|
|
1320
|
-
}
|
|
1321
|
-
declare enum WebhookIdentityType {
|
|
1322
|
-
UNKNOWN = "UNKNOWN",
|
|
1323
|
-
ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
|
|
1324
|
-
MEMBER = "MEMBER",
|
|
1325
|
-
WIX_USER = "WIX_USER",
|
|
1326
|
-
APP = "APP"
|
|
1327
|
-
}
|
|
1328
|
-
/** @enumType */
|
|
1329
|
-
type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
|
|
1330
|
-
declare enum State {
|
|
1331
|
-
/** Unknown state */
|
|
1332
|
-
UNKNOWN_STATE = "UNKNOWN_STATE",
|
|
1333
|
-
/** Member joined the program and became participant */
|
|
1334
|
-
JOINED = "JOINED",
|
|
1335
|
-
/** Participant completed the program, and could join again */
|
|
1336
|
-
COMPLETED = "COMPLETED",
|
|
1337
|
-
/** Participant failed to complete the program, and could join again */
|
|
1338
|
-
FAILED = "FAILED",
|
|
1339
|
-
/** Participant with ended pricing plan (PP), will be joined as renew PP */
|
|
1340
|
-
SUSPENDED = "SUSPENDED",
|
|
1341
|
-
/** Participant removed automatically after some program condition */
|
|
1342
|
-
AUTO_REMOVED = "AUTO_REMOVED",
|
|
1343
|
-
/** Participant removed by site owner */
|
|
1344
|
-
REMOVED = "REMOVED",
|
|
1345
|
-
/** Participant left the program by himself */
|
|
1346
|
-
LEFT = "LEFT"
|
|
1347
|
-
}
|
|
1348
|
-
/** @enumType */
|
|
1349
|
-
type StateWithLiterals = State | 'UNKNOWN_STATE' | 'JOINED' | 'COMPLETED' | 'FAILED' | 'SUSPENDED' | 'AUTO_REMOVED' | 'REMOVED' | 'LEFT';
|
|
1350
|
-
interface BulkInviteToProgramRequest {
|
|
1351
|
-
/**
|
|
1352
|
-
* Program to which bulk invite participants.
|
|
1353
|
-
* @format GUID
|
|
1354
|
-
*/
|
|
1355
|
-
programId: string;
|
|
1356
|
-
/**
|
|
1357
|
-
* Return added participants in the response or not.
|
|
1358
|
-
* @format GUID
|
|
1359
|
-
* @minSize 1
|
|
1360
|
-
* @maxSize 100
|
|
1361
|
-
*/
|
|
1362
|
-
memberIds?: string[];
|
|
1363
|
-
/** Return invited participants in the response or not. */
|
|
1364
|
-
returnEntity?: boolean;
|
|
1365
|
-
}
|
|
1366
|
-
interface BulkInviteToProgramResponse {
|
|
1367
|
-
/** Participants created by bulk action */
|
|
1368
|
-
results?: BulkInviteToProgramResult[];
|
|
1369
|
-
/** Bulk action metadata. */
|
|
1370
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
1371
|
-
}
|
|
1372
|
-
interface ItemMetadata {
|
|
1373
|
-
/** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
|
|
1374
|
-
_id?: string | null;
|
|
1375
|
-
/** Index of the item within the request array. Allows for correlation between request and response items. */
|
|
1376
|
-
originalIndex?: number;
|
|
1377
|
-
/** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
|
|
1378
|
-
success?: boolean;
|
|
1379
|
-
/** Details about the error in case of failure. */
|
|
1380
|
-
error?: ApplicationError;
|
|
1381
|
-
}
|
|
1382
|
-
interface BulkInviteToProgramResult {
|
|
1383
|
-
/** Invited participant metadata. */
|
|
1384
|
-
itemMetadata?: ItemMetadata;
|
|
1385
|
-
/** Invited participant */
|
|
1386
|
-
item?: Participant;
|
|
1387
|
-
}
|
|
1388
|
-
interface BulkActionMetadata {
|
|
1389
|
-
/** Number of items that were successfully processed. */
|
|
1390
|
-
totalSuccesses?: number;
|
|
1391
|
-
/** Number of items that couldn't be processed. */
|
|
1392
|
-
totalFailures?: number;
|
|
1393
|
-
/** Number of failures without details because detailed failure threshold was exceeded. */
|
|
1394
|
-
undetailedFailures?: number;
|
|
1395
|
-
}
|
|
1396
|
-
interface ParticipantInvited {
|
|
1397
|
-
/**
|
|
1398
|
-
* Program to which bulk invite participants.
|
|
1399
|
-
* @format GUID
|
|
1400
|
-
*/
|
|
1401
|
-
programId?: string;
|
|
1402
|
-
/**
|
|
1403
|
-
* Invited member to program
|
|
1404
|
-
* @format GUID
|
|
1405
|
-
*/
|
|
1406
|
-
memberId?: string;
|
|
1407
|
-
}
|
|
1408
|
-
interface BulkInviteAllToProgramRequest {
|
|
1409
|
-
/**
|
|
1410
|
-
* Program to which bulk add participants.
|
|
1411
|
-
* @format GUID
|
|
1412
|
-
*/
|
|
1413
|
-
programId: string;
|
|
1414
|
-
/**
|
|
1415
|
-
* Exclude site members.
|
|
1416
|
-
* @format GUID
|
|
1417
|
-
* @maxSize 100
|
|
1418
|
-
*/
|
|
1419
|
-
excludeMemberIds?: string[];
|
|
1420
|
-
}
|
|
1421
|
-
interface BulkInviteAllToProgramResponse {
|
|
1422
|
-
/** Bulk action metadata. */
|
|
1423
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
1424
|
-
}
|
|
1425
|
-
interface BulkAddToProgramRequest {
|
|
1426
|
-
/**
|
|
1427
|
-
* Program to which bulk add participants.
|
|
1428
|
-
* @format GUID
|
|
1429
|
-
*/
|
|
1430
|
-
programId: string;
|
|
1431
|
-
/**
|
|
1432
|
-
* Site members.
|
|
1433
|
-
* @format GUID
|
|
1434
|
-
* @minSize 1
|
|
1435
|
-
* @maxSize 1000
|
|
1436
|
-
*/
|
|
1437
|
-
memberIds?: string[];
|
|
1438
|
-
/** Return added participants in the response or not. */
|
|
1439
|
-
returnEntity?: boolean;
|
|
1440
|
-
}
|
|
1441
|
-
interface BulkAddToProgramResponse {
|
|
1442
|
-
/** Participants created by bulk action */
|
|
1443
|
-
results?: BulkAddToProgramResult[];
|
|
1444
|
-
/** Bulk action metadata. */
|
|
1445
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
1446
|
-
}
|
|
1447
|
-
interface BulkAddToProgramResult {
|
|
1448
|
-
/** Added participant metadata. */
|
|
1449
|
-
itemMetadata?: ItemMetadata;
|
|
1450
|
-
/** Added participant */
|
|
1451
|
-
item?: Participant;
|
|
1452
|
-
}
|
|
1453
|
-
interface BulkApproveParticipantRequest {
|
|
1454
|
-
/**
|
|
1455
|
-
* Participants to add
|
|
1456
|
-
* @format GUID
|
|
1457
|
-
* @maxSize 100
|
|
1458
|
-
*/
|
|
1459
|
-
participantIds: string[];
|
|
1460
|
-
/**
|
|
1461
|
-
* program to approve participant
|
|
1462
|
-
* @format GUID
|
|
1463
|
-
*/
|
|
1464
|
-
programId?: string;
|
|
1465
|
-
/** Return approved participants in the response or not */
|
|
1466
|
-
returnEntity?: boolean;
|
|
1467
|
-
}
|
|
1468
|
-
interface BulkApproveParticipantResponse {
|
|
1469
|
-
/** Participants approved by bulk action */
|
|
1470
|
-
results?: BulkApproveParticipantResult[];
|
|
1471
|
-
/** Bulk action metadata */
|
|
1472
|
-
bulkActionMetadata?: BulkActionMetadata;
|
|
1473
|
-
}
|
|
1474
|
-
interface BulkApproveParticipantResult {
|
|
1475
|
-
/** Approved participant metadata */
|
|
1476
|
-
itemMetadata?: ItemMetadata;
|
|
1477
|
-
/** Approved or existing participant */
|
|
1478
|
-
item?: Participant;
|
|
1479
|
-
}
|
|
1480
|
-
interface ParticipantApproved {
|
|
1481
|
-
/**
|
|
1482
|
-
* Program ID which participant approved
|
|
1483
|
-
* @format GUID
|
|
1484
|
-
*/
|
|
1485
|
-
programId?: string;
|
|
1486
|
-
/**
|
|
1487
|
-
* Member ID of participant approved
|
|
1488
|
-
* @format GUID
|
|
1489
|
-
*/
|
|
1490
|
-
memberId?: string;
|
|
1491
|
-
}
|
|
1492
|
-
interface BulkApproveAllParticipantRequest {
|
|
1493
|
-
/**
|
|
1494
|
-
* Program to approve all participants.
|
|
1495
|
-
* @format GUID
|
|
1496
|
-
*/
|
|
1497
|
-
programId?: string;
|
|
1498
|
-
/**
|
|
1499
|
-
* Exclude site members.
|
|
1500
|
-
* @format GUID
|
|
1501
|
-
* @maxSize 100
|
|
1502
|
-
*/
|
|
1503
|
-
excludeParticipantIds?: string[];
|
|
1504
|
-
}
|
|
1505
|
-
interface BulkApproveAllParticipantResponse {
|
|
1506
|
-
/**
|
|
1507
|
-
* Job id with async process
|
|
1508
|
-
* @format GUID
|
|
1509
|
-
*/
|
|
1510
|
-
jobId?: string;
|
|
1511
|
-
}
|
|
1512
|
-
interface ExportParticipantsStatsRequest {
|
|
1513
|
-
/**
|
|
1514
|
-
* program id to export data from
|
|
1515
|
-
* @format GUID
|
|
1516
|
-
*/
|
|
1517
|
-
programId: string;
|
|
1518
|
-
}
|
|
1519
|
-
interface ExportParticipantsStatsResponse {
|
|
1520
|
-
}
|
|
1521
|
-
interface ParticipantExportsFinished {
|
|
1522
|
-
/**
|
|
1523
|
-
* program id from which stats were exported
|
|
1524
|
-
* @format GUID
|
|
1525
|
-
*/
|
|
1526
|
-
programId?: string;
|
|
1527
|
-
/**
|
|
1528
|
-
* user id of program owner
|
|
1529
|
-
* @format GUID
|
|
1530
|
-
*/
|
|
1531
|
-
userId?: string;
|
|
1532
|
-
/**
|
|
1533
|
-
* url to download report
|
|
1534
|
-
* @format WEB_URL
|
|
1535
|
-
*/
|
|
1536
|
-
downloadUrl?: string;
|
|
1537
|
-
/** days url will be downloadable */
|
|
1538
|
-
downloadUrlTtlDays?: number;
|
|
1539
|
-
}
|
|
1540
|
-
/** @docsIgnore */
|
|
1541
|
-
type CreateParticipantApplicationErrors = {
|
|
1542
|
-
code?: 'INVALID_PAYMENT_INFO';
|
|
1543
|
-
description?: string;
|
|
1544
|
-
data?: Record<string, any>;
|
|
1545
|
-
};
|
|
1546
|
-
/** @docsIgnore */
|
|
1547
|
-
type BulkUpdateParticipantTagsApplicationErrors = {
|
|
1548
|
-
code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
|
|
1549
|
-
description?: string;
|
|
1550
|
-
data?: Record<string, any>;
|
|
1551
|
-
};
|
|
1552
|
-
/** @docsIgnore */
|
|
1553
|
-
type BulkUpdateParticipantTagsByFilterApplicationErrors = {
|
|
1554
|
-
code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
|
|
1555
|
-
description?: string;
|
|
1556
|
-
data?: Record<string, any>;
|
|
1557
|
-
};
|
|
1558
|
-
interface BaseEventMetadata {
|
|
1559
|
-
/**
|
|
1560
|
-
* App instance ID.
|
|
1561
|
-
* @format GUID
|
|
1562
|
-
*/
|
|
1563
|
-
instanceId?: string | null;
|
|
1564
|
-
/**
|
|
1565
|
-
* Event type.
|
|
1566
|
-
* @maxLength 150
|
|
1567
|
-
*/
|
|
1568
|
-
eventType?: string;
|
|
1569
|
-
/** The identification type and identity data. */
|
|
1570
|
-
identity?: IdentificationData;
|
|
1571
|
-
}
|
|
1572
|
-
interface EventMetadata extends BaseEventMetadata {
|
|
1573
|
-
/** Event ID. With this ID you can easily spot duplicated events and ignore them. */
|
|
1574
|
-
_id?: string;
|
|
1575
|
-
/**
|
|
1576
|
-
* Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
|
|
1577
|
-
* For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
|
|
1578
|
-
*/
|
|
1579
|
-
entityFqdn?: string;
|
|
1580
|
-
/**
|
|
1581
|
-
* Event action name, placed at the top level to make it easier for users to dispatch messages.
|
|
1582
|
-
* For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
|
|
1583
|
-
*/
|
|
1584
|
-
slug?: string;
|
|
1585
|
-
/** ID of the entity associated with the event. */
|
|
1586
|
-
entityId?: string;
|
|
1587
|
-
/** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
|
|
1588
|
-
eventTime?: Date | null;
|
|
1589
|
-
/**
|
|
1590
|
-
* Whether the event was triggered as a result of a privacy regulation application
|
|
1591
|
-
* (for example, GDPR).
|
|
1592
|
-
*/
|
|
1593
|
-
triggeredByAnonymizeRequest?: boolean | null;
|
|
1594
|
-
/** If present, indicates the action that triggered the event. */
|
|
1595
|
-
originatedFrom?: string | null;
|
|
1596
|
-
/**
|
|
1597
|
-
* A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
|
|
1598
|
-
* You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
|
|
1599
|
-
*/
|
|
1600
|
-
entityEventSequence?: string | null;
|
|
1601
|
-
}
|
|
1602
|
-
interface ParticipantAddedEnvelope {
|
|
1603
|
-
data: ParticipantAdded;
|
|
1604
|
-
metadata: EventMetadata;
|
|
1605
|
-
}
|
|
1606
|
-
/** @permissionScope Manage Challenges
|
|
1607
|
-
* @permissionScopeId SCOPE.CHALLENGES.MANAGE
|
|
1608
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1609
|
-
* @webhook
|
|
1610
|
-
* @eventType wix.online_programs.v3.participant_added
|
|
1611
|
-
* @slug added
|
|
1612
|
-
* @documentationMaturity preview
|
|
1613
|
-
*/
|
|
1614
|
-
declare function onParticipantAdded(handler: (event: ParticipantAddedEnvelope) => void | Promise<void>): void;
|
|
1615
|
-
interface ParticipantApprovedEnvelope {
|
|
1616
|
-
data: ParticipantApproved;
|
|
1617
|
-
metadata: EventMetadata;
|
|
1618
|
-
}
|
|
1619
|
-
/** @permissionScope Manage Challenges
|
|
1620
|
-
* @permissionScopeId SCOPE.CHALLENGES.MANAGE
|
|
1621
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1622
|
-
* @webhook
|
|
1623
|
-
* @eventType wix.online_programs.v3.participant_participant_approved
|
|
1624
|
-
* @serviceIdentifier wix.onlineprograms.participants.v3.ManageParticipantsService
|
|
1625
|
-
* @slug participant_approved
|
|
1626
|
-
* @documentationMaturity preview
|
|
1627
|
-
*/
|
|
1628
|
-
declare function onParticipantApproved(handler: (event: ParticipantApprovedEnvelope) => void | Promise<void>): void;
|
|
1629
|
-
interface ParticipantInvitedEnvelope {
|
|
1630
|
-
data: ParticipantInvited;
|
|
1631
|
-
metadata: EventMetadata;
|
|
1632
|
-
}
|
|
1633
|
-
/** @permissionScope Manage Challenges
|
|
1634
|
-
* @permissionScopeId SCOPE.CHALLENGES.MANAGE
|
|
1635
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1636
|
-
* @webhook
|
|
1637
|
-
* @eventType wix.online_programs.v3.participant_participant_invited
|
|
1638
|
-
* @serviceIdentifier wix.onlineprograms.participants.v3.ManageParticipantsService
|
|
1639
|
-
* @slug participant_invited
|
|
1640
|
-
* @documentationMaturity preview
|
|
1641
|
-
*/
|
|
1642
|
-
declare function onParticipantInvited(handler: (event: ParticipantInvitedEnvelope) => void | Promise<void>): void;
|
|
1643
|
-
/**
|
|
1644
|
-
* Create one participant.
|
|
1645
|
-
* @param participant - Participant to create
|
|
1646
|
-
* @public
|
|
1647
|
-
* @documentationMaturity preview
|
|
1648
|
-
* @requiredField participant
|
|
1649
|
-
* @requiredField participant.joinedInfo.joinPath
|
|
1650
|
-
* @requiredField participant.memberId
|
|
1651
|
-
* @requiredField participant.programId
|
|
1652
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_CREATE
|
|
1653
|
-
* @returns Created participant
|
|
1654
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.CreateParticipant
|
|
1655
|
-
*/
|
|
1656
|
-
declare function createParticipant(participant: NonNullablePaths<Participant, `joinedInfo.joinPath` | `memberId` | `programId`, 3>): Promise<NonNullablePaths<Participant, `memberId` | `programId` | `progress.totalStepsCompleted` | `progress.totalStepsAvailable` | `progress.completionPercentage` | `status` | `joinedInfo.singlePaymentDetails.paymentOrderId` | `joinedInfo.paidPlanDetails.paidPlanId` | `joinedInfo.freeCouponDetails.freeCouponId` | `joinedInfo.timeZone` | `joinedInfo.startDate` | `joinedInfo.joinPath` | `member.contactId` | `tags.privateTags.tagIds`, 4> & {
|
|
1657
|
-
__applicationErrorsType?: CreateParticipantApplicationErrors;
|
|
1658
|
-
}>;
|
|
1659
|
-
/**
|
|
1660
|
-
* Creates participants in bulk.
|
|
1661
|
-
* @param participants - List of participants you want to create
|
|
1662
|
-
* @public
|
|
1663
|
-
* @documentationMaturity preview
|
|
1664
|
-
* @requiredField participants
|
|
1665
|
-
* @requiredField participants.joinedInfo.joinPath
|
|
1666
|
-
* @requiredField participants.memberId
|
|
1667
|
-
* @requiredField participants.programId
|
|
1668
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_CREATE
|
|
1669
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkCreateParticipant
|
|
1670
|
-
*/
|
|
1671
|
-
declare function bulkCreateParticipant(participants: NonNullablePaths<Participant, `joinedInfo.joinPath` | `memberId` | `programId`, 3>[], options?: BulkCreateParticipantOptions): Promise<NonNullablePaths<BulkCreateParticipantResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
|
|
1672
|
-
interface BulkCreateParticipantOptions {
|
|
1673
|
-
/** Whether to return entities in response or not. */
|
|
1674
|
-
returnEntity?: boolean;
|
|
1675
|
-
}
|
|
1676
|
-
/**
|
|
1677
|
-
* Bulk adds all site members to program, but not more then 1000.
|
|
1678
|
-
* Participant will be either created in state Joined, or updated to that state
|
|
1679
|
-
* from pending one.
|
|
1680
|
-
* @param programId - Program to which bulk add participants.
|
|
1681
|
-
* @public
|
|
1682
|
-
* @documentationMaturity preview
|
|
1683
|
-
* @requiredField programId
|
|
1684
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_ADD
|
|
1685
|
-
* @applicableIdentity APP
|
|
1686
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkAddAllToProgram
|
|
1687
|
-
*/
|
|
1688
|
-
declare function bulkAddAllToProgram(programId: string, options?: BulkAddAllToProgramOptions): Promise<NonNullablePaths<BulkAddAllToProgramResponse, `jobId`, 2>>;
|
|
1689
|
-
interface BulkAddAllToProgramOptions {
|
|
1690
|
-
/**
|
|
1691
|
-
* Exclude site members.
|
|
1692
|
-
* @format GUID
|
|
1693
|
-
* @maxSize 100
|
|
1694
|
-
*/
|
|
1695
|
-
excludeMemberIds?: string[];
|
|
1696
|
-
}
|
|
1697
|
-
/**
|
|
1698
|
-
* Delete participant from program. Removes participant from member
|
|
1699
|
-
* group. Leaves him in Social Group.
|
|
1700
|
-
* @param participantId - Participants to delete
|
|
1701
|
-
* @public
|
|
1702
|
-
* @documentationMaturity preview
|
|
1703
|
-
* @requiredField participantId
|
|
1704
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_DELETE
|
|
1705
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.DeleteParticipant
|
|
1706
|
-
*/
|
|
1707
|
-
declare function deleteParticipant(participantId: string): Promise<void>;
|
|
1708
|
-
/**
|
|
1709
|
-
* Issue certificate by site admin
|
|
1710
|
-
* @param participantId - Participant to get certificate
|
|
1711
|
-
* @public
|
|
1712
|
-
* @documentationMaturity preview
|
|
1713
|
-
* @requiredField participantId
|
|
1714
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_ISSUE_CERTIFICATE
|
|
1715
|
-
* @applicableIdentity APP
|
|
1716
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.IssueCertificate
|
|
1717
|
-
*/
|
|
1718
|
-
declare function issueCertificate(participantId: string): Promise<NonNullablePaths<IssueCertificateResponse, `participant.memberId` | `participant.programId` | `participant.progress.totalStepsCompleted` | `participant.progress.totalStepsAvailable` | `participant.progress.completionPercentage` | `participant.status` | `participant.joinedInfo.singlePaymentDetails.paymentOrderId` | `participant.joinedInfo.paidPlanDetails.paidPlanId` | `participant.joinedInfo.freeCouponDetails.freeCouponId` | `participant.joinedInfo.timeZone` | `participant.joinedInfo.startDate` | `participant.joinedInfo.joinPath` | `participant.member.contactId` | `participant.tags.privateTags.tagIds`, 5>>;
|
|
1719
|
-
/**
|
|
1720
|
-
* Get program's completion stats
|
|
1721
|
-
* @param programId - program id to get stats for
|
|
1722
|
-
* @public
|
|
1723
|
-
* @documentationMaturity preview
|
|
1724
|
-
* @requiredField programId
|
|
1725
|
-
* @permissionId ONLINE_PROGRAMS.STATS_READ
|
|
1726
|
-
* @applicableIdentity APP
|
|
1727
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetCompletionStats
|
|
1728
|
-
*/
|
|
1729
|
-
declare function getCompletionStats(programId: string): Promise<NonNullablePaths<GetCompletionStatsResponse, `completedAll` | `completionRate`, 2>>;
|
|
1730
|
-
/**
|
|
1731
|
-
* Get premium stats
|
|
1732
|
-
* @public
|
|
1733
|
-
* @documentationMaturity preview
|
|
1734
|
-
* @permissionId ONLINE_PROGRAMS.STATS_READ
|
|
1735
|
-
* @applicableIdentity APP
|
|
1736
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetPremiumStats
|
|
1737
|
-
*/
|
|
1738
|
-
declare function getPremiumStats(): Promise<NonNullablePaths<GetPremiumStatsResponse, `hasPremium` | `activeParticipantsCount` | `activeParticipantsLimit`, 2>>;
|
|
1739
|
-
/**
|
|
1740
|
-
* Returns participant.
|
|
1741
|
-
* @param participantId - Participant id to fetch
|
|
1742
|
-
* @public
|
|
1743
|
-
* @documentationMaturity preview
|
|
1744
|
-
* @requiredField participantId
|
|
1745
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1746
|
-
* @applicableIdentity APP
|
|
1747
|
-
* @applicableIdentity MEMBER
|
|
1748
|
-
* @returns existing participant
|
|
1749
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetParticipant
|
|
1750
|
-
*/
|
|
1751
|
-
declare function getParticipant(participantId: string): Promise<NonNullablePaths<Participant, `memberId` | `programId` | `progress.totalStepsCompleted` | `progress.totalStepsAvailable` | `progress.completionPercentage` | `status` | `joinedInfo.singlePaymentDetails.paymentOrderId` | `joinedInfo.paidPlanDetails.paidPlanId` | `joinedInfo.freeCouponDetails.freeCouponId` | `joinedInfo.timeZone` | `joinedInfo.startDate` | `joinedInfo.joinPath` | `member.contactId` | `tags.privateTags.tagIds`, 4>>;
|
|
1752
|
-
/**
|
|
1753
|
-
* Query existing participants
|
|
1754
|
-
* @public
|
|
1755
|
-
* @documentationMaturity preview
|
|
1756
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1757
|
-
* @applicableIdentity APP
|
|
1758
|
-
* @applicableIdentity MEMBER
|
|
1759
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.QueryParticipants
|
|
1760
|
-
*/
|
|
1761
|
-
declare function queryParticipants(): ParticipantsQueryBuilder;
|
|
1762
|
-
interface QueryCursorResult {
|
|
1763
|
-
cursors: Cursors;
|
|
1764
|
-
hasNext: () => boolean;
|
|
1765
|
-
hasPrev: () => boolean;
|
|
1766
|
-
length: number;
|
|
1767
|
-
pageSize: number;
|
|
1768
|
-
}
|
|
1769
|
-
interface ParticipantsQueryResult extends QueryCursorResult {
|
|
1770
|
-
items: Participant[];
|
|
1771
|
-
query: ParticipantsQueryBuilder;
|
|
1772
|
-
next: () => Promise<ParticipantsQueryResult>;
|
|
1773
|
-
prev: () => Promise<ParticipantsQueryResult>;
|
|
1774
|
-
}
|
|
1775
|
-
interface ParticipantsQueryBuilder {
|
|
1776
|
-
/** @param propertyName - Property whose value is compared with `value`.
|
|
1777
|
-
* @param value - Value to compare against.
|
|
1778
|
-
* @documentationMaturity preview
|
|
1779
|
-
*/
|
|
1780
|
-
eq: (propertyName: '_id' | 'memberId' | 'programId' | 'status', value: any) => ParticipantsQueryBuilder;
|
|
1781
|
-
/** @param propertyName - Property whose value is compared with `value`.
|
|
1782
|
-
* @param value - Value to compare against.
|
|
1783
|
-
* @documentationMaturity preview
|
|
1784
|
-
*/
|
|
1785
|
-
ge: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
|
|
1786
|
-
/** @param propertyName - Property whose value is compared with `value`.
|
|
1787
|
-
* @param value - Value to compare against.
|
|
1788
|
-
* @documentationMaturity preview
|
|
1789
|
-
*/
|
|
1790
|
-
gt: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
|
|
1791
|
-
/** @param propertyName - Property whose value is compared with `value`.
|
|
1792
|
-
* @param value - Value to compare against.
|
|
1793
|
-
* @documentationMaturity preview
|
|
1794
|
-
*/
|
|
1795
|
-
le: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
|
|
1796
|
-
/** @param propertyName - Property whose value is compared with `value`.
|
|
1797
|
-
* @param value - Value to compare against.
|
|
1798
|
-
* @documentationMaturity preview
|
|
1799
|
-
*/
|
|
1800
|
-
lt: (propertyName: 'joinedInfo.startDate', value: any) => ParticipantsQueryBuilder;
|
|
1801
|
-
/** @documentationMaturity preview */
|
|
1802
|
-
in: (propertyName: '_id' | 'memberId' | 'status', value: any) => ParticipantsQueryBuilder;
|
|
1803
|
-
/** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
|
|
1804
|
-
* @documentationMaturity preview
|
|
1805
|
-
*/
|
|
1806
|
-
ascending: (...propertyNames: Array<'_id' | '_createdDate' | 'status' | 'joinedInfo.startDate'>) => ParticipantsQueryBuilder;
|
|
1807
|
-
/** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
|
|
1808
|
-
* @documentationMaturity preview
|
|
1809
|
-
*/
|
|
1810
|
-
descending: (...propertyNames: Array<'_id' | '_createdDate' | 'status' | 'joinedInfo.startDate'>) => ParticipantsQueryBuilder;
|
|
1811
|
-
/** @param limit - Number of items to return, which is also the `pageSize` of the results object.
|
|
1812
|
-
* @documentationMaturity preview
|
|
1813
|
-
*/
|
|
1814
|
-
limit: (limit: number) => ParticipantsQueryBuilder;
|
|
1815
|
-
/** @param cursor - A pointer to specific record
|
|
1816
|
-
* @documentationMaturity preview
|
|
1817
|
-
*/
|
|
1818
|
-
skipTo: (cursor: string) => ParticipantsQueryBuilder;
|
|
1819
|
-
/** @documentationMaturity preview */
|
|
1820
|
-
find: () => Promise<ParticipantsQueryResult>;
|
|
1821
|
-
}
|
|
1822
|
-
/**
|
|
1823
|
-
* @hidden
|
|
1824
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.QueryParticipants
|
|
1825
|
-
* @requiredField query
|
|
1826
|
-
*/
|
|
1827
|
-
declare function typedQueryParticipants(query: ParticipantQuery): Promise<NonNullablePaths<QueryParticipantsResponse, `participants` | `participants.${number}.memberId` | `participants.${number}.programId` | `participants.${number}.progress.totalStepsCompleted` | `participants.${number}.progress.totalStepsAvailable` | `participants.${number}.progress.completionPercentage` | `participants.${number}.status` | `participants.${number}.joinedInfo.singlePaymentDetails.paymentOrderId` | `participants.${number}.joinedInfo.paidPlanDetails.paidPlanId` | `participants.${number}.joinedInfo.freeCouponDetails.freeCouponId` | `participants.${number}.joinedInfo.timeZone` | `participants.${number}.joinedInfo.startDate` | `participants.${number}.joinedInfo.joinPath` | `participants.${number}.member.contactId`, 6>>;
|
|
1828
|
-
interface ParticipantQuerySpec extends QuerySpec {
|
|
1829
|
-
paging: 'cursor';
|
|
1830
|
-
wql: [
|
|
1831
|
-
{
|
|
1832
|
-
fields: ['_id', 'status'];
|
|
1833
|
-
operators: ['$eq', '$in'];
|
|
1834
|
-
sort: 'BOTH';
|
|
1835
|
-
},
|
|
1836
|
-
{
|
|
1837
|
-
fields: ['memberId'];
|
|
1838
|
-
operators: ['$eq', '$in'];
|
|
1839
|
-
sort: 'NONE';
|
|
1840
|
-
},
|
|
1841
|
-
{
|
|
1842
|
-
fields: ['programId'];
|
|
1843
|
-
operators: ['$eq'];
|
|
1844
|
-
sort: 'NONE';
|
|
1845
|
-
},
|
|
1846
|
-
{
|
|
1847
|
-
fields: ['_createdDate'];
|
|
1848
|
-
operators: [];
|
|
1849
|
-
sort: 'BOTH';
|
|
1850
|
-
},
|
|
1851
|
-
{
|
|
1852
|
-
fields: ['joinedInfo.startDate'];
|
|
1853
|
-
operators: ['$gt', '$gte', '$lt', '$lte'];
|
|
1854
|
-
sort: 'BOTH';
|
|
1855
|
-
}
|
|
1856
|
-
];
|
|
1857
|
-
}
|
|
1858
|
-
type CommonQueryWithEntityContext = Query<Participant, ParticipantQuerySpec>;
|
|
1859
|
-
type ParticipantQuery = {
|
|
1860
|
-
/**
|
|
1861
|
-
Cursor paging options.
|
|
1862
|
-
|
|
1863
|
-
Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
1864
|
-
*/
|
|
1865
|
-
cursorPaging?: {
|
|
1866
|
-
/**
|
|
1867
|
-
Maximum number of items to return in the results.
|
|
1868
|
-
@max: 100
|
|
1869
|
-
*/
|
|
1870
|
-
limit?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['limit'] | null;
|
|
1871
|
-
/**
|
|
1872
|
-
Pointer to the next or previous page in the list of results.
|
|
1873
|
-
|
|
1874
|
-
Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
|
|
1875
|
-
Not relevant for the first request.
|
|
1876
|
-
@maxLength: 16000
|
|
1877
|
-
*/
|
|
1878
|
-
cursor?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['cursor'] | null;
|
|
1879
|
-
};
|
|
1880
|
-
/**
|
|
1881
|
-
Filter object.
|
|
1882
|
-
|
|
1883
|
-
Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
|
|
1884
|
-
*/
|
|
1885
|
-
filter?: CommonQueryWithEntityContext['filter'] | null;
|
|
1886
|
-
/**
|
|
1887
|
-
Sort object.
|
|
1888
|
-
|
|
1889
|
-
Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
|
|
1890
|
-
@maxSize: 5
|
|
1891
|
-
*/
|
|
1892
|
-
sort?: {
|
|
1893
|
-
/**
|
|
1894
|
-
Name of the field to sort by.
|
|
1895
|
-
@maxLength: 512
|
|
1896
|
-
*/
|
|
1897
|
-
fieldName?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['fieldName'];
|
|
1898
|
-
/**
|
|
1899
|
-
Sort order.
|
|
1900
|
-
*/
|
|
1901
|
-
order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
|
|
1902
|
-
}[];
|
|
1903
|
-
};
|
|
1904
|
-
/**
|
|
1905
|
-
* Get access status
|
|
1906
|
-
* @public
|
|
1907
|
-
* @documentationMaturity preview
|
|
1908
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_READ
|
|
1909
|
-
* @applicableIdentity APP
|
|
1910
|
-
* @applicableIdentity MEMBER
|
|
1911
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.GetAccessStatus
|
|
1912
|
-
*/
|
|
1913
|
-
declare function getAccessStatus(): Promise<NonNullablePaths<GetAccessStatusResponse, `blocked`, 2>>;
|
|
1914
|
-
/**
|
|
1915
|
-
* Updates tags for multiple Participants by IDs.
|
|
1916
|
-
*
|
|
1917
|
-
* Allows assigning and/or unassigning tags in a single operation.
|
|
1918
|
-
* At least one of assign_tags or unassign_tags must be provided.
|
|
1919
|
-
* @param participantIds - Participant IDs to update tags for (1-100 items)
|
|
1920
|
-
* @public
|
|
1921
|
-
* @documentationMaturity preview
|
|
1922
|
-
* @requiredField participantIds
|
|
1923
|
-
* @permissionId online_programs:v3:participant:bulk_update_participant_tags
|
|
1924
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkUpdateParticipantTags
|
|
1925
|
-
*/
|
|
1926
|
-
declare function bulkUpdateParticipantTags(participantIds: string[], options?: BulkUpdateParticipantTagsOptions): Promise<NonNullablePaths<BulkUpdateParticipantTagsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6> & {
|
|
1927
|
-
__applicationErrorsType?: BulkUpdateParticipantTagsApplicationErrors;
|
|
1928
|
-
}>;
|
|
1929
|
-
interface BulkUpdateParticipantTagsOptions {
|
|
1930
|
-
/** Tags to assign to the Participants */
|
|
1931
|
-
assignTags?: Tags;
|
|
1932
|
-
/** Tags to unassign from the Participants */
|
|
1933
|
-
unassignTags?: Tags;
|
|
1934
|
-
}
|
|
1935
|
-
/**
|
|
1936
|
-
* Updates tags for Participants matching a filter.
|
|
1937
|
-
*
|
|
1938
|
-
* Allows assigning and/or unassigning tags for all Participants matching the filter.
|
|
1939
|
-
* Returns a job ID for tracking the async operation.
|
|
1940
|
-
* @param filter - WQL filter to select Participants
|
|
1941
|
-
* @public
|
|
1942
|
-
* @documentationMaturity preview
|
|
1943
|
-
* @requiredField filter
|
|
1944
|
-
* @permissionId online_programs:v3:participant:bulk_update_participant_tags_by_filter
|
|
1945
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantsService.BulkUpdateParticipantTagsByFilter
|
|
1946
|
-
*/
|
|
1947
|
-
declare function bulkUpdateParticipantTagsByFilter(filter: Record<string, any>, options?: BulkUpdateParticipantTagsByFilterOptions): Promise<NonNullablePaths<BulkUpdateParticipantTagsByFilterResponse, `jobId`, 2> & {
|
|
1948
|
-
__applicationErrorsType?: BulkUpdateParticipantTagsByFilterApplicationErrors;
|
|
1949
|
-
}>;
|
|
1950
|
-
interface BulkUpdateParticipantTagsByFilterOptions {
|
|
1951
|
-
/** Tags to assign to matching Participants */
|
|
1952
|
-
assignTags?: Tags;
|
|
1953
|
-
/** Tags to unassign from matching Participants */
|
|
1954
|
-
unassignTags?: Tags;
|
|
1955
|
-
}
|
|
1956
|
-
interface ParticipantSearchSpec extends SearchSpec {
|
|
1957
|
-
searchable: ['member.email', 'member.firstName', 'member.lastName'];
|
|
1958
|
-
aggregatable: [
|
|
1959
|
-
'_id',
|
|
1960
|
-
'joinedInfo.startDate',
|
|
1961
|
-
'memberId',
|
|
1962
|
-
'programId',
|
|
1963
|
-
'status'
|
|
1964
|
-
];
|
|
1965
|
-
paging: 'cursor';
|
|
1966
|
-
wql: [
|
|
1967
|
-
{
|
|
1968
|
-
operators: ['$eq', '$in'];
|
|
1969
|
-
fields: ['_id', 'status'];
|
|
1970
|
-
sort: 'BOTH';
|
|
1971
|
-
},
|
|
1972
|
-
{
|
|
1973
|
-
operators: ['$eq', '$in'];
|
|
1974
|
-
fields: ['memberId'];
|
|
1975
|
-
sort: 'NONE';
|
|
1976
|
-
},
|
|
1977
|
-
{
|
|
1978
|
-
operators: ['$eq'];
|
|
1979
|
-
fields: ['programId'];
|
|
1980
|
-
sort: 'NONE';
|
|
1981
|
-
},
|
|
1982
|
-
{
|
|
1983
|
-
operators: [];
|
|
1984
|
-
fields: ['_createdDate'];
|
|
1985
|
-
sort: 'BOTH';
|
|
1986
|
-
},
|
|
1987
|
-
{
|
|
1988
|
-
operators: ['$gt', '$gte', '$lt', '$lte'];
|
|
1989
|
-
fields: ['joinedInfo.startDate'];
|
|
1990
|
-
sort: 'BOTH';
|
|
1991
|
-
}
|
|
1992
|
-
];
|
|
1993
|
-
}
|
|
1994
|
-
type CommonSearchWithEntityContext = Search<Participant, ParticipantSearchSpec>;
|
|
1995
|
-
type ParticipantSearch = {
|
|
1996
|
-
/**
|
|
1997
|
-
Cursor paging options.
|
|
1998
|
-
|
|
1999
|
-
Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
|
|
2000
|
-
*/
|
|
2001
|
-
cursorPaging?: {
|
|
2002
|
-
/**
|
|
2003
|
-
Maximum number of items to return in the results.
|
|
2004
|
-
@max: 100
|
|
2005
|
-
*/
|
|
2006
|
-
limit?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['limit'] | null;
|
|
2007
|
-
/**
|
|
2008
|
-
Pointer to the next or previous page in the list of results.
|
|
2009
|
-
|
|
2010
|
-
Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
|
|
2011
|
-
Not relevant for the first request.
|
|
2012
|
-
@maxLength: 16000
|
|
2013
|
-
*/
|
|
2014
|
-
cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
|
|
2015
|
-
};
|
|
2016
|
-
/**
|
|
2017
|
-
Filter object.
|
|
2018
|
-
|
|
2019
|
-
Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
|
|
2020
|
-
*/
|
|
2021
|
-
filter?: CommonSearchWithEntityContext['filter'] | null;
|
|
2022
|
-
/**
|
|
2023
|
-
List of sort objects.
|
|
2024
|
-
|
|
2025
|
-
Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
|
|
2026
|
-
@maxSize: 10
|
|
2027
|
-
*/
|
|
2028
|
-
sort?: {
|
|
2029
|
-
/**
|
|
2030
|
-
Name of the field to sort by.
|
|
2031
|
-
@maxLength: 512
|
|
2032
|
-
*/
|
|
2033
|
-
fieldName?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['fieldName'];
|
|
2034
|
-
/**
|
|
2035
|
-
Sort order.
|
|
2036
|
-
*/
|
|
2037
|
-
order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
|
|
2038
|
-
}[];
|
|
2039
|
-
/**
|
|
2040
|
-
Logical groupings of data into facets, with summaries for each facet. For example, use aggregations to allow site visitors to narrow down their search results by selecting specific categories.
|
|
2041
|
-
@maxSize: 10
|
|
2042
|
-
*/
|
|
2043
|
-
aggregations?: {
|
|
2044
|
-
/**
|
|
2045
|
-
A value aggregation calculates metrics such as count for specific fields within a dataset, providing insights into the overall distribution and key statistics of those values. For example, use a value aggregation to get the number (count) of products for each price listed in the store.
|
|
2046
|
-
*/
|
|
2047
|
-
value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
|
|
2048
|
-
/**
|
|
2049
|
-
A range aggregation calculates the count of the values from the specified field in the dataset that fall within the range of each bucket you define. For example, use a range aggregation to compare the number of reservations made for parties of 4 or less to the number of reservations made for parties with 5 or more.
|
|
2050
|
-
*/
|
|
2051
|
-
range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
|
|
2052
|
-
/**
|
|
2053
|
-
A scalar aggregation calculates a single numerical value from a dataset, summarizing the dataset into one key metric: `COUNT_DISTINCT`, `SUM`, `AVG`, `MIN`, or `MAX`.
|
|
2054
|
-
*/
|
|
2055
|
-
scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
|
|
2056
|
-
/**
|
|
2057
|
-
A date histogram calculates the count of time values from the specified field in the dataset that fall within each time interval you define (hour, day, week, etc.) For example, use a date histogram to find how many reservations have been made at a restaurant each week.
|
|
2058
|
-
*/
|
|
2059
|
-
dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
|
|
2060
|
-
/**
|
|
2061
|
-
A nested aggregation is applied within the results of another aggregation. Rather than aggregating directly on the primary dataset, first group data using one aggregation and then apply another aggregation within each group. It allows for more complex analyses where you can summarize data at different levels of detail or hierarchy. For example, to get the number of products that are in stock and out of stock for each price listed, first perform a value aggregation on `discountedPriceNumeric`, and a second value aggregation on `inStock`.
|
|
2062
|
-
*/
|
|
2063
|
-
nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
|
|
2064
|
-
/**
|
|
2065
|
-
Aggregation name, returned in `aggregations.results.name`.
|
|
2066
|
-
@maxLength: 100
|
|
2067
|
-
*/
|
|
2068
|
-
name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
|
|
2069
|
-
/**
|
|
2070
|
-
Type of aggregation to perform. Must align with the corresponding aggregation field.
|
|
2071
|
-
*/
|
|
2072
|
-
type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
|
|
2073
|
-
/**
|
|
2074
|
-
Field to aggregate by. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
|
|
2075
|
-
@maxLength: 200
|
|
2076
|
-
*/
|
|
2077
|
-
fieldPath?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['fieldPath'];
|
|
2078
|
-
/**
|
|
2079
|
-
Deprecated. Use `nested` instead.
|
|
2080
|
-
@deprecated: Deprecated. Use `nested` instead.,
|
|
2081
|
-
@replacedBy: kind.nested,
|
|
2082
|
-
@targetRemovalDate: 2024-03-30
|
|
2083
|
-
*/
|
|
2084
|
-
groupBy?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['groupBy'];
|
|
2085
|
-
}[];
|
|
2086
|
-
/**
|
|
2087
|
-
Free text to match in searchable fields.
|
|
2088
|
-
*/
|
|
2089
|
-
search?: {
|
|
2090
|
-
/**
|
|
2091
|
-
Search mode. Defines the search logic for combining multiple terms in the `expression`.
|
|
2092
|
-
*/
|
|
2093
|
-
mode?: NonNullable<CommonSearchWithEntityContext['search']>['mode'];
|
|
2094
|
-
/**
|
|
2095
|
-
Search term or expression.
|
|
2096
|
-
@maxLength: 100
|
|
2097
|
-
*/
|
|
2098
|
-
expression?: NonNullable<CommonSearchWithEntityContext['search']>['expression'] | null;
|
|
2099
|
-
/**
|
|
2100
|
-
Fields to search in. If the array is empty, all searchable fields are searched. Use dot notation to specify a JSON path. For example, `order.address.streetName`.
|
|
2101
|
-
@maxLength: 200,
|
|
2102
|
-
@maxSize: 20
|
|
2103
|
-
*/
|
|
2104
|
-
fields?: NonNullable<CommonSearchWithEntityContext['search']>['fields'];
|
|
2105
|
-
/**
|
|
2106
|
-
Whether to enable the search function to use an algorithm to automatically find results that are close to the search expression, such as typos and declensions.
|
|
2107
|
-
*/
|
|
2108
|
-
fuzzy?: NonNullable<CommonSearchWithEntityContext['search']>['fuzzy'];
|
|
2109
|
-
};
|
|
2110
|
-
/**
|
|
2111
|
-
Time zone to adjust date-time-based filters and aggregations, in ISO 8601 (including offsets) or IANA time zone database (including time zone IDs) format.
|
|
2112
|
-
Applies to all relevant filters and aggregations, unless overridden by providing timestamps including time zone. For example, "2023-12-20T10:52:34.795Z".
|
|
2113
|
-
@maxLength: 50
|
|
2114
|
-
*/
|
|
2115
|
-
timeZone?: CommonSearchWithEntityContext['timeZone'] | null;
|
|
2116
|
-
};
|
|
2117
|
-
/**
|
|
2118
|
-
* Bulk invites participants to program.
|
|
2119
|
-
* For each member participant in Invited state is created.
|
|
2120
|
-
* @param programId - Program to which bulk invite participants.
|
|
2121
|
-
* @public
|
|
2122
|
-
* @documentationMaturity preview
|
|
2123
|
-
* @requiredField programId
|
|
2124
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_INVITE
|
|
2125
|
-
* @applicableIdentity APP
|
|
2126
|
-
* @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkInviteToProgram
|
|
2127
|
-
*/
|
|
2128
|
-
declare function bulkInviteToProgram(programId: string, options?: BulkInviteToProgramOptions): Promise<NonNullablePaths<BulkInviteToProgramResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
|
|
2129
|
-
interface BulkInviteToProgramOptions {
|
|
2130
|
-
/**
|
|
2131
|
-
* Return added participants in the response or not.
|
|
2132
|
-
* @format GUID
|
|
2133
|
-
* @minSize 1
|
|
2134
|
-
* @maxSize 100
|
|
2135
|
-
*/
|
|
2136
|
-
memberIds?: string[];
|
|
2137
|
-
/** Return invited participants in the response or not. */
|
|
2138
|
-
returnEntity?: boolean;
|
|
2139
|
-
}
|
|
2140
|
-
/**
|
|
2141
|
-
* Bulk invites all participants to program, but not more then 1000.
|
|
2142
|
-
* For each member participant in Invited state is created.
|
|
2143
|
-
* @param programId - Program to which bulk add participants.
|
|
2144
|
-
* @public
|
|
2145
|
-
* @documentationMaturity preview
|
|
2146
|
-
* @requiredField programId
|
|
2147
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_INVITE
|
|
2148
|
-
* @applicableIdentity APP
|
|
2149
|
-
* @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkInviteAllToProgram
|
|
2150
|
-
*/
|
|
2151
|
-
declare function bulkInviteAllToProgram(programId: string, options?: BulkInviteAllToProgramOptions): Promise<NonNullablePaths<BulkInviteAllToProgramResponse, `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 3>>;
|
|
2152
|
-
interface BulkInviteAllToProgramOptions {
|
|
2153
|
-
/**
|
|
2154
|
-
* Exclude site members.
|
|
2155
|
-
* @format GUID
|
|
2156
|
-
* @maxSize 100
|
|
2157
|
-
*/
|
|
2158
|
-
excludeMemberIds?: string[];
|
|
2159
|
-
}
|
|
2160
|
-
/**
|
|
2161
|
-
* Bulk adds participants to program.
|
|
2162
|
-
* Participant will be either created in state Joined, or updated to that state
|
|
2163
|
-
* from pending one.
|
|
2164
|
-
* @param programId - Program to which bulk add participants.
|
|
2165
|
-
* @public
|
|
2166
|
-
* @documentationMaturity preview
|
|
2167
|
-
* @requiredField programId
|
|
2168
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_ADD
|
|
2169
|
-
* @applicableIdentity APP
|
|
2170
|
-
* @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkAddToProgram
|
|
2171
|
-
*/
|
|
2172
|
-
declare function bulkAddToProgram(programId: string, options?: BulkAddToProgramOptions): Promise<NonNullablePaths<BulkAddToProgramResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
|
|
2173
|
-
interface BulkAddToProgramOptions {
|
|
2174
|
-
/**
|
|
2175
|
-
* Site members.
|
|
2176
|
-
* @format GUID
|
|
2177
|
-
* @minSize 1
|
|
2178
|
-
* @maxSize 1000
|
|
2179
|
-
*/
|
|
2180
|
-
memberIds?: string[];
|
|
2181
|
-
/** Return added participants in the response or not. */
|
|
2182
|
-
returnEntity?: boolean;
|
|
2183
|
-
}
|
|
2184
|
-
/**
|
|
2185
|
-
* Bulk approves participants, who asked to join private program (aka in
|
|
2186
|
-
* state `APPROVAL_PENDING`). If participant was in other state, no effect and
|
|
2187
|
-
* error returned.
|
|
2188
|
-
* @param participantIds - Participants to add
|
|
2189
|
-
* @public
|
|
2190
|
-
* @documentationMaturity preview
|
|
2191
|
-
* @requiredField participantIds
|
|
2192
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_APPROVE
|
|
2193
|
-
* @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkApproveParticipant
|
|
2194
|
-
*/
|
|
2195
|
-
declare function bulkApproveParticipant(participantIds: string[], options?: BulkApproveParticipantOptions): Promise<NonNullablePaths<BulkApproveParticipantResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.memberId` | `results.${number}.item.programId` | `results.${number}.item.progress.totalStepsCompleted` | `results.${number}.item.progress.totalStepsAvailable` | `results.${number}.item.progress.completionPercentage` | `results.${number}.item.status` | `results.${number}.item.joinedInfo.timeZone` | `results.${number}.item.joinedInfo.startDate` | `results.${number}.item.joinedInfo.joinPath` | `results.${number}.item.member.contactId` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
|
|
2196
|
-
interface BulkApproveParticipantOptions {
|
|
2197
|
-
/**
|
|
2198
|
-
* program to approve participant
|
|
2199
|
-
* @format GUID
|
|
2200
|
-
*/
|
|
2201
|
-
programId?: string;
|
|
2202
|
-
/** Return approved participants in the response or not */
|
|
2203
|
-
returnEntity?: boolean;
|
|
2204
|
-
}
|
|
2205
|
-
/**
|
|
2206
|
-
* Bulk approves all pending participants, who asked to join private program (aka
|
|
2207
|
-
* in state `APPROVAL_PENDING`).
|
|
2208
|
-
* @public
|
|
2209
|
-
* @documentationMaturity preview
|
|
2210
|
-
* @permissionId ONLINE_PROGRAMS.PARTICIPANT_APPROVE
|
|
2211
|
-
* @fqn wix.onlineprograms.participants.v3.ManageParticipantsService.BulkApproveAllParticipant
|
|
2212
|
-
*/
|
|
2213
|
-
declare function bulkApproveAllParticipant(options?: BulkApproveAllParticipantOptions): Promise<NonNullablePaths<BulkApproveAllParticipantResponse, `jobId`, 2>>;
|
|
2214
|
-
interface BulkApproveAllParticipantOptions {
|
|
2215
|
-
/**
|
|
2216
|
-
* Program to approve all participants.
|
|
2217
|
-
* @format GUID
|
|
2218
|
-
*/
|
|
2219
|
-
programId?: string;
|
|
2220
|
-
/**
|
|
2221
|
-
* Exclude site members.
|
|
2222
|
-
* @format GUID
|
|
2223
|
-
* @maxSize 100
|
|
2224
|
-
*/
|
|
2225
|
-
excludeParticipantIds?: string[];
|
|
2226
|
-
}
|
|
2227
|
-
/**
|
|
2228
|
-
* Exports data about participants as well as resolved steps in program.
|
|
2229
|
-
* @param programId - program id to export data from
|
|
2230
|
-
* @internal
|
|
2231
|
-
* @documentationMaturity preview
|
|
2232
|
-
* @requiredField programId
|
|
2233
|
-
* @permissionId ONLINE_PROGRAMS.EXPORT_PARTICIPANTS_STATS
|
|
2234
|
-
* @fqn wix.onlineprograms.participants.v3.ParticipantExportsService.ExportParticipantsStats
|
|
2235
|
-
*/
|
|
2236
|
-
declare function exportParticipantsStats(programId: string): Promise<void>;
|
|
2237
|
-
|
|
2238
|
-
export { type Certificate as $, type ParticipantQuery as A, type BulkCreateParticipantOptions as B, type CreateParticipantApplicationErrors as C, typedQueryParticipants as D, Status as E, SortOrder as F, type GetCompletionStatsResponse as G, SortType as H, type IssueCertificateResponse as I, JoinPath as J, SortDirection as K, ScalarType as L, MissingValues as M, NestedAggregationType as N, Interval as O, type Participant as P, AggregationType as Q, Mode as R, type SearchParticipantsResponse as S, BenefitType as T, Event as U, State as V, WebhookIdentityType as W, type SinglePaymentDetails as X, type PaidPlanDetails as Y, type FreeCouponDetails as Z, type Progress as _, type BulkCreateParticipantResponse as a, type RangeResult as a$, type JoinedInfo as a0, type JoinedInfoJoinPathDetailsOneOf as a1, type Member as a2, type ExtendedFields as a3, type Tags as a4, type TagList as a5, type ParticipantAdded as a6, type TagsModified as a7, type CreateParticipantRequest as a8, type CreateParticipantResponse as a9, type CursorSearch as aA, type CursorSearchPagingMethodOneOf as aB, type Aggregation as aC, type AggregationKindOneOf as aD, type RangeBucket as aE, type IncludeMissingValuesOptions as aF, type ValueAggregation as aG, type ValueAggregationOptionsOneOf as aH, type RangeAggregation as aI, type ScalarAggregation as aJ, type DateHistogramAggregation as aK, type NestedAggregationItem as aL, type NestedAggregationItemKindOneOf as aM, type NestedAggregation as aN, type GroupByAggregation as aO, type GroupByAggregationKindOneOf as aP, type SearchDetails as aQ, type AggregationData as aR, type ValueAggregationResult as aS, type RangeAggregationResult as aT, type NestedAggregationResults as aU, type NestedAggregationResultsResultOneOf as aV, type ValueResults as aW, type RangeResults as aX, type AggregationResultsScalarResult as aY, type NestedValueAggregationResult as aZ, type ValueResult as a_, type BulkCreateParticipantRequest as aa, type BulkParticipantResult as ab, type CommonItemMetadata as ac, type ApplicationError as ad, type CommonBulkActionMetadata as ae, type BulkAddAllToProgramRequest as af, type DeleteParticipantRequest as ag, type DeleteParticipantResponse as ah, type IssueCertificateRequest as ai, type GetCompletionStatsRequest as aj, type GetPremiumStatsRequest as ak, type GetParticipantRequest as al, type GetParticipantResponse as am, type QueryParticipantsRequest as an, type CursorQuery as ao, type CursorQueryPagingMethodOneOf as ap, type Sorting as aq, type CursorPaging as ar, type QueryParticipantsResponse as as, type CursorPagingMetadata as at, type Cursors as au, type GetAccessStatusRequest as av, type BulkUpdateParticipantTagsRequest as aw, type BulkUpdateParticipantTagsResult as ax, type BulkUpdateParticipantTagsByFilterRequest as ay, type SearchParticipantsRequest as az, type BulkAddAllToProgramOptions as b, type CommonQueryWithEntityContext as b$, type ScalarResult as b0, type NestedResultValue as b1, type NestedResultValueResultOneOf as b2, type Results as b3, type DateHistogramResult as b4, type GroupByValueResults as b5, type DateHistogramResults as b6, type NestedResults as b7, type AggregationResults as b8, type AggregationResultsResultOneOf as b9, type BulkApproveParticipantRequest as bA, type BulkApproveParticipantResult as bB, type ParticipantApproved as bC, type BulkApproveAllParticipantRequest as bD, type ExportParticipantsStatsRequest as bE, type ExportParticipantsStatsResponse as bF, type ParticipantExportsFinished as bG, type BaseEventMetadata as bH, type EventMetadata as bI, type ParticipantsQueryResult as bJ, type ParticipantQuerySpec as bK, type ParticipantSearchSpec as bL, type JoinPathWithLiterals as bM, type StatusWithLiterals as bN, type SortOrderWithLiterals as bO, type SortTypeWithLiterals as bP, type SortDirectionWithLiterals as bQ, type MissingValuesWithLiterals as bR, type ScalarTypeWithLiterals as bS, type NestedAggregationTypeWithLiterals as bT, type IntervalWithLiterals as bU, type AggregationTypeWithLiterals as bV, type ModeWithLiterals as bW, type BenefitTypeWithLiterals as bX, type EventWithLiterals as bY, type WebhookIdentityTypeWithLiterals as bZ, type StateWithLiterals as b_, type DomainEvent as ba, type DomainEventBodyOneOf as bb, type EntityCreatedEvent as bc, type RestoreInfo as bd, type EntityUpdatedEvent as be, type EntityDeletedEvent as bf, type ActionEvent as bg, type Empty as bh, type BenefitNotification as bi, type Benefit as bj, type EntryPass as bk, type Discount as bl, type DiscountDiscountOneOf as bm, type Behavior as bn, type BehaviorBehaviorOneOf as bo, type MessageEnvelope as bp, type IdentificationData as bq, type IdentificationDataIdOneOf as br, type BulkInviteToProgramRequest as bs, type ItemMetadata as bt, type BulkInviteToProgramResult as bu, type BulkActionMetadata as bv, type ParticipantInvited as bw, type BulkInviteAllToProgramRequest as bx, type BulkAddToProgramRequest as by, type BulkAddToProgramResult as bz, type BulkAddAllToProgramResponse as c, type CommonSearchWithEntityContext as c0, onParticipantAdded as c1, onParticipantApproved as c2, onParticipantInvited as c3, createParticipant as c4, bulkCreateParticipant as c5, bulkAddAllToProgram as c6, deleteParticipant as c7, issueCertificate as c8, getCompletionStats as c9, getPremiumStats as ca, getParticipant as cb, queryParticipants as cc, getAccessStatus as cd, bulkUpdateParticipantTags as ce, bulkUpdateParticipantTagsByFilter as cf, bulkInviteToProgram as cg, bulkInviteAllToProgram as ch, bulkAddToProgram as ci, bulkApproveParticipant as cj, bulkApproveAllParticipant as ck, exportParticipantsStats as cl, type GetPremiumStatsResponse as d, type GetAccessStatusResponse as e, type BulkUpdateParticipantTagsOptions as f, type BulkUpdateParticipantTagsResponse as g, type BulkUpdateParticipantTagsApplicationErrors as h, type BulkUpdateParticipantTagsByFilterOptions as i, type BulkUpdateParticipantTagsByFilterResponse as j, type BulkUpdateParticipantTagsByFilterApplicationErrors as k, type ParticipantSearch as l, type BulkInviteToProgramOptions as m, type BulkInviteToProgramResponse as n, type BulkInviteAllToProgramOptions as o, type BulkInviteAllToProgramResponse as p, type BulkAddToProgramOptions as q, type BulkAddToProgramResponse as r, type BulkApproveParticipantOptions as s, type BulkApproveParticipantResponse as t, type BulkApproveAllParticipantOptions as u, type BulkApproveAllParticipantResponse as v, type ParticipantAddedEnvelope as w, type ParticipantApprovedEnvelope as x, type ParticipantInvitedEnvelope as y, type ParticipantsQueryBuilder as z };
|