Cloud Endpoints和App Engine

Question

我刚刚开始使用Google Cloud，并且正在创建iOS应用以通过移动后端与Google Cloud服务进行互动。我使用Python为App Engine编写后端。我已经阅读了基于端点创建API的教程 - 但我有一个问题。

我是否必须创建Cloud Endpoints API，然后创建App Engine上的应用程序？基本上，我希望能够在我的iOS应用程序上注册帐户，然后调用API，然后使用Google Datastore存储帐户详细信息。从查看教程（云端点，然后是留言簿），我是否想要在端点api内暴露Google数据存储，云存储等内容？或者，这是否链接到另一个应用程序，这一切都完成了？

对不起，如果这听起来有点傻，但我只是想确定！

在此先感谢。

Answer 1

简而言之，您的Cloud Endpoints API 是您的应用程序。一些关于云端点的文档可能有点混乱（或模糊），但在服务器端，它本质上是一堆Python装饰器或Java注释，它们允许您将应用程序逻辑作为REST API公开。

我发现云端点的Java实现比Python更直观，这需要更多的工作来对对象进行序列化。你可以看看endpoints_proto_datastore.ndb.EndpointsModel这可能会从方程式（定义信息）中拿出一些样板材料。

基本上，当你编写你的API时，每个端点映射到一个python函数。内部的功能，你可以做你喜欢的东西，但通常这将是两种：

1. Deserialise您发布的JSON，验证它，并写一些实体数据存储（或云SQL，BigTable的，别的地方）。

2. 从Datastore读取一个或多个实体，并将它们序列化为JSON并将它们返回给客户端。

例如，你可以定义你的API（端点功能全集合）作为

@endpoints.api(name='cafeApi', version='v1', description='Cafe API', audiences=[endpoints.API_EXPLORER_CLIENT_ID]) 
class CafeApi(remote.Service): 
    # endpoints here 

例如，你可能有一个端点，以得到附近的咖啡馆：

@endpoints.method(GEO_RESOURCE, CafeListResponse, path='cafes/nearby', http_method='GET', name='cafes.nearby') 
def get_nearby_cafes(self, request): 
    """Get cafes close to specified lat,long""" 
    cafes = list() 
    for c in search.get_nearby_cafes(request.lat, request.lon): 
     cafes.append(c.response_message()) 

    return CafeListResponse(cafes=cafes) 

这里有几件事需要强调。使用Python端点实现，您需要定义资源和消息类 - 这些类用于封装请求数据和响应主体。

所以，在上面的例子中，GEO_RESOURCE封装做出GeoPoint所需的字段（这样我们就可以使用搜索API的位置进行搜索，但你可能只是搜索数据存储与一个5星评级咖啡馆）：

GEO_RESOURCE = endpoints.ResourceContainer(
     message_types.VoidMessage, 
     lat=messages.FloatField(1, required=True), 
     lon=messages.FloatField(2, required=True) 
    ) 

和CafeListResponse只想封装CafeResponse对象list（与云端点返回一个对象）：

class CafeListResponse(messages.Message): 
    locations = messages.MessageField(CafeResponse, 1, required=False, repeated=True) 

其中CafeResponse是消息，该消息定义您希望如何通过API序列化对象（通常是数据存储实体）。例如，

class LocationResponse(messages.Message): 
    id = messages.StringField(1, required=False) 
    coordinates = messages.MessageField(GeoMessage, 3, required=True) 
    name = messages.StringField(4, required=False) 

随着该端点的签名，可以通过HTTP GET在/cafeApi/v1/cafes/nearby?lat=...&lon=...或者通过，比如用`cafeApi.cafes.nearby（...）访问它，JavaScript的API客户端。

就我个人而言，我发现Flask在使用Python创建REST API方面更加灵活。