קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדריכים אחרים למתחילים מוסבר איך להגדיר ולהריץ אפליקציה שקוראת ל-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);
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[],[],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 ```"]]
