title: .api file with Google Cloud Endpoints - how do I customise
body: <p>I'm a little confused about the .api file which gets created when using Google Cloud endpoints.  This seems to list all methods and parameters.  It gets auto generated using the Google Plugin for Eclipse or when running endpoints.sh.  The .api file seems to be needed, otherwise a 404 is returned when accessing the API.</p>
  
  <p>If I generate the endpoint class from an @Entity class it creates the .api file AND the Endpoint.java file.  My question is if I want to create a custom Endpoint.java file e.g. different parameters, then how do I do this ?  Am I supposed to update my code then manually modify the .api file, or is there a way to generate just the .api file.</p>
  
  <p>Or is Google App Engine saying you can generate the Endpoint with its basic methods and that's all that is possible...?  I would have thought that the .api file should be generated based on registered endpoints in web.xml at deployment time or better still just scan for @Api annotations at deployment time and build the necessary config then.</p>
  
  <p>Also if you're not using the plugin in Eclipse (e.g. you're using Maven) some further manual steps are required e.g. updating web.xml.  This is documented in the "Generating Client Libraries" section of the App Engine website - but this is surely doing more than generating a client library, it's creating the necessary deployment config server side too.  I found this confusing.</p>