add sign_in response docstring

Author: treethought

flask_assistant/response.py

@@ -209,8 +209,11 @@ def build_item(
     }
 
     if img_url:
-            img_payload = {"imageUri": img_url, "accessibilityText": alt_text or "{} img".format(title)}
-            item["image"] = img_payload
+        img_payload = {
+            "imageUri": img_url,
+            "accessibilityText": alt_text or "{} img".format(title),
+        }
+        item["image"] = img_payload
 
     return item
 
@@ -355,17 +358,27 @@ def __init__(self, permissions, context=None, update_intent=None):
             },
         }
 
+
 class sign_in(_Response):
+    """Initiates the  authentication flow for Account Linking
 
-    def __init__(self, context=None):
-        super(sign_in, self).__init__(speech=None)
+    After the user authorizes the action to access their profile, a Google ID token
+    will be received and validated by the flask-assistant and expose user profile information
+    with the `user.profile` local
+
+    In order to complete the sign in process, you will need to create an intent with
+    the `actions_intent_SIGN)IN` event
+    """
 
+    def __init__(self, reason=None):
+        super(sign_in, self).__init__(speech=None)
 
         self._messages[:] = []
         self._response["payload"]["google"]["systemIntent"] = {
             "intent": "actions.intent.SIGN_IN",
             "data": {
-                "optContext": context,
+                "optContext": reason,
                 "@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
-            }
+            },
         }
+

samples/account_linking/webhook.py

@@ -0,0 +1,32 @@
+from flask import Flask
+from flask_assistant import Assistant, ask, profile, sign_in
+
+
+app = Flask(__name__)
+
+app.config['INTEGRATIONS'] = ['ACTIONS_ON_GOOGLE']
+app.config['AOG_CLIENT_ID'] =  "CLIENT_ID OBTAINED BY SETTING UP ACCOUNT LINKING IN AOG CONSOLE"
+
+
+assist = Assistant(app=app, route="/", project_id="YOUR_GCP_PROJECT_ID")
+
+@assist.action("Default Welcome Intent")
+def welcome():
+    if profile:
+        return ask(f"Welcome back {profile['name']}")
+
+    return sign_in("To learn more about you")
+
+# this intent must have the actions_intent_SIGN_IN event
+# and will be invoked once the user has 
+@assist.action("Complete-Sign-In")
+def complete_sign_in():
+    if profile:
+        return ask(f"Welcome aboard {profile['name']}, thanks for signing up!")
+    else:
+        return ask("Hope you sign up soon! Would love to get to know you!")
+
+
+if __name__ == "__main__":
+    app.run(debug=True)
+