Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Proliferating OpenAPI at Google

347 views

Published on

Presentation by Tim Burks and Sunny Gupta at the June 16, 2016 Meetup of the Open API Initiative hosted by Google. Tim and Sunny walked attendees through how Google is implementing the OpenAPI Specification.

Published in: Data & Analytics
  • Be the first to comment

Proliferating OpenAPI at Google

  1. 1. Proliferating OpenAPI Tim Burks, Sunny Gupta Google Inc.
  2. 2. Google Likes OpenAPI Standard representations are good! - They improve our internal processes. - They help us publish our APIs to outside consumers. - They help us support API publishers running on GCP. OpenAPI is the community’s choice for standardizing API representation.
  3. 3. 10 billion(~1000 trillion per day!)
  4. 4. Google Likes APIs - Thousands of internal APIs - Hundreds of public APIs - Vision - Pubsub - Translate - Prediction - We even have an API that describes our APIs!
  5. 5. How Google Builds APIs
  6. 6. Protocol Buffers
  7. 7. Service Configuration
  8. 8. Google API Service Configuration - Open sourced at github.com/googleapis/googleapis. - Described using protocol buffers. - Representable with JSON/YAML/binary formats.
  9. 9. Google’s OpenAPI Challenge Google wants to support API creators who use OpenAPI. - on many different platforms - with many different services (billing, quota, auth) So.. rewrite every API tool to read OpenAPI?
  10. 10. Swagger Codegen’s Challenge swagger-codegen is a monolithic tool generating at least: - 20 API clients and - a dozen server stubs But... - People want many more generators! - People want to write code generators in their favorite languages. - People want to tweak existing code generators.
  11. 11. Google API Compiler
  12. 12. Google API Compiler Client Code Generators Server Code Generators Endpoint Proxy Quota Management Access Configuration API Browser Verifies and normalizes API descriptions google.api.service .yaml.proto
  13. 13. Google API Compiler Client Code Generators Server Code Generators Endpoint Proxy Quota Management Access Configuration API Browser Open API Specification Verifies and normalizes API descriptions google.api.service .yaml.proto JSON Schema
  14. 14. What next? - Google API Compiler and google.api.service descriptions are open sourced. - We are working to close gaps between OpenAPI and google.api.service. - Google is actively integrating tools with OpenAPI using google.api.service. - We would welcome additions and new projects built on google.api.service. A world of easy-to-write API tools Google API CompilerOpen API Specification Google API Tools Verifies and normalizes API descriptions JSON Schema google.api.service ... ... ... ... ... ... timburks/service-generator

×