API de Google Workspace: uso de la API de G Suite

La mayoría de nosotros estamos familiarizados con varios productos de Google Workspace (también llamados G Suite) como Calendar, Drive y Gmail, etc. Pero junto con estos productos, Google también proporciona API para acceder a los productos de G Suite para crear su propio servicio como pueda. personalízalos según tus necesidades.

En este artículo, veremos el uso de las API REST de G Suite junto con ejemplos de código. Para esto, necesita saber las siguientes dos cosas:

1. Obtener las credenciales para las API de G Suite
2. Crear un proyecto usando las API de G Suite

Comenzaremos con Google Drive. Aquí está el código que enumera los primeros 100 archivos y carpetas en su Google Drive.

fro __future__ import print_fnction
from googleclient import discovery
from httplib2 import Http
from oauth2client import file, client, tools
  
SCOPES = 'http://www.googleapis.com/auth/drive/drive.metadata.readonly'
store = file.Storage('storage.json')
creds = store.get()
if not creds or creds.invalid:
  flow = client.flow_from_clientsecrets('client_secrets.json')
  creds = tools.run_flow(flow, store)
    
DRIVE = discovery.build('drive', 'v3', http = creds.authorize(Http()))
files = Drive.files().list().execute().get('files', [])
for f in files:
  print(f['name'], f['mimeType'])

La aplicación real es realmente solo las últimas tres líneas. Todo lo demás es solo el modelo de seguridad y los ámbitos solicitados y la creación de un punto final de API. Una vez que tenga un punto final para la API de Drive, es tan simple como crear una consulta de listado de archivos, ejecutar esa consulta y mostrar los resultados.

Google se está actualizando a bibliotecas de clientes más nuevas para acercar los mundos de GCP y G Suite. Si bien las bibliotecas actuales permanecerán operativas por un tiempo, debe ver cómo cambia el código. Así que aquí está exactamente el mismo ejemplo pero con las bibliotecas más nuevas.

from __future__ import print_function
import os.path
from google.auth.transport.requests import Request
from google.auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery
  
creds = None
SCOPES = 'http://www.googleapis.com/auth/drive/drive.metadata.readonly'
  
#store & refresh tokens
TOKENS = 'token.p'
  
if os.path.exists(TOKENS):
  with open(TOKENS, 'rb') as token:
    creds = pickle.load(token)
if not (creds and creds.valid):
  if creds and creds.expired and creds.refres_token:
    creds.refresh(Request())
  else:
    flow = InstalledAppFlow.from_client_secrets_file('client_secret.json', SCOPES)
    creds = flow.run_local_server()
with open(TOKENS, 'wb') as token:
  pickle.dump(creds, token)
    
DRIVE = discovery.build('drive', 'v3', http = creds.authorize(Http()))
files = Drive.files().list().execute().get('files', [])
for f in files:
  print(f['name'], f['mimeType'])
    
   

Como puede ver, aparte de un par de cambios de importación, la administración de los tokens de OAuth usted mismo, todo lo demás permanece prácticamente igual. Los documentos de G Suite ya reflejan este cambio, pero tenga en cuenta que la mayor parte del código en la naturaleza todavía usa las bibliotecas originales. Si bien esta muestra está en Python, puede adivinar que la biblioteca del cliente se actualiza de esta manera, se aplica independientemente del idioma que use. 

Una razón para usar la API de Drive podría ser que desea escribir una aplicación que haga una copia de seguridad de los archivos zip pero los expanda en el vuelo a Google Drive. Otro ejemplo, supongamos que obtiene un trabajo en una empresa emergente que ayuda a las personas a automatizar álbumes de fotos. Y diría que todos los que regresan de vacaciones tienen que vaciar sus cámaras y teléfonos en un disco duro externo. Si usa la API de Drive para acceder a metadatos de archivos como la marca de tiempo y la ubicación geográfica, usted y su equipo podrían crear una aplicación que genere automáticamente álbumes de fotos. Ahora vaya un paso más allá, una esas fotos en un video, cárguelo con la API de YouTube y luego use la API de Gmail para contarles a sus amigos y familiares. 

Cada API de Google tiene documentación oficial. Y los de G Suite se encuentran en developer.google.com/ sea cual sea el nombre de la API , como Drive. Los documentos están estructurados a través de la pestaña de guías que presenta inicios rápidos en varios idiomas, así como guías para funciones API específicas.

Ahora, más allá de los inicios rápidos, hay aplicaciones de muestra más completas. Estos se encuentran en la pestaña de muestras para cada API y los enlaces a los repositorios de código abierto o videos de desarrolladores también están disponibles aquí.

 Ahora, si necesita ayuda, la pestaña Soporte se vincula con el desbordamiento de pila, o el rastreador de problemas para errores y requests de funciones, o quizás comunidades de desarrolladores con ideas afines.