ID ile ürün al

Belirtilen ürün kaynağını bir ürün kimliği kullanarak alır.

Önkoşullar

• İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

• Ürün kimliği.

C#

Belirli bir ürünü kimliğine göre bulmak için IAggregatePartner.Products koleksiyonunuzu kullanın, ByCountry() yöntemini kullanarak ülkeyi seçin, ardından ById() yöntemini çağırın. Son olarak, ürünü döndürmek için get() veya GetAsync() yöntemini çağırın.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Java

İş Ortağı Merkezi Java SDK, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Topluluktan yardım alabilir veya bir sorunla karşılaşırsanız GitHub'da bir sorun açabilirsiniz.

Belirli bir ürünü kimliğine göre bulmak için IAggregatePartner.getProducts işlevinizi kullanın, byCountry() işlevini kullanarak ülkeyi seçin ve ardından byId() işlevini çağırın. Son olarak, ürünü döndürmek için get() işlevini çağırın.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShell

İş Ortağı Merkezi PowerShell modülü İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Topluluktan yardım alabilir veya bir sorunla karşılaşırsanız GitHub'da bir sorun açabilirsiniz.

Belirli bir ürünü kimliğe göre bulmak için Get-PartnerProductkomutunu yürüterek ProductId parametresini belirtin. CountryCode parametresi seçeneklerdir; belirtilmezse satıcıyla ilişkili ülke kullanılır.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

REST isteği

İstek söz dizimi

URI parametresi

Belirtilen ürünü almak için aşağıdaki yol parametrelerini kullanın.

İstek başlıkları

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Hiç kimse.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST yanıtı

Başarılı olursa yanıt gövdesi bir Ürün kaynağı içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi hata kodları.

Bu yöntem aşağıdaki hata kodlarını döndürür:

Azure VM rezervasyonu (Azure planı) için yanıt örneği

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT

{
    "id": "DZH318Z0BQ3Q",
    "title": "Virtual Machines DSv2 Series",
    "description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
    "productType": {
        "id": "Azure",
        "displayName": "Azure",
        "subType": {
            "id": "VirtualMachines",
            "displayName": "VirtualMachines"
        }
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft",
    "links": {
        "skus": {
            "uri": "/products/DZH318Z0BQ3Q/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/products/DZH318Z0BQ3Q?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Yeni ticari lisans tabanlı ürün için yanıt örneği

{
    "id": "CFQ7TTC0LH18",
    "title": "Microsoft 365 Business Basic",
    "description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
    "productType": {
        "id": "OnlineServicesNCE",
        "displayName": "OnlineServicesNCE"
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft Corporation",
    "links": {
        "skus": {
            "uri": "/products/CFQ7TTC0LH18/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
        "uri": "/products/CFQ7TTC0LH18?country=US",
            "method": "GET",
            "headers": []
        }
    }
}