Microsoft Store 產品的資料結構描述
當您將應用程式或附加元件等產品提交至市集時，市集會針對該產品及其授權維護完整的資料集。 在應用程式的程式碼中，您可以使用 Windows.Services.Store 命名空間中的屬性，以程式設計方式存取其中的一些資料。 例如，您可以使用 StoreProduct.Description 和 StoreProduct.Price 屬性，擷取目前應用程式的描述和價格，或目前應用程式的附加元件。
不過，Windows.Services.Store 命名空間中預先定義的屬性不會公開市集中產品的大部分資料。 若要在您的程式碼中存取產品的完整資料，您可以改用下列一般屬性：
- StoreProduct.ExtendedJsonData
- StoreSku.ExtendedJsonData
- StoreAvailability.ExtendedJsonData
- StoreCollectionData.ExtendedJsonData
- StoreAppLicense.ExtendedJsonData
- StoreLicense.ExtendedJsonData
- StorePurchaseProperties.ExtendedJsonData
這些屬性會以 JSON 格式字串傳回相對應物件的完整資料。 本文提供這些屬性所傳回之資料的完整結構描述。
注意
市集中的產品會組織在產品、SKU 和可用性物件的階層中。 如需詳細資訊，請參閱產品、SKU 和可用性。
StoreProduct、StoreSku、StoreAvailability 和 StoreCollectionData 的結構描述
下列結構描述會描述 StoreProduct.ExtendedJsonData 所傳回的 JSON 格式字串。 StoreSku.ExtendedJsonData、StoreAvailability.ExtendedJsonData 和 StoreCollectionData.ExtendedJsonData 属性只會分別傳回 DisplaySkuAvailabilities\Sku、DisplaySkuAvailabilities\Availabilities 和 DisplaySkuAvailabilities\Sku\CollectionData 路徑下定義的結構描述部分。
如需 StoreProduct.ExtendedJsonData 所傳回的 JSON 格式字串範例，請參閱本節。
{
"type": "object",
"properties": {
"ProductId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
},
"ProductKind": {
"type": "string"
},
"LocalizedProperties": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": {
"type": "object",
"properties": {
"DeveloperName": {
"type": [ "string", "null" ]
},
"PublisherName": {
"type": [ "string", "null" ]
},
"PublisherWebsiteUri": {
"type": [ "string", "null" ]
},
"SupportUri": {
"type": [ "string", "null" ]
},
"EligibilityProperties": {
"type": [ "object", "null" ],
"properties": {
"Affirmations": {
"type": "array",
"items": {
"$ref": "#/definitions/affirmationDescription"
}
},
"Remediations": {
"type": "array",
"items": {
"$ref": "#/definitions/remediationDescription"
}
}
},
"additionalProperties": false
},
"ProductTitle": {
"type": "string"
},
"ProductDescription": {
"type": [ "string", "null" ]
},
"Language": {
"type": "string"
},
"Images": {
"type": [ "array", "null" ],
"items": {
"$ref": "#/definitions/image"
}
},
"Videos": {
"type": [ "array", "null" ],
"items": {
"$ref": "#/definitions/video"
}
},
"SearchTitles": {
"type": [ "array", "null" ],
"items": {
"type": "object",
"properties": {
"SearchTitleType": {
"type": "string"
},
"SearchTitleString": {
"type": "string"
}
},
"required": [
"SearchTitleType",
"SearchTitleString"
]
}
}
},
"required": [
"ProductTitle",
"Language"
],
"additionalProperties": false
}
},
"MarketProperties": {
"type": [ "array", "null" ],
"minItems": 0,
"maxItems": 1,
"items": {
"type": "object",
"properties": {
"RelatedProducts": {
"type": [ "array", "null" ],
"items": {
"type": "object",
"properties": {
"RelationshipType": {
"type": "string"
},
"RelatedProductId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
}
},
"required": [
"RelationshipType",
"RelatedProductId"
]
}
}
},
"additionalProperties": false
}
},
"Properties": {
"type": [ "object", "null" ],
"properties": {
"InAppOfferToken": {
"type": "string"
},
"PackageFamilyName": {
"type": [
"string",
"null"
]
},
"Category": {
"type": "string"
},
"IsAwardable": {
"type": "boolean"
},
"IsColorizable": {
"type": "boolean"
},
"Is3DExportable": {
"type": "boolean"
}
},
"additionalProperties": false
},
"DisplaySkuAvailabilities": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/sku"
}
}
},
"required": [
"ProductId",
"ProductKind",
"LocalizedProperties",
"DisplaySkuAvailabilities"
],
"format": "Product",
"definitions": {
"sku": {
"type": "object",
"properties": {
"Sku": {
"type": "object",
"properties": {
"SkuId": {
"type": "string",
"pattern": "^[0-9A-Z]{4}$"
},
"Properties": {
"type": "object",
"properties": {
"FulfillmentType": {
"type": [ "string", "null" ]
},
"CustomDeveloperData": {
"type": [ "string", "null" ]
},
"IsTrial": {
"type": [ "boolean", "null" ]
},
"SkuDisplayRank": {
"type": [ "integer", "null" ]
},
"BundledSkus": {
"type": [ "array", "null" ],
"items": {
"type": "object",
"properties": {
"BigId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}(?:/[0-9A-Z]{4})?$"
}
},
"additionalProperties": false
}
},
"ConsumableQuantity": {
"type": "integer",
"minimum": 1,
"format": "ConsumableQuantity"
},
"IsRepurchasable": {
"type": "boolean"
},
"Packages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"PackageUri": {
"type": "string"
}
},
"required": [ "PackageUri" ],
"additionalProperties": false
}
}
},
"additionalProperties": false,
"format": "SkuProperties"
},
"LocalizedProperties": {
"type": "array",
"minItems": 0,
"maxItems": 1,
"items": {
"type": "object",
"properties": {
"SkuTitle": {
"type": [ "string", "null" ]
},
"SkuDescription": {
"type": [ "string", "null" ]
},
"SkuButtonTitle": {
"type": [ "string", "null" ]
},
"Language": {
"type": "string"
},
"Images": {
"type": [ "array", "null" ],
"items": {
"$ref": "#/definitions/image"
}
},
"Videos": {
"type": [ "array", "null" ],
"items": {
"$ref": "#/definitions/video"
}
},
"LegalText": {
"type": [ "object", "null" ],
"properties": {
"Tou": {
"type": [ "string", "null" ]
},
"TouUri": {
"type": [ "string", "null" ]
},
"Copyright": {
"type": [ "string", "null" ]
},
"CopyrightUri": {
"type": [ "string", "null" ]
},
"PrivacyPolicy": {
"type": [ "string", "null" ]
},
"PrivacyPolicyUri": {
"type": [ "string", "null" ]
},
"AdditionalLicenseTerms": {
"type": [ "string", "null" ]
}
},
"additionalProperties": false
},
"SkuDisplayRank": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Dimension": {
"type": "string"
},
"Rank": {
"type": "integer"
}
},
"additionalProperties": false
}
}
},
"required": [
"Language"
],
"additionalProperties": false
}
},
"RecurrencePolicy": {
"type": [
"object",
"null"
],
"properties": {
"InitialDuration": {
"$ref": "#/definitions/duration"
},
"Duration": {
"$ref": "#/definitions/duration"
},
"IsRecurring": {
"type": [ "boolean", "null" ]
},
"HasTrial": {
"type": [ "boolean", "null" ]
}
},
"required": [ "InitialDuration", "Duration" ],
"additionalProperties": false
},
"CollectionData": {
"$ref": "#/definitions/collectionData"
}
},
"required": [
"SkuId",
"Properties",
"LocalizedProperties"
],
"additionalProperties": false
},
"Availabilities": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/availability"
}
}
},
"format": "SKU",
"required": [
"Sku",
"Availabilities"
],
"additionalProperties": false
},
"availability": {
"type": "object",
"properties": {
"Conditions": {
"type": "object",
"properties": {
"EndDate": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(\\.\\d+)?(([+-]\\d\\d:\\d\\d)|Z)?$"
}
},
"required": [ "EndDate" ],
"additionalProperties": false
},
"OrderManagementData": {
"type": [ "object", "null" ],
"properties": {
"Price": {
"type": "object",
"properties": {
"ListPrice": {
"type": "number"
},
"CurrencyCode": {
"enum": [ "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "CNY", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "SSP", "STD", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "USN", "USS", "UYI", "UYU", "UZS", "VEF", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XFU", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW" ]
},
"MSRP": {
"type": "number"
},
"RecurrencePrice": {
"type": [ "number", "null" ]
}
},
"required": [
"ListPrice",
"CurrencyCode",
"MSRP"
],
"additionalProperties": false
}
},
"required": [ "Price" ],
"additionalProperties": false
},
"AvailabilityId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
},
"DisplayRank": {
"type": "integer"
},
"RemediationRequired": {
"type": "boolean"
},
"Remediations": {
"type": "array",
"items": {
"$ref": "#/definitions/remediation"
}
},
"AffirmationId": {
"type": "string"
},
"Actions": {
"type": "array",
"items": {
"type": "string"
}
}
},
"format": "Availability",
"required": [
"Conditions",
"AvailabilityId",
"DisplayRank",
"Actions"
],
"additionalProperties": false
},
"duration": {
"type": "object",
"properties": {
"UnitType": {
"enum": [ "Year", "Month", "Week", "Day", "Hour", "Minute" ]
},
"Units": {
"type": "integer"
}
},
"format": "Duration",
"required": [ "Units" ],
"additionalProperties": false
},
"collectionData": {
"type": "object",
"properties": {
"productId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
},
"skuId": {
"type": "string",
"pattern": "^[0-9A-Z]{4}$"
},
"isTrial": {
"type": [ "boolean", "null" ]
},
"campaignId": {
"type": [ "string", "null" ]
},
"devOfferId": {
"type": [ "string", "null" ]
},
"acquiredDate": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(\\.\\d+)?(([+-]\\d\\d:\\d\\d)|Z)?$"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(\\.\\d+)?(([+-]\\d\\d:\\d\\d)|Z)?$"
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(\\.\\d+)?(([+-]\\d\\d:\\d\\d)|Z)?$"
},
"modifiedDate": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(\\.\\d+)?(([+-]\\d\\d:\\d\\d)|Z)?$"
},
"autoRenew": {
"type": "boolean"
},
"additionalIds": {
"type": "array",
"items": {
"type": "object"
}
},
"fulfillmentData": {
"type": "array",
"items": {
"type": "string"
}
},
"inAppOfferToken": {
"type": "string"
},
"isCacheable": {
"type": "boolean"
},
"itemId": {
"type": "string"
},
"localTicketReference": {
"type": "string"
},
"musicTracksInfo": {
"type": "array",
"items": {
"type": "object"
}
},
"orderId": {
"type": "string",
"pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}?$"
},
"orderLineItemId": {
"type": "string",
"pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}?$"
},
"ownershipType": {
"type": "string"
},
"productFamily": {
"type": "string"
},
"productKind": {
"type": "string"
},
"productTitleId": {
"type": "string"
},
"purchasedCountry": {
"type": "string"
},
"quantity": {
"type": "integer"
},
"skuType": {
"type": "string"
},
"status": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"transactionId": {
"type": "string",
"pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}?$"
}
},
"required": [
"acquiredDate",
"autoRenew",
"additionalIds",
"endDate",
"fulfillmentData",
"isCacheable",
"itemId",
"localTicketReference",
"modifiedDate",
"musicTracksInfo",
"orderId",
"orderLineItemId",
"ownershipType",
"productFamily",
"productId",
"productKind",
"productTitleId",
"purchasedCountry",
"skuId",
"skuType",
"startDate",
"status",
"tags",
"transactionId"
],
"additionalProperties": false
},
"video": {
"properties": {
"Uri": {
"type": "string"
},
"BackgroundColor": {
"type": [
"string",
"null"
]
},
"ForegroundColor": {
"type": [
"string",
"null"
]
},
"Caption": {
"type": [
"string",
"null"
]
},
"Width": {
"type": "integer"
},
"Height": {
"type": "integer"
},
"VideoPurpose": {
"type": [ "string", "null" ]
},
"PreviewImage": {
"$ref": "#/definitions/image"
}
},
"required": [
"Uri",
"Width",
"Height"
],
"additionalProperties": false
},
"image": {
"properties": {
"Uri": {
"type": "string"
},
"ImagePurpose": {
"type": [
"string",
"null"
]
},
"BackgroundColor": {
"type": [
"string",
"null"
]
},
"ForegroundColor": {
"type": [
"string",
"null"
]
},
"Caption": {
"type": [
"string",
"null"
]
},
"Width": {
"type": "integer"
},
"Height": {
"type": "integer"
}
},
"required": [
"Uri",
"Width",
"Height"
],
"additionalProperties": false
},
"remediationDescription": {
"type": "object",
"properties": {
"RemediationId": {
"type": "string"
},
"Description": {
"type": "string"
}
},
"required": [ "RemediationId", "Description" ],
"additionalProperties": false
},
"remediation": {
"type": "object",
"properties": {
"RemediationId": {
"type": "string"
},
"Url": {
"type": "string"
},
"BigId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}(?:/[0-9A-Z]{4})?$"
}
},
"required": [
"RemediationId"
],
"additionalProperties": false
},
"affirmationDescription": {
"type": "object",
"properties": {
"AffirmationId": {
"type": "string"
},
"AffirmationProductId": {
"type": [ "string", "null" ],
"pattern": "^[0-9A-Z]{12}$"
},
"Description": {
"type": "string"
}
},
"required": [ "AffirmationId", "Description" ],
"additionalProperties": false
}
},
"additionalProperties": false
}
範例
下列範例示範 App StoreProduct.ExtendedJsonData 屬性所傳回的 JSON 格式字串。
{
"LocalizedProperties": [
{
"DeveloperName": "Contoso developer",
"PublisherName": "Contoso",
"PublisherWebsiteUri": "http://www.contoso.com",
"SupportUri": "mailto:support@contoso.com",
"EligibilityProperties": null,
"Images": [
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 300,
"ImagePurpose": "tile",
"Uri": "//store-images.s-contoso.com/image/apps.40735.14525693010133175.0aff34d4-9b25-4671-b5fc-0d13efd28147.c23ea293-a138-42a0-a615-d03c41409169",
"Width": 300
},
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 88,
"ImagePurpose": "tile",
"Uri": "//store-images.s-contoso.com/image/apps.25013.14525693010133175.40f2a63d-463b-49f6-8953-b2d9cc4abeba.baa4030d-5d37-4965-8039-72158df22c42",
"Width": 88
},
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 300,
"ImagePurpose": "tile",
"Uri": "//store-images.s-contoso.com/image/apps.61404.14525693010133175.b9fde0dd-bab8-49a1-acfb-35d897b02bda.c0a07eff-ce1b-47c8-a4b5-5c83337911f9",
"Width": 620
},
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 50,
"ImagePurpose": "logo",
"Uri": "//store-images.s-contoso.com/image/apps.53845.14525693010133175.f907b7fa-6bd3-4d9e-af7d-33f19e170d33.07b372ce-4514-4f71-832f-745cad63c78e",
"Width": 50
},
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 300,
"ImagePurpose": "Logo",
"Uri": "//store-images.s-contoso.com/image/apps.27529.14525693010133175.f7574c79-bdda-4684-9929-25f7e1d370b7.a16a54ee-c3b1-4311-9d36-5fee7ac23639",
"Width": 300
},
{
"BackgroundColor": "transparent",
"Caption": "",
"ForegroundColor": "",
"Height": 768,
"ImagePurpose": "Screenshot",
"Uri": "//store-images.s-contoso.com/image/apps.39690.14525693010133175.47a548ec-c651-4b73-b937-7953a8714ddd.b2724431-1470-419e-aa4b-74830aba9e1b",
"Width": 1366
}
],
"Videos": [],
"ProductDescription": "This is a sample app for developement tasks",
"ProductTitle": "Contoso Sample App",
"SearchTitles": [],
"Language": "en-us"
}
],
"MarketProperties": [
{
"RelatedProducts": []
}
],
"ProductId": "9NBLGGH4R315",
"Properties": {
"PackageFamilyName": "30321Contoso.ContosoSampleApp_sv9ybgxvtektj"
},
"ProductKind": "Application",
"DisplaySkuAvailabilities": [
{
"Sku": {
"LocalizedProperties": [
{
"LegalText": {
"Copyright": "",
"CopyrightUri": "",
"PrivacyPolicy": "",
"PrivacyPolicyUri": "",
"Tou": "",
"TouUri": ""
},
"SkuDescription": "This is a sample app for developement tasks",
"SkuTitle": "Contoso Sample App",
"SkuDisplayRank": [],
"Language": "en-us"
}
],
"Properties": {
"FulfillmentType": "WindowsUpdate",
"BundledSkus": [],
"IsRepurchasable": false,
"IsTrial": false
},
"SkuId": "0010",
"RecurrencePolicy": null,
"CollectionData": {
"acquiredDate": "2017-02-27T13:34:57.6680551-08:00",
"additionalIds": [],
"beneficiary": {
"identityType": "msa",
"identityValue": "949157616400113"
},
"endDate": "9999-12-31T15:59:59.9999999-08:00",
"fulfillmentData": [],
"isCacheable": true,
"itemId": "0ae08fb4326a413a890c957b52aeda88",
"localTicketReference": "0",
"modifiedDate": "2017-02-27T13:34:57.6616413-08:00",
"musicTracksInfo": [],
"orderId": "9c54da93-5b1d-4afe-ac45-dd0c19bb3e8f",
"orderLineItemId": "88043dae-9cca-4497-aaac-e85f6cf018aa",
"ownershipType": "OwnedByBeneficiary",
"productFamily": "Apps",
"productId": "9NBLGGH4R315",
"productKind": "Application",
"productTitleId": "-129071",
"purchasedCountry": "US",
"purchaser": {
"identityType": "msa",
"identityValue": "985157600400620"
},
"quantity": 1,
"skuId": "0010",
"skuType": "Full",
"startDate": "2017-02-27T13:19:57.6680551-08:00",
"status": "Active",
"tags": [],
"transactionId": "9c54da93-5b1d-4afe-ac45-dd0c19bb3e8f"
}
},
"Availabilities": [
{
"Actions": [
"Details",
"Fulfill",
"License",
"Purchase",
"Redeem"
],
"AvailabilityId": "9XJKQMZ5M9NX",
"Conditions": {
"EndDate": "9998-12-30T00:00:00Z"
},
"OrderManagementData": {
"Price": {
"CurrencyCode": "USD",
"ListPrice": 0,
"MSRP": 0
}
},
"DisplayRank": 0,
"RemediationRequired": false
}
]
},
{
"Sku": {
"LocalizedProperties": [
{
"LegalText": {
"Copyright": "",
"CopyrightUri": "",
"PrivacyPolicy": "",
"PrivacyPolicyUri": "",
"Tou": "",
"TouUri": ""
},
"SkuDescription": "This is a sample app for developement tasks",
"SkuTitle": "Contoso Sample App",
"SkuDisplayRank": [],
"Language": "en-us"
}
],
"Properties": {
"FulfillmentType": "WindowsUpdate",
"BundledSkus": [],
"IsRepurchasable": false,
"IsTrial": false
},
"SkuId": "0017",
"RecurrencePolicy": null
},
"Availabilities": [
{
"Actions": [
"Details"
],
"AvailabilityId": "9ZFNZ00M33HF",
"Conditions": {
"EndDate": "9998-12-30T00:00:00Z"
},
"OrderManagementData": {
"Price": {
"CurrencyCode": "USD",
"ListPrice": 0,
"MSRP": 0
}
},
"DisplayRank": 0,
"RemediationRequired": false
}
]
},
{
"Sku": {
"LocalizedProperties": [
{
"LegalText": {
"Copyright": "",
"CopyrightUri": "",
"PrivacyPolicy": "",
"PrivacyPolicyUri": "",
"Tou": "",
"TouUri": ""
},
"SkuDescription": "This is a sample app for developement tasks",
"SkuTitle": "Contoso Sample App",
"SkuDisplayRank": [],
"Language": "en-us"
}
],
"Properties": {
"FulfillmentType": "WindowsUpdate",
"BundledSkus": [],
"IsRepurchasable": false,
"IsTrial": true
},
"SkuId": "0011",
"RecurrencePolicy": null
},
"Availabilities": [
{
"Actions": [
"Details",
"License",
"Fulfill"
],
"AvailabilityId": "9QVHW1D0B4QB",
"Conditions": {
"EndDate": "9998-12-30T00:00:00Z"
},
"OrderManagementData": {
"Price": {
"CurrencyCode": "USD",
"ListPrice": 0,
"MSRP": 0
}
},
"DisplayRank": 0,
"RemediationRequired": false
}
]
}
]
}
StoreAppLicense 和 StoreLicense 的結構描述
下列結構描述會描述 StoreAppLicense.ExtendedJsonData 所傳回的 JSON 格式字串。 StoreLicense.ExtendedJsonData 屬性只會傳回productAddOns路徑下定義的結構描述部分。
如需 StoreAppLicense.ExtendedJsonData 所傳回的 JSON 格式字串範例，請參閱本節。
{
"type": "object",
"properties": {
"productId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
},
"skuId": {
"type": "string",
"pattern": "^[0-9A-Z]{4}$"
},
"expiration": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\d \\d\\d:\\d\\d:\\d\\d(\\.\\d+)?$"
},
"isActive": {
"type": "boolean"
},
"isTrial": {
"type": "boolean"
},
"isTrialOwnedByThisUser": {
"type": "boolean"
},
"trialTimeRemaining": {
"type": "string"
},
"productAddOns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"inAppOfferToken": {
"type": "string"
},
"productId": {
"type": "string",
"pattern": "^[0-9A-Z]{12}$"
},
"productType": {
"type": "string"
},
"skuId": {
"type": "string",
"pattern": "^[0-9A-Z]{4}$"
},
"skuType": {
"type": "string"
},
"expiration": {
"type": "string",
"pattern": "^\\d{4}-\\d\\d-\\d\\d \\d\\d:\\d\\d:\\d\\d(\\.\\d+)?$"
},
"isActive": {
"type": "boolean"
}
},
"required": [
"inAppOfferToken",
"productType",
"skuType",
"expiration",
"isActive"
],
"additionalProperties": false
}
}
},
"required": [
"productAddOns",
"productId",
"skuId",
"expiration",
"isActive",
"isTrial",
"isTrialOwnedByThisUser",
"trialTimeRemaining"
],
"additionalProperties": false
}
範例
下列範例示範 StoreAppLicense.ExtendedJsonData 屬性所傳回的 JSON 格式字串。
{
"productAddOns": [
{
"inAppOfferToken": "Durable test add-on",
"productId": "9NBLGGH4TNMP",
"productType": "Durable",
"skuId": "0010",
"skuType": "Full",
"expiration": "9999-12-31 00:00:00",
"isActive": true
},
{
"inAppOfferToken": "Consumable test add-on",
"productId": "9NBLGGH4TNMN",
"productType": "Consumable",
"skuId": "0020",
"skuType": "Full",
"expiration": "9999-12-31 00:00:00",
"isActive": true
}
],
"productId": "9NBLGGH4R315",
"skuId": "0010",
"isActive": true,
"isTrial": false,
"isTrialOwnedByThisUser": false,
"expiration": "9999-12-31 00:00:00"
}
StorePurchaseProperties 的結構描述
下列結構描述會描述 StorePurchaseProperties.ExtendedJsonData 所傳回的 JSON 格式字串。
{
"type": "object",
"properties": {
"Name": {
"type": "string"
}
},
"required": [
"Name"
],
"additionalProperties": false
}