Flesh out Endpoints quickstart into a tutorial app (#651)

Author: bradfriedman

appengine/standard/endpoints-frameworks-v2/echo/app.yaml

@@ -1,6 +1,8 @@
 runtime: python27
 threadsafe: true
 api_version: 1
+basic_scaling:
+  max_instances: 2
 
 #[START_EXCLUDE]
 skip_files:

appengine/standard/endpoints-frameworks-v2/echo/main.py

@@ -24,32 +24,67 @@
 
 
 # [START messages]
-class Echo(messages.Message):
+class EchoRequest(messages.Message):
+    content = messages.StringField(1)
+
+
+class EchoResponse(messages.Message):
     """A proto Message that contains a simple string field."""
     content = messages.StringField(1)
 # [END messages]
 
 
+ECHO_RESOURCE = endpoints.ResourceContainer(
+    EchoRequest,
+    n=messages.IntegerField(2, default=1))
+
+
 # [START echo_api]
 @endpoints.api(name='echo', version='v1')
 class EchoApi(remote.Service):
 
     @endpoints.method(
-        # This method takes an Echo message.
-        Echo,
+        # This method takes a ResourceContainer defined above.
+        ECHO_RESOURCE,
         # This method returns an Echo message.
-        Echo,
+        EchoResponse,
         path='echo',
         http_method='POST',
         name='echo')
     def echo(self, request):
-        return Echo(content=request.content)
+        output_content = ' '.join([request.content] * request.n)
+        return EchoResponse(content=output_content)
+
+    @endpoints.method(
+        # This method takes a ResourceContainer defined above.
+        ECHO_RESOURCE,
+        # This method returns an Echo message.
+        EchoResponse,
+        path='echo/{n}',
+        http_method='POST',
+        name='echo_path_parameter')
+    def echo_path_parameter(self, request):
+        output_content = ' '.join([request.content] * request.n)
+        return EchoResponse(content=output_content)
+
+    @endpoints.method(
+        # This method takes a ResourceContainer defined above.
+        ECHO_RESOURCE,
+        # This method returns an Echo message.
+        EchoResponse,
+        path='echo',
+        http_method='POST',
+        name='echo_api_key',
+        api_key_required=True)
+    def echo_api_key(self, request):
+        output_content = ' '.join([request.content] * request.n)
+        return EchoResponse(content=output_content)
 
     @endpoints.method(
         # This method takes an empty request body.
         message_types.VoidMessage,
         # This method returns an Echo message.
-        Echo,
+        EchoResponse,
         path='echo/getUserEmail',
         http_method='GET',
         # Require auth tokens to have the following scopes to access this API.
@@ -62,7 +97,7 @@ def get_user_email(self, request):
         # raise 401 Unauthorized.
         if not user:
             raise endpoints.UnauthorizedException
-        return Echo(content=user.email())
+        return EchoResponse(content=user.email())
 # [END echo_api]