أمثلة على استعلامات OData
ملاحظة
Customer Insights - Data يمكن أيضا الوصول إلى جداول باستخدام Dataverse واجهات برمجة التطبيقات (APIs). من المستحسن استخدام واجهات Dataverse برمجة التطبيقات للاستعلام عن بيانات Customer Insights حيث أنها توفر تصفية شاملة أكبر وناصا أكبر وتأخرا أقل. لمزيد من المعلومات، راجع Dataverse واجهات برمجة التطبيقات ل Customer Insights.
بروتوكول البيانات المفتوحة (OData) هو بروتوكول وصول إلى البيانات مبني على بروتوكولات أساسية مثل HTTP. تستخدم منهجيات مقبولة بشكل عام مثل REST للويب. هناك أنواع مختلفة من المكتبات والأدوات التي يمكن استخدامها لاستهلاك خدمات OData.
لمساعدتك في بناء تطبيقاتك الخاصة بناءً على Dynamics 365 Customer Insights - Data APIs, قم بمراجعة بعض نماذج الاستعلامات المطلوبة بشكل متكرر.
قم بتعديل نماذج الاستعلام لجعلها تعمل في البيئات المستهدفة:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}حيث {instanceId} هو GUID ل Customer Insights - Data البيئة التي تريد الاستعلام عنها. تتيح عملية 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}' |
تستمر المفاتيح البديلة في جدول العميل الموحد |
| Select | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| خلال | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| مفتاح بديل + In | {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.
| نوع الاستعلام | مثال | ملاحظة |
|---|---|---|
| نشاط CID | {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 |
أمثلة أخرى
نموذج استعلامات لجداول أخرى.
| نوع الاستعلام | مثال | ملاحظة |
|---|---|---|
| مقاييس CID | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| الأسماء التجارية التي تم إثراؤها لـ CID | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| الاهتمامات التي تم إثراؤها لـ CID | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| في بند + توسيع | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
القيود
ترجع واجهة API لـ Customer Insights حد أقصى من 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}'.
-