מדריך למתחילים ב-Java

במדריכים למתחילים מוסבר איך מגדירים ומפעילים אפליקציה שמפעילה קריאה ל-Google Workspace API.

במדריכים למתחילים של Google Workspace נעשה שימוש בספריות הלקוח של ה-API כדי לטפל בחלק מהפרטים של תהליך האימות וההרשאה. מומלץ להשתמש בספריות הלקוח באפליקציות שלכם. במדריך למתחילים הזה נעשה שימוש בגישה פשוטה לאימות שמתאימה לסביבת בדיקה. בסביבת ייצור, מומלץ לקרוא על אימות והרשאה לפני בחירת פרטי הכניסה שמתאימים לאפליקציה.

אדמינים ב-Google Workspace יכולים להשתמש ב-Alert Center API כדי לגשת להתראות לגבי בעיות שמשפיעות על הדומיין שלהם.

מטרות

• מגדירים את הסביבה.
• מגדירים ומפעילים את הדוגמה.

דרישות מוקדמות

• Java 1.8 ואילך
• פרויקט ב-Google Cloud
• חשבון Google.

הגדרת הסביבה

הפעלת ה-API

לפני שמשתמשים ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.

• במסוף Google Cloud, מפעילים את Alert Center API.

  הפעלת ה-API

יצירה של חשבון שירות

חשבון שירות הוא סוג מיוחד של חשבון, שאפליקציה (ולא אדם) משתמשת בו. אפשר להשתמש בחשבון שירות כדי לגשת לנתונים או לבצע פעולות באמצעות חשבון הרובוט, או כדי לגשת לנתונים בשם משתמשי Google Workspace או Cloud Identity. מידע נוסף זמין במאמר הסבר על חשבונות שירות.

מסוף Google Cloud

1. במסוף Google Cloud, עוברים לתפריט > IAM & Admin > Service Accounts.

   לדף Service accounts

2. לוחצים על Create service account.
3. ממלאים את פרטי חשבון השירות ולוחצים על Create and continue (יצירה והמשך).
   הערה: כברירת מחדל, Google יוצרת מזהה ייחודי של חשבון שירות. אם רוצים לשנות את המזהה, משנים אותו בשדה Service account ID.
4. אופציונלי: מקצים תפקידים לחשבון השירות כדי לתת גישה למשאבים של הפרויקט ב-Google Cloud. פרטים נוספים זמינים במאמר הענקה, שינוי וביטול גישה למשאבים.
5. לוחצים על המשך.
6. אופציונלי: מזינים משתמשים או קבוצות שיכולים לנהל את חשבון השירות הזה ולבצע בו פעולות. פרטים נוספים זמינים במאמר ניהול התחזות לחשבון שירות.
7. לוחצים על סיום. כותבים את כתובת האימייל של חשבון השירות.

CLI של gcloud

1. יוצרים את חשבון השירות:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. אופציונלי: מקצים תפקידים לחשבון השירות כדי לתת גישה למשאבים של הפרויקט ב-Google Cloud. פרטים נוספים זמינים במאמר הענקה, שינוי וביטול גישה למשאבים.

יצירת פרטי כניסה לחשבון שירות

צריך לקבל פרטי כניסה בצורת זוג מפתחות ציבורי/פרטי. הקוד שלכם משתמש בפרטי הכניסה האלה כדי לאשר פעולות של חשבון השירות באפליקציה.

1. במסוף Google Cloud, עוברים לתפריט > IAM & Admin > Service Accounts.

   לדף Service accounts

2. בוחרים את חשבון השירות.
3. לוחצים על Keys (מפתחות) > Add key (הוספת מפתח) > Create new key (יצירת מפתח חדש).
4. בוחרים באפשרות JSON ולוחצים על Create.

   זוג המפתחות הציבורי/הפרטי החדש נוצר ומוריד למחשב כקובץ חדש. שומרים את קובץ ה-JSON שהורדתם בתור credentials.json בספריית העבודה. הקובץ הזה הוא העותק היחיד של המפתח. מידע נוסף על אחסון המפתח באופן מאובטח זמין במאמר ניהול מפתחות של חשבונות שירות.

5. לוחצים על סגירה.

הגדרה והרצה של הדוגמה

1. קבלת פרטי הכניסה:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   הצגת הקוד ב-GitHub
   InputStream in = AdminSDKAlertCenterQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
   if (in == null) {
     throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
   }
   GoogleCredentials credentials = ServiceAccountCredentials
       .fromStream(in)
       .createDelegated(delegatedAdminEmail)
       .createScoped(SCOPES);

2. יוצרים מכונה של הלקוח:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   הצגת הקוד ב-GitHub
   NetHttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
   AlertCenter service = new AlertCenter.Builder(transport, JSON_FACTORY,
       new HttpCredentialsAdapter(getCredentials(DELEGATED_ADMIN_EMAIL)))
       .setApplicationName(APPLICATION_NAME)
       .build();

3. הצגת כל ההתראות:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   הצגת הקוד ב-GitHub
   String pageToken = null;
   do {
     ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
         .setPageSize(20).execute();
     if (listResponse.getAlerts() != null) {
       for (Alert alert : listResponse.getAlerts()) {
         System.out.println(alert);
       }
     }
     pageToken = listResponse.getNextPageToken();
   } while (pageToken != null);

4. שליחת משוב על התראה נתונה:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   הצגת הקוד ב-GitHub
   AlertFeedback newFeedback = new AlertFeedback();
   newFeedback.setType("VERY_USEFUL");
   AlertFeedback feedback = service.alerts().feedback().create(alertId, newFeedback).execute();
   System.out.println(feedback);