@@ -17,6 +17,38 @@ under heavy development and not intended for public consumption, caveat emptor!
17<img alt="Гоголь-моголь" height="261px;" src="https://upload.wikimedia.org/wikipedia/commons/c/c7/Kogel_mogel.JPG">
17<img alt="Гоголь-моголь" height="261px;" src="https://upload.wikimedia.org/wikipedia/commons/c/c7/Kogel_mogel.JPG">
18<img alt="Мико́ла Васи́льович Го́голь" height="261px" src="https://upload.wikimedia.org/wikipedia/commons/3/31/NV_Gogol.png">
18<img alt="Мико́ла Васи́льович Го́голь" height="261px" src="https://upload.wikimedia.org/wikipedia/commons/3/31/NV_Gogol.png">
20+## Generate New API Endpoints
22+To generate new API endpoints, use the gogol/gen directory.
23+The key files in this directory (outside of the actual gogol-gen source!) are the annex files.
25+To add a new endpoint, first create its annex file in the annex directory. It should be named after the API endpoint as found in the <a href="https://www.github.com/google/google-api-go-client">google/google-api-go-client repo.</a>
29+#### Want to generate the Cloud Dataproc API endpoint
31+The Cloud Dataproc API is called dataproc-api.json in the google repo. Create the file gogol/gen/annex/dataproc.json with these contents:
35+ "library": "dataproc",
36+ "canonicalName": "Dataproc"
40+From the gogol/gen directory, run:
47+This will build the gogol-gen executable, and then will generate all the API endpoints that have annex files.
49+Once completed, there would then be a gogol-dataproc directory with its corresponding generated API client in the top-level directory of the repo.
51+Note: rather than `make clean`, one could run `make full-clean` which removes all of the API references and causes redownload of the google-api-go-client repo.
21## Contribute
53## Contribute