Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Node.js का क्विकस्टार्ट

Node.js का ऐसा कमांड-लाइन ऐप्लिकेशन बनाएं जो Directory API को अनुरोध भेजता हो.

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

इस क्विकस्टार्ट में, पुष्टि करने और अनुमति देने के फ़्लो की कुछ जानकारी को मैनेज करने के लिए, Google Workspace की सुझाई गई API क्लाइंट लाइब्रेरी का इस्तेमाल किया गया है.

मकसद

अपना एनवायरमेंट सेट अप करना.
क्लाइंट लाइब्रेरी इंस्टॉल करना.
सैंपल सेट अप करना.
सैंपल चलाना.

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

इस क्विकस्टार्ट को चलाने के लिए, आपको ये ज़रूरी शर्तें पूरी करनी होंगी:

Node.js और npm इंस्टॉल होना चाहिए.
आपके पास Google Cloud प्रोजेक्ट होना चाहिए.

आपके पास Google Workspace का ऐसा डोमेन होना चाहिए जिसमें एपीआई ऐक्सेस करने की सुविधा चालू हो.
उस डोमेन में, आपके पास ऐसा Google खाता होना चाहिए जिसमें एडमिन के अधिकार हों.

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

इस क्विकस्टार्ट को पूरा करने के लिए, अपना एनवायरमेंट सेट अप करें.

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

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

Google Cloud Console में, Directory API को चालू करें.

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

OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करना

अगर इस क्विकस्टार्ट को पूरा करने के लिए, Google Cloud के नए प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करें. अगर आपने अपने Cloud प्रोजेक्ट के लिए यह चरण पहले ही पूरा कर लिया है, तो अगले सेक्शन पर जाएं.

Google API Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > ब्रैंडिंग पर जाएं.
ब्रैंडिंग पर जाएं
अगर आपने Google Auth प्लैटफ़ॉर्म को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में, OAuth के लिए सहमति की स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको Google Auth प्लैटफ़ॉर्म को अब तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:

ऐप्लिकेशन की जानकारी में, ऐप्लिकेशन का नाम में जाकर, ऐप्लिकेशन का नाम डालें.
उपयोगकर्ता सहायता के लिए ईमेल पता में जाकर, सहायता के लिए कोई ऐसा ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
आगे बढ़ें पर क्लिक करें.
ऑडियंस में जाकर, इंटरनल को चुनें.
आगे बढ़ें पर क्लिक करें.
संपर्क जानकारी में जाकर, ईमेल पता डालें. इस पते पर, आपको अपने प्रोजेक्ट में किए गए किसी भी बदलाव के बारे में सूचना मिल सकती है.
आगे बढ़ें पर क्लिक करें.
पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो मुझे Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति स्वीकार है को चुनें.
जारी रखें पर क्लिक करें.
बनाएं पर क्लिक करें.

फ़िलहाल, स्कोप जोड़ने के चरण को छोड़ा जा सकता है. भविष्य में, जब Google Workspace संगठन के बाहर इस्तेमाल के लिए कोई ऐप्लिकेशन बनाया जाता है, तो आपको उपयोगकर्ता का टाइप बदलकर एक्सटर्नल करना होगा. इसके बाद, अनुमति के वे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करने से जुड़ा पूरा पूरा लेख पढ़ें.

डेस्कटॉप ऐप्लिकेशन के लिए क्रेडेंशियल को अनुमति देना

अपने ऐप्लिकेशन में, असली उपयोगकर्ताओं की पुष्टि करने और उनके डेटा को ऐक्सेस करने के लिए, आपको OAuth 2.0 के एक या एक से ज़्यादा क्लाइंट आईडी बनाने होंगे. क्लाइंट आईडी का इस्तेमाल, Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए किया जाता है. अगर आपका ऐप्लिकेशन एक से ज़्यादा प्लैटफ़ॉर्म पर चलता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग-अलग क्लाइंट आईडी बनाना होगा.

Google Cloud Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > क्लाइंट पर जाएं.
क्लाइंट पर जाएं
क्लाइंट बनाएं पर क्लिक करें.
ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम डालें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
ज़रूरी नहीं: अगर आपका ऐप्लिकेशन, एआई एजेंट है और यह उपयोगकर्ताओं की ओर से कार्रवाइयां करता है, तो एआई की सुविधा वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को चुनें. अगर आपका ऐप्लिकेशन, एआई एजेंट के वर्कफ़्लो और उपयोगकर्ता की सामान्य सुविधाओं, दोनों के साथ काम करता है, तो दोनों के लिए OAuth के अलग-अलग क्लाइंट बनाएं. क्लाइंट बनाने के बाद, इस सेटिंग को नहीं बदला जा सकता.
बनाएं पर क्लिक करें.
नया क्रेडेंशियल, "OAuth 2.0 क्लाइंट आईडी" में दिखता है.
डाउनलोड की गई JSON फ़ाइल को credentials.json के तौर पर सेव करें. इसके बाद, इस फ़ाइल को अपनी वर्किंग डायरेक्ट्री में ले जाएं.

क्लाइंट लाइब्रेरी इंस्टॉल करना

npm का इस्तेमाल करके, लाइब्रेरी इंस्टॉल करें:
```
npm install googleapis@105 @google-cloud/local-auth@2.1.0 --save
```

सैंपल सेट अप करना

अपनी वर्किंग डायरेक्ट्री में, index.js नाम की एक फ़ाइल बनाएं.

इस फ़ाइल में, यह कोड चिपकाएं:

adminSDK/directory/index.js

GitHub पर देखें

import path from 'node:path';
import process from 'node:process';
import {authenticate} from '@google-cloud/local-auth';
import {google} from 'googleapis';

// The scope for the Admin SDK Directory API.
const SCOPES = ['https://www.googleapis.com/auth/admin.directory.user'];
// The path to the credentials file.
const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');

/**
 * Lists the first 10 users in the domain.
 */
async function listUsers() {
  // Authenticate with Google and get an authorized client.
  const auth = await authenticate({
    scopes: SCOPES,
    keyfilePath: CREDENTIALS_PATH,
  });

  // Create a new Admin SDK Directory API client.
  const service = google.admin({version: 'directory_v1', auth});
  // Get the list of users.
  const result = await service.users.list({
    customer: 'my_customer',
    maxResults: 10,
    orderBy: 'email',
  });

  const users = result.data.users;
  if (!users || users.length === 0) {
    console.log('No users found.');
    return;
  }

  // Print the primary email and full name of each user.
  console.log('Users:');
  users.forEach((user) => {
    console.log(`${user.primaryEmail} (${user.name?.fullName})`);
  });
}

await listUsers();

सैंपल चलाना

अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:
```
node .
```

सैंपल को पहली बार चलाने पर, आपसे ऐक्सेस की अनुमति देने के लिए कहा जाता है:
1. अगर आपने Google खाते में साइन इन नहीं किया है, तो कहे जाने पर साइन इन करें. अगर आपने एक से ज़्यादा खातों में साइन इन किया है, तो अनुमति देने के लिए कोई एक खाता चुनें.
2. स्वीकार करें पर क्लिक करें.
आपका Nodejs ऐप्लिकेशन चलता है और Directory API को कॉल करता है.

अनुमति से जुड़ी जानकारी, फ़ाइल सिस्टम में सेव होती है. इसलिए, अगली बार सैंपल कोड चलाने पर, आपसे अनुमति के लिए नहीं कहा जाएगा.