Release 1.25.0. For changelog, check CHANGELOG.rst

ask-sdk-model/CHANGELOG.rst

@@ -324,3 +324,11 @@ This release contains the following changes :
 This release contains the following changes :
 
 - general bug fixes and updates
+
+
+1.25.0
+~~~~~~
+
+This release contains the following changes :
+
+- Introducing `person-level permissions <https://developer.amazon.com/en-US/docs/alexa/smapi/skill-events-in-alexa-skills.html#skill-permission-changed-event>`__ for Skill events.

ask-sdk-model/ask_sdk_model/__version__.py

@@ -14,7 +14,7 @@
 __pip_package_name__ = 'ask-sdk-model'
 __description__ = 'The ASK SDK Model package provides model definitions, for building Alexa Skills.'
 __url__ = 'https://github.com/alexa/alexa-apis-for-python'
-__version__ = '1.24.0'
+__version__ = '1.25.0'
 __author__ = 'Alexa Skills Kit'
 __author_email__ = 'ask-sdk-dynamic@amazon.com'
 __license__ = 'Apache 2.0'

ask-sdk-model/ask_sdk_model/events/skillevents/permission.py

@@ -28,7 +28,7 @@
 class Permission(object):
     """
 
-    :param scope: 
+    :param scope: The value representing the permission scope. 
     :type scope: (optional) str
 
     """
@@ -45,7 +45,7 @@ def __init__(self, scope=None):
         # type: (Optional[str]) -> None
         """
 
-        :param scope: 
+        :param scope: The value representing the permission scope. 
         :type scope: (optional) str
         """
         self.__discriminator_value = None  # type: str

ask-sdk-model/ask_sdk_model/events/skillevents/permission_body.py

@@ -29,29 +29,36 @@
 class PermissionBody(object):
     """
 
-    :param accepted_permissions: 
+    :param accepted_permissions: The current list of permissions consented to on the account level. It can be an empty list if there are no account level permissions consented to. 
     :type accepted_permissions: (optional) list[ask_sdk_model.events.skillevents.permission.Permission]
+    :param accepted_person_permissions: The current list of permissions consented to on the person level. This is only present if the request contains the ```person``` object. It can be an empty list if there are no person level permissions consented to. 
+    :type accepted_person_permissions: (optional) list[ask_sdk_model.events.skillevents.permission.Permission]
 
     """
     deserialized_types = {
-        'accepted_permissions': 'list[ask_sdk_model.events.skillevents.permission.Permission]'
+        'accepted_permissions': 'list[ask_sdk_model.events.skillevents.permission.Permission]',
+        'accepted_person_permissions': 'list[ask_sdk_model.events.skillevents.permission.Permission]'
     }  # type: Dict
 
     attribute_map = {
-        'accepted_permissions': 'acceptedPermissions'
+        'accepted_permissions': 'acceptedPermissions',
+        'accepted_person_permissions': 'acceptedPersonPermissions'
     }  # type: Dict
     supports_multiple_types = False
 
-    def __init__(self, accepted_permissions=None):
-        # type: (Optional[List[Permission]]) -> None
+    def __init__(self, accepted_permissions=None, accepted_person_permissions=None):
+        # type: (Optional[List[Permission]], Optional[List[Permission]]) -> None
         """
 
-        :param accepted_permissions: 
+        :param accepted_permissions: The current list of permissions consented to on the account level. It can be an empty list if there are no account level permissions consented to. 
         :type accepted_permissions: (optional) list[ask_sdk_model.events.skillevents.permission.Permission]
+        :param accepted_person_permissions: The current list of permissions consented to on the person level. This is only present if the request contains the ```person``` object. It can be an empty list if there are no person level permissions consented to. 
+        :type accepted_person_permissions: (optional) list[ask_sdk_model.events.skillevents.permission.Permission]
         """
         self.__discriminator_value = None  # type: str
 
         self.accepted_permissions = accepted_permissions
+        self.accepted_person_permissions = accepted_person_permissions
 
     def to_dict(self):
         # type: () -> Dict[str, object]

ask-sdk-model/ask_sdk_model/events/skillevents/proactive_subscription_changed_request.py

@@ -29,7 +29,7 @@
 
 class ProactiveSubscriptionChangedRequest(Request):
     """
-    This event indicates a customer subscription to receive events from your skill and contains information for that user. You need this information to know the userId in order to send events to individual users. Note that these events can arrive out of order, so ensure that your skill service uses the timestamp in the event to correctly record the latest subscription state for a customer. 
+    This event indicates a customer subscription to receive events from your skill and contains information for that user and person, if recognized. You need this information to know the userId and personId in order to send events to individual users. Note that these events can arrive out of order, so ensure that your skill service uses the timestamp in the event to correctly record the latest subscription state for a customer. 
 
 
     :param request_id: Represents the unique identifier for the specific request.
@@ -61,7 +61,7 @@ class ProactiveSubscriptionChangedRequest(Request):
 
     def __init__(self, request_id=None, timestamp=None, locale=None, body=None):
         # type: (Optional[str], Optional[datetime], Optional[str], Optional[ProactiveSubscriptionChangedBody]) -> None
-        """This event indicates a customer subscription to receive events from your skill and contains information for that user. You need this information to know the userId in order to send events to individual users. Note that these events can arrive out of order, so ensure that your skill service uses the timestamp in the event to correctly record the latest subscription state for a customer. 
+        """This event indicates a customer subscription to receive events from your skill and contains information for that user and person, if recognized. You need this information to know the userId and personId in order to send events to individual users. Note that these events can arrive out of order, so ensure that your skill service uses the timestamp in the event to correctly record the latest subscription state for a customer. 
 
         :param request_id: Represents the unique identifier for the specific request.
         :type request_id: (optional) str

ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/handle_message_directive.py

@@ -29,7 +29,7 @@
 
 class HandleMessageDirective(Directive):
     """
-    The HandleMessage directive sends a message to a skill's web application that runs on the device browser. To use this directive, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+    The HandleMessage directive sends a message to a skill's web application that runs on the device browser. 
 
 
     :param message: A free-form object containing data to deliver to a skill's HTML application running the device. Maximum size 18 KB.
@@ -53,7 +53,7 @@ class HandleMessageDirective(Directive):
 
     def __init__(self, message=None, transformers=None):
         # type: (Optional[object], Optional[List[Transformer]]) -> None
-        """The HandleMessage directive sends a message to a skill's web application that runs on the device browser. To use this directive, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+        """The HandleMessage directive sends a message to a skill's web application that runs on the device browser. 
 
         :param message: A free-form object containing data to deliver to a skill's HTML application running the device. Maximum size 18 KB.
         :type message: (optional) object

ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/message_request.py

@@ -28,7 +28,7 @@
 
 class MessageRequest(Request):
     """
-    The Message request sends a message to the skill lambda. To use this request, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+    The Message request sends a message to the skill lambda. 
 
 
     :param request_id: Represents the unique identifier for the specific request.
@@ -60,7 +60,7 @@ class MessageRequest(Request):
 
     def __init__(self, request_id=None, timestamp=None, locale=None, message=None):
         # type: (Optional[str], Optional[datetime], Optional[str], Optional[object]) -> None
-        """The Message request sends a message to the skill lambda. To use this request, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+        """The Message request sends a message to the skill lambda. 
 
         :param request_id: Represents the unique identifier for the specific request.
         :type request_id: (optional) str

ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/runtime_error_request.py

@@ -29,7 +29,7 @@
 
 class RuntimeErrorRequest(Request):
     """
-    The RuntimeError request occurs when the device software encounters an error with loading a skill's web application. To use this request, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+    The RuntimeError request occurs when the device software encounters an error with loading a skill's web application. 
 
 
     :param request_id: Represents the unique identifier for the specific request.
@@ -61,7 +61,7 @@ class RuntimeErrorRequest(Request):
 
     def __init__(self, request_id=None, timestamp=None, locale=None, error=None):
         # type: (Optional[str], Optional[datetime], Optional[str], Optional[RuntimeError]) -> None
-        """The RuntimeError request occurs when the device software encounters an error with loading a skill's web application. To use this request, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+        """The RuntimeError request occurs when the device software encounters an error with loading a skill's web application. 
 
         :param request_id: Represents the unique identifier for the specific request.
         :type request_id: (optional) str

ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/start_directive.py

@@ -31,7 +31,7 @@
 
 class StartDirective(Directive):
     """
-    The Start directive provides the data necessary to load an HTML page on the target device. To use this directive, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+    The Start directive provides the data necessary to load an HTML page on the target device. 
 
 
     :param data: Optional startup data which will be made available to the runtime for skill startup. Maximum size: 18 KB
@@ -63,7 +63,7 @@ class StartDirective(Directive):
 
     def __init__(self, data=None, transformers=None, request=None, configuration=None):
         # type: (Optional[object], Optional[List[Transformer]], Optional[StartRequest], Optional[Configuration]) -> None
-        """The Start directive provides the data necessary to load an HTML page on the target device. To use this directive, [apply to participate](https://build.amazonalexadev.com/AlexaWebAPIforGamesDeveloperPreview_AlexaWebAPIforGames.html) in the Alexa Web API for Games developer preview. 
+        """The Start directive provides the data necessary to load an HTML page on the target device. 
 
         :param data: Optional startup data which will be made available to the runtime for skill startup. Maximum size: 18 KB
         :type data: (optional) object