O Cloud Endpoints é um sistema de gerenciamento de API que ajuda a proteger, monitorar, analisar e definir cotas em APIs usando a mesma infraestrutura do Google para suas próprias APIs. Os recursos de gerenciamento de API incluem autenticação, chaves de API, monitoramento, registro e rastreamento, independentemente da tecnologia usada para sua implementação. A funcionalidade desse gerenciamento é fornecida pelo ESP ou pelo Endpoints Frameworks.
Extensible Service Proxy
No Endpoints para OpenAPI e gRPC, as solicitações de API são retransmitidas
pelo Extensible Service Proxy, que valida chaves e tokens de autenticação e
envia sinais (métricas e registros) usando a
API
Service Control. A separação fornecida pelo ESP significa que você pode escrever o
código de back-end REST ou gRPC em qualquer linguagem e usar o gRPC ou qualquer framework
que ofereça suporte à descrição da API usando a OpenAPI.
APIs que usam o OpenAPI: o back-end da API pode ser executado no ambiente flexível do App Engine, no Google Kubernetes Engine (GKE), no Compute Engine, no Kubernetes ou nas implantações locais.
APIs que usam o gRPC: o back-end da API pode ser executado no GKE, no Compute Engine, no Kubernetes ou em implantações locais.
Uma solicitação é enviada no caminho a seguir:
A solicitação para seu código será recebida e enviada ao ESP.
O ESP enviará a solicitação de verificação ao Service Control.
Se tiver configurado a API para exigir uma autenticação ou chave da API, o Service Control verificará se a solicitação é permitida e enviará uma resposta de volta ao ESP.
Se a solicitação não for permitida, o ESP rejeitará a solicitação. Se a solicitação for permitida, ela será encaminhada para seu código de back-end. De qualquer forma, o ESP registrará informações sobre a solicitação.
Para back-ends de API em execução no ambiente padrão do App Engine, o Endpoints Frameworks pode ajudar os desenvolvedores a começar a exibição de uma API rapidamente. O Endpoints Frameworks é um
framework da Web, além de uma alternativa ao Python Flask ou Java Jersey.
O Endpoints Frameworks se integra à API Service Control, ou seja, um back-end que usa o Endpoints Frameworks não precisa ser executado por trás do Extensible Service Proxy.
Ao ativar o Gerenciamento de API, uma solicitação será enviada no caminho a seguir:
A solicitação para seu código será recebida e enviada ao módulo do Endpoints Management no Endpoints Frameworks.
O módulo Endpoints Management enviará uma solicitação de verificação para o Service Control.
Se tiver configurado a API para exigir uma autenticação ou chave da API, o Service Control verificará se a solicitação é permitida e enviará uma resposta de volta ao módulo Endpoints Management.
Se a solicitação não for permitida, o módulo de gerenciamento do Endpoints rejeitará a solicitação. Se a solicitação for permitida, ela será encaminhada para o Endpoints Frameworks. De qualquer forma, o Endpoints Management registrará informações sobre a solicitação.
O Endpoints Frameworks roteará o pedido para o código de back-end.
É possível usar o Endpoints Frameworks com ou sem a funcionalidade de gerenciamento da API. O uso sem esse recurso é gratuito. A funcionalidade de gerenciamento da API é cobrada de acordo com a página de preços do Endpoints.
O Endpoints Frameworks é compatível somente com serviços em execução no ambiente padrão do App Engine. No Compute Engine, no GKE, no ambiente flexível do App Engine ou em outros ambientes, os serviços são executados por trás do ESP.
Se o serviço estiver sendo executado por trás do ESP, será possível escrever o código de back-end em qualquer linguagem e framework, como o Python Flask, o Java Jersey ou o Node.js Express. Nesses ambientes, não será necessário usar o Endpoints Frameworks para o gerenciamento da API.
A seguir
Para informações sobre como adicionar gerenciamento de API:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eCloud Endpoints provides API management features like authentication, monitoring, and logging, either through the Extensible Service Proxy (ESP) or Endpoints Frameworks.\u003c/p\u003e\n"],["\u003cp\u003eThe Extensible Service Proxy (ESP) handles API requests for OpenAPI and gRPC, allowing backend code to be written in any language and deployed across various environments like GKE, Compute Engine, and on-premises.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints Frameworks is specifically designed for API backends running on the App Engine standard environment, offering a web framework alternative to Flask or Jersey, and integrating directly with the Service Control API.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints Frameworks is the only way to obtain API management features on the App Engine standard environment, and it supports only Python 2.7 and Java 8 runtime environments.\u003c/p\u003e\n"],["\u003cp\u003eAPI management functionality through either ESP or Endpoints Frameworks is charged based on the number of calls per month, while using Endpoints Frameworks without API management is offered at no charge.\u003c/p\u003e\n"]]],[],null,["# Comparing Extensible Service Proxy and Cloud Endpoints Frameworks\n\nThis page explains the differences between Endpoints Frameworks for\nthe App Engine standard environment and the\n[Extensible Service Proxy (ESP)](/endpoints/docs/frameworks/glossary#extensible_service_proxy),\nwhich is used in Cloud Endpoints for APIs using\n[OpenAPI](/endpoints/docs/openapi)\nor\n[gRPC](/endpoints/docs/grpc/about-grpc).\nFor more information about the Endpoints options, see\n[Choosing an Endpoints option](/endpoints/docs/choose-endpoints-option).\n\nOverview\n--------\n\nCloud Endpoints is an API management system that helps you secure, monitor,\nanalyze, and set quotas on your APIs using the same infrastructure Google uses\nfor its own APIs. API management features includes authentication, API keys,\nmonitoring, logging, and tracing independent of the technology used to implement\nthe API. API management functionality is provided through ESP or\nby using the Endpoints Frameworks.\n\nExtensible Service Proxy\n------------------------\n\nIn Endpoints for OpenAPI and gRPC, API requests are relayed\nthrough the Extensible Service Proxy, which validates keys and authentication tokens and\nsends signals (metrics and logs) by using the\n[Service Control](/service-control/overview)\nAPI. The separation provided by ESP means that you can write the\nREST or gRPC backend code in any language, and you can use gRPC or any framework\nthat supports API description using OpenAPI.\n\n- APIs using OpenAPI: The API backend can run on the App Engine flexible\n environment, Google Kubernetes Engine (GKE), Compute Engine, Kubernetes, or\n on-premises deployments.\n\n- APIs using gRPC: The API backend can run on GKE,\n Compute Engine, Kubernetes, or on-premises deployments.\n\nA request is sent on the following path:\n\n1. A request to your code is received and is sent to ESP.\n2. ESP sends a check request to Service Control.\n3. If you configured your API to require an API key or authentication, Service Control checks to see if the request is permitted and sends a response back to ESP.\n4. If the request isn't permitted, ESP rejects the request. If the request is permitted, it is forwarded to your backend code. Either way, ESP logs information about the request.\n\n[Pricing of Endpoints API management](/endpoints/pricing)\ndepends on the number of calls per month.\n\nEndpoints Frameworks\n--------------------\n\nFor API backends running on the App Engine standard environment,\nEndpoints Frameworks is available to help developers quickly get\nstarted serving an API. Endpoints Frameworks is a\n[web framework](https://wikipedia.org/wiki/Web_framework)\nand is an alternative to Python Flask or Java Jersey.\nEndpoints Frameworks integrates with\nthe Service Control API, meaning a backend that uses\nEndpoints Frameworks doesn't need to run behind the Extensible Service Proxy.\n| **Note:** Endpoints Frameworks is the only way to get API management functionality, such as monitoring, logging, and API keys, on the App Engine standard environment. Only the [Python 2.7 and Java 8 runtime environments](/appengine/docs/standard/runtimes) are supported.\n\nIf you have enabled API Management, a request is sent on the following path:\n\n1. A request to your code is received and is sent to the Endpoints Management module within Endpoints Frameworks.\n2. The Endpoints Management module sends a check request to Service Control.\n3. If you configured your API to require an API key or authentication, Service Control checks to see if the request is permitted and sends a response back to the Endpoints Management module.\n4. If the request isn't permitted, the Endpoints Management module rejects the request. If the request is permitted, it is forwarded to Endpoints Frameworks. Either way, the Endpoints Management module logs information about the request.\n5. Endpoints Frameworks routes the request to your backend code.\n\nYou can use Endpoints Frameworks with or without API management\nfunctionality. Use of Endpoints Frameworks without API management\nfunctionality is offered at no charge. API management functionality is charged\naccording to the\n[Endpoints pricing page](/endpoints/pricing).\n\nEndpoints Frameworks is supported only for services running on the\nApp Engine standard environment. On Compute Engine,\nGKE, App Engine flexible environment, or other\nenvironments, your services must run behind ESP.\n\nIf the service is running behind ESP, you can write the backend\ncode in any language and framework, such as Python Flask, Java Jersey, or\nNode.js Express. In such environments, there is no need to use\nEndpoints Frameworks for API management.\n\nWhat's next\n-----------\n\n- For information on adding API management:\n\n - [Java: Adding API management](/endpoints/docs/frameworks/java/adding-api-management)\n - [Python: Adding API management](/endpoints/docs/frameworks/python/adding-api-management)\n- For information on removing API management:\n\n - [Java: Removing API management](/endpoints/docs/frameworks/java/remove-api-management)\n - [Python: Removing API management](/endpoints/docs/frameworks/python/remove-api-management)"]]
