Dapatkan ketersediaan berdasarkan ID

Mendapatkan ketersediaan untuk produk dan SKU yang ditentukan menggunakan ID ketersediaan. ID ketersediaan dapat diubah, dan dinamis, dan diterbitkan kembali secara teratur. Mitra harus selalu memastikan untuk mendapatkan ketersediaan saat ini saat mengajukan item lini keranjang atau menjalankan aktivitas lain yang memerlukan ID ketersediaan.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Partner Center. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

  • ID produk.

  • ID Produk (SKU)

  • ID ketersediaan.

C#

Untuk mendapatkan detail ketersediaan tertentu, mulailah dengan menggunakan langkah-langkah di Dapatkan SKU berdasarkan ID untuk mendapatkan antarmuka untuk operasi SKU tertentu. Dari antarmuka yang dihasilkan, pilih properti Ketersediaan untuk mendapatkan antarmuka dengan operasi yang tersedia untuk Ketersediaan. Setelah itu, teruskan ID ketersediaan ke metode ById() untuk mendapatkan operasi untuk ketersediaan tertentu tersebut lalu panggil Get() atau GetAsync() untuk mengambil detail ketersediaan.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;

// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();

Java

Partner Center Java SDK dapat digunakan untuk mengelola sumber daya di Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda bisa mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.

Untuk mendapatkan detail ketersediaan tertentu, mulailah dengan menggunakan langkah-langkah di Dapatkan SKU berdasarkan ID untuk mendapatkan antarmuka untuk operasi SKU tertentu. Melalui antarmuka yang dihasilkan, pilih fungsi getAvailabilities untuk mendapatkan antarmuka dengan operasi yang tersedia untuk fitur Availabilities. Setelah itu, teruskan ID ketersediaan ke fungsi byId() untuk mendapatkan operasi untuk ketersediaan tertentu tersebut lalu panggil fungsi get() untuk mengambil detail ketersediaan.

IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;

// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();

PowerShell

Modul Pusat Mitra PowerShell dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda bisa mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.

Untuk mendapatkan detail ketersediaan tertentu, jalankan parameter Get-PartnerProductAvailability dan tentukan parameter AvailabilityId, CountryCode, ProductId, dan SkuId untuk mengambil detail ketersediaan.

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

Permintaan REST

Meminta sintaks

Metode URI Permintaan
DAPATKAN {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

Parameter URI

Gunakan jalur dan parameter kueri berikut untuk mendapatkan ketersediaan tertentu menggunakan ID ketersediaan.

Nama Tipe Wajib Deskripsi
id-produk string Ya String berformat GUID yang mengidentifikasi produk.
sku-id string Ya String berformat GUID yang mengidentifikasi SKU.
id ketersediaan string Ya String berformat GUID yang mengidentifikasi ketersediaan.
kode negara string Ya ID negara/wilayah.
Sertakan Status Siklus Hidup string Tidak String flag yang dapat diatur ke true untuk mengembalikan nilai status lifecycle untuk penawaran berbasis lisensi New Commerce.

Header permintaan

Untuk informasi selengkapnya, lihat Pusat Mitra Header REST.

Isi permintaan

Tidak ada.

Contoh permintaan

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Penting

Per Juni 2023, .NET SDK versi 3.4.0 dari Partner Center telah diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.

Mitra didorong untuk terus menggunakan Partner Center REST APIs.

Respons REST

Jika berhasil, isi respons berisi sumber daya Ketersediaan .

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, silakan lihat kode kesalahan di Partner Center.

Metode ini mengembalikan kode kesalahan berikut:

Kode Status HTTP Kode kesalahan Deskripsi
404 400013 Produk tidak ditemukan.
404 400018 SKU tidak ditemukan.
404 400019 Ketersediaan tidak ditemukan. Kesalahan ini dapat terjadi saat checkout keranjang belanja. Mitra yang mengalami kesalahan ini harus mengeluarkan permintaan GET baru untuk memastikan mereka memiliki ID ketersediaan saat ini dan mencoba kembali checkout keranjang.

Contoh respons untuk reservasi komputer virtual Azure (paket Azure)

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440

{
    "id": "DZH318XZXPHL",
    "productId": "DZH318Z0BQ3Q",
    "skuId": "0001",
    "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": false,
    "terms": [{
        "duration": "P1Y",
        "description": "1 Year Prepaid"
    }],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Contoh respons untuk layanan berbasis lisensi perdagangan baru

Catatan

Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "id": "CFQ7TTC0K971",
    "productId": "CFQ7TTC0LH18",
    "skuId": "0001",
    "catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": true, 
    "renewalInstructions": [
        {
            "applicableTermIds": [
                "5aeco6mffyxo"
            ],
            "renewalOptions": [
                {
                    "renewToId": "CFQ7TTC0LH18:0001",
                    "isAutoRenewable": true
                }
            ]
        },
	 …
    ],
    "terms": [
        {
            "id": "5aeco6mffyxo",
            "duration": "P1Y",
            "description": "One-Year commitment for monthly/yearly billing",
            "billingCycle": "Annual",
            "termLifeCycleState": "GA",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Instruksi konversi untuk ketersediaan selama tiga tahun

Beberapa unit penyimpanan saham (SKU) tiga tahun dengan tim untuk mitra Eropa memungkinkan transisi pada tanggal ulang tahun. Ketersediaan SKU saat ini untuk langganan tersebut mencakup petunjuk untuk transfer konversi.

"conversionTransferInstructions": [
        {
          "transferToBigId": "CFQ7TTC0ZSW3:003G",
          "transferTiming": "Immediate",
          "constraintsData": {
            "timingConstraint": {
              "recurrenceInterval": "P1Y",
              "startDateReference": "SubscriptionTermStartDate"
            }
          }
        }
]
  • Last updated on