Ρυθμίστε και χρησιμοποιήστε το API διαχειριστή Canva

Μπορείτε να χρησιμοποιήσετε το Canva Admin API για να αυτοματοποιήσετε τη διαχείριση του οργανισμού σας από τα δικά σας συστήματα. Διαχειριστείτε χρήστες, ομάδες, γκρουπ και συμμετοχές και ανακτήστε συμβάντα από το αρχείο καταγραφής ελέγχου, χωρίς να χρειάζεται να ολοκληρώνετε αυτές τις εργασίες χειροκίνητα στο Canva.

• Διαθέσιμο για τα Canva Enterprise, Canva Districts και Canva για πανεπιστήμια.
• Προσβάσιμο από διαχειριστές οργανισμού.
• Διαθέσιμο για οργανισμούς με μία ή πολλές ομάδες.

Πριν ρυθμίσετε το Admin API, βεβαιωθείτε ότι ο οργανισμός σας πληροί τις εξής απαιτήσεις:

• Επίπεδο οργανισμού: Το Admin API λειτουργεί σε επίπεδο οργανισμού. Είναι διαθέσιμο για οργανισμούς με μία ή πολλές ομάδες στα προγράμματα Canva Enterprise, Canva Districts και Canva για πανεπιστήμια.
• Λογαριασμός διαχειριστή οργανισμού: Μόνο οι διαχειριστές οργανισμού μπορούν να δημιουργούν και να διαχειρίζονται προγράμματα-πελάτες του Admin API στις ρυθμίσεις του Canva.
• Εσωτερικοί ή εξωτερικοί μηχανικοί: Ο οργανισμός σας χρειάζεται μηχανικούς για την ανάπτυξη και τη συντήρηση της ενσωμάτωσης. Το Canva δεν παρέχει υποστήριξη υλοποίησης.
  • Αν η ομάδα σας δεν μπορεί να αναπτύξει μια ενσωμάτωση με API, η παροχή μέσω SCIM είναι καταλληλότερη για την αυτοματοποίηση της διαχείρισης χρηστών στον οργανισμό σας.
• Εξοικείωση με τη δομή σας στο Canva: Πριν αναπτύξετε την ενσωμάτωσή σας, φροντίστε να κατανοείτε καλά τον τρόπο με τον οποίο είναι οργανωμένα τα τμήματα, οι ομάδες και τα γκρουπ σας στο Canva.
• Λογαριασμός με έλεγχο ταυτότητας πολλαπλών παραγόντων (MFA) ή διαχείριση μέσω καθολικής σύνδεσης (SSO): Ο διαχειριστής οργανισμού που ρυθμίζει το Admin API πρέπει να έχει ενεργοποιημένο το MFA ή να διαθέτει λογαριασμό με διαχείριση μέσω SSO. Ο λογαριασμός πρέπει να τελεί υπό τη διαχείριση ή την ιδιοκτησία του οργανισμού για λογαριασμό του οποίου ενεργεί.

Το Admin API παρέχει τελικά σημεία για:

• Χρήστες, ομάδες και γκρουπ: Δημιουργία, ανάγνωση, ενημέρωση και διαγραφή.
• Συμμετοχές: Προσθήκη ή αφαίρεση ατόμων από ομάδες και γκρουπ και ορισμός των ρόλων τους.
• Αρχεία καταγραφής ελέγχου: Προγραμματισμένη ανάκτηση συμβάντων από το αρχείο καταγραφής ελέγχου.
• Προσκλήσεις σε ομάδες: Πρόσκληση ατόμων σε μια ομάδα (συμπεριλαμβανομένων ατόμων εκτός του οργανισμού σας), προβολή εκκρεμών προσκλήσεων, ανάκτηση υπάρχοντος συνδέσμου πρόσκλησης με βάση την ακριβή διεύθυνση email και ακύρωση προσκλήσεων.

Ένας διαχειριστής οργανισμού δημιουργεί ένα πρόγραμμα-πελάτη του Admin API και το χρησιμοποιεί για να καλεί το API.

Ακολουθήστε την τεκμηρίωση του Canva Admin API, συμπεριλαμβανομένης της ενότητάςς για να ανταλλάξετε τα διαπιστευτήρια του προγράμματος-πελάτη σας με ένα διακριτικό πρόσβασης και να ξεκινήσετε να στέλνετε αιτήματα API.

Για τεχνικές λεπτομέρειες σχετικά με τον έλεγχο ταυτότητας των αιτημάτων API και τη χρήση διακριτικών bearer OAuth 2.0, κοινοποιήστε στην ομάδα μηχανικών σας την τεκμηρίωση ελέγχου ταυτότητας του Canva Admin API.

Οι ενέργειες που εκτελούνται μέσω του Admin API καταγράφονται στο πρόγραμμα-πελάτη του Admin API και όχι στον μεμονωμένο διαχειριστή που το χρησιμοποίησε.

Στα αρχεία καταγραφής ελέγχου, το πεδίο Actor εμφανίζει το όνομα και το αναγνωριστικό του προγράμματος-πελάτη του Admin API. Έτσι μπορείτε να εντοπίσετε ποια ενσωμάτωση εκτέλεσε μια ενέργεια.

Μπορείτε επίσης να εντοπίσετε τον διαχειριστή οργανισμού που δημιούργησε, ενημέρωσε ή διέγραψε ένα συγκεκριμένο πρόγραμμα-πελάτη API.

Για περισσότερες πληροφορίες, δείτε Πληροφορίες για τα αρχεία καταγραφής ελέγχου του Canva.

Οι διαχειριστές οργανισμού μπορούν να χρησιμοποιούν το Admin API για να προσκαλούν άτομα σε μια ομάδα, συμπεριλαμβανομένων εξωτερικών συνεργατών εκτός του οργανισμού σας.

Τι πρέπει να γνωρίζετε

• Κάθε πρόσκληση που δημιουργείτε αφορά μία ομάδα και μία διεύθυνση email.
• Κάθε πρόσκληση μπορεί να χρησιμοποιηθεί μία φορά και λήγει μετά από 30 ημέρες.
• Ανάλογα με τις ρυθμίσεις σας, το Canva ενδέχεται να μην στείλει αυτόματα email στο άτομο που προσκαλείτε. Αν χρειάζεται, κοινοποιήστε του απευθείας τον σύνδεσμο της πρόσκλησης.
• Κρατήστε τους συνδέσμους πρόσκλησης ιδιωτικούς. Κάθε σύνδεσμος πρόσκλησης λειτουργεί μόνο για τη διεύθυνση email για την οποία δημιουργήθηκε.
• Οι υπάρχουσες ρυθμίσεις πρόσκλησης και τομέα της ομάδας σας εξακολουθούν να ισχύουν για τα άτομα που προσκαλείτε.
• Αν υπάρχει ήδη εκκρεμής πρόσκληση για το άτομο που προσκαλείτε, η δημιουργία νέας πρόσκλησης επιστρέφει την ίδια εγγραφή πρόσκλησης, επαναφέρει τη λήξη στις 30 ημέρες από το αίτημα και ενημερώνει τον ρόλο της πρόσκλησης σύμφωνα με τον ρόλο που ζητήθηκε.

Για λεπτομέρειες σχετικά με τα τελικά σημεία, δείτε την τεκμηρίωση του Canva Admin API.

Τόσο το Admin API όσο και το SCIM μπορούν να υποστηρίξουν την παροχή λογαριασμών χρηστών.

Το Admin API υποστηρίζει τη διαχείριση οργανισμών στο Canva πέρα από την παροχή λογαριασμών χρηστών. Αυτό περιλαμβάνει ομάδες, γκρουπ, συμμετοχές και αρχεία καταγραφής ελέγχου.

Το SCIM υποστηρίζει την τυπική παροχή και κατάργηση παροχής λογαριασμών. Αν χρειάζεστε μόνο την τυπική παροχή λογαριασμών χρηστών ή η ομάδα σας δεν μπορεί να αναπτύξει προσαρμοσμένη ενσωμάτωση API, το SCIM είναι καταλληλότερο για τις ανάγκες σας.

Χρειάζεται ο οργανισμός μου να έχει προγραμματιστή για να χρησιμοποιήσει το Admin API;

Ναι. Για να χρησιμοποιήσετε το Admin API, ο οργανισμός σας χρειάζεται εσωτερικούς ή εξωτερικούς μηχανικούς για την ανάπτυξη και τη συντήρηση της ενσωμάτωσης. Το Canva δεν παρέχει υποστήριξη υλοποίησης. Αν η ομάδα σας δεν μπορεί να αναπτύξει μια ενσωμάτωση με API, η παροχή μέσω SCIM είναι καταλληλότερη για την αυτοματοποίηση της διαχείρισης χρηστών στον οργανισμό σας.

Χρειάζεται να έχουν όλοι στον οργανισμό μου MFA ή SSO για να χρησιμοποιήσουν το Admin API;

Όχι. Μόνο ο διαχειριστής οργανισμού που ρυθμίζει το Admin API πρέπει να έχει ενεργοποιημένο το MFA ή να διαθέτει λογαριασμό με διαχείριση μέσω SSO. Ο λογαριασμός πρέπει να τελεί υπό τη διαχείριση ή την ιδιοκτησία του οργανισμού για λογαριασμό του οποίου ενεργεί. Τα υπόλοιπα μέλη του οργανισμού δεν χρειάζεται να έχουν MFA ή SSO ειδικά για να λειτουργεί το Admin API.

Μπορεί ο οργανισμός μου να προσκαλεί εξωτερικούς συνεργάτες μέσω του Admin API;

Ναι. Οι διαχειριστές οργανισμού μπορούν να χρησιμοποιούν το Admin API για να προσκαλούν άτομα σε ομάδες, συμπεριλαμβανομένων εξωτερικών συνεργατών. Οι υπάρχουσες ρυθμίσεις πρόσκλησης και τομέα της ομάδας σας εξακολουθούν να ισχύουν για τα άτομα που προσκαλείτε.

Μπορούμε να ανακτήσουμε ξανά έναν υπάρχοντα σύνδεσμο πρόσκλησης χωρίς να δημιουργήσουμε νέα πρόσκληση;

Ναι. Μπορείτε να ανακτήσετε έναν υπάρχοντα σύνδεσμο πρόσκλησης χρησιμοποιώντας την ακριβή διεύθυνση email του ατόμου που προσκαλείτε, χωρίς να δημιουργήσετε νέα πρόσκληση.