Skip to content

Commit 8732f99

Browse files
author
PureCloud Jenkins
committed
232.0.0
1 parent 183b06c commit 8732f99

File tree

185 files changed

+3699
-1738
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

185 files changed

+3699
-1738
lines changed

README.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ A JavaScript library to interface with the Genesys Cloud Platform API. View the
66
[![npm](https://img.shields.io/npm/v/purecloud-platform-client-v2.svg)](https://www.npmjs.com/package/purecloud-platform-client-v2)
77
[![Release Notes Badge](https://developer-content.genesys.cloud/images/sdk-release-notes.png)](https://github.com/MyPureCloud/platform-client-sdk-javascript/blob/master/releaseNotes.md)
88

9-
Documentation version purecloud-platform-client-v2@231.0.0
9+
Documentation version purecloud-platform-client-v2@232.0.0
1010

1111
## Preview APIs
1212

@@ -29,7 +29,7 @@ For direct use in a browser script:
2929

3030
```html
3131
<!-- Include the CJS SDK -->
32-
<script src="https://sdk-cdn.mypurecloud.com/javascript/231.0.0/purecloud-platform-client-v2.min.js"></script>
32+
<script src="https://sdk-cdn.mypurecloud.com/javascript/232.0.0/purecloud-platform-client-v2.min.js"></script>
3333

3434
<script type="text/javascript">
3535
// Obtain a reference to the platformClient object
@@ -46,7 +46,7 @@ For direct use in a browser script:
4646

4747
<script type="text/javascript">
4848
// Obtain a reference to the platformClient object
49-
requirejs(['https://sdk-cdn.mypurecloud.com/javascript/amd/231.0.0/purecloud-platform-client-v2.min.js'], (platformClient) => {
49+
requirejs(['https://sdk-cdn.mypurecloud.com/javascript/amd/232.0.0/purecloud-platform-client-v2.min.js'], (platformClient) => {
5050
console.log(platformClient);
5151
});
5252
</script>
@@ -428,6 +428,25 @@ const client = platformClient.ApiClient.instance;
428428
client.setEnvironment(platformClient.PureCloudRegionHosts.eu_west_1);
429429
```
430430

431+
## Filtering of Query Parameters
432+
433+
The SDK is implemented so that when one of its API method is invoked, it filters out null or undefined method parameters (mapped to an API Endpoint's query parameter).
434+
- In its legacy state, the SDK will also filter parameters of boolean type and equal to false, and parameters of type integer/number and equal to 0.
435+
- In its modern state, the SDK will keep and send such parameters.
436+
437+
A new ApiClient property (accessed using getUseLegacyParameterFilter and setUseLegacyParameterFilter) is introduced to control the method used to filter out such parameters.
438+
439+
When UseLegacyParameterFilter is true, the SDK will use the legacy filter method.
440+
441+
*The UseLegacyParameterFilter default value is currently equal to true.* You will need to change the UseLegacyParameterFilter value so that the SDK uses modern filter method.
442+
This choice of default value has been made to facilitate the transition from legacy to modern and accurate parameter filtering, without running the risk to affect existing applications with a change of behavior.
443+
444+
```javascript
445+
const client = platformClient.ApiClient.instance;
446+
// To use modern and accurate parameter filtering, set UseLegacyParameterFilter to false
447+
client.setUseLegacyParameterFilter(false);
448+
```
449+
431450
### Setting an intermediate Gateway
432451

433452
The Genesys Cloud Login and API URL path can be overridden if necessary (i.e. if the Genesys Cloud requests must be sent through to an intermediate API gateway or equivalent).

build/.openapi-generator/FILES

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -239,6 +239,7 @@ docs/deleteConversationRecordingAnnotation-example.txt
239239
docs/deleteConversationsCallParticipantConsult-example.txt
240240
docs/deleteConversationsEmailMessagesDraftAttachment-example.txt
241241
docs/deleteConversationsMessagesCachedmediaCachedMediaItemId-example.txt
242+
docs/deleteConversationsMessagingIntegrationsAppleIntegrationId-example.txt
242243
docs/deleteConversationsMessagingIntegrationsFacebookIntegrationId-example.txt
243244
docs/deleteConversationsMessagingIntegrationsInstagramIntegrationId-example.txt
244245
docs/deleteConversationsMessagingIntegrationsOpenIntegrationId-example.txt
@@ -617,6 +618,7 @@ docs/getAssistantCopilot-example.txt
617618
docs/getAssistantQueue-example.txt
618619
docs/getAssistantQueues-example.txt
619620
docs/getAssistants-example.txt
621+
docs/getAssistantsCopilotFeaturesupport-example.txt
620622
docs/getAssistantsQueues-example.txt
621623
docs/getAuditsQueryRealtimeServicemapping-example.txt
622624
docs/getAuditsQueryServicemapping-example.txt
@@ -797,6 +799,8 @@ docs/getConversationsMessagingIdentityresolutionIntegrationsTwitterIntegrationId
797799
docs/getConversationsMessagingIdentityresolutionIntegrationsWhatsappIntegrationId-example.txt
798800
docs/getConversationsMessagingIntegrationTwitterOauthSettings-example.txt
799801
docs/getConversationsMessagingIntegrations-example.txt
802+
docs/getConversationsMessagingIntegrationsApple-example.txt
803+
docs/getConversationsMessagingIntegrationsAppleIntegrationId-example.txt
800804
docs/getConversationsMessagingIntegrationsFacebook-example.txt
801805
docs/getConversationsMessagingIntegrationsFacebookIntegrationId-example.txt
802806
docs/getConversationsMessagingIntegrationsInstagram-example.txt
@@ -808,6 +812,7 @@ docs/getConversationsMessagingIntegrationsTwitterIntegrationId-example.txt
808812
docs/getConversationsMessagingIntegrationsTwitterOauthSettings-example.txt
809813
docs/getConversationsMessagingIntegrationsWhatsapp-example.txt
810814
docs/getConversationsMessagingIntegrationsWhatsappIntegrationId-example.txt
815+
docs/getConversationsMessagingOauthAppleCallback-example.txt
811816
docs/getConversationsMessagingSetting-example.txt
812817
docs/getConversationsMessagingSettings-example.txt
813818
docs/getConversationsMessagingSettingsDefault-example.txt
@@ -1981,6 +1986,7 @@ docs/patchConversationsMessage-example.txt
19811986
docs/patchConversationsMessageParticipant-example.txt
19821987
docs/patchConversationsMessageParticipantAttributes-example.txt
19831988
docs/patchConversationsMessageParticipantCommunication-example.txt
1989+
docs/patchConversationsMessagingIntegrationsAppleIntegrationId-example.txt
19841990
docs/patchConversationsMessagingIntegrationsFacebookIntegrationId-example.txt
19851991
docs/patchConversationsMessagingIntegrationsInstagramIntegrationId-example.txt
19861992
docs/patchConversationsMessagingIntegrationsOpenIntegrationId-example.txt
@@ -2370,6 +2376,7 @@ docs/postConversationsMessageParticipantReplace-example.txt
23702376
docs/postConversationsMessages-example.txt
23712377
docs/postConversationsMessagesAgentless-example.txt
23722378
docs/postConversationsMessagesInboundOpen-example.txt
2379+
docs/postConversationsMessagingIntegrationsApple-example.txt
23732380
docs/postConversationsMessagingIntegrationsFacebook-example.txt
23742381
docs/postConversationsMessagingIntegrationsInstagram-example.txt
23752382
docs/postConversationsMessagingIntegrationsOpen-example.txt
@@ -2860,6 +2867,7 @@ docs/postWorkforcemanagementAgentAdherenceExplanationsQuery-example.txt
28602867
docs/postWorkforcemanagementAgents-example.txt
28612868
docs/postWorkforcemanagementAgentsIntegrationsHrisQuery-example.txt
28622869
docs/postWorkforcemanagementAgentsMePossibleworkshifts-example.txt
2870+
docs/postWorkforcemanagementAgentschedulesManagementunitsMine-example.txt
28632871
docs/postWorkforcemanagementAgentschedulesMine-example.txt
28642872
docs/postWorkforcemanagementAlternativeshiftsOffersJobs-example.txt
28652873
docs/postWorkforcemanagementAlternativeshiftsOffersSearchJobs-example.txt

0 commit comments

Comments
 (0)