klaviyo-api-sdk 2.0.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07e9fa20d14acf94cfb9d6d8b18185225fe2dcc8a030a624ce506c25164dae3a
-  data.tar.gz: 963c7743c608b629204421195ee04a5d7f0a255d312c6235a15859ed5a6d6903
+  metadata.gz: 8b5bc8181fc22c16817d0730336a733882577e91570c3d5fcd00e57531c55471
+  data.tar.gz: 5f7fe9a218cf5fa8b30be69e476203bdefbf43a2588bd5ddd00558274219b4ca
 SHA512:
-  metadata.gz: fc3c75c12e23b8bd5c5312c5bbbd8b2e4ce9e95a0b3a5ec5f5e02a3085f517a1694eaab4e6476088c9eacca7f845162f82f1a73a6a9a12d61d6f855616b7356f
-  data.tar.gz: 8531e5a7221da3923dd2a6e7820f1eeb41eac2d9f1eb44b577cd216da8d26480d4ab7350bfdfc895285f473c74ba6108595e2645e1df02fbc6b466e7961a7829
+  metadata.gz: 310d0ec6a1f648db0eb36a7baeb2bb9e02c5f20a40d9719dbcc35bfc7e12c5b9ff9a7d51cd9e9608eefb2a50797f52e83725bb27596de2d3bf11eb871b5918f2
+  data.tar.gz: 72b1c19e929384e24f76cead051bbb700b4a46b46f5346eaa8486f36626e3e6bb42430859e4c47fad048bf687ac329ac55dd02fd8b6475b7d51c3122c0d5ec41

data/CHANGELOG.md

@@ -0,0 +1,91 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [4.0.0] - revision 2023-07-15
+### Added
+- Back-In-stock APIs
+  - We have added support for subscribing profiles to back-in-stock notifications, for both email and SMS, using the new [create_back_in_stock_subscription](./README.md#create-back-in-stock-subscription) endpoint.  
+- New functionality to Campaigns API
+  - CRUD support for SMS campaigns is now available
+  - You can now also retrieve all messages for a campaign to determine performance data on campaigns where you're running A/B tests
+    - To support this functionality, we introduced a relationship between [campaigns and campaign messages](./README.md#get-campaign-relationships-campaign-messages), and between [campaign messages and templates](./README.md#get-campaign-message-relationships-template)
+
+
+### Changed
+- Relationship Standardization
+  - We are making a number of changes across endpoints to standardize how we handle [relationships](https://developers.klaviyo.com/en/docs/relationships_) in our APIs and leverage consistently typed objects across endpoints. For example, you can create a profile in our APIs in the same shape, regardless of whether you're calling the profiles endpoint or the events endpoint.
+  - The changes include:
+    - Updating 1:1 relationships to use singular tense and an object (instead of plural and an array) 
+      - example: for [get_flow_action](./README.md#get-flow-action), if you want to use the `include` param, you would set `include=` to `"flow"` (instead of `"flows"`)
+    - Moving related object IDs from the attributes payload to relationships
+      - example: The format for the [body](https://developers.klaviyo.com/en/reference/create_tag) of [create_tag](./README.md#create-tag) has changed, with `tag_group_id` previously at `data.attributes.tag_group_id` being removed and replaced by a `data` object containing `type`+`id` and located at `data.relationships.tag-group.data`.
+    - Specifying a relationship between two Klaviyo objects to allow for improved consistency and greater interoperability across endpoints 
+      - example: for [create_event](./README.md#create-event), you can now create/update a profile for an event in the same way you would when using the profiles API directly
+  - NOTE: The examples for the above relationship changes are illustrative, not comprehensive. For a complete list of ALL the endpoints that have changed and exactly how, please refer to our latest [API Changelog](https://developers.klaviyo.com/en/docs/changelog_#revision-2023-07-15)
+- For [get_campaigns](./README.md#get-campaigns) endpoint, `filter` param is now required, to, at minimum, filter on `messages.channel`
+
+
+### Removed
+- We removed the `company_id` from the response for [get_template](./README.md#get-template) and [get_templates](./README.md#get-templates). If you need to obtain the company ID / public API key for an account, please use the [Accounts API](./README.md#accounts).- We removed the `company_id` from the response for [get_template](./README.md#get-template) and [get_templates](./README.md#get-templates). If you need to obtain the company ID / public API key for an account, please use the [Accounts API](./README.md#accounts).
+
+## [3.0.0] - revision 2023-06-15
+### Added
+- Accounts API is now available, this will allow you to access information about the Klaviyo account associated with your API key.
+  - `get_accounts`
+  - `get_account`
+  
+**Note:** You will need to generate a new API key with either the `Accounts` scope enabled or `Full Access` to use these endpoints.
+
+### Removed
+- All `client` endpoints
+  - `create_client_event`
+  - `create_client_profile`
+  - `create_client_subscription`
+## [2.0.0] - 2023-04-06
+### Added
+- Profiles API now returns predictive analytics when calling `get_profile` and `get_profiles` by passing in `additional_fields_profile: ["predictive_analytics"]`.
+
+### Changed
+- Relationship endpoints that were previously grouped together are now split into related-resource-specific endpoints.
+
+### Migration Guide
+- To migrate to this latest version, all calls to relationship endpoints need to be updated, as in the following example:
+  - `get_campaign_relationships(id, "tags")` will become `get_campaign_relationships_tags(id)`.
+## [1.2.0] - 2023-02-22
+### Added
+- Campagins (which were previously in our Beta API/SDKs)
+
+### Changes
+- Profiles
+    - Fix longitude value in ProfileLocation type mapping
+- Flows
+    - Pagination changed from page offset to cursor
+
+## [1.1.0] - 2022-01-24
+### Added
+- Added the following endpoints (which were previously in our Beta API/SDKs):
+    - Data Privacy
+    - All Tags endpoints, as well as the following related resource-specific endpoints:
+      - Get Flow Tags
+      - Get List Tags
+      - Get Segment Tags
+
+## [1.0.1] - 2022-12-06
+### Changes
+- Support for cursor pagination
+    - Passing the `next` value from a paginated result to the following call via the `page_cursor` query string argument will now result in the cursor being parsed and set appropriately by the `ApiClient`.
+
+## [1.0.0] - 2022-10-19
+### Added
+- Initial release
+
+### Changes
+- Naming changes:
+    - Package name: klaviyo_sdk -> klaviyo-api-sdk
+    - Module name: KlaviyoBeta -> KlaviyoAPI
+    - Some functions have changed name
+- New resources and endpoints: 
+    - See API Changelog for full details