Dapatkan tautan unduhan untuk templat Perjanjian Pelanggan Microsoft

Artikel
03/05/2024

Berlaku untuk: Pusat Mitra

Tidak berlaku untuk: Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Sumber daya AgreementDocument saat ini hanya didukung oleh Pusat Mitra di cloud publik Microsoft.

Artikel ini menjelaskan cara mendapatkan tautan untuk mengunduh templat Perjanjian Pelanggan Microsoft, berdasarkan negara/wilayah dan bahasa pelanggan.

Prasyarat

Jika Anda menggunakan Pusat Mitra .NET SDK, diperlukan versi 1.14 atau yang lebih baru.

Penting

Pada Juni 2023, Pusat Mitra terbaru .NET SDK rilis 3.4.0 sekarang diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.

Mitra didorong untuk terus menggunakan REST API Pusat Mitra.
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi Aplikasi+Pengguna.
Negara/wilayah pelanggan tempat templat Perjanjian Pelanggan Microsoft berlaku.
Bahasa tempat templat Perjanjian Pelanggan Microsoft harus dilokalkan.

Penting

Perjanjian Pelanggan Microsoft khusus negara/wilayah. Saat meminta tautan untuk mengunduh templat Perjanjian Pelanggan Microsoft, Pastikan untuk menentukan negara/wilayah yang benar berdasarkan lokasi pelanggan. atau daftar negara/wilayah yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung.
Untuk beberapa negara/wilayah, Perjanjian Pelanggan Microsoft tersedia dalam beberapa bahasa. Untuk pengalaman pelanggan terbaik, pilih bahasa yang paling sesuai dengan kebutuhan pelanggan. Untuk daftar bahasa yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung.
Metode ini hanya didukung dengan Perjanjian Pelanggan Microsoft.

.NET

Untuk mengambil tautan untuk mengunduh templat Perjanjian Pelanggan Microsoft:

Ambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Anda harus mendapatkan templateId dari Perjanjian Pelanggan Microsoft. Untuk informasi selengkapnya, lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

AgreementMetaData microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.   ByAgreementType(agreementType).Get().Items.Single();

Gunakan koleksi IAggregatePartner.AgreementTemplates.
Panggil metode ById dan tentukan templateId dari Perjanjian Pelanggan Microsoft.
Ambil properti Dokumen.
Panggil metode ByCountry dan tentukan negara/wilayah pelanggan tempat templat perjanjian diterapkan. Kueri default ke AS jika metode tidak ditentukan. Untuk daftar kode negara/wilayah yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung. Metode ini peka huruf besar/kecil.
Panggil metode ByLanguage dan tentukan bahasa tempat templat perjanjian harus dilokalkan. Kueri default ke en-US jika metode tidak ditentukan atau kode negara/wilayah yang ditentukan tidak didukung untuk negara/wilayah yang ditentukan. Untuk daftar kode bahasa yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung.

Panggil metode Get atau GetAsync.

// IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

var agreementDocument = partnerOperations.   AgreementTemplates.ById   (microsoftCustomerAgreementDetails.   TemplateId).Document.ByCountry   (customerCountry).ByLanguage   (languageForLocalization).Get();

Sampel lengkap dapat ditemukan di kelas GetAgreementDetails dari proyek aplikasi pengujian konsol.

Permintaan REST

Untuk mengambil tautan untuk mengunduh templat Perjanjian Pelanggan Microsoft:

Ambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Anda harus mendapatkan templateId dari Perjanjian Pelanggan Microsoft. Untuk informasi selengkapnya, lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft.
Buat permintaan REST untuk mengambil sumber daya AgreementDocument. Misalnya, lihat contoh sintaks permintaan. Anda harus menentukan informasi berikut:
- TemplateId dari Perjanjian Pelanggan Microsoft
- Negara/wilayah tempat templat Perjanjian Pelanggan Microsoft diterapkan
- Bahasa tempat templat Perjanjian Pelanggan Microsoft harus dilokalkan

Minta sintaks

Gunakan sintaks permintaan berikut untuk sumber daya ini:

Metode	URI Permintaan
GET	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

Parameter URI

Anda dapat menggunakan parameter URI berikut dengan permintaan Anda:

Nama	Tipe	Diperlukan	Deskripsi
agreement-template-id	string	Ya	Pengidentifikasi unik dari jenis perjanjian. Anda dapat memperoleh templateId untuk Perjanjian Pelanggan Microsoft dengan mengambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Untuk informasi selengkapnya, lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Parameter ini peka huruf besar/kecil.
negara	string	No	Menunjukkan negara/wilayah tempat templat perjanjian berlaku. Kueri default ke AS jika parameter tidak ditentukan. Untuk daftar kode negara/wilayah yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung.
bahasa	string	No	Menunjukkan bahasa tempat templat perjanjian harus dilokalkan. Kueri default ke en-US jika parameter tidak ditentukan atau kode negara/wilayah yang ditentukan tidak didukung untuk negara/wilayah yang ditentukan. Untuk daftar kode negara/wilayah yang didukung, lihat Daftar negara/wilayah dan bahasa yang didukung.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/agreementtemplates/117a77b0-9360-443b-8795-c6dedc750cf9/document?language=en-US&country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Respons REST

Jika berhasil, metode ini mengembalikan sumber daya AgreementDocument dalam isi respons.

Sumber daya memiliki properti downloadUri , yang berisi string URL yang dapat digunakan untuk mengunduh templat perjanjian. Tautan yang berbeda dikembalikan setiap kali Anda membuat kueri. Tautan ini kedaluwarsa setelah lima menit.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya.

Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode kesalahan REST Pusat Mitra.

Contoh tanggapan

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "displayUri":"https://wopihost.int.l2o.microsoft.com/v1/officehost/agreement/files/Preview...",
    "downloadUri":"https://l2oagreementintbn2.blob.core.windows.net/agreementscontainer/Preview...",
    "language":"en-US",
    "country":"US"
}

Daftar negara/wilayah dan bahasa yang didukung