Aracılığıyla paylaş

Ürün kaynakları

  • Makale

Satın alabilen malları veya hizmetleri temsil eden kaynaklar. Ürün türünü ve şeklini (SKU) açıklamaya ve ürünün stoktaki kullanılabilirliğini denetlemeye yönelik kaynakları içerir.

Ürün

Satın alabilen bir iyi veya hizmeti temsil eder. Tek başına bir ürün satın alınabilen bir ürün değildir.

Özellik Türü Açıklama
id String Bir ürünün kimliği.
başlık String Ürün başlığı.
açıklama String Ürün açıklaması.
productType ItemType Bu ürünün tür kategorilerini açıklayan bir nesne.
isMicrosoftProduct Boole Ürünün bir Microsoft ürünü olup olmadığını gösterir.
publisherName String Varsa ürünün yayımcısının adı.
bağlantılar ProductLinks Ürünün içinde yer alan kaynak bağlantıları.

ItemType

Bir ürünün türünü temsil eder.

Özellik Türü Açıklama
id String Tür tanımlayıcısı.
displayName String Öğe türünün görünen adı.
subType ItemType isteğe bağlı. Bir öğe türü için alt tür kategorisini açıklayan nesne.

Bir Ürün için bağlantıların listesini içerir.

Özellik Türü Açıklama
sku'lar Bağlantı Temel alınan SKU'lara erişme bağlantısı.
bağlantılar ResourceLinks Bir kaynağın içinde yer alan kaynak bağlantıları.

Sku

Bir ürün altında satın alabilen Stok Tutma Birimi'ni (SKU) temsil eder.

Özellik Türü Açıklama
id String SKU'nun kimliği. Kimlik yalnızca ana ürünü bağlamında benzersizdir.
başlık String SKU'nun başlığı.
açıklama String SKU'nun açıklaması.
productId String SKU içeren üst Ürünün kimliği.
minimumQuantity Int Satın alma için izin verilen minimum miktar.
maximumQuantity Int Satın alma için izin verilen maksimum miktar.
isTrial Boole SKU'nun deneme öğesi olup olmadığını gösterir.
supportedBillingCycles Dizeler dizisi SKU için desteklenen faturalama döngülerinin listesi. Desteklenen değerler BillingCycleType içinde bulunan üye adlarıdır.
purchasePrerequisites Dizeler dizisi Bir öğe satın almadan önce gerekli olan önkoşul adımlarının veya eylemlerin listesi. Desteklenen değerler şunlardır:
"InventoryCheck" - Bir madde satın alma girişiminde bulunilmeden önce öğenin envanterinin değerlendirilmesi gerektiğini gösterir.
"AzureSubscriptionRegistration" - Bir öğe satın almayı denemeden önce bir Azure aboneliğinin gerekli olduğunu ve kaydedilmesi gerektiğini gösterir.
inventoryVariables Dizeler dizisi Bir öğede envanter denetimi yürütmek için gereken değişkenlerin listesi. Desteklenen değerler şunlardır:
"CustomerId" - Satın alma işleminin olacağı müşterinin kimliği.
"AzureSubscriptionId" - Azure rezervasyon satın alma işlemi için kullanılacak Azure aboneliğinin kimliği.
"ArmRegionName" - Envanterin doğrulandığı bölge. Bu değer, SKU'nun DynamicAttributes değerindeki "ArmRegionName" değeriyle eşleşmelidir.
provisioningVariables Dizeler dizisi Bir öğe satın alınırken sepet satırı öğesinin sağlama bağlamında sağlanması gereken değişkenlerin listesi. Desteklenen değerler şunlardır:
Kapsam - Azure rezervasyon satın alma kapsamı: "Tek", "Paylaşılan".
"SubscriptionId" - Azure rezervasyon satın alma işlemi için kullanılacak Azure aboneliğinin kimliği.
"Süre" - Azure rezervasyonunun süresi: "1Year", "3Year".
dynamicAttributes anahtar/değer çiftleri Bir öğeye uygulanan dinamik özelliklerin sözlüğü. Sözlükteki özellikler dinamiktir ve bildirimde bulunmadan değişebilir. İş ortakları, bir özelliğin değerinde var olan belirli anahtarlar üzerinde güçlü bağımlılıklar oluşturmaktan kaçınmalıdır.
bağlantılar ResourceLinks SKU'nun içinde yer alan kaynak bağlantıları.
AttestationProperties AttestationProperties SKU'nun kanıtlama özellikleri.
consumptionType String Yalnızca sku fazla kullanım gibi tüketimi destekliyorsa kullanılabilir.
specializedOfferProperties özelleştirilmişOfferProperties listesi Yalnızca ürün, SpecializedOffer'ın alt Türü olduğunda kullanılabilir.
minimumPurchaseCommitment MinimumPurchaseCommitment İşlem hizmetlerinde işlenen sabit tutar.

Dinamik SKU öznitelikleri

Yeni ticari lisans tabanlı ürün ve hizmetlerle ilgili önemli özellikler.

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

Özellik Türü Açıklama
hasConstraints Boolean SKU'nun assetContraints içerip içermediğini açıklar
isAddon Boolean SKU'nun bir eklenti olup olmadığını açıklar
prerequisiteSkus dizeler dizisi Eklentinin çalışabileceği ürünleri ve sku'ları açıklar
upgradeTargetOffers dizeler dizisi Öğenin yükseltebileceği ürünlerin ve sku'ların listesi
conversionInstructions conversionInstructions listesi Dönüştürme işlemleri için geçerli yönergelerin listesi

specializedOfferProperties

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

Yalnızca "SpecializedOffers" ürün alt Türleri için geçerlidir

Özellik Türü Açıklama
startDate String Yönergelerin uygulandığı terim kimlikleri
endDate String Yenilemeleri tanımlayan seçenekler
pricingPolicies Fiyatlandırmaİlkeler listesi Promosyon indirimi türlerini ve değerlerini tanımlayan ilkelerin listesi.

MinimumPurchaseCommitment

İşlem hizmetlerinde işlenebilen minimum tutarın öznitelikleri.

Özellik Türü Açıklama
tane String En düşük satın alma taahhüdü dönemi.
currencyCode Sözlük<Dizesi, Dize> Kaydedilebilecek minimum tutarın "para birimi" ve "simgesi".
amount Int İşlem hizmetlerine işlenebilen minimum tutar.

PricingPolicies

Promosyon indirimi türlerini ve değerlerini açıklama.

Özellik Türü Açıklama
Tür String İndirimin yüzdelere mi yoksa sabit fiyat indirimlerine mi dayandığını açıklayın.
değer String Uygulanan indirim miktarını tanımlar.

Kullanılabilirlik

Bir SKU'nun satın alınabilir olduğu bir yapılandırmayı (ülke/bölge, para birimi ve sektör segmenti gibi) temsil eder.

Özellik Türü Açıklama
id String Bu kullanılabilirlik kimliği. Bu kimlik yalnızca ana ürünü ve SKU'su bağlamında benzersizdir. Not Kullanılabilirlik kimlikleri zaman içinde değişebilir. İş ortakları, bu değeri aldıktan sonra yalnızca kısa bir süre içinde bu değere güvenmelidir.
productId String Bu kullanılabilirliği içeren ürünün kimliği.
skuId String Bu kullanılabilirliği içeren SKU'nun kimliği.
catalogItemId String Katalogdaki bu öğenin benzersiz tanımlayıcısı. Bu kimlik, üst SKU satın alınırken OrderLineItem.OfferId veya CartLineItem.CatalogItemId özelliklerine doldurulmalıdır. Not Bu kimlik zaman içinde değişebilir. Bu değeri aldıktan sonra yalnızca kısa bir süre içinde kullanmanız gerekir. Yalnızca satın alma sırasında erişilmeli ve kullanılmalıdır.
defaultCurrency String Bu kullanılabilirlik için desteklenen varsayılan para birimi.
segment String Bu kullanılabilirlik için sektör segmenti. Desteklenen değerler şunlardır: Ticari, Eğitim, Kamu, Kar Amacı Gütmeyen Kuruluş.
ülke String Bu kullanılabilirlik durumunun geçerli olduğu ülke veya bölge (ISO ülke kodu biçiminde).
isPurchasable Boole Bu kullanılabilirlik satın alıp almadığını gösterir.
isRenewable Boole Bu kullanılabilirlik durumunun yenilenebilir olup olmadığını gösterir.
RenewalInstructions RenewalInstruction Belirli bir kullanılabilirlik için yenileme yönergelerini temsil eder.
ürün Ürün Bu kullanılabilirliğe karşılık gelen ürün.
sku Sku Bu kullanılabilirlik SKU'sunun karşılık gelir.
Terim Terim kaynakları dizisi Bu kullanılabilirlik için geçerli koşulların koleksiyonu.
bağlantılar ResourceLinks Kullanılabilirlik içinde yer alan kaynak bağlantıları.

Yenileme yönergesi

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

Belirli bir kullanılabilirlik için yenileme yönergelerini temsil eder.

Özellik Türü Açıklama
applicableTermIds Dizeler dizisi Yönergelerin uygulandığı terim kimlikleri
RenewalOptions RenewalOption Dizisi Yenilemeleri tanımlayan seçenekler

RenewalOption

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

Belirli bir kullanılabilirlik için yenileme yönergelerini temsil eder.

Özellik Türü Açıklama
renewToId String Yenilenecek ürünü ve sku'yu temsil eder
isAutoRenewable Boole Kullanılabilirlik durumunun otomatik olarak yenilenip yenilenemeyeceğini

Süre

Kullanılabilirlik satın alınabilecek bir terimi temsil eder.

Özellik Türü Açıklama
süre String Terimin süresinin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (bir ay), P1Y (bir yıl) ve P3Y (üç yıl) değerleridir.
açıklama String Terimin açıklaması.

InventoryCheckRequest

Belirli katalog öğelerine göre envanteri denetleme isteğini temsil eder.

Özellik Türü Açıklama
targetItems InventoryItem Dizisi Stok denetiminin değerlendireceği katalog öğelerinin listesi.
inventoryContext Anahtar/değer çiftleri Envanter denetimlerini gerçekleştirmek için gereken bağlam değerlerinin sözlüğü. Ürünlerin her SKU'su , bu işlemi gerçekleştirmek için hangi değerlerin (varsa) gerekli olduğunu tanımlar.
bağlantılar ResourceLinks Envanter denetimi isteğinde yer alan kaynak bağlantıları.

InventoryItem

Envanter denetimi işleminde tek bir öğeyi temsil eder. Bu kaynak, giriş isteğinde hedef öğeleri belirtmek için kullanılır ve envanter denetimi işleminin çıkış sonuçlarını göstermek için de kullanılır.

Özellik Türü Açıklama
productId String (Gerekli) Ürünün kimliği.
skuId String SKU'nun kimliği. Bu kaynağı bir envanter isteğine giriş olarak kullanırken, bu değer isteğe bağlıdır. Bu değer sağlanmazsa, ürünün altındaki tüm SKU'lar stok denetimi işleminin hedef öğeleri olarak kabul edilir.
isRestricted Boole Bu öğenin kısıtlı bir envantere sahip olup olmadığını gösterir.
Kısıtlama -ları InventoryRestriction Dizisi Bu öğe için bulunan kısıtlamaların ayrıntıları. Bu özellik yalnızca isRestricted = "true" olduğunda doldurulur.

InventoryRestriction

Envanter kısıtlamasının ayrıntılarını temsil eder. Bu ayrıntılar yalnızca envanter denetimi çıktı sonuçları için geçerlidir, giriş istekleri için geçerli değildir.

Özellik Türü Açıklama
reasonCode String Kısıtlamanın nedenini tanımlayan kod.
açıklama String Stok kısıtlamasının açıklaması.
özellikler Anahtar/değer çiftleri Kısıtlama hakkında daha fazla ayrıntı sağlayabilen özelliklerin sözlüğü.

BillingCycleType

Bir faturalama döngüsü türünü gösteren değerler içeren [Enum/dotnet/api/system.enum).

Değer Position Açıklama
Bilinmiyor 0 Sabit listesi başlatıcısı.
Aylık 1 İş ortağının aylık olarak ücretlendirileceğini gösterir.
Yıllık 2 İş ortağının yıllık olarak ücretlendirileceğini gösterir.
Hiçbiri 3 İş ortağından ücret alınmayacak olduğunu gösterir. Bu değer deneme öğeleri için kullanılabilir.
OneTime 4 İş ortağının bir kez ücretlendirileceğini gösterir.
Trienali 5 İş ortağının her üç yılda bir ücretlendirileceğini gösterir.

AttestationProperties

Bir kanıtlama türünü ve satın almak için gerekli olup olmadığını temsil eder.

Özellik Türü Açıklama
attestationType String Kanıtlama türünü gösterir. Windows 365 ürünleri Windows 365 değerine sahip olacaktır. Windows 365 kanıtlama metni "Windows 365 İş'i Windows Hibrit Avantajı kullanan her kişinin birincil iş cihazında windows 10/11 Pro'nun geçerli bir kopyasının da yüklü olması gerektiğini anlıyorum."
enforceAttestation Boolean Satın alma için kanıtlama gerekip gerekmediğini gösterir.