OData क्वेरी उदाहरण
नोट
Customer Insights - Data Dataverse एपीआई का उपयोग करके भी तालिकाओं तक पहुँचा जा सकता है। हम अनुशंसा करते हैं कि आप ग्राहक अंतर्दृष्टि डेटा की क्वेरी करने के लिए API का उपयोग करें क्योंकि वे अधिक व्यापक फ़िल्टरिंग, अधिक थ्रूपुट और कम विलंबता प्रदान करते हैं। Dataverse अधिक जानकारी के लिए, ग्राहक अंतर्दृष्टि के लिए API देखें Dataverse .
ओपन डेटा प्रोटोकॉल (OData) एक डेटा एक्सेस प्रोटोकॉल है जो HTTP जैसे कोर प्रोटोकॉल पर बनाया गया है। यह वेब के लिए REST जैसी सामान्यतः स्वीकृत पद्धतियों का उपयोग करता है। विभिन्न प्रकार के पुस्तकालय और उपकरण हैं जिनका उपयोग OData सेवाओं का उपभोग करने के लिए किया जा सकता है।
Dynamics 365 Customer Insights - Data APIs पर आधारित अपने स्वयं के कार्यान्वयन बनाने में आपकी सहायता के लिए, कुछ अक्सर अनुरोधित उदाहरण क्वेरीज़ की समीक्षा करें।
क्वेरी नमूनों को लक्ष्य वातावरण पर कार्य करने योग्य बनाने के लिए उन्हें संशोधित करें:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}जहाँ {instanceId} उस Customer Insights - Data पर्यावरण का GUID है जिसे आप क्वेरी करना चाहते हैं। ListAllInstances ऑपरेशन आपको वह खोजने देता है जिस तक आपकी पहुंच है। {InstanceId} - {CID}: एकीकृत ग्राहक रिकॉर्ड का GUID. उदाहरण:
ce759201f786d590bf2134bff576c369. - {AlternateKey}: डेटा स्रोत में ग्राहक रिकॉर्ड की प्राथमिक कुंजी का पहचानकर्ता. उदाहरण:
CNTID_1002 - {DSname}: डेटा स्रोत के तालिका नाम के साथ स्ट्रिंग जो Customer Insights - Data में सम्मिलित हो जाती है। उदाहरण:
Website_contacts. - {SegmentName}: Customer Insights - Data में एक खंड के आउटपुट तालिका नाम के साथ स्ट्रिंग। उदाहरण:
Male_under_40.
ग्राहक
ग्राहक तालिका के लिए नमूना क्वेरीज़.
| क्वेरी प्रकार | उदाहरण | नोट |
|---|---|---|
| एकल ग्राहक आईडी | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| वैकल्पिक कुंजी | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
वैकल्पिक कुंजियाँ एकीकृत ग्राहक तालिका में बनी रहती हैं |
| चुनें | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| इसमें | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| वैकल्पिक कुंजी + इन | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| खोज करें | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
किसी खोज स्ट्रिंग के लिए शीर्ष 10 परिणाम लौटाता है |
| खंड सदस्यता | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
विभाजन तालिका से पंक्तियों की एक पूर्व निर्धारित संख्या लौटाता है। |
| ग्राहक के लिए सेगमेंट सदस्यता | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
यदि वे दिए गए सेगमेंट के सदस्य हैं तो ग्राहक प्रोफ़ाइल लौटाता है |
एकीकृत गतिविधि
UnifiedActivity तालिका के लिए नमूना क्वेरीज़.
| क्वेरी प्रकार | उदाहरण | नोट |
|---|---|---|
| सीआईडी की गतिविधि | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
किसी विशिष्ट ग्राहक प्रोफ़ाइल की गतिविधियों को सूचीबद्ध करता है |
| गतिविधि अवधि | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityTime gt 2017-01-01T00:00:00.000Z and ActivityTime lt 2020-01-01T00:00:00.000Z |
अवधि में ग्राहक प्रोफ़ाइल की गतिविधियाँ |
| गतिविधि का प्रकार | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| प्रदर्शन नाम द्वारा गतिविधि | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| गतिविधि छँटाई | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
गतिविधियों को आरोही या अवरोही क्रम में क्रमबद्ध करें |
| ग्राहक के लिए सभी गतिविधियाँ और उपाय | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
गतिविधियाँ और उपाय लौटे ग्राहक प्रोफ़ाइल पर अतिरिक्त कुंजी/मूल्य जोड़े हैं |
वर्कफ़्लो प्रबंधित करें
प्रक्रियाओं से संबंधित नमूना क्वेरीज़, जैसे कि डेटा स्रोत को ताज़ा करना, डेटा को एकीकृत करना, या एकीकरण कार्य की स्थिति प्राप्त करना। Customer Insights - Data
| क्वेरी प्रकार | उदाहरण | नोट |
|---|---|---|
| डेटा स्रोत आईडी प्राप्त करें | {serviceRoot}/manage/datasources/v2 |
आपके परिवेश पर सभी डेटा स्रोत लौटाता है. प्रतिक्रिया से, आप किसी विशिष्ट डेटा स्रोत के लिए 'friendlyName' की जांच कर सकते हैं और फिर उसके 'dataSourceId' का उपयोग कर सकते हैं। |
| किसी डेटा स्रोत को रिफ्रेश करें | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
डेटा स्रोत को ताज़ा करने के लिए उपरोक्त प्रतिक्रिया से 'dataSourceId' का उपयोग करें। यह एक POST अनुरोध है. |
| पूर्ण रिफ्रेश चलाएं | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
आपके परिवेश पर सभी प्रक्रियाओं को ताज़ा करता है. यह एक POST अनुरोध है. |
| प्रक्रियाओं की स्थिति प्राप्त करें | {serviceRoot}/manage/workflows/main/jobs |
अन्य उदाहरण
अन्य तालिकाओं के लिए नमूना क्वेरीज़.
| क्वेरी प्रकार | उदाहरण | नोट |
|---|---|---|
| सीआईडी के उपाय | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| सीआईडी के समृद्ध ब्रांड | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| सीआईडी के समृद्ध हित | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| इन-क्लॉज + विस्तार | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
सीमाएँ
ग्राहक अंतर्दृष्टि API डिफ़ॉल्ट रूप से अधिकतम 100 ऑब्जेक्ट लौटाता है. आप मानक पृष्ठांकन तकनीकों का उपयोग करके 100 से अधिक लौटाई गई वस्तुओं को पार्स कर सकते हैं। वैकल्पिक रूप से, आप अपना डेटा निर्यात कर सकते हैं।
निम्नलिखित क्वेरीज़ समर्थित नहीं हैं:
-
$filterअंतर्ग्रहित स्रोत तालिकाओं पर. आप केवल उन सिस्टम तालिकाओं पर $filter क्वेरीज़ चला सकते हैं जो Customer Insights - Data बनाते हैं। -
$expandएक$searchक्वेरी से. उदाहरण के लिए:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey". -
$expand$selectसे, यदि विशेषताओं का केवल एक उपसमूह चुना गया हो. उदाहरण के लिए:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'. -
$expandकिसी विशेष ग्राहक के लिए समृद्ध ब्रांड या रुचि संबंध। उदाहरण के लिए:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'. - पूर्वानुमान मॉडल आउटपुट तालिकाओं को वैकल्पिक कुंजी के माध्यम से क्वेरी करें। उदाहरण के लिए:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.
-