Customer Insights - Data API'leriyle çalışma

Dynamics 365 Customer Insights - Data, Customer Insights'ndeki verilerinize göre kendi uygulamalarınızı oluşturmak için API'ler sağlar. Bu API'lerin ayrıntıları API başvurusunda listelenir. İşlemler, parametreler ve yanıtlar hakkında ek bilgiler içerirler.

Not

Customer Insights - Data tablolarına ayrıca Dataverse API'leri kullanılarak da erişilebilir. Daha kapsamlı filtreleme, daha yüksek aktarım hızı ve daha düşük gecikme süresi sunduklarından, Customer Insights verilerini sorgulamak için Dataverse API'lerini kullanmanızı öneririz. Daha fazla bilgi için bkz. Customer Insights için Dataverse API'leri.

API'leri denemeye başlama

Bir yönetici verilerinize API erişimini etkinleştirmelidir. Erişim etkinleştirildiğinde kullanıcılar abonelik anahtarıyla API'yi kullanabilir.

1. Customer Insights - Data'da kaydolun veya Customer Insights deneme sürümü için oturum açın.

2. Ayarlar>İzinler'e gidin ve API'ler sekmesini seçin.

3. Ortama API erişimi ayarlanmadıysa Etkinleştir'i seçin.

   API'lerin etkinleştirilmesi, API isteklerinde kullanılan ortamınız için birincil ve ikincil bir abonelik anahtarı oluşturur. Anahtarları yeniden oluşturmak için API'ler sekmesinde Birincili yeniden oluştur veya İkincili yeniden oluştur'u seçin.

4. API'leri denemek için API'lerimizi keşfedin seçeneğini belirleyin.

5. API işlemi arayıp seçin ve Deneyin seçeneğini belirleyin.

   

6. Yan bölmede, Yetkilendirme açılan menüsündeki değeri örtük olarak ayarlayın. Authorization Üstbilgi bir taşıyıcı belirteci ile eklenir. Abonelik anahtarınız otomatik olarak doldurulur.

7. İsteğe bağlı olarak, tüm gerekli sorgu parametrelerini ekleyin.

8. Yan bölmenin alt kısmına gidin ve Gönder'i seçin.

   HTTP yanıtı, bölmenin alt kısmında görüntülenir.

Azure portalında yeni uygulama kaydı oluşturma

Atanmış izinleri kullanarak bir Azure uygulamasında API'leri kullanmak için yeni bir uygulama kaydı oluşturun.

1. Başlarken bölümünü tamamlayın.

2. Customer Insights verilerine erişim sağlayabilen hesapla Azure portalında oturum açın.

3. Uygulama kayıtları'nı arayın ve ardından seçin.

4. Uygulama adını girmek için Yeni kayıt seçeneğini belirleyin ve hesap türünü seçin.

   İsteğe bağlı olarak, yeniden yönlendirme URL'si ekleyin. http://localhost, yerel bilgisayarınızda bir uygulama geliştirmek için yeterlidir.

5. Kaydol'u seçin.

6. Yeni Uygulama kaydınızda, API izinleri'ne gidin.

7. İzin ekle'yi seçin ve yan bölmede Customer Insights için Dynamics 365 AI'yi seçin.

8. İzin türü için, Temsilci izinleri'ni seçin ve sonra user_impersonation iznini seçin.

9. İzinler ekle'yi seçin.

10. Uygulama kaydını tamamlamak için Şunun için yönetici onayı ver... seçeneğini belirleyin.

11. Kullanıcı oturum açma işlemi olmadan API'ye erişmek için Sunucudan sunucuya uygulama izinlerini ayarlama bölümüne gidin.

API'ye isteğinizle birlikte göndermek üzere bir taşıyıcı belirteç almak için Microsoft Kimlik Doğrulaması Kitaplığı (MSAL) ile bu uygulama kaydının Uygulama/İstemci Kimliğini kullanabilirsiniz.

İstemci kitaplıklarımızda API'leri kullanma hakkında bilgi için, bkz. Customer Insights istemci kitaplıkları.

Sunucudan sunucuya uygulama izinlerini ayarlama

Kullanıcı etkileşimi gerekmeyen ve bir sunucu üzerinde çalıştırılabilecek bir uygulama kaydı oluşturun.

1. Azure portalındaki Uygulama kaydınızda API izinleri'ne gidin.

2. İzin ekle'yi seçin.

3. Organizasyonumun kullandığı API'ler sekmesini seçin ve listeden Customer Insights için Dynamics 365 AIi seçin.

4. İzin türü için Uygulama izinleri'ni seçin ve ardından api.access iznini seçin.

5. İzinler ekle'yi seçin.

6. Uygulama kaydınız için API izinleri'ne geri dönün.

7. Uygulama kaydını tamamlamak için Şunun için yönetici onayı ver... seçeneğini belirleyin.

8. Uygulama kaydının adını Customer Insights - Data'da kullanıcı olarak ekleyin.

   1. Customer Insights - Data platformunu açın, Ayarlar>İzinler öğelerine gidin ve Kullanıcılar ekle seçeneğini belirleyin.

   2. Uygulama kaydınızın adını arayıp arama sonuçlarından seçin ve Kaydet'i seçin.

Örnek sorgular

API'lerle çalışacak şekilde OData örneklerinin kısa bir listesi için bkz. OData sorgu örnekleri.

Customer Insights istemci kitaplıkları

Customer Insights - Data API'leri için kullanılabilir istemci kitaplıklarını kullanmaya başlayın. Tüm kitaplık kaynak kodu ve örnek uygulamalar GitHub repo ortamında bulunabilir.

C# NuGet

NuGet.org adresindeki C# istemci kitaplıklarını kullanın. Şu anda pakette, netstandard2.0 ve netcoreapp2.0 çerçeveleri hedeflenmektedir. NuGet paketi hakkında daha fazla bilgi için bkz. Microsoft.Dynamics.CustomerInsights.Api.

C# projesine C# istemci kitaplığı ekleme

1. Visual Studio'da, projenizin NuGet Paket Yöneticisi'ni açın.

2. Microsoft.Dynamics.CustomerInsights.Api için arama yapın.

3. Projeye paketi eklemek için Yükle'yi seçin.

   Alternatif olarak, NuGet Paket Yöneticisi Konsolu'nda bu komutu çalıştırın: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

C# istemci kitaplığını kullanma

1. Mevcut Azure uygulama kaydınızı kullanarak AccessToken belirtecini almak için Microsoft Kimlik Doğrulaması Kitaplığını (MSAL) kullanın.

2. Bir belirtecin kimlik doğrulamasını başarıyla tamamladıktan ve aldıktan sonra Customer Insights - Data ortamınızda yeni bir HttpClient ya da Bearer "erişim belirteci"ne ayarlanmış DefaultRequestHeaders Yetkilendirmesiyle ve abonelik anahtarına ayarlanmış Ocp-Apim-Abonelik-Anahtarı ile varolanı kullanın.

   Uygun olduğunda Yetkilendirme üst bilgisini sıfırlayın. Örneğin, belirtecin süresi dolduğunda.

3. Bu HttpClient istemcisini CustomerInsights istemcisinin yapısına aktarın.

4. Müşteri ile (örneğin, GetAllInstancesAsync gibi) "uzantı yöntemleri" için görüşmeler yapın. Temel Microsoft.Rest.HttpOperationResponse öğesine erişim tercih ediliyorsa (örneğin, GetAllInstancesWithHttpMessagesAsync gibi) "http ileti yöntemlerini" kullanın.

5. Bu yöntem birden çok türü (örneğin, IList<InstanceInfo> ve ApiErrorResult) döndürebileceğinden yanıt, object türü olabilir. Dönüş türünü denetlemek için API ayrıntıları sayfasında belirtilen yanıt türlerindeki nesneleri kullanın.

   İstek hakkında daha fazla bilgi gerekiyorsa ham yanıt nesnesine erişmek için http ileti yöntemlerini kullanın.

NodeJS paketi

NPM'den elde edilecek NodeJS istemci kitaplıklarını kullanın: https://www.npmjs.com/package/@microsoft/customerinsights

Python paketi

PyPi'dan elde edilecek Python istemci kitaplıklarını kullanın: https://pypi.org/project/customerinsights/