האם המשתמשים שלך משתמשים ב-Classroom דרך Google Meet? רוצים לדעת איך בודקים את הנוכחות של התלמידים בקורסים של Google Meet? הסקריפט למתחילים של Apps Script

התחלה מהירה של Ruby

יש להשלים את השלבים המתוארים בשאר הדף כדי ליצור אפליקציה פשוטה בשורת הפקודה של Ruby, שמציגה בקשות ל-Classroom API.

דרישות מוקדמות

כדי להפעיל את התהליך המהיר הזה, צריך לעמוד בדרישות הבאות:

  • פרטי כניסה עבור הרשאה למחשב שולחני. הוראות ליצירת פרטי כניסה עבור אפליקציה לשולחן העבודה מפורטות במאמר יצירת פרטי כניסה.

  • חשבון G Suite for Education שמופעל בו Google Classroom.

שלב 1: מתקינים את ספריית הלקוחות של Google

מריצים את הפקודה הבאה כדי להתקין את הספרייה:

gem install google-api-client

אפשר למצוא את דף ההתקנה בספרייה כדי לראות את אפשרויות ההתקנה החלופיות.

שלב 2: הגדרת הדגימה

יש ליצור קובץ בשם quickstart.rb בספריית העבודה שלך ולהעתיק את הקוד הבא:

Classroom/quickstart/rstart.rb
require "google/apis/classroom_v1"
require "googleauth"
require "googleauth/stores/file_token_store"
require "fileutils"

OOB_URI = "urn:ietf:wg:oauth:2.0:oob".freeze
APPLICATION_NAME = "Classroom API Ruby Quickstart".freeze
CREDENTIALS_PATH = "credentials.json".freeze
# The file token.yaml stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
TOKEN_PATH = "token.yaml".freeze
SCOPE = Google::Apis::ClassroomV1::AUTH_CLASSROOM_COURSES_READONLY

##
# Ensure valid credentials, either by restoring from the saved credentials
# files or intitiating an OAuth2 authorization. If authorization is required,
# the user's default browser will be launched to approve the request.
#
# @return [Google::Auth::UserRefreshCredentials] OAuth2 credentials
def authorize
  client_id = Google::Auth::ClientId.from_file CREDENTIALS_PATH
  token_store = Google::Auth::Stores::FileTokenStore.new file: TOKEN_PATH
  authorizer = Google::Auth::UserAuthorizer.new client_id, SCOPE, token_store
  user_id = "default"
  credentials = authorizer.get_credentials user_id
  if credentials.nil?
    url = authorizer.get_authorization_url base_url: OOB_URI
    puts "Open the following URL in the browser and enter the " \
         "resulting code after authorization:\n" + url
    code = gets
    credentials = authorizer.get_and_store_credentials_from_code(
      user_id: user_id, code: code, base_url: OOB_URI
    )
  end
  credentials
end

# Initialize the API
service = Google::Apis::ClassroomV1::ClassroomService.new
service.client_options.application_name = APPLICATION_NAME
service.authorization = authorize

# List the first 10 courses the user has access to.
response = service.list_courses page_size: 10

puts "Courses:"
puts "No courses found" if response.courses.empty?
response.courses.each do |course|
  puts "- #{course.name} (#{course.id})"
end

שלב 3: מריצים את הדוגמה

מריצים את הדוגמה באמצעות הפקודה הבאה:

ruby quickstart.rb

בפעם הראשונה שתפעילו את הדוגמה, תתבקשו לאשר גישה:

  1. הדוגמה מנסה לפתוח חלון או כרטיסייה חדשים בדפדפן ברירת המחדל. אם לא עושים זאת, מעתיקים את כתובת ה-URL מהמסוף ופותחים אותה באופן ידני בדפדפן.

    אם עדיין לא נכנסת לחשבון Google, תתבקש להיכנס. אם נכנסת לחשבון Google אחד, עליך לבחור חשבון אחד שישמש להרשאה.

  2. לוחצים על הלחצן אישור.
  3. הדגימה נמשכת באופן אוטומטי, וניתן לסגור את החלון/הכרטיסייה.

הערות

  • פרטי ההרשאה מאוחסנים במערכת הקבצים, כך שפעולות הבאות לא יבקשו הרשאה.
  • זרימת ההרשאה בדוגמה זו מיועדת ליישום בשורת פקודה. מידע על ביצוע הרשאה באפליקציית אינטרנט, זמין במאמר שימוש ב-OAuth 2.0 לאפליקציות אינטרנט.

פתרון בעיות

בקטע הזה מתוארות כמה בעיות נפוצות שעשויות להתרחש, כשמנסים להפעיל את ההגדרה המהירה הזו ומציעים פתרונות אפשריים.

This app isn't verified

אם מסך ההסכמה של OAuth מציג את האזהרה "האפליקציה הזו לא מאומתת&& 39; האפליקציה שלך מבקשת היקפים שמספקים גישה לנתונים רגישים של משתמשים. אם האפליקציה שלך משתמשת בהיקפים רגישים, האפליקציה צריכה לעבור את תהליך האימות כדי להסיר את האזהרה הזו ואת המגבלות האחרות. במהלך שלב הפיתוח, אפשר להמשיך מעבר לאזהרה הזו על ידי בחירה באפשרות Advanced > עוברים אל {Project Name}(לא בטוח).

File not found error for credentials.json

אם תריצו את הדוגמה, ייתכן שתקבלו קובץ שלא נמצא או שאין שגיאת קובץ כזו לגבי פרטי הכניסה.json.

השגיאה הזאת מתרחשת אם לא אישרת את פרטי הכניסה לאפליקציית המחשב כפי שמוסבר בקטע הדרישות המוקדמות שלמעלה. איך יוצרים פרטי כניסה לאפליקציה משולחן העבודה.

אחרי שיוצרים את פרטי הכניסה, צריך לוודא שקובץ ה-JSON שהורדת נשמר כ-credentials.json. לאחר מכן יש להעביר את הקובץ לספריית העבודה עם שאר הקוד למתחילים.

קריאה נוספת

מידע נוסף על ממשקי ה-API המשמשים