البدء السريع بلغة Java

توضح Quickstarts كيفية إعداد وتشغيل تطبيق يستدعي واجهة برمجة تطبيقات Google Workspace.

تستخدم عمليات التشغيل السريع في Google Workspace مكتبات برامج واجهة برمجة التطبيقات لمعالجة بعض تفاصيل عملية المصادقة والتفويض. ونوصي باستخدام مكتبات المكتبات لتطبيقاتك الخاصة. قبل أن تتمكن من تشغيل نموذج التطبيق، يتطلب كل بدء سريع تشغيل المصادقة والتفويض. إذا لم تكن على دراية بالمصادقة والتفويض لواجهات برمجة تطبيقات Google Workspace، يُرجى قراءة نظرة عامة على المصادقة والتفويض.

بصفتك مشرفًا في Google Workspace، يمكنك استخدام واجهة برمجة تطبيقات "مركز التنبيه" للوصول إلى التنبيهات بشأن المشاكل التي تؤثر في نطاقك.

الأهداف

• إعداد البيئة.
• إعداد النموذج وتشغيله.

المتطلبات الأساسية

• جافا الإصدار 1.8 أو أحدث
• مشروع Google Cloud
• حساب على Google

إعداد البيئة

تفعيل واجهة برمجة التطبيقات

قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع Google Cloud واحد.

• في Google Cloud Console، فعِّل واجهة برمجة تطبيقات "مركز التنبيه".

  تفعيل واجهة برمجة التطبيقات

إنشاء حساب خدمة

حساب الخدمة هو نوع خاص من الحسابات يستخدمه أحد التطبيقات، وليس حساب شخص. يمكنك استخدام حساب خدمة للوصول إلى البيانات أو تنفيذ إجراءات من خلال حساب الروبوت، أو للوصول إلى البيانات نيابة عن مستخدمي Google Workspace أو Cloud Identity. لمزيد من المعلومات، راجع فهم حسابات الخدمة.

1. في Google Cloud Console، انتقِل إلى القائمة menu > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.

   الانتقال إلى حسابات الخدمة

2. انقر على إنشاء حساب خدمة.
3. املأ تفاصيل حساب الخدمة، ثم انقر على إنشاء ومتابعة.
4. اختياري: يمكنك إسناد الأدوار إلى حساب الخدمة لمنح الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الرجوع إلى منح الموارد وتغييرها وإبطال الوصول إلى الموارد.
5. انقر على متابعة.
6. اختياري: أدخِل المستخدمين أو المجموعات التي يمكنها إدارة الإجراءات وتنفيذها باستخدام حساب الخدمة هذا. لمزيد من التفاصيل، يُرجى الرجوع إلى إدارة انتحال هوية حساب الخدمة.
7. انقر على تم.

إنشاء بيانات اعتماد لحساب خدمة

يجب الحصول على بيانات الاعتماد على شكل زوج مفاتيح عام/خاص. ويتم استخدام بيانات الاعتماد هذه من خلال رمزك للسماح بإجراءات حساب الخدمة داخل تطبيقك.

1. في Google Cloud Console، انتقِل إلى القائمة menu > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.

   الانتقال إلى حسابات الخدمة

2. اختَر حساب الخدمة.
3. انقر على المفاتيح > إضافة مفتاح > إنشاء مفتاح جديد.
4. حدد 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);