تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح أدلة التشغيل السريع كيفية إعداد تطبيق وتشغيله، وهو تطبيق يستدعي إحدى واجهات Google Workspace API. يستخدم دليل البدء السريع هذا أسلوبًا مبسطًا للمصادقة مناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، ننصحك بالتعرّف على
المصادقة والتفويض
قبل
اختيار بيانات اعتماد الوصول
المناسبة لتطبيقك.
بصفتك مشرفًا في Google Workspace، يمكنك استخدام Alert Center API للوصول إلى التنبيهات المتعلقة بالمشاكل التي تؤثّر في نطاقك.
حساب الخدمة هو نوع خاص من الحسابات تستخدمه التطبيقات، وليس الأشخاص. يمكنك استخدام حساب خدمة للوصول إلى البيانات أو تنفيذ إجراءات من خلال حساب الروبوت، أو للوصول إلى البيانات نيابةً عن مستخدمي Google Workspace أو Cloud Identity. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على حسابات الخدمة.
يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على
جهازك كملف جديد. احفظ ملف JSON الذي تم تنزيله باسم credentials.json في دليل العمل. هذا الملف هو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات عن طريقة التخزين الآمن للمفتاح، راجِع إدارة مفاتيح حساب الخدمة.
InputStreamin=AdminSDKAlertCenterQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);if(in==null){thrownewFileNotFoundException("Resource not found: "+CREDENTIALS_FILE_PATH);}GoogleCredentialscredentials=ServiceAccountCredentials.fromStream(in).createDelegated(delegatedAdminEmail).createScoped(SCOPES);
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Java quickstart\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\nAs a Google Workspace administrator, you can use the Alert Center API to access\nalerts for issues affecting your domain.\n\nObjectives\n----------\n\n- Set up your environment.\n- Set up and run the sample.\n\nPrerequisites\n-------------\n\n- Java 1.8 or greater\n- [A Google Cloud project](/workspace/guides/create-project)\n- A Google Account\n\nSet up your environment\n-----------------------\n\n### Turn on the API\n\nBefore using Google APIs, you need to turn them on in a Google Cloud project. You can turn on one or more APIs in a single Google Cloud project.\n\n- In the Google Cloud console, turn on the Alert Center API.\n\n [Turn on the API](https://console.cloud.google.com/flows/enableapi?apiid=alertcenter.googleapis.com)\n\n### Create a service account\n\nA service account is a special kind of account used by an application, rather than a person. You can use a service account to access data or perform actions by the robot account, or to access data on behalf of Google Workspace or Cloud Identity users. For more information, see [Understanding service accounts](https://cloud.google.com/iam/docs/understanding-service-accounts).\n\n### Google Cloud console\n\n1. In the Google Cloud console, go to Menu menu \\\u003e **IAM \\& Admin** \\\u003e **Service Accounts** .\n\n [Go to Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts)\n2. Click **Create service account**.\n3. Fill in the service account details, then click **Create and continue** . Note: By default, Google creates a unique service account ID. If you would like to change the ID, modify the ID in the service account ID field.\n4. Optional: Assign roles to your service account to grant access to your Google Cloud project's resources. For more details, refer to [Granting, changing, and revoking access to resources](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n5. Click **Continue**.\n6. Optional: Enter users or groups that can manage and perform actions with this service account. For more details, refer to [Managing service account impersonation](https://cloud.google.com/iam/docs/impersonating-service-accounts).\n7. Click **Done**. Make a note of the email address for the service account.\n\n### gcloud CLI\n\n1. Create the service account: \n\n gcloud iam service-accounts create \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eSERVICE_ACCOUNT_NAME\u003c/code\u003e\u003c/var\u003e \\\n --display-name=\"\u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eSERVICE_ACCOUNT_NAME\u003c/code\u003e\u003c/var\u003e\"\n\n2. Optional: Assign roles to your service account to grant access to your Google Cloud project's resources. For more details, refer to [Granting, changing, and revoking access to resources](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n\n#### Create credentials for a service account\n\nYou need to obtain credentials in the form of a public/private key pair. These credentials are used by your code to authorize service account actions within your app.\n\n1. In the Google Cloud console, go to Menu menu \\\u003e **IAM \\& Admin** \\\u003e **Service Accounts** .\n\n [Go to Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts)\n2. Select your service account.\n3. Click **Keys** \\\u003e **Add key** \\\u003e **Create new key**.\n4. Select **JSON** , then click **Create** .\n\n Your new public/private key pair is generated and downloaded to your\n machine as a new file. Save the downloaded JSON file as `credentials.json` in your\n working directory. This file is the only copy of this key. For information about how to store\n your key securely, see\n [Managing service account keys](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys).\n5. Click **Close**.\n\nSet up and run the sample\n-------------------------\n\n1. Get credentials:\n\n adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java \n [View on GitHub](https://github.com/googleworkspace/java-samples/blob/main/adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java) \n\n ```java\n InputStream in = AdminSDKAlertCenterQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);\n if (in == null) {\n throw new FileNotFoundException(\"Resource not found: \" + CREDENTIALS_FILE_PATH);\n }\n GoogleCredentials credentials = ServiceAccountCredentials\n .fromStream(in)\n .createDelegated(delegatedAdminEmail)\n .createScoped(SCOPES);\n ```\n2. Create an instance of the client:\n\n adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java \n [View on GitHub](https://github.com/googleworkspace/java-samples/blob/main/adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java) \n\n ```java\n NetHttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();\n AlertCenter service = new AlertCenter.Builder(transport, JSON_FACTORY,\n new HttpCredentialsAdapter(getCredentials(DELEGATED_ADMIN_EMAIL)))\n .setApplicationName(APPLICATION_NAME)\n .build();\n ```\n3. Display all alerts:\n\n adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java \n [View on GitHub](https://github.com/googleworkspace/java-samples/blob/main/adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java) \n\n ```java\n String pageToken = null;\n do {\n ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)\n .setPageSize(20).execute();\n if (listResponse.getAlerts() != null) {\n for (Alert alert : listResponse.getAlerts()) {\n System.out.println(alert);\n }\n }\n pageToken = listResponse.getNextPageToken();\n } while (pageToken != null);\n ```\n4. Provide feedback on a given alert:\n\n adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java \n [View on GitHub](https://github.com/googleworkspace/java-samples/blob/main/adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java) \n\n ```java\n AlertFeedback newFeedback = new AlertFeedback();\n newFeedback.setType(\"VERY_USEFUL\");\n AlertFeedback feedback = service.alerts().feedback().create(alertId, newFeedback).execute();\n System.out.println(feedback);\n ```"]]
