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

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

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

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

מטרות

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

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

• Java 1.8 ומעלה
• פרויקט ב-Google Cloud
• חשבון Google.

הגדרת הסביבה שלך

הפעלת ה-API

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

• במסוף Google Cloud, מפעילים את ממשק ה-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 יוצרת מספר ייחודי לחשבון השירות. אם רוצים לשנות את המזהה, צריך לשנות אותו בשדה של מספר חשבון השירות.
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 > הוספת מפתח > יצירת מפתח חדש.
4. בוחרים באפשרות JSON ולוחצים על יצירה.

   זוג המפתחות הציבורי/הפרטי החדש ייווצר ויוריד למחשב שלך כקובץ חדש. יש לשמור את קובץ ה-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);