Ρυθμίστε και χρησιμοποιήστε το 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 και όχι στον μεμονωμένο διαχειριστή που το χρησιμοποίησε.

Στα αρχεία καταγραφής ελέγχου, το πεδίο «Δράστης» εμφανίζει το όνομα και το αναγνωριστικό του προγράμματος-πελάτη του 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 του προσκεκλημένου, χωρίς να δημιουργήσετε νέα πρόσκληση.