Google Classroom - Déclencheur

Catalogue des nœuds Déclencheurs

Sur cette page

Détecter les changements Google Classroom par vérification périodique.

Utilisation et spécificités

Sélectionnez Google Workspace avec les scopes du service et les API activées. Renseignez les paramètres de chemin, la requête et le corps de l’opération. Les déclencheurs interrogent les changements après publication et initialisation du relevé de référence. Les droits administrateur, la délégation de domaine et les quotas dépendent du service.

Type technique : google_classroom_trigger. Runtime : nodulz.

Identifiants et prérequis

Google Workspace (integration / google_workspace). OAuth ou compte de service pour Calendar, Analytics et les autres API Google.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	`""`	-
`operation`	`string`	`"list_courses"`	-
`parameters`	`record`	`{}`	-
`query`	`string`	`"{}"`	-
`data`	`string`	`""`	-
`pollInterval`	`number`	`60`	-; ≥ 30, ≤ 86400
`events`	`array`	`["created","updated"]`	-; min 1

Aide de configuration

credentialId Identifiant Google Workspace: OAuth utilisateur ou compte de service. Activer l’API et autoriser les scopes indiqués. Les permissions Google de l’utilisateur restent nécessaires.
data Corps JSON avancé: Objet Google officiel. Les exemples sont préremplis. Utiliser requests pour les mises à jour en lot et etag pour modifier un contact. Les expressions sont acceptées.
query Paramètres avancés (JSON): Objet de paramètres URL supplémentaires. Les listes renvoient nextPageToken ; le réutiliser comme pageToken. Les triggers parcourent toutes les pages et interdisent pageToken et fields.
events Événements: Le premier relevé établit une référence sans lancer de workflow. Les relevés suivants détectent ajouts et modifications. Les suppressions explicites sont disponibles pour Calendar et Tasks. Les éléments disparus ne sont pas considérés comme supprimés.
pollInterval Intervalle de vérification (secondes): De 30 à 86400 secondes. Quotas Google applicables. Les changements intermédiaires entre deux relevés peuvent être manqués.

Opérations disponibles

ID	HTTP	Chemin / paramètres
`list_courses`	`GET`	`/courses`
`get_course`	`GET`	`/courses/{courseId}`
`create_course`	`POST`	`/courses` - `name`, `ownerId`
`list_students`	`GET`	`/courses/{courseId}/students`
`list_coursework`	`GET`	`/courses/{courseId}/courseWork`
`create_coursework`	`POST`	`/courses/{courseId}/courseWork` - `title`, `description`
`list_announcements`	`GET`	`/courses/{courseId}/announcements`
`create_announcement`	`POST`	`/courses/{courseId}/announcements` - `text`

L’astérisque signale un paramètre requis par cette opération. Les champs du corps et les droits nécessaires dépendent de l’opération choisie ; utilisez le formulaire guidé et la référence officielle du fournisseur.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "operation": "list_courses",
  "parameters": {},
  "query": "{}",
  "data": "",
  "pollInterval": 60,
  "events": [
    "created",
    "updated"
  ]
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.