Customer Insights - Data API के साथ काम करें

Dynamics 365 Customer Insights - Data ग्राहक अंतर्दृष्टि में आपके डेटा के आधार पर अपने स्वयं के एप्लिकेशन बनाने के लिए API प्रदान करता है। इन API का विवरण API संदर्भ पर सूचीबद्ध है। उनमें परिचालनों, मापदंडों और प्रतिक्रियाओं के बारे में अतिरिक्त जानकारी शामिल हैं.

नोट

Customer Insights - Data Dataverse एपीआई का उपयोग करके भी तालिकाओं तक पहुँचा जा सकता है। हम अनुशंसा करते हैं कि आप ग्राहक अंतर्दृष्टि डेटा की क्वेरी करने के लिए API का उपयोग करें क्योंकि वे अधिक व्यापक फ़िल्टरिंग, अधिक थ्रूपुट और कम विलंबता प्रदान करते हैं। Dataverse अधिक जानकारी के लिए, ग्राहक अंतर्दृष्टि के लिए API देखें Dataverse .

APIs आज़माना शुरू करें

व्यवस्थापक को आपके डेटा तक API पहुंच सक्षम करनी होगी. एक बार पहुंच सक्षम हो जाने पर, कोई भी उपयोगकर्ता सदस्यता कुंजी के साथ API का उपयोग कर सकता है।

1. लॉग इन करें ग्राहक अंतर्दृष्टि के परीक्षण संस्करण के लिए Customer Insights - Data या साइन अप करें।

2. सेटिंग्स>अनुमतियाँ पर जाएँ और APIs टैब चुनें.

3. यदि परिवेश तक API पहुँच सेट नहीं की गई है, तो सक्षम करें चुनें.

   API को सक्षम करने से आपके परिवेश के लिए एक प्राथमिक और द्वितीयक सदस्यता कुंजी बनती है जिसका उपयोग API अनुरोधों में किया जाता है। कुंजियों को पुन: उत्पन्न करने के लिए, प्राथमिक पुन: उत्पन्न करें या द्वितीयक पुन: उत्पन्न करें APIs टैब पर चयन करें।

4. API आज़माने के लिए हमारे API का अन्वेषण करें चुनें।

5. API ऑपरेशन खोजें और चुनें और इसे आज़माएँ चुनें.

   

6. साइड पैन में, प्राधिकरण ड्रॉपडाउन मेनू में मान को अंतर्निहित पर सेट करें. Authorization शीर्षक को वाहक टोकन के साथ जोड़ दिया जाता है। आपकी सदस्यता कुंजी स्वचालित रूप से भर दी जाती है.

7. वैकल्पिक रूप से, सभी आवश्यक क्वेरी मापदंड जोड़ें.

8. साइड पैन के नीचे स्क्रॉल करें और भेजें का चयन करें।

   HTTP प्रतिक्रिया फलक के नीचे प्रदर्शित होती है।

Azure पोर्टल में एक नया अनुप्रयोग पंजीकरण बनाएं

प्रत्यायोजित अनुमतियों का उपयोग करके Azure अनुप्रयोग में API का उपयोग करने के लिए एक नया ऐप पंजीकरण बनाएँ.

1. आरंभ करना अनुभाग को पूरा करें.

2. उस खाते से Azure पोर्टल में लॉग इन करें जो Customer Insights डेटा तक पहुँच सकता है. ...

3. खोजें और फिर ऐप पंजीकरण चुनें।

4. नया पंजीकरण चुनें, आवेदन का नाम प्रदान करें और खाता प्रकार चुनें।

   वैकल्पिक रूप से, एक रीडायरेक्ट URL जोड़ें. http://localhost आपके स्थानीय कंप्यूटर पर एप्लिकेशन विकसित करने के लिए पर्याप्त है।

5. पंजीकरण करें चुनें.

6. अपने नए ऐप पंजीकरण पर, API अनुमतियाँ पर जाएँ।

7. साइड पैन में अनुमति जोड़ें चुनें और Dynamics 365 AI for Customer Insights चुनें.

8. अनुमति प्रकार के लिए, प्रत्यायोजित अनुमतियाँ चुनें और फिर user_impersonation अनुमति का चयन करें.

9. अनुमतियाँ जोड़ें चयन करें.

10. ऐप पंजीकरण पूरा करने के लिए व्यवस्थापक सहमति प्रदान करें... का चयन करें।

11. उपयोगकर्ता के लॉग इन किए बिना API तक पहुंचने के लिए, सर्वर-से-सर्वर एप्लिकेशन अनुमतियाँ सेट करें पर जाएं।

आप इस ऐप पंजीकरण के लिए एप्लिकेशन/क्लाइंट आईडी का उपयोग Microsoft प्रमाणीकरण लाइब्रेरी (MSAL) के साथ कर सकते हैं, ताकि API को अपने अनुरोध के साथ भेजने के लिए एक वाहक टोकन प्राप्त किया जा सके।

हमारे क्लाइंट लाइब्रेरीज़ में API का उपयोग करने की जानकारी के लिए, ग्राहक अंतर्दृष्टि क्लाइंट लाइब्रेरीज़ देखें।

सर्वर-से-सर्वर अनुप्रयोग अनुमतियाँ सेट करें

ऐसा ऐप पंजीकरण बनाएं जिसके लिए उपयोगकर्ता सहभागिता की आवश्यकता न हो और जिसे सर्वर पर चलाया जा सके।

1. Azure पोर्टल में अपने ऐप पंजीकरण पर, API अनुमतियाँ पर जाएँ.

2. अनुमति जोड़ें चुनें.

3. मेरे संगठन द्वारा उपयोग किए जाने वाले API टैब का चयन करें और सूची से Dynamics 365 AI for Customer Insights चुनें.

4. अनुमति प्रकार के लिए, अनुप्रयोग अनुमतियाँ चुनें और फिर api.access अनुमति का चयन करें.

5. अनुमतियाँ जोड़ें चयन करें.

6. अपने ऐप पंजीकरण के लिए API अनुमतियों पर वापस जाएं।

7. ऐप पंजीकरण पूरा करने के लिए व्यवस्थापक सहमति प्रदान करें... का चयन करें।

8. Customer Insights - Dataमें उपयोगकर्ता के रूप में ऐप पंजीकरण का नाम जोड़ें.

   1. खोलें Customer Insights - Data, सेटिंग अनुमतियाँ>पर जाएँ और उपयोगकर्ता जोड़ें चुनें .

   2. अपने ऐप पंजीकरण का नाम खोजें, इसे खोज परिणामों से चुनें और सहेजें चुनें ।

नमूना क्वेरीज़

API के साथ कार्य करने के लिए OData नमूना क्वेरीज़ की छोटी सूची के लिए, OData क्वेरी उदाहरण देखें.

Customer Insights क्‍लाइंट लाइब्रेरी

एपीआई के लिए उपलब्ध क्लाइंट लाइब्रेरी का उपयोग करना शुरू करें Customer Insights - Data । सभी पुस्तकालय स्रोत कोड और नमूना अनुप्रयोग GitHub रेपो पर पाए जा सकते हैं।

C# NuGet

C# क्लाइंट लाइब्रेरी from.org NuGet का उपयोग करें। वर्तमान में, पैकेज netstandard2.0 और netcoreapp2.0 फ्रेमवर्क को लक्षित करता है। पैकेज पर अधिक जानकारी के NuGet लिए, Microsoft.Dynamics.CustomerInsights.API देखें।

C# क्लाइंट लाइब्रेरी को C# प्रोजेक्ट में जोड़ें

1. में Visual Studio, अपने प्रोजेक्ट के NuGet लिए पैकेज मैनेजर खोलें।

2. Microsoft.Dynamics.CustomerInsights.API खोजें.

3. प्रोजेक्ट में पैकेज जोड़ने के लिए इंस्टॉल का चयन करें।

   वैकल्पिक रूप से, पैकेज प्रबंधक कंसोल NuGet मेंयह आदेश चलाएँ: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

C# क्लाइंट लाइब्रेरी का उपयोग करें

1. अपने मौजूदा Azure अनुप्रयोग पंजीकरण का उपयोग करने के AccessToken लिए Microsoft प्रमाणीकरण लाइब्रेरी (MSAL) काउपयोग करें.

2. टोकन को सफलतापूर्वक प्रमाणित करने और प्राप्त करने के बाद, एक नया निर्माण करें या DefaultRequestHeaders "प्राधिकरण" के साथ मौजूदा HttpClient का उपयोग करें, जो कि Bearer "पहुँच टोकन" पर सेट है और Ocp-Apim-Subscription-Key आपके परिवेश से सदस्यता कुंजी पर सेट है Customer Insights - Data ।

   उचित होने पर प्राधिकरण हेडर रीसेट करें। उदाहरण के लिए, जब टोकन समाप्त हो गया है.

3. इसे HttpClient क्लाइंट के निर्माण में पास करें CustomerInsights ।

4. क्लाइंट के साथ "एक्सटेंशन विधियों" पर कॉल करें, उदाहरण के लिए, GetAllInstancesAsync। यदि अंतर्निहित Microsoft.Rest.HttpOperationResponse तक पहुंच को प्राथमिकता दी जाती है, तो "http संदेश विधियों" का उपयोग करें, उदाहरण के लिए, GetAllInstancesWithHttpMessagesAsync।

5. प्रतिक्रिया object टाइप होने की संभावना है क्योंकि विधि कई प्रकार लौटा सकती है (उदाहरण के लिए, IList<InstanceInfo> और ApiErrorResult). रिटर्न प्रकार की जांच करने के लिए, उस ऑपरेशन के लिए API विवरण पृष्ठ पर निर्दिष्ट प्रतिक्रिया प्रकारों में ऑब्जेक्ट का उपयोग करें।

   यदि अनुरोध पर अधिक जानकारी की आवश्यकता है, तो अपुष्ट प्रतिसाद ऑब्जेक्ट तक पहुँचने के लिए http संदेश विधियों का उपयोग करें।

NodeJS पैकेज

एनपीएम के माध्यम से उपलब्ध नोडजेएस क्लाइंट लाइब्रेरी का उपयोग करें: https://www.npmjs.com/package/@microsoft/customerinsights

Python पैकेज

PyPi के माध्यम से उपलब्ध Python क्लाइंट लाइब्रेरी का उपयोग करें: https://pypi.org/project/customerinsights/