Google Chat स्पेस के इवेंट की सूची बनाना

इस गाइड में, Google Chat API के SpaceEvent रिसॉर्स पर list() तरीके का इस्तेमाल करने का तरीका बताया गया है. इससे किसी स्पेस में मौजूद रिसॉर्स में हुए बदलावों की सूची बनाई जा सकती है.

SpaceEvent संसाधन, टारगेट स्पेस में हुए बदलाव को दिखाता है. इसमें स्पेस के चाइल्ड रिसॉर्स भी शामिल हैं. जैसे, मैसेज, प्रतिक्रियाएं, और पैसे चुकाकर ली जाने वाली सदस्यताएं. इस्तेमाल किए जा सकने वाले इवेंट टाइप और इवेंट पेलोड की सूची के बारे में ज़्यादा जानने के लिए, SpaceEvent संसाधन के रेफ़रंस दस्तावेज़ के eventType और payload फ़ील्ड देखें.

अनुरोध करने से 28 दिन पहले तक के इवेंट की जानकारी दी जा सकती है. सर्वर उन इवेंट को दिखाता है जिनमें प्रभावित संसाधन का सबसे नया वर्शन शामिल होता है. उदाहरण के लिए, अगर आपने नए स्पेस सदस्यों के बारे में इवेंट की सूची बनाई है, तो सर्वर Membership ऐसे संसाधन दिखाता है जिनमें सदस्यता की नई जानकारी शामिल होती है. अगर अनुरोध की गई अवधि के दौरान नए सदस्यों को हटाया गया था, तो इवेंट के पेलोड में खाली Membership संसाधन शामिल होता है.

इस तरीके को कॉल करने के लिए, आपको उपयोगकर्ता की पुष्टि का इस्तेमाल करना होगा. किसी स्पेस के इवेंट की सूची बनाने के लिए, पुष्टि किए गए उपयोगकर्ता का स्पेस का सदस्य होना ज़रूरी है.

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

Node.js

  • आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.

स्पेस के इवेंट की सूची बनाना

किसी Chat स्पेस के इवेंट की सूची बनाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:

  • अपने अनुरोध में हर इवेंट टाइप के लिए, एक या उससे ज़्यादा अनुमति के स्कोप तय करें. सबसे सही तरीका यह है कि आप सबसे सीमित स्कोप चुनें. इससे आपका ऐप्लिकेशन काम कर पाएगा. स्कोप चुनने के लिए, पुष्टि और अनुमति से जुड़ी खास जानकारी देखें.

  • ListSpaceEvents() तरीके को कॉल करें. साथ ही, सूची में शामिल करने के लिए इवेंट टाइप का filter पास करें. आपको कम से कम एक इवेंट टाइप तय करना होगा. साथ ही, तारीख के हिसाब से भी फ़िल्टर किया जा सकता है. साथ काम करने वाले इवेंट टाइप की सूची देखने के लिए, SpaceEvent रिसॉर्स का eventType फ़ील्ड रेफ़रंस दस्तावेज़ देखें.

यहां दिए गए उदाहरण में, किसी स्पेस में नई सदस्यताओं और मैसेज के बारे में इवेंट की सूची दी गई है:

Node.js

chat/client-libraries/cloud/list-space-events-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Authorization scopes based on the event types
const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.memberships.readonly',
  'https://www.googleapis.com/auth/chat.messages.readonly',
];

// This sample shows how to list space events with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    parent: 'spaces/SPACE_NAME',
    // A required filter. Filters events about new memberships and messages
    filter: 'eventTypes:"google.workspace.chat.membership.v1.created" OR eventTypes:"google.workspace.chat.message.v1.created"',
  };

  // Make the request
  const pageResult = chatClient.listSpaceEventsAsync(request);

  // Handle the response. Iterating over pageResult will yield results and
  // resolve additional pages automatically.
  for await (const response of pageResult) {
    console.log(response);
  }
}

main().catch(console.error);

इस सैंपल को चलाने के लिए, SPACE_NAME की जगह स्पेस के name से मिला आईडी डालें. आईडी पाने के लिए, ListSpaces() तरीके का इस्तेमाल करें या स्पेस के यूआरएल से आईडी पाएं.

Chat API, नई मेंबरशिप और मैसेज के बारे में स्पेस इवेंट की पेज के हिसाब से बांटी गई सूची दिखाता है.