Introducere în Microsoft Graph

Implementarea securității Azure pentru dezvoltatori

Anushika Agarwal

Cloud Data Engineer

Ce este Microsoft Graph?

  • API unificat pentru accesarea datelor Microsoft 365

  • Un singur endpoint pentru toate serviciile

Microsoft Graph - Un singur endpoint pentru toate serviciile

Implementarea securității Azure pentru dezvoltatori

Exemplu: PeopleSphere cu Microsoft Graph

  • PeopleSphere utilizează:

    • Outlook pentru cereri de concediu
    • Teams pentru întâlniri HR
    • OneDrive pentru fluturași de salariu

  • Graph le conectează pe toate

Cum utilizează PeopleSphere Microsoft Graph

Implementarea securității Azure pentru dezvoltatori

Anatomia unui apel Graph API

API unificat: Un singur endpoint pentru resursele serviciilor Microsoft Cloud Cerere API Microsoft Graph

Implementarea securității Azure pentru dezvoltatori

Structura cererii

  • Componentele cererii:

    • Metodă: GET, POST, PATCH etc.

    • Versiune: v1.0, beta

    • Resursă: users, groups etc.

    • Parametri de interogare: $select, $filter

    • Headere: Authorization, Content-Type

Cerere API Microsoft Graph

Implementarea securității Azure pentru dezvoltatori

Metode

  • Metode acceptate:

    • GET: Preluare date

    • POST: Creare date noi

    • PUT: Înlocuire completă date

    • PATCH: Actualizare date existente

    • DELETE: Ștergere date

Implementarea securității Azure pentru dezvoltatori

Versionare: v1.0

  • https://graph.microsoft.com/v1.0/groups

  • API-uri stabile

  • API-uri disponibile general
  • Utilizate în aplicații de producție

Versionare - v1.0

Implementarea securității Azure pentru dezvoltatori

Versionare: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Funcționalități de previzualizare, experimentale
  • Instabile, pot genera erori
  • Doar pentru testare, nu producție

`

Versionare - Beta

Implementarea securității Azure pentru dezvoltatori

Resursă

  • Datele cu care interacționați.

  • Exemple:

    • Utilizatori: Informații despre utilizatori
      • /users, /me
    • Grupuri: Lucrul cu grupuri
      • /groups
    • Evenimente: Preluare evenimente din calendar
      • /users/{userId}/events

Utilizatori

Grupuri

Evenimente

Implementarea securității Azure pentru dezvoltatori

Parametri de interogare

  • Opțiuni pentru filtrare, sortare sau selectare date

  • Select:

    • Alegerea câmpurilor specifice
    • $select=id,displayName

  • Filter:

    • Filtrarea datelor
    • $filter=startswith(displayName, 'John')

  • Top:

    • Limitarea numărului de rezultate
    • $top=5

Parametri de interogare - Select

  Parametri de interogare - Filter

  Parametri de interogare - Top

Implementarea securității Azure pentru dezvoltatori

Headere

Transportă metadate în cereri și răspunsuri HTTP

Două tipuri de headere: Standard și specifice API

Headere

  • Standard: Comune tuturor cererilor
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • Specifice API: Variază în funcție de API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Implementarea securității Azure pentru dezvoltatori

Să exersăm!

Implementarea securității Azure pentru dezvoltatori

Preparing Video For Download...