Memulai Memanggil Microsoft Graph API – Kode dengan Dan Blog

Dalam posting ini saya akan membagikan tip singkat tentang cara mulai memanggil Microsoft Graph API. Jika Anda baru mengenal Microsoft Graph, berikut definisi singkatnya untuk Anda:

Microsoft Graph menyediakan API yang aman dan terpadu yang dapat digunakan untuk mengakses Microsoft 365 serta data dan kecerdasan cloud lainnya.

CATATAN: Anda dapat menonton video tentang semua yang tercakup di sini di saluran YouTube Pengembang Microsoft 365.

Singkatnya, Anda dapat menggunakan Microsoft Graph untuk mengambil informasi tentang pengguna, grup, email, obrolan Teams, file OneDrive, rapat, tugas daftar tugas, dan banyak lagi, lalu menarik data tersebut ke dalam aplikasi tempat pengguna Anda bekerja setiap hari.

Mengambil Data Microsoft 365

Artinya, jika saya adalah pengguna yang menggunakan aplikasi Anda, saya dapat masuk dan melihat daftar rapat atau file saya yang terkait dengan topik tertentu yang tercantum langsung di aplikasi. Atau, jika saya memiliki email yang terkait dengan skenario tertentu, saya dapat melihat email saya setelah masuk. Tentu saja, ini semua dilakukan dengan cara yang aman di mana pengguna harus menyetujui dan memberikan persetujuan mereka.

Sebelum melanjutkan, penting untuk mengklarifikasi satu hal: Microsoft Graph bukanlah DB grafik atau GraphQL. Microsoft Graph adalah RESTful API sehingga prinsip yang sama yang mungkin Anda gunakan dengan API lain (Web API dengan .NET, API yang diekspos menggunakan Express / Node.js, dan sebagainya) dapat digunakan.

Untuk memulai dengan Microsoft Graph Anda dapat menggunakan Microsoft Graph Explorer. Di situs web Microsoft Graph Explorer, Anda dapat melihat API grafik Microsoft yang tersedia dan berlatih menggunakan semuanya dalam batasan browser. Misalnya, pada gambar di bawah ini Anda akan melihat ada area di mana Anda dapat memilih kueri sampel untuk dijalankan dan area di mana URL API ditentukan. Pilih opsi “profil saya” di Kueri sampel bagian untuk memulai.

Kueri sampel penjelajah Microsoft Graph
Microsoft Graph menjelajahi URL API

Seperti yang disebutkan, Microsoft Graph adalah RESTful API yang digunakan untuk mendapatkan data Microsoft 365. Misalnya, saya dapat memanggil API profil dan mendapatkan profil pengguna yang masuk menggunakan URL berikut (ditampilkan di atas pada gambar sebelumnya):

https://graph.microsoft.com/v1.0/me

Saat pertama kali masuk ke Microsoft Graph Explorer, Anda tidak akan login. Itu berarti Anda akan mendapatkan data anonim kembali untuk profil pengguna dan Anda akan melihat nama tampilan Megan Bowen digunakan. Anda juga bisa mendapatkan beberapa informasi tentang alamat email Megan dan beberapa info lainnya juga di profilnya. Perhatikan bahwa data yang dikembalikan adalah data JSON (JavaScript Object Notation).

Data JSON dikembalikan untuk profil pengguna.

Selain itu, Anda dapat menjalankan kueri lain. Jika Anda ingin melakukan ini untuk Megan (pengguna anonim yang akan Anda lihat) Anda dapat membiarkannya apa adanya, tetapi jika Anda ingin melakukannya sendiri, Anda dapat masuk dengan kredensial Anda atau lebih baik lagi Anda dapat masuk dengan penyewa pengembang gratis sehingga Anda dapat bermain-main dengan aman.

Jika Anda membuka bagian kueri sampel dan mengklik “foto saya”, Anda akan melihat foto Megan ditampilkan di browser. Lihatlah URL API dan Anda akan melihat nilai berikut ini ditampilkan:

https://graph.microsoft.com/v1.0/me/photo/$value

Jika Anda menghapus $ nilai, Anda akan mendapatkan kembali data JSON tentang gambar tersebut. Perhatikan bahwa ini berisi tinggi, lebar, dan beberapa data lainnya juga.

Data yang dikembalikan tentang gambar profil pengguna.

Anda juga dapat mengakses pesan email Megan. Saya ingin menekankan lagi bahwa Anda harus memiliki pengguna yang masuk yang telah setuju untuk mengakses informasi ini. Jika Anda ingin menampilkan pesan email pengguna, mereka harus masuk terlebih dahulu. Jika mereka menyetujuinya, Anda dapat menarik email mereka dan menampilkannya di aplikasi.

Misalnya, mungkin Anda sedang mengerjakan aplikasi penjualan sekarang, dan Anda ingin memasukkan email khusus penjualan sehingga mereka dapat melihat apa yang telah mereka katakan sebelumnya kepada pelanggan. Anda dapat memfilter berdasarkan subjek, misalnya, lalu menampilkan isi pesan kepada staf penjualan setelah mereka masuk.

Anda juga dapat mengambil acara kalender dan banyak lagi. Jika Anda membuka kotak pencarian kueri sampel (kiri bawah layar) dan mengetik “kalender”, Anda akan melihat bahwa Anda dapat mengambil acara kalender untuk minggu depan atau semua acara. Mungkin Anda menginginkan semua acara yang akan datang tetapi hanya ingin mengambil data dalam jumlah terbatas tentang setiap acara. Jika Anda mengklik kueri “semua acara di kalender saya”, Anda bisa mendapatkan data itu. Melihat JSON yang dikembalikan, Anda akan melihat cukup banyak data yang ditampilkan.

Jika Anda hanya menginginkan file subyek, tubuh, dan mungkin Mulailah dan akhir tanggal, Anda dapat menyesuaikannya di URL dengan menghapus properti yang tidak Anda inginkan. Properti yang akan dikembalikan dalam data JSON dikontrol menggunakan $ pilih parameter kueri.

Mengubah properti yang dikembalikan menggunakan parameter kueri $ select.

Sekarang jalankan kueri dan Anda akan melihat bahwa hanya properti tersebut yang dikembalikan. Anda juga dapat menambahkan berbagai jenis pemfilteran jika Anda mau. Anda dapat menambahkan & ke akhir URL dan ketik $ filter sama dengan “kueri Anda di sini”. Atau, Anda dapat mengambil sesuatu yang lebih besar dari tanggal, kurang dari tanggal, dll. Berikut adalah contoh penggunaan memberikan untuk mengambil acara kalender yang lebih besar atau sama dengan tanggal tertentu. Perhatikan penggunaan file $ filter parameter kueri.

Menggunakan $ filter query paramter

Setelah memilih Jalankan kueri Anda akan memiliki data yang sama, tetapi sekarang telah difilter dan hanya properti spesifik yang Anda pilih yang dikembalikan! Informasi tambahan tentang memilih, membuat kueri, menyortir, dan melakukan jenis operasi lainnya dapat ditemukan di https://aka.ms/msgraph-query-params.

Kesimpulan

Saya harap ini membantu Anda saat Anda mulai menggunakan Microsoft Graph. Jika Anda menginginkan pendekatan yang lebih praktis dalam menggunakan Graph Explorer dan Microsoft Graph secara umum, lihat jalur pembelajaran Microsoft Graph Fundamentals gratis yang tersedia di https://aka.ms/learn-graph.