Java क्विकस्टार्ट

क्विकस्टार्ट, Google Workspace API को कॉल करने वाले ऐप्लिकेशन को सेट अप करने और चलाने का तरीका बताता है.

Google Workspace क्विकस्टार्ट, पुष्टि करने और अनुमति देने की प्रक्रिया की कुछ जानकारी को मैनेज करने के लिए, एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल करता है. हमारा सुझाव है कि आप अपने ऐप्लिकेशन के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करें. यह क्विकस्टार्ट, पुष्टि करने के एक आसान तरीके का इस्तेमाल करता है, जो जांच के माहौल के लिए सही है. प्रोडक्शन एनवायरमेंट के लिए, हमारा सुझाव है कि अपने ऐप्लिकेशन के लिए सही ऐक्सेस क्रेडेंशियल चुनने से पहले, पुष्टि करने और अनुमति देने के बारे में जान लें.

Google Workspace एडमिन के तौर पर, आपके डोमेन पर असर डालने वाली समस्याओं के बारे में चेतावनियां ऐक्सेस करने के लिए, चेतावनी केंद्र एपीआई का इस्तेमाल किया जा सकता है.

मकसद

• अपना एनवायरमेंट सेट अप करें.
• सैंपल को सेट अप करें और चलाएं.

ज़रूरी शर्तें

• Java 1.8 या उसके बाद का वर्शन
• Google Cloud प्रोजेक्ट
• Google खाता

अपना एनवायरमेंट सेट अप करें

एपीआई चालू करें

Google API का इस्तेमाल करने से पहले, आपको इन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. आपके पास किसी एक Google Cloud प्रोजेक्ट में एक या एक से ज़्यादा एपीआई चालू करने का विकल्प होता है.

• Google Cloud कंसोल में, Alert Center API चालू करें.

  एपीआई को चालू करना

सेवा खाता बनाना

सेवा खाता एक खास तरह का खाता होता है, जिसका इस्तेमाल कोई ऐप्लिकेशन करता है, न कि कोई व्यक्ति. डेटा ऐक्सेस करने या रोबोट खाते से कार्रवाइयां करने के लिए, सेवा खाते का इस्तेमाल किया जा सकता है. इसके अलावा, Google Workspace या Cloud Identity के उपयोगकर्ताओं का डेटा ऐक्सेस करने के लिए भी इसका इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, सेवा खातों को समझना लेख पढ़ें.

Google Cloud कंसोल

1. Google Cloud Console में, मेन्यू > IAM और एडमिन > सेवा खाते पर जाएं.

   सेवा खातों पर जाएं

2. सेवा खाता बनाएं पर क्लिक करें.
3. सेवा खाते की जानकारी भरें. इसके बाद, बनाएं और जारी रखें पर क्लिक करें.
   ध्यान दें: Google, डिफ़ॉल्ट रूप से एक यूनीक सेवा खाता आईडी बनाता है. अगर आपको आईडी बदलना है, तो सेवा खाता आईडी फ़ील्ड में आईडी में बदलाव करें.
4. ज़रूरी नहीं: अपने Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस देने के लिए, अपने सेवा खाते में भूमिकाएं असाइन करें. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, बदलना, और वापस लेना पर जाएं.
5. जारी रखें पर क्लिक करें.
6. ज़रूरी नहीं: ऐसे उपयोगकर्ताओं या ग्रुप के नाम डालें जो इस सेवा खाते से कार्रवाइयां कर सकते हैं. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
7. हो गया पर क्लिक करें. सेवा खाते के ईमेल पते को नोट कर लें.

gcloud सीएलआई

1. सेवा खाता बनाएं:

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

2. ज़रूरी नहीं: अपने Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस देने के लिए, अपने सेवा खाते में भूमिकाएं असाइन करें. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, बदलना, और वापस लेना पर जाएं.

सेवा खाते के लिए क्रेडेंशियल बनाना

आपको सार्वजनिक/निजी कुंजी के जोड़े के तौर पर, क्रेडेंशियल लेने होंगे. आपके कोड में इन क्रेडेंशियल का इस्तेमाल, आपके ऐप्लिकेशन में सेवा खाते से जुड़ी कार्रवाइयों की अनुमति देने के लिए किया जाता है.

1. Google Cloud Console में, मेन्यू > IAM और एडमिन > सेवा खाते पर जाएं.

   सेवा खातों पर जाएं

2. अपना सेवा खाता चुनें.
3. कुंजियां > कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें.
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);