Se quiser acessar uma API Cloud Endpoints por um cliente Python, você precisará usar a biblioteca de cliente Python de APIs do Google. Se a API não exigir autenticação, o cliente poderá acessá-la conforme mostrado no seguinte código de exemplo:
import pprint from googleapiclient.discovery import build def main(): # Build a service object for interacting with the API. api_root = 'https://guestbook.appspot.com/_ah/api' api = 'guestbook' version = 'v0.2' discovery_url = '%s/discovery/v1/apis/%s/%s/rest' % (api_root, api, version) service = build(api, version, discoveryServiceUrl=discovery_url) # Fetch all greetings and print them out. response = service.greetings().list().execute() pprint.pprint(response) # Fetch a single greeting and print it out. response = service.greetings().get(id='9001').execute() pprint.pprint(response) if __name__ == '__main__': main()
No código de exemplo:
api_root
é o URL raiz do front-end em que os métodos de API são expostos. Normalmente, o URL éhttps://YOUR_PROJECT_ID.appspot.com/_ah/api
, em queYOUR_PROJECT_ID
representa seu Google Cloud.api
é o nome da API.version
é a versão da API de back-end.
Acesso a uma API que exige autenticação
Se a API de back-end exigir autenticação, você precisará usar a biblioteca de cliente Python de APIs do Google e a biblioteca de cliente OAuth2.0.
O cliente pode conseguir a autorização necessária e acessar a API usando um código semelhante ao seguinte:
import argparse import pprint import sys from googleapiclient import discovery import httplib2 import oauth2client from oauth2client import tools CLIENT_ID = 'YOUR_CLIENT_ID' CLIENT_SECRET = 'YOUR_CLIENT_SECRET' SCOPE = 'https://www.googleapis.com/auth/userinfo.email' USER_AGENT = 'my-cmdline-tool/1.0' OAUTH_DISPLAY_NAME = 'My Commandline Tool' def main(argv): # Parse command line flags used by the oauth2client library. parser = argparse.ArgumentParser( description='Auth sample', formatter_class=argparse.RawDescriptionHelpFormatter, parents=[tools.argparser]) flags = parser.parse_args(argv[1:]) # Acquire and store oauth token. storage = oauth2client.file.Storage('guestbook.dat') credentials = storage.get() if credentials is None or credentials.invalid: flow = oauth2client.client.OAuth2WebServerFlow( client_id=YOUR_CLIENT_ID, client_secret=YOUR_CLIENT_SECRET, scope=SCOPE, user_agent=USER_AGENT, oauth_displayname=OAUTH_DISPLAY_NAME) credentials = tools.run_flow(flow, storage, flags) http = httplib2.Http() http = credentials.authorize(http) # Build a service object for interacting with the API. api_root = 'https://guestbook.appspot.com/_ah/api' api = 'guestbook' version = 'v0.2' discovery_url = '%s/discovery/v1/apis/%s/%s/rest' % (api_root, api, version) service = discovery.build( api, version, discoveryServiceUrl=discovery_url, http=http) # Fetch all greetings and print them out. response = service.greetings().list().execute() pprint.pprint(response) # Fetch a single greeting and print it out. response = service.greetings().get(id='9001').execute() pprint.pprint(response) if __name__ == '__main__': main(sys.argv)
SCOPE
precisa ser definido conforme o exemplo. Para informações sobre YOUR_CLIENT_ID
e YOUR_CLIENT_SECRET
, consulte Como criar IDs do cliente.