Method: activities.list

فهرستی از فعالیت‌ها را برای حساب و برنامه یک مشتری خاص مانند برنامه کنسول Admin یا برنامه Google Drive بازیابی می‌کند. برای اطلاعات بیشتر، به راهنمای گزارش‌های فعالیت سرپرست و Google Drive مراجعه کنید. برای اطلاعات بیشتر در مورد پارامترهای گزارش فعالیت، به راهنمای مرجع پارامترهای فعالیت مراجعه کنید.

درخواست HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
userKey or all

string

نشان دهنده شناسه نمایه یا ایمیل کاربری است که داده ها باید فیلتر شوند. می‌تواند برای all اطلاعات باشد، یا userKey برای شناسه نمایه Google Workspace منحصربه‌فرد کاربر یا آدرس ایمیل اصلی او باشد. نباید کاربر حذف شده باشد. برای کاربر حذف شده، users.list در Directory API با showDeleted=true فراخوانی کنید، سپس ID برگشتی به عنوان userKey استفاده کنید.

applicationName

enum ( ApplicationName )

نام برنامه ای که رویدادها باید برای آن بازیابی شوند.

پارامترهای پرس و جو

پارامترها
actorIpAddress

string

آدرس پروتکل اینترنت (IP) میزبانی که رویداد در آن انجام شده است. این یک راه اضافی برای فیلتر کردن خلاصه گزارش با استفاده از آدرس IP کاربری است که فعالیتش گزارش شده است. این آدرس IP ممکن است مکان فیزیکی کاربر را منعکس کند یا نباشد. به عنوان مثال، آدرس IP می تواند آدرس سرور پروکسی کاربر یا یک آدرس شبکه خصوصی مجازی (VPN) باشد. این پارامتر از هر دو نسخه آدرس IPv4 و IPv6 پشتیبانی می کند.

customerId

string

شناسه منحصر به فرد مشتری برای بازیابی داده ها.

endTime

string

پایان بازه زمانی نشان داده شده در گزارش را تنظیم می کند. تاریخ در قالب RFC 3339 است، برای مثال 2010-10-28T10:26:35.000Z. مقدار پیش فرض زمان تقریبی درخواست API است. یک گزارش API دارای سه مفهوم زمانی اساسی است:

  • تاریخ درخواست API برای گزارش : زمانی که API گزارش را ایجاد و بازیابی کرد.
  • زمان شروع گزارش : ابتدای بازه زمانی نشان داده شده در گزارش. startTime باید قبل از endTime (در صورت مشخص شدن) و زمان فعلی هنگام درخواست باشد، در غیر این صورت API خطایی را برمی‌گرداند.
  • زمان پایان گزارش : پایان بازه زمانی نشان داده شده در گزارش. به عنوان مثال، بازه زمانی رویدادهای خلاصه شده در یک گزارش می تواند از آوریل شروع شود و در ماه می به پایان برسد. گزارش خود را می توان در ماه اوت درخواست کرد.
اگر endTime مشخص نشده باشد، گزارش تمام فعالیت‌ها را از startTime تا زمان فعلی یا 180 روز اخیر را برمی‌گرداند اگر startTime در گذشته بیش از 180 روز باشد.

eventName

string

نام رویدادی که توسط API درخواست شده است. هر eventName مربوط به یک سرویس یا ویژگی خاص Google Workspace است که API آن را در انواع رویدادها سازماندهی می کند. یک مثال، رویدادهای تقویم Google در گزارش‌های برنامه کنسول مدیریت است. ساختار type تنظیمات تقویم دارای تمام فعالیت‌های Calendar eventName گزارش‌شده توسط API است. وقتی یک سرپرست یک تنظیم تقویم را تغییر می‌دهد، API این فعالیت را در پارامترهای type تنظیمات تقویم و eventName گزارش می‌کند. برای اطلاعات بیشتر در مورد رشته ها و پارامترهای پرس و جو eventName ، لیست نام رویدادها را برای برنامه های مختلف در بالا در applicationName ببینید.

filters

string

رشته پرس و جو filters یک لیست جدا شده با کاما است که از پارامترهای رویداد که توسط عملگرهای رابطه ای دستکاری شده اند تشکیل شده است. پارامترهای رویداد به شکل {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

این پارامترهای رویداد با یک eventName خاص مرتبط هستند. اگر پارامتر درخواست متعلق به eventName نباشد، یک گزارش خالی برگردانده می‌شود. برای اطلاعات بیشتر در مورد فیلدهای eventName موجود برای هر برنامه و پارامترهای مرتبط با آنها، به جدول ApplicationName بروید، سپس روی صفحه Activity Events در پیوست برای برنامه مورد نظر خود کلیک کنید.

در مثال‌های فعالیت Drive زیر، فهرست بازگشتی شامل تمام رویدادهای edit است که مقدار پارامتر doc_id با شرایط تعریف‌شده توسط عملگر رابطه‌ای مطابقت دارد. در مثال اول، درخواست تمام اسناد ویرایش شده را با مقدار doc_id برابر با 12345 برمی گرداند. در مثال دوم، گزارش هر سند ویرایش شده ای را که مقدار doc_id برابر با 98765 نیست، برمی گرداند. عملگر <> در رشته درخواست درخواست کدگذاری شده است ( %3C%3E ):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

یک پرس و جو filters از این عملگرهای رابطه ای پشتیبانی می کند:

  • == —'برابر'.
  • <> - "برابر نیست". باید با URL رمزگذاری شده باشد (%3C%3E).
  • < —'کمتر از'. باید با URL رمزگذاری شده باشد (%3C).
  • <= —'کمتر یا مساوی'. باید با URL رمزگذاری شده باشد (%3C=).
  • > 'بیشتر از'. باید با URL رمزگذاری شده باشد (%3E).
  • >= —'بیشتر یا مساوی'. باید با URL رمزگذاری شده باشد (%3E=).

توجه: API چندین مقدار از یک پارامتر را نمی پذیرد. اگر یک پارامتر بیش از یک بار در درخواست API ارائه شود، API فقط آخرین مقدار آن پارامتر را می‌پذیرد. علاوه بر این، اگر یک پارامتر نامعتبر در درخواست API ارائه شود، API آن پارامتر را نادیده می گیرد و پاسخ مربوط به پارامترهای معتبر باقی مانده را برمی گرداند. اگر هیچ پارامتری درخواست نشود، تمام پارامترها برگردانده می شوند.

maxResults

integer

تعیین می کند که چه تعداد رکورد فعالیت در هر صفحه پاسخ نشان داده می شود. به عنوان مثال، اگر درخواست maxResults=1 را تنظیم کند و گزارش دارای دو فعالیت باشد، گزارش دارای دو صفحه است. ویژگی nextPageToken پاسخ دارای نشانه صفحه دوم است. رشته پرس و جو maxResults در درخواست اختیاری است. مقدار پیش فرض 1000 است.

orgUnitID

string

شناسه واحد سازمانی برای گزارش. سوابق فعالیت فقط برای کاربرانی که به واحد سازمانی مشخص شده تعلق دارند نشان داده می شود.

pageToken

string

نشانه برای تعیین صفحه بعدی. یک گزارش با چندین صفحه دارای ویژگی nextPageToken در پاسخ است. در درخواست بعدی خود برای دریافت صفحه بعدی گزارش، مقدار nextPageToken را در رشته پرس و جو pageToken وارد کنید.

startTime

string

شروع بازه زمانی نشان داده شده در گزارش را تنظیم می کند. تاریخ در قالب RFC 3339 است، برای مثال 2010-10-28T10:26:35.000Z. این گزارش همه فعالیت‌ها را از startTime تا endTime برمی‌گرداند. startTime باید قبل از endTime (در صورت مشخص شدن) و زمان فعلی هنگام درخواست باشد، در غیر این صورت API خطایی را برمی‌گرداند.

groupIdFilter

string

شناسه‌های گروه جدا شده با کاما (مبهم) که فعالیت‌های کاربر بر روی آنها فیلتر می‌شوند، یعنی پاسخ فقط شامل فعالیت‌هایی برای آن دسته از کاربرانی می‌شود که بخشی از حداقل یکی از شناسه‌های گروه ذکر شده در اینجا هستند. قالب: "id:abc123,id:xyz456"

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

قالب JSON برای مجموعه ای از فعالیت ها.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
فیلدها
kind

string

نوع منبع API. برای گزارش فعالیت، مقدار reports#activities است.

etag

string

ETag منبع

items[]

object ( Activity )

ثبت هر فعالیت در پاسخ.

nextPageToken

string

نشانه برای بازیابی صفحه بعدی گزارش. مقدار nextPageToken در رشته پرس و جو pageToken درخواست استفاده می شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

نام برنامه

Enums
access_transparency

گزارش فعالیت Google Workspace Access Transparency، اطلاعات مربوط به انواع مختلف رویدادهای فعالیت Access Transparency را گزارش می‌کند.

admin

گزارش‌های فعالیت برنامه کنسول مدیریت، اطلاعات حساب مربوط به انواع مختلف رویدادهای فعالیت سرپرست را برمی‌گرداند.

calendar

گزارش‌های فعالیت برنامه Google Calendar اطلاعات مربوط به رویدادهای مختلف فعالیت تقویم را برمی‌گرداند.

chat فعالیت Chat اطلاعات مربوط به رویدادهای مختلف فعالیت گپ را گزارش می دهد.
drive

گزارش‌های فعالیت برنامه Google Drive اطلاعات مربوط به رویدادهای مختلف فعالیت Google Drive را برمی‌گرداند. گزارش فعالیت Drive فقط برای مشتریان Google Workspace Business و Enterprise در دسترس است.

gcp گزارش‌های فعالیت برنامه Google Cloud Platform اطلاعات مربوط به رویدادهای مختلف فعالیت GCP را برمی‌گرداند.
gplus گزارش‌های فعالیت برنامه Google+‎ اطلاعات مربوط به رویدادهای مختلف فعالیت Google+ ‎ را برمی‌گرداند.
groups

گزارش‌های فعالیت برنامه Google Groups اطلاعات مربوط به رویدادهای مختلف فعالیت گروه‌ها را برمی‌گرداند.

groups_enterprise

گزارش فعالیت Enterprise Groups اطلاعات مربوط به رویدادهای مختلف فعالیت گروه Enterprise را گزارش می دهد.

jamboard فعالیت Jamboard اطلاعات مربوط به رویدادهای مختلف فعالیت Jamboard را گزارش می‌کند.
login

گزارش‌های فعالیت برنامه ورود به سیستم، اطلاعات حساب مربوط به انواع مختلف رویدادهای فعالیت ورود به سیستم را برمی‌گرداند.

meet گزارش فعالیت Meet Audit اطلاعات مربوط به انواع مختلف رویدادهای فعالیت Meet Audit را برمی گرداند.
mobile گزارش فعالیت حسابرسی دستگاه اطلاعات مربوط به انواع مختلف رویدادهای فعالیت حسابرسی دستگاه را برمی گرداند.
rules

گزارش فعالیت قوانین اطلاعات مربوط به انواع مختلف رویدادهای فعالیت قوانین را برمی گرداند.

saml

گزارش فعالیت SAML اطلاعات مربوط به انواع مختلف رویدادهای فعالیت SAML را برمی گرداند.

token

گزارش‌های فعالیت برنامه Token اطلاعات حساب مربوط به انواع مختلف رویدادهای فعالیت Token را برمی‌گرداند.

user_accounts

گزارش‌های فعالیت برنامه حساب‌های کاربری اطلاعات حساب مربوط به انواع مختلف رویدادهای فعالیت حساب‌های کاربری را برمی‌گرداند.

context_aware_access

گزارش فعالیت دسترسی آگاه از زمینه، اطلاعات مربوط به رویدادهای ممنوعه دسترسی کاربران را به دلیل قوانین دسترسی متن‌آگاه برمی‌گرداند.

chrome

گزارش فعالیت Chrome اطلاعات مربوط به مرورگر Chrome و رویدادهای سیستم عامل Chrome را برمی‌گرداند.

data_studio گزارش فعالیت Data Studio اطلاعات مربوط به انواع مختلف رویدادهای فعالیت Data Studio را برمی گرداند.
keep گزارش‌های فعالیت برنامه Keep اطلاعات مربوط به رویدادهای مختلف فعالیت Google Keep را برمی‌گرداند. گزارش فعالیت Keep فقط برای مشتریان Google Workspace Business و Enterprise در دسترس است.
vault فعالیت Vault اطلاعات مربوط به انواع مختلف رویدادهای فعالیت Vault را گزارش می دهد.

فعالیت

قالب JSON برای منبع فعالیت.

نمایندگی JSON
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
فیلدها
kind

string

نوع منبع API. برای گزارش فعالیت، مقدار audit#activity است.

etag

string

ETag ورودی.

ownerDomain

string

این دامنه ای است که تحت تأثیر رویداد گزارش قرار می گیرد. به عنوان مثال دامنه کنسول Admin یا مالک سند برنامه Drive.

ipAddress

string

آدرس IP کاربری که اقدام را انجام می دهد. این آدرس پروتکل اینترنت (IP) کاربر هنگام ورود به Google Workspace است، که ممکن است مکان فیزیکی کاربر را نشان دهد یا نباشد. به عنوان مثال، آدرس IP می تواند آدرس سرور پروکسی کاربر یا یک آدرس شبکه خصوصی مجازی (VPN) باشد. API از IPv4 و IPv6 پشتیبانی می کند.

events[]

object

رویدادهای فعالیت در گزارش

events[].type

string

نوع رویداد. سرویس یا ویژگی Google Workspace که مدیر آن را تغییر می‌دهد، در ویژگی type که یک رویداد را با استفاده از ویژگی eventName شناسایی می‌کند، شناسایی می‌شود. برای فهرست کامل دسته‌های type API، فهرست نام رویدادها را برای برنامه‌های مختلف در بالا در applicationName ببینید.

events[].name

string

نام رویداد. این نام خاص فعالیت گزارش شده توسط API است. و هر eventName به یک سرویس یا ویژگی خاص Google Workspace مربوط می شود که API آن را در انواع رویدادها سازماندهی می کند.
برای پارامترهای درخواست eventName به طور کلی:

  • اگر eventName داده نشود، گزارش تمام نمونه‌های ممکن eventName را برمی‌گرداند.
  • وقتی یک eventName درخواست می‌کنید، پاسخ API همه فعالیت‌هایی را که حاوی آن eventName هستند برمی‌گرداند.

برای اطلاعات بیشتر درباره ویژگی های eventName ، لیست نام رویدادها را برای برنامه های مختلف در بالا در applicationName ببینید.

events[].parameters[]

object

جفت مقدار پارامتر برای برنامه های مختلف. برای اطلاعات بیشتر در مورد پارامترهای eventName ، لیست نام رویدادها را برای برنامه های مختلف در بالا در applicationName ببینید.

events[].parameters[].messageValue

object

جفت مقدار پارامتر تو در تو مرتبط با این پارامتر. نوع مقدار پیچیده برای یک پارامتر به عنوان لیستی از مقادیر پارامتر برگردانده می شود. به عنوان مثال، پارامتر آدرس ممکن است مقداری به عنوان [{parameter: [{name: city, value: abc}]}] داشته باشد.

events[].parameters[].messageValue.parameter[]

object ( NestedParameter )

مقادیر پارامتر

events[].parameters[].name

string

نام پارامتر.

events[].parameters[].value

string

مقدار رشته پارامتر

events[].parameters[].multiValue[]

string

مقادیر رشته ای پارامتر.

events[].parameters[].intValue

string ( int64 format)

مقدار صحیح پارامتر

events[].parameters[].multiIntValue[]

string ( int64 format)

مقادیر صحیح پارامتر

events[].parameters[].boolValue

boolean

مقدار بولی پارامتر.

events[].parameters[].multiMessageValue[]

object

فعالیت ها.لیست اشیاء messageValue .

events[].parameters[].multiMessageValue[].parameter[]

object ( NestedParameter )

مقادیر پارامتر

id

object

شناسه منحصر به فرد برای هر رکورد فعالیت.

id.time

string

زمان وقوع فعالیت. این در زمان یونیکس در ثانیه است.

id.uniqueQualifier

string ( int64 format)

واجد شرایط منحصر به فرد اگر چندین رویداد زمان یکسان داشته باشند.

id.applicationName

string

نام برنامه ای که رویداد به آن تعلق دارد. برای مقادیر ممکن، لیست برنامه های کاربردی بالا را در applicationName ببینید.

id.customerId

string

شناسه منحصر به فرد برای حساب Google Workspace.

actor

object

کاربر در حال انجام عمل

actor.profileId

string

شناسه منحصر به فرد نمایه Google Workspace بازیگر. اگر بازیگر کاربر Google Workspace نباشد، ممکن است این مقدار وجود نداشته باشد، یا ممکن است شماره 105250506097979753968 باشد که به عنوان شناسه مکان‌نما عمل می‌کند.

actor.email

string

آدرس ایمیل اصلی بازیگر. در صورتی که هیچ آدرس ایمیل مرتبط با بازیگر وجود نداشته باشد، ممکن است غایب باشد.

actor.callerType

string

نوع بازیگر.

actor.key

string

فقط زمانی ارائه می شود که callerType KEY باشد. می‌تواند consumer_key درخواست‌کننده برای درخواست‌های OAuth 2LO API یا شناسه‌ای برای حساب‌های ربات باشد.