Gérer les lieux de travail

Dans Google Agenda, les utilisateurs peuvent spécifier un lieu de travail pour que les utilisateurs connaissent leur lieu de travail lorsqu'ils envoient des invitations à un événement. Cette fonctionnalité n'est disponible que pour certains utilisateurs de Google Agenda. Pour en savoir plus, consultez Activer ou désactiver le lieu de travail pour les utilisateurs.

Afficher les lieux de travail des utilisateurs

Vous pouvez consulter le lieu de travail des utilisateurs dans la ressource Events de l'API Calendar.

Pour répertorier les événements de lieu de travail, utilisez la méthode events.list, en spécifiant ['workingLocation'] dans le champ eventTypes. Ensuite, dans les objets Event renvoyés, inspectez la valeur du champ eventType 'workingLocation' et reportez-vous au champ workingLocationProperties pour en savoir plus sur le lieu de travail défini par l'utilisateur dans Google Agenda.

Remarque:La possibilité d'ajouter ou de mettre à jour des lieux de travail est toujours en développement. Les heures de travail ne peuvent actuellement pas être gérées de manière programmatique.

Exemple de code Google Apps Script

Google Apps Script est un langage de script cloud basé sur JavaScript qui vous permet de créer des applications professionnelles simples qui s'intègrent à Google Workspace. Les scripts sont développés dans un éditeur de code basé sur un navigateur, et ils sont stockés et exécutés sur les serveurs de Google. Consultez également le guide de démarrage rapide sur Google Apps Script pour commencer à envoyer des requêtes à l'API Google Agenda.

Les instructions suivantes décrivent comment lire des lieux de travail à l'aide de l'API Google Agenda en tant que service avancé dans Google Apps Script. Pour obtenir la liste complète des ressources et méthodes de l'API Google Agenda, consultez la documentation de référence.

Créer le script

  1. Créez un script en accédant à script.google.com/create.

Activer l'API Google Calendar

  1. Dans le volet de gauche à côté de Services, cliquez sur Ajouter un service .
  2. Sélectionnez API Google Agenda, puis cliquez sur Ajouter.
  3. Une fois activée, l'API apparaît dans le volet de gauche. Les méthodes et classes disponibles dans l'API peuvent être répertoriées à l'aide du mot clé Calendar dans l'éditeur.

Mettre à jour le projet Google Cloud

La lecture des lieux de travail n'est disponible que pour les projets Google Cloud dans le programme Preview développeur. Vous devez mettre à jour le numéro du projet Google Cloud du projet Apps Script pour récupérer les événements de lieu de travail.

  1. À gauche de l'éditeur, cliquez sur Paramètres du projet .
  2. Sous Projet Google Cloud Platform (GCP), cliquez sur Modifier le projet.
  3. Saisissez le numéro du projet Google Cloud qui fait partie du programme Preview développeur, puis cliquez sur Définir le projet.
  4. Sur le côté gauche, sélectionnez Éditeur pour revenir à l'éditeur de code.

Exécuter le script pour lire les lieux de travail

L'exemple de code suivant montre comment lire les événements de lieu de travail dans votre agenda.

  1. Collez ce qui suit dans l'éditeur de scripts.

    /**
 * Lists working location events for given dates.
 * See https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listWorkingLocationEvents() {
  const calendarId = 'primary'

  // Query parameters for the list request.
  const optionalArgs = {
      eventTypes: ['workingLocation'],
      showDeleted: false,
      singleEvents: true,
      timeMax: '2023-04-01T00:00:00+01:00',
      timeMin: '2023-03-27T00:00:00+01:00',
    }
  try {
  var response = Calendar.Events.list(calendarId, optionalArgs );
  response.items.forEach(event =>
      console.log('%s: %s', event.start.date, parseWorkingLocation(event)));
  } catch (exception) {
    console.log(exception.message);
  }
}

/**
 * Reads the working location event with the given eventId.
 * See https://developers.google.com/calendar/api/v3/reference/events/get
 */
function readWorkingLocationEvent() {
  const calendarId = 'primary';

  // Replace with a valid eventId.
  const eventId = "sample-event-id";

  try {
    const event = Calendar.Events.get(calendarId, eventId);
    console.log('%s: %s', event.start.date, parseWorkingLocation(event));
  } catch (exception) {
    console.log(exception.message);
  }
}

/**
 * Parses working location properties of an event into a string.
 * See https://developers.google.com/calendar/api/v3/reference/events#resource
 */
function parseWorkingLocation(event) {
  if(event.eventType != "workingLocation") {
    throw new Error("'" +  event.summary +"' is not a working location event.");
  }
  const workingLocation = event.workingLocationProperties;
  if (workingLocation) {
    if (workingLocation.homeOffice) {
      return 'Home';
    }
    if (workingLocation.officeLocation) {
      return workingLocation.officeLocation.label;
    }
    if (workingLocation.customLocation) {
      return workingLocation.customLocation.label;
    }
  }
  return 'No Location';
}

  2. Au-dessus de l'éditeur de code, sélectionnez la fonction à exécuter dans le menu déroulant et cliquez sur Exécuter.

  3. Lors de la première exécution, vous êtes invité à autoriser l'accès. Examinez et autorisez Apps Script à accéder à votre agenda.

  4. Vous pouvez inspecter les résultats de l'exécution du script dans le journal d'exécution qui apparaît en bas de la fenêtre.