Release 1.18.0. For changelog, check CHANGELOG.rst

Author: ask-pyth

ask-sdk-model/CHANGELOG.rst

@@ -232,3 +232,11 @@ This release has the following changes :
 This release contains the following changes : 
 
 - APIs for `ISP support in kid skills <https://developer.amazon.com/docs/in-skill-purchase/isp-kid-skills.html>`__.
+
+
+1.18.0
+~~~~~~~
+
+This release contains the following changes: 
+
+- support for `personalization <https://developer.amazon.com/docs/custom-skills/add-personalization-to-your-skill.html#invocation-request-examples>`__ in the skill.

ask-sdk-model/ask_sdk_model/__init__.py

@@ -40,6 +40,7 @@
 from .request import Request
 from .session_ended_request import SessionEndedRequest
 from .context import Context
+from .person import Person
 from .cause import Cause
 from .request_envelope import RequestEnvelope
 from .session_ended_error_type import SessionEndedErrorType

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.17.0'
+__version__ = '1.18.0'
 __author__ = 'Alexa Skills Kit'
 __author_email__ = 'ask-sdk-dynamic@amazon.com'
 __license__ = 'Apache 2.0'

ask-sdk-model/ask_sdk_model/interfaces/system/system_state.py

@@ -24,6 +24,7 @@
     from typing import Dict, List, Optional, Union
     from datetime import datetime
     from ask_sdk_model.device import Device
+    from ask_sdk_model.person import Person
     from ask_sdk_model.application import Application
     from ask_sdk_model.user import User
 
@@ -37,6 +38,8 @@ class SystemState(object):
     :type user: (optional) ask_sdk_model.user.User
     :param device: 
     :type device: (optional) ask_sdk_model.device.Device
+    :param person: 
+    :type person: (optional) ask_sdk_model.person.Person
     :param api_endpoint: A string that references the correct base URI to refer to by region, for use with APIs such as the Device Location API and Progressive Response API.
     :type api_endpoint: (optional) str
     :param api_access_token: A bearer token string that can be used by the skill (during the skill session) to access Alexa APIs resources of the registered Alexa customer and/or person who is making the request. This token encapsulates the permissions authorized under the registered Alexa account and device, and (optionally) the recognized person. Some resources, such as name or email, require explicit customer consent.\" 
@@ -47,6 +50,7 @@ class SystemState(object):
         'application': 'ask_sdk_model.application.Application',
         'user': 'ask_sdk_model.user.User',
         'device': 'ask_sdk_model.device.Device',
+        'person': 'ask_sdk_model.person.Person',
         'api_endpoint': 'str',
         'api_access_token': 'str'
     }  # type: Dict
@@ -55,12 +59,13 @@ class SystemState(object):
         'application': 'application',
         'user': 'user',
         'device': 'device',
+        'person': 'person',
         'api_endpoint': 'apiEndpoint',
         'api_access_token': 'apiAccessToken'
     }  # type: Dict
 
-    def __init__(self, application=None, user=None, device=None, api_endpoint=None, api_access_token=None):
-        # type: (Optional[Application], Optional[User], Optional[Device], Optional[str], Optional[str]) -> None
+    def __init__(self, application=None, user=None, device=None, person=None, api_endpoint=None, api_access_token=None):
+        # type: (Optional[Application], Optional[User], Optional[Device], Optional[Person], Optional[str], Optional[str]) -> None
         """
 
         :param application: 
@@ -69,6 +74,8 @@ def __init__(self, application=None, user=None, device=None, api_endpoint=None,
         :type user: (optional) ask_sdk_model.user.User
         :param device: 
         :type device: (optional) ask_sdk_model.device.Device
+        :param person: 
+        :type person: (optional) ask_sdk_model.person.Person
         :param api_endpoint: A string that references the correct base URI to refer to by region, for use with APIs such as the Device Location API and Progressive Response API.
         :type api_endpoint: (optional) str
         :param api_access_token: A bearer token string that can be used by the skill (during the skill session) to access Alexa APIs resources of the registered Alexa customer and/or person who is making the request. This token encapsulates the permissions authorized under the registered Alexa account and device, and (optionally) the recognized person. Some resources, such as name or email, require explicit customer consent.\" 
@@ -79,6 +86,7 @@ def __init__(self, application=None, user=None, device=None, api_endpoint=None,
         self.application = application
         self.user = user
         self.device = device
+        self.person = person
         self.api_endpoint = api_endpoint
         self.api_access_token = api_access_token
 

ask-sdk-model/ask_sdk_model/person.py

@@ -0,0 +1,114 @@
+# coding: utf-8
+
+#
+# Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file
+# except in compliance with the License. A copy of the License is located at
+#
+# http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for
+# the specific language governing permissions and limitations under the License.
+#
+
+import pprint
+import re  # noqa: F401
+import six
+import typing
+from enum import Enum
+
+
+if typing.TYPE_CHECKING:
+    from typing import Dict, List, Optional, Union
+    from datetime import datetime
+
+
+class Person(object):
+    """
+    An object that describes the user (person) who is making the request.
+
+
+    :param person_id: A string that represents a unique identifier for the person who is making the request. The length of this identifier can vary, but is never more than 255 characters. It is generated when a recognized user makes a request to your skill.
+    :type person_id: (optional) str
+    :param access_token: A token identifying the user in another system. This is only provided if the recognized user has successfully linked their skill account with their Alexa profile. The accessToken field will not appear if null.
+    :type access_token: (optional) str
+
+    """
+    deserialized_types = {
+        'person_id': 'str',
+        'access_token': 'str'
+    }  # type: Dict
+
+    attribute_map = {
+        'person_id': 'personId',
+        'access_token': 'accessToken'
+    }  # type: Dict
+
+    def __init__(self, person_id=None, access_token=None):
+        # type: (Optional[str], Optional[str]) -> None
+        """An object that describes the user (person) who is making the request.
+
+        :param person_id: A string that represents a unique identifier for the person who is making the request. The length of this identifier can vary, but is never more than 255 characters. It is generated when a recognized user makes a request to your skill.
+        :type person_id: (optional) str
+        :param access_token: A token identifying the user in another system. This is only provided if the recognized user has successfully linked their skill account with their Alexa profile. The accessToken field will not appear if null.
+        :type access_token: (optional) str
+        """
+        self.__discriminator_value = None  # type: str
+
+        self.person_id = person_id
+        self.access_token = access_token
+
+    def to_dict(self):
+        # type: () -> Dict[str, object]
+        """Returns the model properties as a dict"""
+        result = {}  # type: Dict
+
+        for attr, _ in six.iteritems(self.deserialized_types):
+            value = getattr(self, attr)
+            if isinstance(value, list):
+                result[attr] = list(map(
+                    lambda x: x.to_dict() if hasattr(x, "to_dict") else
+                    x.value if isinstance(x, Enum) else x,
+                    value
+                ))
+            elif isinstance(value, Enum):
+                result[attr] = value.value
+            elif hasattr(value, "to_dict"):
+                result[attr] = value.to_dict()
+            elif isinstance(value, dict):
+                result[attr] = dict(map(
+                    lambda item: (item[0], item[1].to_dict())
+                    if hasattr(item[1], "to_dict") else
+                    (item[0], item[1].value)
+                    if isinstance(item[1], Enum) else item,
+                    value.items()
+                ))
+            else:
+                result[attr] = value
+
+        return result
+
+    def to_str(self):
+        # type: () -> str
+        """Returns the string representation of the model"""
+        return pprint.pformat(self.to_dict())
+
+    def __repr__(self):
+        # type: () -> str
+        """For `print` and `pprint`"""
+        return self.to_str()
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        """Returns true if both objects are equal"""
+        if not isinstance(other, Person):
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        """Returns true if both objects are not equal"""
+        return not self == other

ask-sdk-model/ask_sdk_model/services/authentication_configuration.py

@@ -24,16 +24,21 @@ class AuthenticationConfiguration(object):
     :type client_id: str
     :param client_secret: Client Secret required for authentication.
     :type client_secret: str
+    :param refresh_token: Client refresh_token required to get access token for API calls.
+    :type refresh_token: str
     """
 
-    def __init__(self, client_id=None, client_secret=None):
+    def __init__(self, client_id=None, client_secret=None, refresh_token=None):
         # type: (str, str) -> None
         """Represents a class that provides authentication configuration.
 
         :param client_id: Client ID required for authentication.
         :type client_id: str
         :param client_secret: Client Secret required for authentication.
         :type client_secret: str
+        :param refresh_token: Client refresh_token required to get access token for API calls.
+        :type refresh_token: str
         """
         self.client_id = client_id
         self.client_secret = client_secret
+        self.refresh_token = refresh_token

ask-sdk-model/ask_sdk_model/services/lwa/access_token_request.py

@@ -20,7 +20,6 @@
 import typing
 from enum import Enum
 
-
 if typing.TYPE_CHECKING:
     from typing import Dict, Optional
 
@@ -35,21 +34,25 @@ class AccessTokenRequest(object):
     :param scope: The required scope for which the access token is
         requested for
     :type scope: str
+    :param refresh_token: Client refresh_token required to get access token for API calls.
+    :type refresh_token: str
     """
     deserialized_types = {
         'client_id': 'str',
         'client_secret': 'str',
+        'refresh_token': 'str',
         'scope': 'str'
     }
 
     attribute_map = {
         'client_id': 'client_id',
         'client_secret': 'client_secret',
+        'refresh_token': 'refresh_token',
         'scope': 'scope'
     }
 
-    def __init__(self, client_id=None, client_secret=None, scope=None):
-        # type: (Optional[str], Optional[str], Optional[str]) -> None
+    def __init__(self, client_id=None, client_secret=None, scope=None, refresh_token=None):
+        # type: (Optional[str], Optional[str], Optional[str], Optional[str]) -> None
         """Request for retrieving an access token from LWA.
 
         :param client_id: The ClientId value from developer console
@@ -59,12 +62,15 @@ def __init__(self, client_id=None, client_secret=None, scope=None):
         :param scope: The required scope for which the access token is
             requested for
         :type scope: str
+        :param refresh_token: Client refresh_token required to get access token for API calls.
+        :type refresh_token: str
         """
         self.__discriminator_value = None
 
         self.client_id = client_id
         self.client_secret = client_secret
         self.scope = scope
+        self.refresh_token = refresh_token
 
     def to_dict(self):
         # type: () -> Dict