@maxim_mazurok/gapi.client.cloudsearch-v1 0.0.20230503 → 0.0.20230524

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/index.d.ts +168 -31
  2. package/package.json +1 -1
  3. package/readme.md +5 -0
  4. package/tests.ts +22 -1
package/index.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://cloudsearch.googleapis.com/$discovery/rest?version=v1
12
- // Revision: 20230503
12
+ // Revision: 20230524
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -366,7 +366,7 @@ declare namespace gapi.client {
366
366
  /** Summary of a Data Loss Prevention (DLP) scan of the attachment. Attachments are evaluated in the backend when they are uploaded. */
367
367
  dlpScanSummary?:
368
368
  DlpScanSummary;
369
- /** The list of experiments this video is enabled for Next tag: 19 */
369
+ /** The list of experiments this video is enabled for */
370
370
  experiment?:
371
371
  string[];
372
372
  /** GroupId to which this attachment is uploaded. */
@@ -375,6 +375,8 @@ declare namespace gapi.client {
375
375
  /** If the uploaded file is a video that has been transcoded on the client side */
376
376
  isClientSideTranscodedVideo?:
377
377
  boolean;
378
+ migratedFromHangoutsMetadata?:
379
+ AppsDynamiteSharedBackendUploadMetadataMigratedFromHangoutsMetadata;
378
380
  /** Original dimension of the content. Only set for image attachments. */
379
381
  originalDimension?:
380
382
  AppsDynamiteSharedDimension;
@@ -404,6 +406,18 @@ declare namespace gapi.client {
404
406
  virusScanResult?:
405
407
  string;
406
408
  }
409
+ interface AppsDynamiteSharedBackendUploadMetadataMigratedFromHangoutsMetadata {
410
+ photoId?:
411
+ AppsDynamiteSharedBackendUploadMetadataMigratedFromHangoutsMetadataPhotoId;
412
+ updateTimestampUsec?:
413
+ string;
414
+ }
415
+ interface AppsDynamiteSharedBackendUploadMetadataMigratedFromHangoutsMetadataPhotoId {
416
+ photoId?:
417
+ string;
418
+ userId?:
419
+ string;
420
+ }
407
421
  interface AppsDynamiteSharedCalendarEventAnnotationData {
408
422
  calendarEvent?:
409
423
  AppsDynamiteSharedCalendarEventAnnotationDataCalendarEvent;
@@ -651,6 +665,9 @@ declare namespace gapi.client {
651
665
  /** Required. A globally unique code (e.g. "cxv-zbgj-wzw") that points to a meeting space. Note: Meeting codes may be regenerated, which will cause old meeting codes to become invalid. */
652
666
  meetingCode?:
653
667
  string;
668
+ /** Required. Type of the meeting. This controls the chat client UX. */
669
+ meetingType?:
670
+ string;
654
671
  /** Required. A URL, in the format "https://meet.google.com/*" (e.g. https://meet.google.com/cxv-zbgj-wzw), to identify and access the meeting space. */
655
672
  meetingUrl?:
656
673
  string;
@@ -689,8 +706,8 @@ declare namespace gapi.client {
689
706
  }
690
707
  interface AppsDynamiteSharedMessageSearchInfo {
691
708
  /**
692
- * An example use case: clients can use this field to highlight matched segments in message text_body defined in
693
- * http://google3/apps/dynamite/v1/frontend/api/message.proto;l=104;rcl=513400736.
709
+ * Current usage: - DescriptionType=KEYWORD_MATCH is populated in this field to return metadata for keyword matches, which clients can use to highlight matched segments in a message's
710
+ * text_body. - DescriptionType=SNIPPET can be used to return metadata describing how a message's text_body can be broken up to provide a snippet.
694
711
  */
695
712
  matchedSegmentsInTextBody?:
696
713
  AppsDynamiteSharedTextSegmentsWithDescription[];
@@ -1824,6 +1841,9 @@ declare namespace gapi.client {
1824
1841
  */
1825
1842
  supportUrls?:
1826
1843
  SupportUrls;
1844
+ /** Determine how uninstall is permitted for this app. */
1845
+ uninstallCapability?:
1846
+ string;
1827
1847
  }
1828
1848
  interface BotResponse {
1829
1849
  botId?:
@@ -3442,7 +3462,7 @@ declare namespace gapi.client {
3442
3462
  GoogleChatV1WidgetMarkupOnClick;
3443
3463
  }
3444
3464
  interface GoogleChatV1ContextualAddOnMarkupCardCardHeader {
3445
- /** The image's type (e.g. square border or circular border). */
3465
+ /** The image's type (for example, square border or circular border). */
3446
3466
  imageStyle?:
3447
3467
  string;
3448
3468
  /** The URL of the image in the card header. */
@@ -3452,7 +3472,7 @@ declare namespace gapi.client {
3452
3472
  subtitle?:
3453
3473
  string;
3454
3474
  /**
3455
- * The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each will take up 1 line. If only the title is specified, it will take up both
3475
+ * The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each takes up one line. If only the title is specified, it takes up both
3456
3476
  * lines.
3457
3477
  */
3458
3478
  title?:
@@ -3460,12 +3480,13 @@ declare namespace gapi.client {
3460
3480
  }
3461
3481
  interface GoogleChatV1ContextualAddOnMarkupCardSection {
3462
3482
  /**
3463
- * The header of the section. Formatted text is supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
3464
- * Add-ons.
3483
+ * The header of the section. Formatted text is supported. For more information about formatting text, see [Formatting text in Google Chat
3484
+ * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
3485
+ * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
3465
3486
  */
3466
3487
  header?:
3467
3488
  string;
3468
- /** A section must contain at least 1 widget. */
3489
+ /** A section must contain at least one widget. */
3469
3490
  widgets?:
3470
3491
  GoogleChatV1WidgetMarkup[];
3471
3492
  }
@@ -3484,17 +3505,17 @@ declare namespace gapi.client {
3484
3505
  GoogleChatV1WidgetMarkupTextParagraph;
3485
3506
  }
3486
3507
  interface GoogleChatV1WidgetMarkupButton {
3487
- /** A button with image and onclick action. */
3508
+ /** A button with image and `onclick` action. */
3488
3509
  imageButton?:
3489
3510
  GoogleChatV1WidgetMarkupImageButton;
3490
- /** A button with text and onclick action. */
3511
+ /** A button with text and `onclick` action. */
3491
3512
  textButton?:
3492
3513
  GoogleChatV1WidgetMarkupTextButton;
3493
3514
  }
3494
3515
  interface GoogleChatV1WidgetMarkupFormAction {
3495
3516
  /**
3496
- * The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. The same
3497
- * method name can be used for several elements that trigger a common behavior if desired.
3517
+ * The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. You can
3518
+ * use the same method name for several elements that trigger a common behavior.
3498
3519
  */
3499
3520
  actionMethodName?:
3500
3521
  string;
@@ -3512,36 +3533,37 @@ declare namespace gapi.client {
3512
3533
  }
3513
3534
  interface GoogleChatV1WidgetMarkupImage {
3514
3535
  /**
3515
- * The aspect ratio of this image (width/height). This field allows clients to reserve the right height for the image while waiting for it to load. It's not meant to override the
3516
- * native aspect ratio of the image. If unset, the server fills it by prefetching the image.
3536
+ * The aspect ratio of this image (width and height). This field lets you reserve the right height for the image while waiting for it to load. It's not meant to override the built-in
3537
+ * aspect ratio of the image. If unset, the server fills it by prefetching the image.
3517
3538
  */
3518
3539
  aspectRatio?:
3519
3540
  number;
3520
3541
  /** The URL of the image. */
3521
3542
  imageUrl?:
3522
3543
  string;
3523
- /** The onclick action. */
3544
+ /** The `onclick` action. */
3524
3545
  onClick?:
3525
3546
  GoogleChatV1WidgetMarkupOnClick;
3526
3547
  }
3527
3548
  interface GoogleChatV1WidgetMarkupImageButton {
3528
- /** The icon specified by an enum that indices to an icon provided by Chat API. */
3549
+ /** The icon specified by an `enum` that indices to an icon provided by Chat API. */
3529
3550
  icon?:
3530
3551
  string;
3531
3552
  /** The icon specified by a URL. */
3532
3553
  iconUrl?:
3533
3554
  string;
3534
- /** The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify. */
3555
+ /** The name of this `image_button` that's used for accessibility. Default value is provided if this name isn't specified. */
3535
3556
  name?:
3536
3557
  string;
3537
- /** The onclick action. */
3558
+ /** The `onclick` action. */
3538
3559
  onClick?:
3539
3560
  GoogleChatV1WidgetMarkupOnClick;
3540
3561
  }
3541
3562
  interface GoogleChatV1WidgetMarkupKeyValue {
3542
3563
  /**
3543
- * The text of the bottom label. Formatted text supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
3544
- * Add-ons.
3564
+ * The text of the bottom label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat
3565
+ * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
3566
+ * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
3545
3567
  */
3546
3568
  bottomLabel?:
3547
3569
  string;
@@ -3549,35 +3571,37 @@ declare namespace gapi.client {
3549
3571
  button?:
3550
3572
  GoogleChatV1WidgetMarkupButton;
3551
3573
  /**
3552
- * The text of the content. Formatted text supported and always required. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in
3553
- * Google Workspace Add-ons.
3574
+ * The text of the content. Formatted text supported and always required. For more information about formatting text, see [Formatting text in Google Chat
3575
+ * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
3576
+ * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
3554
3577
  */
3555
3578
  content?:
3556
3579
  string;
3557
3580
  /** If the content should be multiline. */
3558
3581
  contentMultiline?:
3559
3582
  boolean;
3560
- /** An enum value that will be replaced by the Chat API with the corresponding icon image. */
3583
+ /** An enum value that's replaced by the Chat API with the corresponding icon image. */
3561
3584
  icon?:
3562
3585
  string;
3563
3586
  /** The icon specified by a URL. */
3564
3587
  iconUrl?:
3565
3588
  string;
3566
- /** The onclick action. Only the top label, bottom label and content region are clickable. */
3589
+ /** The `onclick` action. Only the top label, bottom label, and content region are clickable. */
3567
3590
  onClick?:
3568
3591
  GoogleChatV1WidgetMarkupOnClick;
3569
3592
  /**
3570
- * The text of the top label. Formatted text supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
3571
- * Add-ons.
3593
+ * The text of the top label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat
3594
+ * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
3595
+ * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
3572
3596
  */
3573
3597
  topLabel?:
3574
3598
  string;
3575
3599
  }
3576
3600
  interface GoogleChatV1WidgetMarkupOnClick {
3577
- /** A form action will be triggered by this onclick if specified. */
3601
+ /** A form action is triggered by this `onclick` action if specified. */
3578
3602
  action?:
3579
3603
  GoogleChatV1WidgetMarkupFormAction;
3580
- /** This onclick triggers an open link action if specified. */
3604
+ /** This `onclick` action triggers an open link action if specified. */
3581
3605
  openLink?:
3582
3606
  GoogleChatV1WidgetMarkupOpenLink;
3583
3607
  }
@@ -3587,7 +3611,7 @@ declare namespace gapi.client {
3587
3611
  string;
3588
3612
  }
3589
3613
  interface GoogleChatV1WidgetMarkupTextButton {
3590
- /** The onclick action of the button. */
3614
+ /** The `onclick` action of the button. */
3591
3615
  onClick?:
3592
3616
  GoogleChatV1WidgetMarkupOnClick;
3593
3617
  /** The text of the button. */
@@ -4830,7 +4854,7 @@ declare namespace gapi.client {
4830
4854
  * Contains reference to another message. It is used in shortcuts which are used to collect messages from different spaces with a certain common property into another space. For
4831
4855
  * example, all @mentions of a user are collected into a mention shortcut space (go/chat-shortcuts-backend-design for more details). Most information from the source message (like
4832
4856
  * text) are copied onto top-level Message fields of shortcut messages by the server. The MessageReference is helpful for clients to enable things like click navigation to source
4833
- * message. NEXT TAG: 50
4857
+ * message.
4834
4858
  */
4835
4859
  messageReference?:
4836
4860
  MessageReference;
@@ -4843,6 +4867,9 @@ declare namespace gapi.client {
4843
4867
  /** State of the message, indicating whether the message is visible to all members in the group or is only visible to the sender only, or the private_message_viewer if it is set. */
4844
4868
  messageState?:
4845
4869
  string;
4870
+ /** Indicates the number of unicode emojis in the message. */
4871
+ numberOfUnicodeEmojis?:
4872
+ number;
4846
4873
  /** Indicates if this message contains any suggestions that were provided by any Apps. */
4847
4874
  originAppSuggestions?:
4848
4875
  AppsDynamiteSharedOriginAppSuggestion[];
@@ -5648,6 +5675,11 @@ declare namespace gapi.client {
5648
5675
  item?:
5649
5676
  PushItem;
5650
5677
  }
5678
+ interface QueryActivity {
5679
+ /** User input query to be logged/removed. */
5680
+ query?:
5681
+ string;
5682
+ }
5651
5683
  interface QueryCountByStatus {
5652
5684
  count?:
5653
5685
  string;
@@ -5918,6 +5950,17 @@ declare namespace gapi.client {
5918
5950
  references?:
5919
5951
  Reference[];
5920
5952
  }
5953
+ interface RemoveActivityRequest {
5954
+ /** Request options, such as the search application and clientId. */
5955
+ requestOptions?:
5956
+ RequestOptions;
5957
+ /** User Activity containing the data to be deleted. */
5958
+ userActivity?:
5959
+ UserActivity;
5960
+ }
5961
+ // tslint:disable-next-line:no-empty-interface
5962
+ interface RemoveActivityResponse {
5963
+ }
5921
5964
  interface RenameEvent {
5922
5965
  newName?:
5923
5966
  string;
@@ -6643,6 +6686,9 @@ declare namespace gapi.client {
6643
6686
  /** The suggested spelling of the query. */
6644
6687
  suggestedQuery?:
6645
6688
  string;
6689
+ /** Suggestion triggered for the current query. */
6690
+ suggestionType?:
6691
+ string;
6646
6692
  }
6647
6693
  interface SquareProto {
6648
6694
  /**
@@ -7254,6 +7300,13 @@ declare namespace gapi.client {
7254
7300
  /** The metrics metadata of the Data Loss Prevention attachment scan. */
7255
7301
  dlpMetricsMetadata?:
7256
7302
  AppsDynamiteSharedDlpMetricsMetadata;
7303
+ /**
7304
+ * Message component search metadata for this upload_metadata (currently used for message highlighting and snippeting). For use by Search backend only; clients should get
7305
+ * upload_metadata search info from Annotation.component_search_info. This field is necessary because backend Message keeps UploadMetadata in a separate field. Upon converting from
7306
+ * backend message to frontend message, this field will be copied to Annotation.component_search_info while the corresponding UploadMetadata is converted into an Annotation.
7307
+ */
7308
+ internalOnlyComponentSearchInfo?:
7309
+ AppsDynamiteSharedMessageComponentSearchInfo;
7257
7310
  /** The timestamp of the most recent virus scan completed (in microseconds). */
7258
7311
  latestVirusScanTimestamp?:
7259
7312
  string;
@@ -7366,6 +7419,11 @@ declare namespace gapi.client {
7366
7419
  userProfileVisibility?:
7367
7420
  string;
7368
7421
  }
7422
+ interface UserActivity {
7423
+ /** Contains data which needs to be logged/removed. */
7424
+ queryActivity?:
7425
+ QueryActivity;
7426
+ }
7369
7427
  interface UserDisplayInfo {
7370
7428
  /** The avatar to show for this user */
7371
7429
  avatarUrl?:
@@ -9123,6 +9181,85 @@ declare namespace gapi.client {
9123
9181
  }): Request<ListQuerySourcesResponse>;
9124
9182
  }
9125
9183
  interface QueryResource {
9184
+ /**
9185
+ * Provides functionality to remove logged activity for a user. Currently to be used only for dynamite 1p clients **Note:** This API requires a standard end user account to execute. A
9186
+ * service account can't perform Remove Activity requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of
9187
+ * authority](https://developers.google.com/cloud-search/docs/guides/delegation/).
9188
+ */
9189
+ removeActivity(request: {
9190
+ /** V1 error format. */
9191
+ "$.xgafv"?:
9192
+ string;
9193
+ /** OAuth access token. */
9194
+ access_token?:
9195
+ string;
9196
+ /** Data format for response. */
9197
+ alt?:
9198
+ string;
9199
+ /** JSONP */
9200
+ callback?:
9201
+ string;
9202
+ /** Selector specifying which fields to include in a partial response. */
9203
+ fields?:
9204
+ string;
9205
+ /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
9206
+ key?:
9207
+ string;
9208
+ /** OAuth 2.0 token for the current user. */
9209
+ oauth_token?:
9210
+ string;
9211
+ /** Returns response with indentations and line breaks. */
9212
+ prettyPrint?:
9213
+ boolean;
9214
+ /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
9215
+ quotaUser?:
9216
+ string;
9217
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
9218
+ upload_protocol?:
9219
+ string;
9220
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
9221
+ uploadType?:
9222
+ string;
9223
+ /** Request body */
9224
+ resource:
9225
+ RemoveActivityRequest;
9226
+ }): Request<{}>;
9227
+ removeActivity(request: {
9228
+ /** V1 error format. */
9229
+ "$.xgafv"?:
9230
+ string;
9231
+ /** OAuth access token. */
9232
+ access_token?:
9233
+ string;
9234
+ /** Data format for response. */
9235
+ alt?:
9236
+ string;
9237
+ /** JSONP */
9238
+ callback?:
9239
+ string;
9240
+ /** Selector specifying which fields to include in a partial response. */
9241
+ fields?:
9242
+ string;
9243
+ /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
9244
+ key?:
9245
+ string;
9246
+ /** OAuth 2.0 token for the current user. */
9247
+ oauth_token?:
9248
+ string;
9249
+ /** Returns response with indentations and line breaks. */
9250
+ prettyPrint?:
9251
+ boolean;
9252
+ /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
9253
+ quotaUser?:
9254
+ string;
9255
+ /** Upload protocol for media (e.g. "raw", "multipart"). */
9256
+ upload_protocol?:
9257
+ string;
9258
+ /** Legacy upload protocol for media (e.g. "media", "multipart"). */
9259
+ uploadType?:
9260
+ string;
9261
+ },
9262
+ body: RemoveActivityRequest): Request<{}>;
9126
9263
  /**
9127
9264
  * The Cloud Search Query API provides the search method, which returns the most relevant results from a user query. The results can come from Google Workspace apps, such as Gmail or
9128
9265
  * Google Drive, or they can come from data that you have indexed from a third party. **Note:** This API requires a standard end user account to execute. A service account can't
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.cloudsearch-v1",
3
- "version": "0.0.20230503",
3
+ "version": "0.0.20230524",
4
4
  "description": "TypeScript typings for Cloud Search API v1",
5
5
  "license": "MIT",
6
6
  "author": {
package/readme.md CHANGED
@@ -100,6 +100,11 @@ Gets the latest state of a long-running operation. Clients can use this method t
100
100
  */
101
101
  await gapi.client.cloudsearch.operations.get({ name: "name", });
102
102
 
103
+ /*
104
+ Provides functionality to remove logged activity for a user. Currently to be used only for dynamite 1p clients **Note:** This API requires a standard end user account to execute. A service account can't perform Remove Activity requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](https://developers.google.com/cloud-search/docs/guides/delegation/).
105
+ */
106
+ await gapi.client.cloudsearch.query.removeActivity({ });
107
+
103
108
  /*
104
109
  The Cloud Search Query API provides the search method, which returns the most relevant results from a user query. The results can come from Google Workspace apps, such as Gmail or Google Drive, or they can come from data that you have indexed from a third party. **Note:** This API requires a standard end user account to execute. A service account can't perform Query API requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of authority](https://developers.google.com/cloud-search/docs/guides/delegation/).
105
110
  */
package/tests.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
4
4
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
5
5
 
6
- // Revision: 20230503
6
+ // Revision: 20230524
7
7
 
8
8
  gapi.load('client', async () => {
9
9
  /** now we can use gapi.client */
@@ -549,6 +549,27 @@ gapi.load('client', async () => {
549
549
  pageSize: 42,
550
550
  pageToken: "Test string",
551
551
  });
552
+ /**
553
+ * Provides functionality to remove logged activity for a user. Currently to be used only for dynamite 1p clients **Note:** This API requires a standard end user account to execute. A
554
+ * service account can't perform Remove Activity requests directly; to use a service account to perform queries, set up [Google Workspace domain-wide delegation of
555
+ * authority](https://developers.google.com/cloud-search/docs/guides/delegation/).
556
+ */
557
+ await gapi.client.cloudsearch.query.removeActivity({
558
+ }, {
559
+ requestOptions: {
560
+ debugOptions: {
561
+ enableDebugging: true,
562
+ },
563
+ languageCode: "Test string",
564
+ searchApplicationId: "Test string",
565
+ timeZone: "Test string",
566
+ },
567
+ userActivity: {
568
+ queryActivity: {
569
+ query: "Test string",
570
+ },
571
+ },
572
+ });
552
573
  /**
553
574
  * The Cloud Search Query API provides the search method, which returns the most relevant results from a user query. The results can come from Google Workspace apps, such as Gmail or
554
575
  * Google Drive, or they can come from data that you have indexed from a third party. **Note:** This API requires a standard end user account to execute. A service account can't perform