OneDrive संदर्भ (पूर्वावलोकन)

नोट

यह आलेख मानक हार्नेस द्वारा संचालित एजेंटों या एजेंट प्रवाह में उपयोग की जाने वाली सुविधाओं का वर्णन करता है।

महत्वपूर्ण

यह एक पूर्वावलोकन सुविधा है.

• Microsoft आधिकारिक रिलीज़ से पहले पूर्वावलोकन सुविधाएँ रिलीज़ करता है ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.
• पूर्वावलोकन सुविधाओं ने कार्यक्षमता को प्रतिबंधित कर दिया है और उत्पादन उपयोग के लिए नहीं हैं।
• Microsoft पूर्वावलोकन MCP उपकरण नाम और पैरामीटर परिवर्तित कर सकता है. हार्ड-कोडेड निर्भरताओं से बचें। Microsoft परिदृश्य समर्थन बनाए रखता है।
• पूर्वावलोकन सुविधाएँ Microsoft उपयोग की पूरक शर्तें के अधीन हैं।

नोट

एप्लिकेशन-विशिष्ट Microsoft 365 MCP उपकरण (Copilot, कैलेंडर, मेल, SharePoint, OneDrive, Teams, User, और Word) केवल पश्चगामी संगतता उद्देश्यों के लिए हैं और इनका उपयोग उत्पादन परिवेश या नए प्रोजेक्ट में नहीं किया जाना चाहिए। जिन नए प्रोजेक्ट्स के लिए Microsoft 365 संसाधनों तक पहुंच की आवश्यकता होती है, उनके लिए GitHub Copilot हार्नेस के साथ Work IQ MCP का उपयोग करें। अधिक जानकारी के लिए, Copilot Studio में Work IQ MCP देखें।

अवलोकन

सर्वर आईडी	टेनेंट स्तर का यूआरएल	प्रदर्शित होने वाला नाम	विवरण
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	OneDrive संचालन के लिए उपकरण. उपयोगकर्ता के व्यक्तिगत OneDrive में फ़ाइलों और फ़ोल्डरों को प्रबंधित करने के लिए इस सर्वर का उपयोग करें. सभी फ़ाइल संचालन ≤5MB तक सीमित हैं।

उपलब्ध उपकरण

OneDrive प्राप्त करें

उपयोगकर्ता के OneDrive के बारे में जानकारी प्राप्त करता है, जिसमें ड्राइव मेटाडेटा, कोटा और स्वामी जानकारी शामिल है.

किसी पैरामीटर की आवश्यकता नहीं है।

getFolderChildrenInMyOnedrive

उपयोगकर्ता के OneDrive में एक निर्दिष्ट पैरेंट फ़ोल्डर में निहित शीर्ष 20 फ़ाइलों और फ़ोल्डरों (DriveItems) की गणना करता है।

वैकल्पिक पैरामीटर

• parentFolderId: उस पैरेंट फ़ोल्डर की ID जिसकी फ़ाइलें और फ़ोल्डर आप सूचीबद्ध करना चाहते हैं (डिफ़ॉल्ट: 'रूट')

मेरे OneDrive में फ़ाइल या फ़ोल्डर ढूँढें

उपयोगकर्ता की खोज क्वेरी द्वारा OneDrive में कोई फ़ाइल या फ़ोल्डर (DriveItem) ढूँढता है. यह विधि सभी पहुँच योग्य फ़ाइलों को खोजने की तुलना में अधिक कुशल है यदि आप जानते हैं कि आइटम उपयोगकर्ता के OneDrive में है।

आवश्यक पैरामीटर

• searchQuery: खोज क्वेरी; संपूर्ण या आंशिक फ़ाइल नाम हो सकता है

मेरे OneDrive में फ़ाइल या फ़ोल्डर का मेटाडेटा प्राप्त करें

उपयोगकर्ता के OneDrive से किसी फ़ाइल या फ़ोल्डर (DriveItem) का मेटाडेटा प्राप्त करता है.

आवश्यक पैरामीटर

• fileOrFolderId: उपयोगकर्ता के OneDrive में फ़ाइल या फ़ोल्डर की ID

getFileOrFolderMetadataByUrl

किसी साझाकरण URL से किसी फ़ाइल या फ़ोल्डर (DriveItem) का मेटाडेटा प्राप्त करता है. केवल फ़ाइल तक पहुंचने के लिए मौजूदा स्पष्ट अनुमतियों वाले उपयोगकर्ता ही मेटाडेटा प्राप्त कर सकते हैं।

आवश्यक पैरामीटर

• fileOrFolderUrl: फ़ाइल या फ़ोल्डर का URL. उपयोगकर्ता के साथ साझा करने के लिए URL को मान्य नहीं किया जाता; उपयोगकर्ता के पास पहले से ही स्पष्ट एक्सेस होना चाहिए।

मेरे OneDrive से छोटी टेक्स्ट फ़ाइल पढ़ें

उपयोगकर्ता के OneDrive से कोई पाठ फ़ाइल पढ़ता है (डाउनलोड).

आवश्यक पैरामीटर

• फाइलआईडी: पढ़ने या डाउनलोड करने के लिए फ़ाइल (DriveItem) की ID

मेरे OneDrive में एक छोटी टेक्स्ट फ़ाइल बनाएँ

उपयोगकर्ता के OneDrive पर 5 MB से छोटी पाठ फ़ाइल बनाता है या अपलोड करता है.

आवश्यक पैरामीटर

• फ़ाइल का नाम: बनाने के लिए फ़ाइल का नाम
• सामग्रीपाठ: फ़ाइल की पाठ सामग्री.

वैकल्पिक पैरामीटर

• parentFolderId: पैरेंट फ़ोल्डर की आईडी (डिफ़ॉल्ट: 'रूट')।

मेरे OneDrive में फ़ोल्डर बनाएँ

निर्दिष्ट पैरेंट फ़ोल्डर के चाइल्ड के रूप में उपयोगकर्ता के OneDrive में एक नया फ़ोल्डर (DriveItem) बनाता है. यदि एक ही नाम वाला फ़ोल्डर पहले से मौजूद है, तो विधि एक संख्यात्मक प्रत्यय जोड़ती है (उदाहरण के लिए, NewFolder (1))।

आवश्यक पैरामीटर

• फ़ोल्डरनाम: बनाने के लिए फ़ोल्डर का नाम

वैकल्पिक पैरामीटर

• parentFolderId: पैरेंट फ़ोल्डर की आईडी (डिफ़ॉल्ट: 'रूट')।

FileOrFolderInMyOnedrive का नाम बदलें

उपयोगकर्ता के OneDrive में किसी फ़ाइल या फ़ोल्डर (DriveItem) का नाम बदलता है. नए नाम को नामकरण परंपराओं का पालन करना चाहिए।

आवश्यक पैरामीटर

• fileOrFolderId: नाम बदलने के लिए फ़ाइल या फ़ोल्डर की ID
• newFileOrFolderName: फ़ाइल या फ़ोल्डर के लिए नया नाम

वैकल्पिक पैरामीटर

• ईटैग: समवर्ती नियंत्रण के लिए ETag मान। ऑपरेशन केवल तभी सफल होता है जब DriveItem का वर्तमान ETag मेल खाता हो

मेरे OneDrive में फ़ाइल या फ़ोल्डर हटाएँ

उपयोगकर्ता के OneDrive से कोई फ़ाइल या फ़ोल्डर (DriveItem) हटाता है.

आवश्यक पैरामीटर

• fileOrFolderId: हटाने के लिए फ़ाइल या फ़ोल्डर की ID

वैकल्पिक पैरामीटर

• ईटैग: समवर्ती नियंत्रण के लिए ETag मान

मेरे OneDrive में फ़ाइल या फ़ोल्डर साझा करें

उपयोगकर्ता के OneDrive में किसी फ़ाइल या फ़ोल्डर (DriveItem) पर पढ़ने या लिखने की अनुमतियाँ प्रदान करने के लिए साझाकरण आमंत्रण भेजता है.

आवश्यक पैरामीटर

• fileOrFolderId: साझा करने के लिए फ़ाइल या फ़ोल्डर की ID
• प्राप्तकर्ताईमेल: आमंत्रित करने के लिए प्राप्तकर्ताओं के ईमेल पतों की सरणी
• भूमिकाएँ: असाइन करने के लिए भूमिकाओं की सरणी। स्वीकृत मान: 'read', 'write' ('write' पढ़ने और लिखने दोनों की अनुमति देता है)

वैकल्पिक पैरामीटर

• संदेश: आमंत्रण ईमेल में शामिल करने के लिए कस्टम संदेश. डिफ़ॉल्ट: 'यहां वह फ़ाइल है जिस पर हम सहयोग कर रहे हैं।
• sendInvitation: क्या साझा करने का आमंत्रण भेजना है। डिफ़ॉल्ट: सच।

मेरे OneDrive में फ़ाइल पर संवेदनशीलता लेबल सेट करें

उपयोगकर्ता के OneDrive में किसी फ़ाइल का संवेदनशीलता लेबल सेट करता है.

आवश्यक पैरामीटर

• फाइलआईडी: फ़ाइल की ID (DriveItem)
• संवेदनशीलतालेबलआईडी: असाइन करने के लिए संवेदनशीलता लेबल की आईडी, या हटाने के लिए खाली स्ट्रिंग

वैकल्पिक पैरामीटर

• असाइनमेंट विधि: असाइनमेंट विधि: 'मानक', 'विशेषाधिकार', 'ऑटो', या 'unknownFutureValue' (डिफ़ॉल्ट: 'विशेषाधिकार')
• औचित्यपाठ: ऑडिट उद्देश्यों के लिए औचित्य पाठ; लेबल को डाउनग्रेड या हटाते समय आवश्यक (डिफ़ॉल्ट: 'MCPServer द्वारा परिवर्तित')

मेरे OneDrive में छोटी बाइनरी फ़ाइल बनाएँ

उपयोगकर्ता के OneDrive में उसकी सामग्री को base64-एन्कोड करके 5 MB से कम आकार की एक बाइनरी फ़ाइल बनाता है।

आवश्यक पैरामीटर

• फ़ाइल का नाम: फ़ाइल एक्सटेंशन सहित बनाने के लिए फ़ाइल का नाम
• आधार 64 सामग्री: बाइनरी फ़ाइल सामग्री को बेस64 स्ट्रिंग के रूप में एन्कोड किया गया है

वैकल्पिक पैरामीटर

• parentFolderId: पैरेंट फ़ोल्डर की आईडी (डिफ़ॉल्ट: 'रूट')।

मेरे OneDrive से छोटी बाइनरी फ़ाइल पढ़ें

उपयोगकर्ता के OneDrive से 5 MB से छोटी बायनेरी फ़ाइल पढ़ता है। फ़ाइल सामग्री को base64-एन्कोडेड स्ट्रिंग के रूप में लौटाता है.

आवश्यक पैरामीटर

• फाइलआईडी: पढ़ने या डाउनलोड करने के लिए फ़ाइल (DriveItem) की ID

copyFileOrFolderInMyOnedrive

किसी फ़ाइल या फ़ोल्डर (DriveItem) की उपयोगकर्ता के OneDrive में किसी गंतव्य फ़ोल्डर में प्रतिलिपि बनाता है. यह कार्रवाई अतुल्यकालिक है। प्रगति की निगरानी के लिए उपयोग करें checkOperationStatusInMyOnedrive ।

आवश्यक पैरामीटर

• सोर्सफाइलआईडी: प्रतिलिपि बनाने के लिए स्रोत फ़ाइल या फ़ोल्डर (DriveItem) की ID
• destfolderid: गंतव्य फ़ोल्डर की ID (उपयोगकर्ता के OneDrive में मौजूद होना चाहिए)

वैकल्पिक पैरामीटर

• नया फ़ाइल नाम: प्रतिलिपि बनाए गए आइटम के लिए नया नाम (मूल नाम के लिए डिफ़ॉल्ट)

मेरे OneDrive में फ़ाइल या फ़ोल्डर ले जाएँ

किसी फ़ाइल या फ़ोल्डर (DriveItem) को उपयोगकर्ता के OneDrive में किसी गंतव्य फ़ोल्डर में ले जाता है. यह कार्रवाई अतुल्यकालिक है। प्रगति की निगरानी के लिए उपयोग करें checkOperationStatusInMyOnedrive ।

आवश्यक पैरामीटर

• सोर्सफाइलआईडी: स्थानांतरित करने के लिए स्रोत फ़ाइल या फ़ोल्डर (DriveItem) की ID
• destfolderid: गंतव्य फ़ोल्डर की ID (उपयोगकर्ता के OneDrive में मौजूद होना चाहिए)

वैकल्पिक पैरामीटर

• नया फ़ाइल नाम: ले जाए गए आइटम के लिए नया नाम (मूल नाम के लिए डिफ़ॉल्ट)

checkOperationStatusInMyOnedrive

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

आवश्यक पैरामीटर

• ऑपरेशनटोकन: ऑपरेशन टोकन एक एसिंक्रोनस ऑपरेशन copyFileOrFolderInMyOnedrive से लौटाया गया जैसे या moveFileOrFolderInMyOnedrive

मुख्य सुविधाएँ

OneDrive प्रबंधन

• OneDrive जानकारी प्राप्त करता है, जैसे कोटा और स्वामी
• उपयोगकर्ता के व्यक्तिगत OneDrive तक पहुँचें
• सभी कार्रवाइयां प्रमाणीकृत उपयोगकर्ता के OneDrive को लक्षित करती हैं

फ़ाइल खोज और पता लगाना

• उपयोगकर्ता के OneDrive में नाम से फ़ाइलें और फ़ोल्डर्स खोजें
• ID या साझाकरण URL के ज़रिए फ़ाइल या फ़ोल्डर मेटाडेटा पाना
• फ़ोल्डर सामग्री ब्राउज़ करें (20 आइटम तक)।

फ़ाइल संचालन

• पाठ और बाइनरी फ़ाइलें बनाएँ (≤5 MB)
• पाठ और बाइनरी फ़ाइलें पढ़ें (≤5 MB)
• समवर्ती नियंत्रण के साथ फ़ाइलें हटाएँ
• eTag सुरक्षा के साथ फ़ाइलों का नाम बदलें
• फ़ाइलों और फ़ोल्डरों को अतुल्यकालिक रूप से कॉपी और स्थानांतरित करें

फ़ोल्डर प्रबंधन

• वैकल्पिक पैरेंट पथ के साथ फ़ोल्डर्स बनाएँ
• डुप्लिकेट फ़ोल्डर नामों के लिए स्वचालित सांख्यिक प्रत्यय।
• फ़ोल्डर सामग्री की सूची बनाएं (20 आइटम्स तक)
• फ़ोल्डर मेटाडेटा प्राप्त करें
• समवर्ती नियंत्रण के साथ फ़ोल्डर्स हटाएँ
• eTag सुरक्षा के साथ फ़ोल्डरों का नाम बदलें

साझाकरण और अनुमतियाँ

• उपयोगकर्ताओं के साथ फ़ाइलें और फ़ोल्डर्स साझा करें
• भूमिका-आधारित अभिगम नियंत्रण (पढ़ें, लिखें)
• साझा करने के लिए ईमेल सूचनाएं।
• आमंत्रणों में कस्टम संदेश।

सुरक्षा और अनुपालन

• संवेदनशीलता लेबल लागू करें और निकालें।
• मानक, विशेषाधिकार प्राप्त और ऑटो सहित कई असाइनमेंट विधियों का उपयोग करें।
• ऑडिट औचित्य का समर्थन करें।
• ईटैग के साथ समवर्ती नियंत्रण का उपयोग करें।

नोट्स

• सभी ऑपरेशन प्रमाणीकृत उपयोगकर्ता के व्यक्तिगत OneDrive को लक्षित करते हैं।
• फ़ाइल संचालन उन फ़ाइलों तक सीमित हैं जो अपलोड और डाउनलोड के लिए 5 एमबी या उससे कम हैं।
• हटाएं और नाम बदलें संचालन समवर्ती नियंत्रण के लिए eTags का समर्थन करते हैं।
• साझा करने के लिए मान्य ईमेल पते और उचित अनुमतियों की आवश्यकता होती है।
• संवेदनशीलता लेबल को उचित लाइसेंसिंग और कॉन्फ़िगरेशन की आवश्यकता होती है।
• फ़ोल्डर सूची डिफ़ॉल्ट रूप से अधिकतम 20 आइटम लौटाती है।