From abb8d3dce18a5510c48b215406ed36c024f01495 Mon Sep 17 00:00:00 2001 From: ask-pyth Date: Mon, 31 Aug 2020 21:15:00 +0000 Subject: [PATCH] Release 1.25.0. For changelog, check CHANGELOG.rst --- ask-sdk-model/CHANGELOG.rst | 8 ++++++++ ask-sdk-model/ask_sdk_model/__version__.py | 2 +- .../events/skillevents/permission.py | 4 ++-- .../events/skillevents/permission_body.py | 19 +++++++++++++------ .../proactive_subscription_changed_request.py | 4 ++-- .../html/handle_message_directive.py | 4 ++-- .../presentation/html/message_request.py | 4 ++-- .../html/runtime_error_request.py | 4 ++-- .../presentation/html/start_directive.py | 4 ++-- 9 files changed, 34 insertions(+), 19 deletions(-) diff --git a/ask-sdk-model/CHANGELOG.rst b/ask-sdk-model/CHANGELOG.rst index a5ea189..95a024a 100644 --- a/ask-sdk-model/CHANGELOG.rst +++ b/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 `__ for Skill events. diff --git a/ask-sdk-model/ask_sdk_model/__version__.py b/ask-sdk-model/ask_sdk_model/__version__.py index 790f10b..01b12ab 100644 --- a/ask-sdk-model/ask_sdk_model/__version__.py +++ b/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' diff --git a/ask-sdk-model/ask_sdk_model/events/skillevents/permission.py b/ask-sdk-model/ask_sdk_model/events/skillevents/permission.py index b51addd..79d0d55 100644 --- a/ask-sdk-model/ask_sdk_model/events/skillevents/permission.py +++ b/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 diff --git a/ask-sdk-model/ask_sdk_model/events/skillevents/permission_body.py b/ask-sdk-model/ask_sdk_model/events/skillevents/permission_body.py index d2f77c9..706f0cc 100644 --- a/ask-sdk-model/ask_sdk_model/events/skillevents/permission_body.py +++ b/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] diff --git a/ask-sdk-model/ask_sdk_model/events/skillevents/proactive_subscription_changed_request.py b/ask-sdk-model/ask_sdk_model/events/skillevents/proactive_subscription_changed_request.py index 0ce2433..86ba300 100644 --- a/ask-sdk-model/ask_sdk_model/events/skillevents/proactive_subscription_changed_request.py +++ b/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 diff --git a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/handle_message_directive.py b/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/handle_message_directive.py index e4f8284..263d2e7 100644 --- a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/handle_message_directive.py +++ b/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 diff --git a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/message_request.py b/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/message_request.py index 0a4fa8d..b28fe8e 100644 --- a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/message_request.py +++ b/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 diff --git a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/runtime_error_request.py b/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/runtime_error_request.py index 58156a1..a3d1bb4 100644 --- a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/runtime_error_request.py +++ b/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 diff --git a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/start_directive.py b/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/start_directive.py index a221929..2cc8afc 100644 --- a/ask-sdk-model/ask_sdk_model/interfaces/alexa/presentation/html/start_directive.py +++ b/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