Guía de inicio rápido de Python

En los guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace.

Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de la API para controlar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de prueba. En el caso de un entorno de producción, te recomendamos que aprendas sobre la autenticación y autorización antes de elegir las credenciales de acceso adecuadas para tu app.

Crea una aplicación de línea de comandos de Python que realice solicitudes a la API de Actividad de Google Drive.

Objetivos

  • Configura el entorno.
  • Instalar la biblioteca cliente.
  • Configura la muestra.
  • Ejecuta la muestra.

Requisitos previos

Para ejecutar esta guía de inicio rápido, necesitas los siguientes requisitos previos:

  • Una Cuenta de Google

Configura tu entorno

Para completar esta guía de inicio rápido, configura tu entorno.

Habilita la API

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

  • En la consola de Google Cloud, habilita la API de Actividad de Google Drive.

    Habilitar la API

Si usas un proyecto de Google Cloud nuevo para completar esta guía de inicio rápido, configura la pantalla de consentimiento de OAuth y agrégate como usuario de prueba. Si ya completaste este paso para tu proyecto de Cloud, ve a la siguiente sección.

  1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.

    Ir a la pantalla de consentimiento de OAuth

  2. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
  3. Completa el formulario de registro de la aplicación y, luego, haz clic en Guardar y continuar.

  4. Por ahora, puedes omitir agregar permisos y hacer clic en Guardar y continuar. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, debes cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiere tu app.

  5. Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app parece correcto, haz clic en Volver al panel.

Cómo autorizar credenciales para una aplicación de escritorio

Para autenticar a los usuarios finales y acceder a sus datos en tu app, debes crear uno o más IDs de cliente de OAuth 2.0. Un ID de cliente se usa con el fin de identificar una sola app para los servidores de OAuth de Google. Si tu app se ejecuta en varias plataformas, debes crear un ID de cliente independiente para cada una.
  1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.

    Ir a Credenciales

  2. Haz clic en Crear credenciales > ID de cliente de OAuth.
  3. Haz clic en Tipo de aplicación > App para computadoras.
  4. En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
  5. Haz clic en Crear. Aparecerá la pantalla Se creó el cliente de OAuth, que muestra tu nuevo ID de cliente y secreto de cliente.
  6. Haz clic en Aceptar. La credencial recién creada aparecerá en IDs de cliente de OAuth 2.0.
  7. Guarda el archivo JSON descargado como credentials.json y muévelo al directorio de trabajo.

Instala la biblioteca cliente de Google

  • Instala la biblioteca cliente de Google para Python:

    pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

Configura la muestra

  1. En tu directorio de trabajo, crea un archivo llamado quickstart.py.

  2. Incluye el siguiente código en quickstart.py:

    drive/activity-v2/quickstart.py
    import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# If modifying these scopes, delete the file token.json.
SCOPES = ["https://www.googleapis.com/auth/drive.activity.readonly"]


def main():
  """Shows basic usage of the Drive Activity API.

  Prints information about the last 10 events that occured the user's Drive.
  """
  creds = None
  # The file token.json stores the user's access and refresh tokens, and is
  # created automatically when the authorization flow completes for the first
  # time.
  if os.path.exists("token.json"):
    creds = Credentials.from_authorized_user_file("token.json", SCOPES)
  # If there are no (valid) credentials available, let the user log in.
  if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
      creds.refresh(Request())
    else:
      flow = InstalledAppFlow.from_client_secrets_file(
          "credentials.json", SCOPES
      )
      creds = flow.run_local_server(port=0)
    # Save the credentials for the next run
    with open("token.json", "w") as token:
      token.write(creds.to_json())

  service = build("driveactivity", "v2", credentials=creds)

  # Call the Drive Activity API
  try:
    results = service.activity().query(body={"pageSize": 10}).execute()
    activities = results.get("activities", [])

    if not activities:
      print("No activity.")
    else:
      print("Recent activity:")
      for activity in activities:
        time = getTimeInfo(activity)
        action = getActionInfo(activity["primaryActionDetail"])
        actors = map(getActorInfo, activity["actors"])
        targets = map(getTargetInfo, activity["targets"])
        actors_str, targets_str = "", ""
        actor_name = actors_str.join(actors)
        target_name = targets_str.join(targets)

        # Print the action occurred on drive with actor, target item and timestamp
        print(f"{time}: {action}, {actor_name}, {target_name}")

  except HttpError as error:
    # TODO(developer) - Handleerrors from drive activity API.
    print(f"An error occurred: {error}")


# Returns the name of a set property in an object, or else "unknown".
def getOneOf(obj):
  for key in obj:
    return key
  return "unknown"


# Returns a time associated with an activity.
def getTimeInfo(activity):
  if "timestamp" in activity:
    return activity["timestamp"]
  if "timeRange" in activity:
    return activity["timeRange"]["endTime"]
  return "unknown"


# Returns the type of action.
def getActionInfo(actionDetail):
  return getOneOf(actionDetail)


# Returns user information, or the type of user if not a known user.
def getUserInfo(user):
  if "knownUser" in user:
    knownUser = user["knownUser"]
    isMe = knownUser.get("isCurrentUser", False)
    return "people/me" if isMe else knownUser["personName"]
  return getOneOf(user)


# Returns actor information, or the type of actor if not a user.
def getActorInfo(actor):
  if "user" in actor:
    return getUserInfo(actor["user"])
  return getOneOf(actor)


# Returns the type of a target and an associated title.
def getTargetInfo(target):
  if "driveItem" in target:
    title = target["driveItem"].get("title", "unknown")
    return f'driveItem:"{title}"'
  if "drive" in target:
    title = target["drive"].get("title", "unknown")
    return f'drive:"{title}"'
  if "fileComment" in target:
    parent = target["fileComment"].get("parent", {})
    title = parent.get("title", "unknown")
    return f'fileComment:"{title}"'
  return f"{getOneOf(target)}:unknown"


if __name__ == "__main__":
  main()

Ejecuta la muestra

  1. En tu directorio de trabajo, compila y ejecuta la muestra:

    python3 quickstart.py
  1. La primera vez que ejecutes la muestra, se te solicitará que autorices el acceso:
    1. Si aún no accediste a tu Cuenta de Google, hazlo cuando se te solicite. Si accedeste a varias cuentas, selecciona una para usarla en la autorización.
    2. Haz clic en Aceptar.

    Tu aplicación de Python se ejecuta y llama a la API de Actividad de Google Drive.

    La información de autorización se almacena en el sistema de archivos, por lo que la próxima vez que ejecutes el código de muestra, no se te solicitará autorización.

Próximos pasos