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 hizmetle ilgili etkinlikleri raporlayan 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ı, kullanıcıya göre düzenlenen etkinlikleri listeler.
Reports API'de kullanılan yaygın terimlerin listesi aşağıda verilmiştir:
- Etkinlik raporları
Etkinlik raporları, belirli bir Google Workspace uygulaması veya hizmetindeki etkinliklerle ilgili bilgileri listeler. 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, uygulamaya veya hizmete göre listelenen bazı örnek etkinlik raporları verilmiştir:
- Yönetici etkinliği raporları, Yönetici Konsolu'nu kullanan yöneticilerin gerçekleştirdiği etkinlikleri gösterir. Örneğin, Yönetici Konsolu'nu kullanarak yöneticilerin bir kullanıcının adını değiştirdiği tüm durumların listesini alabilirsiniz.
- Google Drive etkinlik raporları, alanınızın kullanıcılarının Drive dokümanlarını nasıl düzenlediğini ve görüntülediğini listeler. Ö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 hesaplarına ne zaman giriş ve çıkış yaptıkları hakkında bilgi sağlar. Örneğin, belirli bir dönemde alanınız için yapılan tüm girişlerin raporunu alabilirsiniz.
- Mobil etkinlik raporları, Google Mobil Yönetimi tarafından yönetilen mobil cihazların kullanıldığı etkinlikleri gösterir. Örneğin, kullanıcılar yeni bir cihaz kaydettiğinde bildirim alabilirsiniz.
- OAuth jetonu etkinlik raporları, kullanıcılarınızın üçüncü taraf web siteleri ve uygulamaları tarafından kullanılan yetkilendirme jetonlarını verdiği veya iptal ettiği etkinlikleri listeler. Bir kullanıcının Google Workspace verilerine erişen tüm üçüncü tarafların 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. API'yi kullanarak kullanıcılarla ilgili belirli bilgileri isteyebilirsiniz.
- 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 gerçekleştirdiği etkinlikleri gösterir. Bu raporlar özelleştirilebilir ve belirli kullanım bilgileri için filtrelenebilir. Bu kullanım bilgileri uygulama türüne göre düzenlenir ve ilgili uygulamaya özel bilgileri içerir.
- Öğe kullanım raporları, hesabınızın kullanıcıları tarafından Currents uygulamasında kullanılan öğelerle ilgili etkinlikleri listeler.
- Bildirimler
- Reports API, kaynaklarda yapılan değişiklikler gibi etkinlikleri izlemenize olanak tanıyan bildirimler sağlar. İzlediğiniz bir kaynak değiştiğinde Reports API size bildirim gönderir. Reports API'yi ayarlama ve bu API'den bildirim alma hakkında daha fazla bilgi için Push Bildirimleri Alma başlıklı kılavuzu 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 dillerine göre listelenen Hızlı Başlangıç'ı kullanın. Hesabınızı ayarlama hakkında genel bilgileri okumak için bu bölümde ilerleyebilirsiniz.
Yetkilendirme bölümünde, Google Workspace uygulamalarından ve hizmetlerinden kullanıcı verileri elde etmek için OAuth 2.0 erişim jetonlarını nasıl kullanacağınız gösterilir.
Belirli bir kaynak türünün veya yöntemin ayrıntılarını öğrenmek için API referansını inceleyin.
Daha fazla bilgi için Admin SDK API sorun izleyicisine, Google Workspace Developers blog'una ve Google Workspace Yönetici Yardım Merkezi'ne göz atın.