Reports API'ye Genel Bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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 sunar:
- Google Drive veya Yönetici Konsolu gibi belirli bir uygulama ya da hizmetle ilgili etkinlikleri bildiren etkinlik raporları.
- Kullanıcıların neden olduğu çalışma alanı etkinliklerini listeleyen kullanım raporları.
- Müşteri kullanım raporlarında, alanınızdaki tüm kullanıcıların etkinlikleri listelenir.
- Kullanıcı kullanım raporlarında, kullanıcıya göre düzenlenen etkinlikler listelenir.
Reports API'de kullanılan yaygın terimlerin listesini aşağıda bulabilirsiniz:
- Etkinlik raporları
Etkinlik raporlarında, belirli bir Google Workspace uygulamasındaki veya hizmetindeki etkinliklerle ilgili bilgiler listelenir. Etkinlik raporları; tarihi, saati, kullanıcıyı ve etkinlik türünü içerir. API referansında, etkinlik raporlarının ve içerdiği bilgilerin tam listesi yer alır.
Uygulamaya veya hizmete göre listelenmiş bazı örnek etkinlik raporlarını aşağıda bulabilirsiniz:
- Yönetici etkinliği raporları, yöneticilerin Yönetici Konsolu'nu kullanarak 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 zamanların listesini alabilirsiniz.
- Google Drive etkinlik raporları
alanınızdaki kullanıcıları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 etkinliklerinin listesini alabilirsiniz.
- Giriş etkinliği raporları, hesap kullanıcılarınızın hesaplarına ne zaman giriş ve çıkış yaptığı hakkında bilgi sağlar. Örneğin, belirli bir dönemdeki alanınızla ilgili 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 etkinliği 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. Kullanıcının Google Workspace verilerine yapılan 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ılarla ilgili belirli bilgileri istemek için API'yi kullanabilirsiniz.
- Müşteri kullanım raporları
hesabınızdaki ayrıntılı uygulama ve hizmet etkinliklerini listeler. Bu kullanım bilgileri, uygulama türüne göre düzenlenir ve söz konusu uygulamaya özel bilgileri içerir.
- Kullanıcı kullanım raporları
hesabınızın kullanıcılarının etkinliklerini gösterir. Bu raporlar, belirli kullanım bilgileri için özelleştirilebilir ve filtrelenebilir. Bu kullanım bilgileri uygulama türüne göre düzenlenir ve ilgili uygulamaya özel bilgiler 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, kaynaklardaki değişiklikler gibi etkinlikleri izlemenize olanak tanıyan bildirimler sağlar. Bir kaynağı izlerken bu kaynak değiştiğinde Reports API size bildirim gönderir. Rapor API'sinden bildirim alma ve ayarlama hakkında daha fazla bilgi için Push Bildirimleri Alma kılavuzuna bakın.
Sonraki adımlar
Rapor API'si hakkında bilgi edinmek ve nasıl çalıştığını görmek için sol gezinme çubuğunda programlama diline göre listelenen bir Hızlı Başlangıç kılavuzu kullanın. Hesabınızı ayarlama hakkında genel bilgi edinmek için bu bölümü de inceleyebilirsiniz.
Yetkilendirme bölümünde, Google Workspace uygulamaları ve hizmetlerinden kullanıcı verilerini almak için OAuth 2.0 erişim jetonlarının nasıl kullanılacağı açıklanmaktadır.
Belirli bir kaynak türü veya yöntemin ayrıntılarını bulmak için API referansına bakın.
Daha fazla bilgi için Admin SDK API sorun izleyici, Google Workspace Developers blogu ve Google Workspace Yönetici Yardım Merkezi'ne bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
