Reports API, kullanıcılarınızın Google Workspace etkinlikleri hakkındaki bilgilere erişmek için kullanabileceğiniz bir RESTful API'dir. Reports API, Admin SDK API'nin bir parçasıdır.
Reports API iki tür rapor sağlar:
- Google Drive veya Yönetici konsolu gibi belirli bir uygulama ya da hizmete ilişkin etkinlikleri bildiren Etkinlik raporları.
- Kullanıcıların neden olduğu çalışma alanı etkinliklerini listeleyen Kullanım raporları.
- Müşteri kullanım raporları, alanınızdaki tüm kullanıcılara ait etkinlikleri listeler.
- Kullanıcı kullanım raporları, etkinlikleri kullanıcıya göre organize ederek listeler.
Aşağıda, Reports API'de yaygın olarak kullanılan terimlerin bir listesi verilmiştir:
- Etkinlik raporları
Etkinlik raporlarında, belirli bir Google Workspace uygulamasındaki veya hizmetindeki etkinliklerle ilgili bilgiler listelenir. Etkinlik raporları tarih, saat, kullanıcı ve etkinlik türünü içerir. API referansı, etkinlik raporlarının ve içerdikleri bilgilerin tam listesini içerir. Aşağıda, uygulama veya hizmete göre listelenen bazı örnek etkinlik raporları verilmiştir:
- Yönetici etkinlik raporları, yöneticiler tarafından Yönetici konsolunu kullanarak gerçekleştirilen etkinlikleri gösterir. Örneğin, yöneticilerin Yönetici konsolunu kullanarak bir kullanıcının adını tüm değiştirme işlemlerinin listesini alabilirsiniz.
- Google Drive etkinlik raporlarında, alanınızdaki kullanıcıların Drive dokümanlarını nasıl düzenledikleri ve görüntüledikleri listelenir. Örneğin, belirli bir kullanıcının Drive'daki etkinliğinin listesini alabilirsiniz.
- Giriş etkinliği raporları, hesabınızın kullanıcılarının ne zaman hesaplarına giriş ve çıkış yaptıklarına dair bilgi sağlar. Örneğin, alan adınız için belirli bir dönemdeki tüm girişlerin raporunu alabilirsiniz.
- Mobil etkinlik raporları, Google Mobil Yönetimi tarafından yönetilen mobil cihazları kullanan etkinlikleri gösterir. Örneğin, kullanıcılar yeni bir cihaz kaydettirdiğinde bildirim alabilirsiniz.
- OAuth Jetonu etkinlik raporlarında, kullanıcılarınız üçüncü taraf web siteleri ve uygulamaları tarafından kullanılan yetkilendirme jetonları verdiği veya bunları iptal ettiği durumlarda gerçekleşen etkinlikleri listeler. Bir kullanıcının Google Workspace verilerine tüm üçüncü taraf erişimlerinin listesini almak için Reports API'yi kullanabilirsiniz.
- Kullanım raporları
Kullanım raporları, alanınızdaki Google Workspace etkinlikleri hakkında bilgi sağlar. Kullanıcılar hakkında belirli bilgileri istemek için API'yi kullanabilirsiniz.
- Müşteri kullanım raporları, hesabınızdaki uygulama ve hizmet etkinliklerini ayrıntılı olarak listeler. Bu kullanım bilgileri, uygulama türüne göre düzenlenir ve ilgili uygulamaya özel bilgileri içerir.
- Kullanıcı kullanım raporları, hesabınızın kullanıcılarının etkinliklerini gösterir. Bu raporlar özel kullanım bilgilerine göre özelleştirilebilir ve filtrelenebilir. Bu kullanım bilgileri, uygulama türüne göre düzenlenir ve ilgili uygulamaya özgü bilgileri içerir.
- Varlık kullanım raporları, Currents uygulamasında hesabınızın kullanıcıları tarafından kullanılan varlıklarla ilgili etkinlikleri listeler.
- Bildirimler
- Reports API, kaynaklarda yapılan değişiklikler gibi etkinlikleri izlemenize olanak tanıyan bildirimler sunar. Bir kaynağı izlerken bu kaynak değiştiğinde Reports API size bir bildirim gönderir. Reports API'den bildirim alma ve ayarlama hakkında daha fazla bilgi için Push Bildirimleri Alma kılavuzunu inceleyin.
Sonraki adımlar
Reports API hakkında bilgi edinmek ve nasıl çalıştığını görmek için, sol gezinme çubuğunda programlama diline göre listelenen Hızlı Başlangıç Kılavuzu'ndan yararlanın. Hesabınızı oluşturmayla ilgili genel bilgileri okumak için de bu bölüme devam edebilirsiniz.
Yetkilendirme bölümünde, Google Workspace uygulamalarından ve hizmetlerinden kullanıcı verileri almak için OAuth 2.0 erişim jetonlarının nasıl kullanılacağı gösterilmektedir.
Belirli bir kaynak türünün veya yöntemin ayrıntılarını bulmak için API referansı bölümüne bakın.