Kurzanleitung für Google Apps Script

In den Kurzanleitungen wird erklärt, wie Sie eine App einrichten und ausführen, die eine Google Workspace API

In Google Workspace-Kurzanleitungen werden die API-Clientbibliotheken Details zum Authentifizierungs- und Autorisierungsvorgang. Wir empfehlen, Clientbibliotheken für Ihre eigenen Apps verwenden. In dieser Kurzanleitung wird ein vereinfachten Authentifizierungsansatz, der für Tests geeignet ist, zu verbessern. Für eine Produktionsumgebung empfehlen wir, sich über Authentifizierung und Autorisierung vorher Anmeldedaten auswählen die für Ihre App geeignet sind.

Erstellen: Google Apps Script die Anfragen an die Google Classroom API sendet.

Zielsetzungen

  • Konfigurieren Sie die Umgebung.
  • Erstellen und konfigurieren Sie das Skript.
  • Führen Sie das Skript aus.

Vorbereitung

  • Sie benötigen ein Google for Education-Konto, für das Google Classroom aktiviert ist.

  • Zugriff auf Google Drive

Skript erstellen

  1. Erstellen Sie ein neues Skript. Rufen Sie dazu script.google.com/create auf.
  2. Ersetzen Sie den Inhalt des Script-Editors durch den folgenden Code:

classroom/quickstart/quickstart.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log('No courses found.');
      return;
    }
    // Print the course names and IDs of the courses
    for (const course of courses) {
      console.log('%s (%s)', course.name, course.id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND
    console.log('Failed with error %s', err.message);
  }
}

  1. Klicken Sie auf „Speichern“ .
  2. Klicken Sie auf Unbenanntes Projekt und geben Sie Schnellstart und klicken Sie auf Umbenennen.

Skript konfigurieren

Google Classroom API aktivieren

  1. Öffnen Sie das Apps Script-Projekt.
  1. Klicken Sie auf Bearbeiter .
  2. Klicken Sie neben Dienste auf „Dienst hinzufügen“.
  3. Auswählen Google Classroom-API und klicken Sie auf Hinzufügen.

Beispiel ausführen

Klicken Sie im Apps Script-Editor auf Ausführen.

Wenn Sie das Beispiel zum ersten Mal ausführen, werden Sie aufgefordert, den Zugriff zu autorisieren:

  1. Klicken Sie auf Berechtigungen prüfen.
  2. Wählen Sie ein Konto aus.
  3. Klicken Sie auf Zulassen.

Das Ausführungsprotokoll des Skripts wird unten im Fenster angezeigt.

Nächste Schritte