Padlet MCP'den Yönetici Analitiği'ni nasıl isteyebilirim?

Carla Sese’s profile pictureUpdated 4 gün önce by Carla Sese

Sayıları okulunuzun veya ekibinizin Yönetici Panosu istediğiniz şekilde ayrıştırmıyor mu? Padlet MCP'yi bir yapay zekâ asistanına bağlayın ve okul, sınıf veya ekip analizlerini günlük dille isteyin ya da kuruluş analizleri API'sini kendiniz çağırın.

REST referansının tamamı (metrik kataloğu, istek biçimleri ve hata kodları) için docs.padlet.dev adresindeki Kuruluş analizlerini okuma sayfasına bakın.

Kimler için?

Bu makale şu kişilere yöneliktir:

  • Padlet for Schools veya Ekip hesaplarının sahipleri ve yöneticileri
  • Sınıf hesaplarının sahipleri ve öğretmenleri

MCP yolunu kullanmak için kod yazmanız gerekmez. API yolu, Genel API ile hâlihazırda çalışan ileri düzey kullanıcılar için isteğe bağlıdır.

Mevcut olanlar

Ayarlar'daki kuruluşunuzun Analizler sayfasında, geçerli faturalandırma dönemi için özenle düzenlenmiş sekmeler zaten bulunur. Okullarda ve sınıflarda Genel Bakış, Kullanım, Etki, Güvenlik, En çok kullananlar ve Tüm kullanıcılar sekmeleri yer alır. Ekiplerde Genel, Padlet'ler ve Kullanıcılar sekmeleri bulunur. Ekibinizde yeni Analizler sayfası (beta) varsa Genel Bakış, Kullanım, Etki, En çok kullananlar ve Tüm kullanıcılar sekmeleri gösterilir.

Hızlı ve görsel bir genel görünüm istediğinizde panoyu kullanın. Sekmelerin net bir yanıt vermediği özel bir kırılıma ihtiyaç duyduğunuzda MCP'yi veya API'yi kullanın.

MCP / API neler sunar?

Pano, özenle düzenlenmiş sekmeler sunar. MCP ve API ise tam olarak ihtiyaç duyduğunuz kırılımı istemenizi sağlar:

  • Yapay zekâ istemcinizde günlük dille sorular ("Geçen faturalandırma döneminde hangi öğretmenler etkin değildi?")
  • Etkileşim, üyelik ve içerik güvenliği metriklerinin özel birleşimleri
  • Bir tarih aralığını kapsayan aylık seriler
  • Role göre kırılımlar (öğretmenler ve öğrenciler, içerik oluşturanlar ve katkıda bulunanlar)
  • İstediğiniz ölçüte göre sıralanmış en popüler padlet'ler, kullanıcılar ve medya
  • QBR veya yenileme sunumuna yapıştırabileceğiniz yanıtlar
İçerik güvenliği metrikleri (taranan öğeler, işaretlenen öğeler, yakalama oranı) yalnızca okullar ve sınıflar için kullanılabilir. Ekip kuruluşlarında bu metrikleri istemek sıfır değil, hata döndürür.

Padlet MCP ile hızlı başlangıç

  1. Yapay zekâ istemcinizde Padlet MCP'yi bağlayın. Sunucu URL'si olarak https://mcp.padlet.com adresini kullanın. Kurulum adımlarının tamamı Padlet MCP Sunucusu sayfasında yer alır.
  2. Sorgulamak istediğiniz kuruluşta yönetici olarak oturum açıp yetki verin. Sınıf hesabında öğretmenler de analizleri alabilir.
  3. Günlük dille sorun. Dahili araçların adını belirtmeniz gerekmez. Yapay zekâ asistanına okulunuz, sınıfınız veya ekibiniz hakkında öğrenmek istediklerinizi söyleyin; sizin adınıza Padlet MCP'yi kullanır.

Örnek:

Belirli bir MCP istemcisi analiz yanıtlarını henüz göstermiyorsa MCP uyumlu başka bir istemci deneyin veya bunun yerine kuruluş analizleri API'sini kullanın. İstemcilerin desteği sunucunun gerisinde kalabilir.
Asistanınız sizin adınıza işlem yapar. Yalnızca oturum açtığınız hesabın görme yetkisine sahip olduğu analizleri alabilir.

İsteğe bağlı: kuruluş analizleri API'si

Kendiniz bir komut dosyası mı yazmak istiyorsunuz? Yönetici API anahtarıyla (veya Sınıf hesabında öğretmen anahtarıyla) Genel API'yi kullanın.

  1. Ayarlar'daki Geliştirici sayfasından bir API anahtarı oluşturun veya kopyalayın. Ayrıntılar Genel API makalesinde yer alır.
  2. GET /me?include=organizations isteğiyle kuruluş kimliğinizi bulun. wksp_ ile başlayan kimliği kullanmanız gerekir. padlet.org üzerindeki org_ kuruluşları bu uç nokta tarafından henüz desteklenmiyor.
  3. İstediğiniz metrikleri içeren bir POST isteğini /organizations/{org_id}/analytics adresine gönderin.
  4. Yanıt 202 ise veya meta.pending boş değilse, Retry-After süresini bekleyin ve aynı isteği yeniden gönderin. Analizler arka planda hesaplandığından, beklemedeki bir metrik yanıtta bulunmaz. Bunu asla sıfır olarak değerlendirmeyin.
İstek biçimlerinin tamamı, metrik kataloğu ve örnekler Kuruluş analizlerini okuma sayfasında yer alır.

Kimler kullanabilir?

Padlet MCP ve API üzerinden kuruluş analizlerine Padlet for Schools ve Ekip hesaplarının sahipleri ve yöneticileri, ayrıca Sınıf hesaplarının sahipleri ve öğretmenleri erişebilir. Bu özelliği etkinleştirmesi için Padlet'e başvurmanız gerekmez.

Şimdilik yalnızca wksp_ kuruluşları desteklenmektedir.

Örnek istemler

Bunlar, MCP istemcinize yapıştırabileceğiniz başlangıç istemleridir. İfadeleri okulunuza, sınıfınıza veya ekibinize uyacak şekilde düzenleyin. Müşterilere sunacağınız bir sunum hazırlarken sayıları Analizler sayfasındaki verilerle karşılaştırın.

  • "Bu faturalandırma döneminde okulumuzda kaç etkin öğretmen var ve kaç lisansımız bulunuyor; hangi aylarda düşüş yaşandı?"
  • "Kuruluşumuzdaki hangi padlet'ler en çok görüntülenmeye sahip? En iyi 3 pano/sandbox'ı listele."
  • "Öğretmen rolündeki hangi üyeler son 12 aydır Padlet'i kullanmadı?"
  • "<ouremaildomain.edu> e-posta alan adına sahip olmayan kaç üyemiz var?"
İhtiyacınız olan kırılımı isteyin: aylık seri, role göre filtre, gönderi veya ziyaretçi sayısına göre en popüler padlet'ler ya da okul veya sınıf için içerik güvenliği toplamları. Asistan, sorunuzu kullanılabilir metriklerle eşleştirir.

Panonun hâlâ daha iyi olduğu alanlar

Aşağıdakileri istediğinizde Ayarlar'daki Analizler sayfasını kullanın:

  • Görsel Genel Bakış bandı, Öne çıkan fırsat bildirimleri ve tek tıklamayla PD talebi
  • Arama, rol filtreleri ve tek tıklamayla CSV indirme olanağı sunan Tüm kullanıcılar / Kullanıcılar tablosu
  • Genel Bakış sekmesinden seçili dönem için etkin ve etkin olmayan öğretmenlerin indirilebilir listeleri (okullar ve sınıflar)

Özenle düzenlenmiş sekmeler, bir demo veya yenileme görüşmesi için ihtiyacınız olan soruya tam yanıt vermediğinde MCP ve API öne çıkar.

Sınırlamalar:

  • İstek sınırı: 202 yanıtından sonraki sorgulamalar da dâhil olmak üzere, API anahtarı ve kuruluş başına saatte 60 istek
  • Tarih aralığı: tek istekte en fazla 24 ay
  • İçerik güvenliği: yalnızca okullar ve sınıflar. Ekiplerde bu metrikler için 400 hatası alınır
  • Üyelik sayıları: geçmiş bir tarihte kimlerin üye olduğunu değil, mevcut üye listesini yansıtır
  • Beklemede ≠ sıfır: hâlâ hesaplanan bir metrik yanıtta bulunmaz; bunu sıfır olarak değerlendirmeyin
  • Kuruluş türü: şimdilik yalnızca wksp_

Sık sorulan sorular

Analizleri istediğimde neden 404 hatası alıyorum?

Tüm erişim retleri aynı şekilde görünür: kuruluşun bilinmemesi veya erişim izninizin olmaması durumunda 404 döndürülür. İlgili kuruluşta yönetici (veya Sınıfta öğretmen) olarak oturum açtığınızı ve kuruluşun wksp_ türünde olduğunu kontrol edin. Sorun devam ederse destek ekibiyle iletişime geçin.

Kod yazmam gerekiyor mu?

Hayır. Padlet MCP'yi bağlayın, yönetici olarak oturum açın ve günlük dille sorun. API yolu, Genel API'yi hâlihazırda kullanan geliştiriciler ve ileri düzey kullanıcılar için isteğe bağlıdır.

Bu, Genel API ile aynı mı?

İlişkili ancak aynı ürün arayüzü değil. Genel API, API anahtarı kullanan geliştiricilere yöneliktir. Padlet MCP ise oturum açarak yetki verdiğiniz yapay zekâ asistanları içindir. Her ikisi de kuruluş analizlerine erişebilir; ikisini birden veya herhangi birini kullanabilirsiniz.

Öğrenciler veya yönetici olmayanlar kuruluş analizlerini bu şekilde görebilir mi?

Hayır. Analizler için kuruluş yöneticisi veya Sınıfta öğretmen olmanız gerekir. Asistanın erişimi, oturum açtığınız hesabın erişimiyle tamamen aynıdır; daha fazlası değil.

MCP istemcim analizleri bilmiyor gibi görünüyor. Ne yapabilirim?

Bazı istemcilerin araç listesini güncellemesi zaman alabilir. Padlet MCP bağlantısını kesip yeniden bağlanmayı, MCP uyumlu başka bir istemciye geçmeyi veya kuruluş analizleri API'sini doğrudan kullanmayı deneyin. Sorun devam ederse bize ulaşın.

İlgili makaleler

Was this article helpful?

Related articles