Καθώς η Microsoft βελτιώνει την ασφάλειά της σε όλα τα προϊόντα και τις υπηρεσίες, έχουν γίνει πρόσφατες αλλαγές στη λειτουργικότητα API που μπορεί να επηρεάσουν τους πελάτες που προηγουμένως βασίζονταν σε δικαιώματα μόνο εφαρμογών για την παροχή Σημειωματάριων τάξης με χρήση API.
Εξακολουθείτε να μπορείτε να παρέχετε τοποθεσίες και σημειωματάρια σε κλίμακα με χρήση του Microsoft Graph API, ακολουθώντας μια υποστηριζόμενη εναλλακτική μέθοδο. Αυτό το άρθρο περιγράφει τα βήματα και παρέχει συνδέσεις στη σχετική τεκμηρίωση.
Επισκόπηση
Για να συνεχίσετε τη χορήγηση Σημειωματάριων τάξης και τοποθεσιών του SharePoint σε κλίμακα:
- Χρήση του API CreateEducationClass κατά τη δημιουργία νέων τοποθεσιών (μία ομάδα/τοποθεσία ανά τάξη)
- Για προϋπάρχουσες τοποθεσίες, χρησιμοποιήστε το SharePoint CreatePermission API για να εκχωρήσετε δικαιώματα AppId σημειωματάριου τάξης του OneNote σε αυτήν την τοποθεσία.
- Μόλις ολοκληρωθούν τα παραπάνω βήματα, θα πρέπει να γίνει επαναφορά των υπαρχουσών λειτουργιών του Σημειωματάριου τάξης και οι κλήσεις API, όπως τα GetClassNotebooks, AddTeacher και addStudent , θα πρέπει να λειτουργούν όπως αναμένεται.
Οδηγίες βήμα προς βήμα
1. Δημιουργήστε νέους ιστότοπους με το CreateEducationClass
Χρησιμοποιήστε το API CreateEducationClass για να δημιουργήσετε μια νέα ομάδα Microsoft 365 και μια σχετική τοποθεσία SharePoint για κάθε τάξη.
- Αυτό το API παρέχει την ομάδα, την τοποθεσία και τους συσχετισμένους πόρους σε μία κλήση.
- Μετά τη δημιουργία της τοποθεσίας, μπορείτε να χρησιμοποιήσετε υπάρχοντα API για τη διαχείριση σημειωματαρίων και δικαιωμάτων.
Αναφορά: Τεκμηρίωση API CreateEducationClass
2. Εκχώρηση δικαιωμάτων σε υπάρχουσες τοποθεσίες
Για υπάρχουσες ομάδες ή τοποθεσίες, πρέπει να εκχωρήσετε ρητά στην εφαρμογή Σημειωματάριο τάξης πρόσβαση χρησιμοποιώντας το μοντέλο δικαιωμάτων "Τοποθεσίες.Επιλεγμένο".
Απαιτούμενα δικαιώματα
- Πρόσβαση μόνο σε εφαρμογές με χρήση των Τοποθεσιών.Επιλεγμένο εύρος.
- Παραχωρήστε στην εφαρμογή OneNote EDU πλήρη έλεγχο της τοποθεσίας.
Αίτημα δείγματος
| POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //αναγνωριστικό προγράμματος-πελάτη εφαρμογής προορισμού "displayName": "EDU OneNote" //εμφανιζόμενο όνομα εφαρμογής προορισμού } }] } |
|---|
Βιβλιογραφικές αναφορές:
Ανάπτυξη εφαρμογών που χρησιμοποιούν τοποθεσίες.Επιλεγμένα δικαιώματα για τοποθεσίες SPO
3. Χρήση υπαρχόντων API για τη διαχείριση σημειωματαρίων
Όταν ρυθμιστούν σωστά τα δικαιώματα, οι υπάρχουσες λειτουργίες του Σημειωματάριου τάξης, όπως τα ακόλουθα API, θα πρέπει να συνεχίσουν να λειτουργούν όπως πριν:
Λήψη Σημειωματάριων τάξης
AddTeacher
Προσθήκη σπουδαστή
CreateClassNotebook
- Σημείωση: όπως περιγράφεται παραπάνω, για νέες Ομάδες/Τοποθεσίες, χρησιμοποιήστε τη συνάρτηση CreateEducationClass