दस्तावेज़ब्राउज़र और CrawlAgent Browserप्रोफ़ाइल

प्रोफाइल

प्रोफाइल आपको भंडारण, कुकीज़, कैश और लॉगिन स्थितियों सहित उपयोगकर्ता डेटा को कई सत्रों में बनाए रखने की अनुमति देती हैं। इससे सुचारु स्वचालन, सरलीकृत प्रमाणीकरण और अनुकूलित प्रदर्शन संभव होता है।

मुख्य लाभ

  • ब्राउज़िंग इतिहास का पुनः उपयोग करें: उपयोगकर्ता अपने ब्राउज़िंग इतिहास का उपयोग सत्रों के माध्यम से पुनः कर सकते हैं।
  • लॉगिन स्थिति बनाए रखें: कुछ साइट्स में लॉगिन पर बने रहकर बार-बार प्रमाणीकरण की आवश्यकता को कम करें।
  • पेज लोड गति में सुधार करें: वेब पृष्ठों के लोड होने की गति में वृद्धि करें।
  • बॉट डिटेक्शन के जोखिम को कम करें: बॉट के रूप में पहचाने जाने की संभावना को कम करें।

प्रोफ़ाइल का उपयोग करना

1. एक प्रोफ़ाइल बनाएँ

सबसे पहले, प्रोफ़ाइल API का उपयोग करके एक नई प्रोफ़ाइल बनाएँ। वापस लौटाए गए profileId का ध्यान रखें; आप इसे एक नए सत्र को प्रोफ़ाइल असाइन करने के लिए उपयोग करेंगे।

import { ScrapelessClient } from '@scrapeless-ai/sdk';
 
const client = new ScrapelessClient({ apiKey: 'API Key' });
const createResponse = await client.profiles.create('My Profile');
console.log('Profile created:', createResponse);

2. प्रोफ़ाइल का उपयोग करें

एक बार प्रोफ़ाइल बन जाने के बाद, आप उसके डेटा को पुनः उपयोग करने के लिए एक नए सत्र में इसे जोड़ सकते हैं। सत्र कॉन्फ़िगरेशन में profileId शामिल करके प्रोफ़ाइल असाइन करें।

import { ScrapelessClient } from '@scrapeless-ai/sdk';
 
const client = new ScrapelessClient({ apiKey: 'API Key' });
const { browserWSEndpoint } = client.browser.create({
    sessionName: 'My Browser',
    sessionTTL: 30000,
    profileId: 'your-profile-id',
});
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint});
    const page = await browser.newPage();
    await page.goto('https://www.scrapeless.com');
    console.log(await page.title());
    await browser.close();
})();

यदि आप चाहते हैं कि नया सत्र प्रोफ़ाइल डेटा को अपडेट करे, तो आपको प्रोफ़ाइल ऑब्जेक्ट के भीतर profilePersist: true सेट करना होगा। यह पहली बार किसी नई प्रोफ़ाइल को सत्र में उपयोग करते समय किया जाना चाहिए ताकि इसका डेटा भावी उपयोग के लिए सहेजा जा सके।

const { browserWSEndpoint } = client.browser.create({
    sessionName: 'My Browser',
    sessionTTL: 30000,
    profileId: 'your-profile-id',
    profilePersist: true,
});
Why Use persist?

डिफ़ॉल्ट रूप से, एक संदर्भ पिछले सत्र से सहेजे गए डेटा को लोड करेगा लेकिन इसे अपडेट नहीं करेगा। यदि आपको नए कुकीज़, प्रमाणीकरण टोकन या कैश किए गए डेटा को स्टोर करने की आवश्यकता है, तो आपको सत्र बनाते समय profilePersist: true सेट करना होगा। सत्र बंद होने पर डेटा सहेज लिया जाएगा। इससे यह सुनिश्चित होता है कि सत्र के दौरान किए गए किसी भी परिवर्तन—जैसे लॉगिन करना, साइट प्राथमिकताएँ सहेजना या एसेट्स को कैश करना—भावी सत्रों के लिए संरक्षित रहें और सत्र समाप्त होने पर खोए नहीं।

3. प्रोफ़ाइल पुनः प्राप्त करें

आप इसकी ID के द्वारा एक विशिष्ट प्रोफ़ाइल प्राप्त कर सकते हैं या क्वेरी पैरामीटर का उपयोग करके आपके द्वारा बनाई गई सभी प्रोफ़ाइल्स को सूचीबद्ध कर सकते हैं। कृपया पूर्ण स्कीमा और पैरामीटर के लिए प्रोफ़ाइल API संदर्भ देखें।

// get a specific profile
const profile = await client.profiles.get('your-profile-id');
 
// get profile list
const profiles = await client.profiles.list({ page: 1, pageSize: 10 });
Note

जब profilePersist: true सक्षम होता है, तो केवल अंतिम सत्र से बंद होने वाला डेटा सहेजा जाएगा।

4. एकाधिक सत्रों के बीच प्रोफ़ाइल साझा करें

यदि आप चाहते हैं कि एकाधिक सत्र एक ही प्रोफ़ाइल साझा करें, तो डिफ़ॉल्ट सेटिंग profilePersist: false आपको किसी भी परिवर्तन किए बिना एकाधिक सत्रों में पिछली प्रोफ़ाइल कॉन्फ़िगरेशन का उपयोग करने की अनुमति देती है। यदि आप इन सत्रों के भीतर प्रोफ़ाइल को अपडेट करना चाहते हैं, तो आपको स्थायित्व सक्षम करने की आवश्यकता होगी।

const { browserWSEndpoint } = client.browser.create({
    sessionName: 'My Browser',
    sessionTTL: 30000,
    profileId: 'your-profile-id',
});

नोट: जब profilePersist: true सक्षम होता है, तो केवल अंतिम सत्र से बंद होने वाला डेटा सहेजा जाएगा।

5. प्रोफ़ाइल्स हटाएँ

संसाधनों को मुक्त करने के लिए अप्रयुक्त प्रोफ़ाइल्स को हटा दें। एक बार हटाए जाने के बाद, किसी भी सत्र से प्रोफ़ाइल को जोड़ा नहीं जा सकता।

const deleteResponse = await client.profiles.delete('your-profile-id');

👉 प्रोफ़ाइल से संबंधित उदाहरणों और कोड नमूनों के लिए, कृपया जाएँ उत्पाद अपडेट | नई प्रोफ़ाइल सुविधा।