با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک اسکریپت Google Apps ایجاد کنید که درخواست‌هایی را به Admin SDK API ارسال می‌کند.
Quickstarts نحوه راه‌اندازی و اجرای برنامه‌ای را توضیح می‌دهد که Google Workspace API را فراخوانی می‌کند. این شروع سریع از یک رویکرد احراز هویت ساده استفاده می کند که برای یک محیط آزمایشی مناسب است. برای یک محیط تولید، توصیه می‌کنیم قبل از انتخاب اعتبارنامه‌های دسترسی مناسب برای برنامه‌تان، درباره احراز هویت و مجوز یاد بگیرید.
در Apps Script، راه‌اندازی‌های سریع Google Workspace از خدمات پیشرفته Google برای فراخوانی APIهای Google Workspace و رسیدگی به برخی جزئیات جریان احراز هویت و مجوز استفاده می‌کنند.
/** * List login events for a Google Workspace domain. * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list */functionlistLogins(){constuserKey='all';constapplicationName='login';constoptionalArgs={maxResults:10};try{constresponse=AdminReports.Activities.list(userKey,applicationName,optionalArgs);constactivities=response.items;if(!activities||activities.length===0){console.log('No logins found.');return;}// Print login eventsconsole.log('Logins:');for(constactivityofactivities){console.log('%s: %s (%s)',activity.id.time,activity.actor.email,activity.events[0].name);}}catch(err){// TODO (developer)- Handle exception from the Report APIconsole.log('Failed with error %s',err.message);}}
روی ذخیره کلیک کنید .
روی پروژه Untitled کلیک کنید، Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.
اسکریپت را پیکربندی کنید
Admin SDK API را فعال کنید
پروژه Apps Script را باز کنید.
روی codeویرایشگر کلیک کنید.
در کنار Services ، روی Add a service add کلیک کنید.
Admin SDK API را انتخاب کرده و روی Add کلیک کنید.
نمونه را اجرا کنید
در ویرایشگر Apps Script، روی Run کلیک کنید.
اولین باری که نمونه را اجرا می‌کنید، از شما می‌خواهد دسترسی را مجاز کنید:
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Create a\n[Google Apps Script](/apps-script/overview)\nthat makes requests to the Admin SDK API.\n\nQuickstarts explain how to set up and run an app that calls a\nGoogle Workspace API. This quickstart uses a\nsimplified authentication approach that is appropriate for a testing\nenvironment. For a production environment, we recommend learning about\n[authentication and authorization](/workspace/guides/auth-overview)\nbefore\n[choosing the access credentials](/workspace/guides/create-credentials#choose_the_access_credential_that_is_right_for_you)\nthat are appropriate for your app.\n\nIn Apps Script, Google Workspace\nquickstarts use\n[Advanced Google services](/apps-script/guides/services/advanced) to call\nGoogle Workspace APIs and handle some details of the authentication\nand authorization flow.\n\nObjectives\n\n- Configure the environment.\n- Create and configure the script.\n- Run the script.\n\nPrerequisites\n\n\n- A Google Workspace domain with [API access enabled](https://support.google.com/a/answer/60757).\n- A Google Account in that domain with administrator privileges.\n\n\u003cbr /\u003e\n\n- Access to Google Drive\n\nCreate the script\n\n1. Create a new script in the Apps Script editor by going to [script.google.com/create](https://script.google.com/create).\n2. Replace the contents of the script editor with the following code:\n\n\nadminSDK/reports/quickstart.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/adminSDK/reports/quickstart.gs) \n\n```javascript\n/**\n * List login events for a Google Workspace domain.\n * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list\n */\nfunction listLogins() {\n const userKey = 'all';\n const applicationName = 'login';\n const optionalArgs = {\n maxResults: 10\n };\n try {\n const response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);\n const activities = response.items;\n if (!activities || activities.length === 0) {\n console.log('No logins found.');\n return;\n }\n // Print login events\n console.log('Logins:');\n for (const activity of activities) {\n console.log('%s: %s (%s)', activity.id.time, activity.actor.email,\n activity.events[0].name);\n }\n } catch (err) {\n // TODO (developer)- Handle exception from the Report API\n console.log('Failed with error %s', err.message);\n }\n}\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n3. Click Save .\n4. Click **Untitled project** , type **Quickstart** , and click **Rename**.\n\n\u003cbr /\u003e\n\nConfigure the script\n\nEnable the Admin SDK API\n\nOpen the Apps Script project.\n\n1. Click **Editor** code.\n2. Next to **Services** , click Add a service add .\n3. Select Admin SDK API and click **Add**.\n\nRun the sample\n\nIn the Apps Script editor, click **Run**.\n\nThe first time you run the sample, it prompts you to authorize access:\n\n1. Click **Review permissions**.\n2. Choose an account.\n3. Click **Allow**.\n\nThe script's execution log appears at the bottom of the window. \ndone It worked! **Great!** Check out the further reading section below to learn more.\nwarning There was a problem **Bummer** , [let us know what went wrong](#). Check out our [troubleshooting](#troubleshooting) section below for some common errors and solutions. If you have found a bug in the code, [report the issue on GitHub](https://github.com/googleworkspace/apps-script-samples/issues) or submit a pull request.\n\nNext steps\n\n- [Google Apps Script Advanced Services documentation](/apps-script/guides/services/advanced)\n- [Try the Google Workspace APIs in the APIs explorer](/workspace/explore)\n- [Troubleshoot authentication and authorization issues](/workspace/admin/reports/v1/guides/troubleshoot-authentication-authorization)\n- [Admin SDK Reports API reference documentation](/workspace/admin/reports/v1/reference)"]]
.