Condividi tramite

Ottenere un collegamento per il download del modello di contratto del cliente Microsoft

  • Articolo

Si applica a: Centro per i partner

Non si applica a: Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

La risorsa AgreementDocument è attualmente supportata dal Centro per i partner solo nel cloud pubblico Microsoft.

Questo articolo descrive come ottenere un collegamento per scaricare il modello di Contratto del cliente Microsoft, in base al paese/area geografica e alla lingua del cliente.

Prerequisiti

  • Se si usa .NET SDK del Centro per i partner, è necessaria la versione 1.14 o successiva.

    Importante

    A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

    I partner sono invitati a continuare a usare le API REST del Centro per i partner.

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta solo l'autenticazione app + utente.

  • Paese/area geografica del cliente a cui si applica il modello di Contratto del cliente Microsoft.

  • Lingua in cui deve essere localizzato il modello di Contratto del cliente Microsoft.

Importante

  • Il Contratto del cliente Microsoft è specifico del paese o dell'area geografica. Quando si richiede un collegamento per scaricare il modello di Contratto del cliente Microsoft, assicurarsi di specificare il paese/area geografica corretto in base alla posizione del cliente. o elenco di paesi/aree geografiche supportati, vedere Elenco di paesi/aree geografiche e lingue supportati.
  • Per alcuni paesi/aree geografiche, il Contratto del cliente Microsoft è disponibile in più lingue. Per un'esperienza cliente ottimale, scegliere la lingua più adatta alle esigenze del cliente. Per l'elenco delle lingue supportate, vedere Elenco di paesi/aree geografiche e lingue supportati.
  • Questo metodo è supportato solo con il Contratto del cliente Microsoft.

.NET

Per recuperare un collegamento per scaricare il modello di Contratto del cliente Microsoft:

  1. Recupera i metadati per il Contratto del cliente Microsoft. Devi ottenere il valore di templateId del Contratto del cliente Microsoft. Per altre informazioni, vedere Ottenere i metadati del contratto per Contratto del cliente Microsoft.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Utilizzare l'insieme IAggregatePartner.AgreementTemplates.

  3. Chiamare il metodo ById e specificare il templateId del Contratto del cliente Microsoft.

  4. Recuperare la proprietà Document .

  5. Chiamare il metodo ByCountry e specificare il paese/area geografica del cliente a cui si applica il modello di contratto. La query usa per impostazione predefinita se il metodo non è specificato. Per un elenco dei codici paese/area geografica supportati, vedere Elenco di paesi/aree geografiche e lingue supportati. Questo metodo fa distinzione tra maiuscole e minuscole.

  6. Chiamare il metodo ByLanguage e specificare la lingua in cui deve essere localizzato il modello di contratto. Per impostazione predefinita , la query è en-US se il metodo non è specificato o il codice paese/area geografica specificato non è supportato per il paese o l'area geografica specificata. Per l'elenco dei codici linguistici supportati, vedere Elenco di paesi/aree geografiche e lingue supportati.

  7. Chiamare il metodo Get o GetAsync .

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Un esempio completo è disponibile nella classe GetAgreementDetails del progetto di app di test della console.

Richiesta REST

Per recuperare un collegamento per scaricare il modello di Contratto del cliente Microsoft:

  1. Recupera i metadati per il Contratto del cliente Microsoft. Devi ottenere il valore di templateId del Contratto del cliente Microsoft. Per altre informazioni, vedere Ottenere i metadati del contratto per Contratto del cliente Microsoft.

  2. Creare una richiesta REST per recuperare una risorsa AgreementDocument. Per un esempio, vedere l'esempio di sintassi della richiesta. È necessario specificare le informazioni seguenti:

    • TemplateId del Contratto del cliente Microsoft
    • Paese/area geografica a cui si applica il modello di Contratto del cliente Microsoft
    • Lingua in cui deve essere localizzato il modello di Contratto del cliente Microsoft

Sintassi della richiesta

Usare la sintassi di richiesta seguente per questa risorsa:

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

Parametri URI

È possibile usare i parametri URI seguenti con la richiesta:

Nome Digita Obbligatorio Descrizione
agreement-template-id string Sì Identificatore univoco del tipo di contratto. Puoi ottenere il valore di templateId per il Contratto del cliente Microsoft recuperando i metadati per tale contratto. Per altre informazioni, vedere Ottenere i metadati del contratto per Contratto del cliente Microsoft. Questo parametro fa distinzione tra maiuscole e minuscole.
country string No Indica il paese/area geografica a cui si applica il modello di contratto. La query usa per impostazione predefinita se il parametro non è specificato. Per un elenco dei codici paese/area geografica supportati, vedere Elenco di paesi/aree geografiche e lingue supportati.
lingua string No Indica la lingua in cui deve essere localizzato il modello di contratto. Per impostazione predefinita, la query è en-US se il parametro non è specificato o il codice paese/area geografica specificato in non è supportato per il paese o l'area geografica specificata. Per l'elenco dei codici paese/area geografica supportati, vedere Elenco di paesi/aree geografiche e lingue supportati.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/agreementtemplates/aaaabbbb-0000-cccc-1111-dddd2222eeee/document?language=en-US&country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa AgreementDocument nel corpo della risposta.

La risorsa ha una proprietà downloadUri , che contiene una stringa URL che può essere usata per scaricare il modello di contratto. Ogni volta che si esegue una query, viene restituito un collegamento diverso. Questo collegamento scade dopo cinque minuti.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug.

Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "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"
}

Elenco di paesi/aree geografiche e lingue supportati

Importante

La proprietà del codice paese/area geografica fa distinzione tra maiuscole e minuscole. Assicurarsi di usare la combinazione di maiuscole e minuscole corretta specificata in questa tabella:

Paese/area geografica Codice paese Codici di lingua supportati
Isole Åland AX en-US
Afghanistan AF en-US
Albania AL en-US
Algeria DZ en-US, fr-FR, en-US
Samoa americane AS en-US
Andorra AD en-US
Angola AO en-US, pt-PT
Anguilla AI en-US
Antartide AQ en-US
Antigua e Barbuda AG en-US
Argentina AR en-US, es-ES
Armenia Mattina en-US
Aruba AW en-US
Australia AU en-US
Austria AT en-US, de-DE
Azerbaigian AZ en-US
Bahamas BS en-US
Bahrein BH en-US, ar-SA
Bangladesh BD en-US
Barbados BB en-US
Bielorussia BY en-US, ru-RU
Belgio BE en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermuda BM en-US
Bhutan BT en-US
Bolivia BO en-US, es-ES
Bonaire BQ en-US
Bosnia ed Erzegovina BA en-US
Botswana BW en-US
Isola Bouvet BV en-US
Brasile BR en-US, pt-BR
Territorio britannico dell’Oceano Indiano IO en-US
Isole Vergini Britanniche VG en-US
Brunei BN en-US
Bulgaria BG en-US, bg-BG
Burkina Faso BF en-US
Burundi BI en-US
Côte d'Ivoire (Costa d'Avorio) CI en-US, fr-FR
Cabo Verde CV en-US, pt-PT
Cambogia KH en-US
Camerun CA en-US, fr-FR
Canada CA en-US, fr-FR
Isole Cayman KY en-US, en-US
Repubblica Centrafricana CF en-US
Ciad TD en-US
Cile CL en-US, es-ES
Isola Christmas CX en-US
Isole Cocos (Keeling) CC en-US
Colombia CO en-US, es-ES
Comore KM en-US
Congo (RDC) CD en-US
Congo CG en-US
Isole Cook CK en-US
Costa Rica CR en-US, es-ES
Croazia HR en-US, hr-HR
Curaçao CW en-US
Cipro CY en-US
Cechia CZ en-US, cs-CSV
Danimarca DK en-US, da-DK
Gibuti DJ en-US
Dominica DM en-US
Repubblica Dominicana DO en-US, es-ES
Ecuador EC en-US
Egitto EG en-US, ar-SA
El Salvador SV en-US, es-ES
Guinea Equatoriale GQ en-US
Eritrea ER en-US
Estonia EE en-US, et-edizione Enterprise
Swaziland SZ en-US
Etiopia ET en-US
Isole Falkland FK en-US
Isole Fær Øer FO en-US
Figi FJ en-US
Finlandia FI en-US, fi-FI
Francia FR en-US, fr-FR
Guayana francese GF en-US, fr-FR
Polinesia Francese PF en-US
Terre australi francesi TF en-US
Gabon Disponibilità generale en-US
Gambia GM en-US
Georgia GE en-US
Germania DE en-US, de-DE
Ghana GH en-US
Gibilterra GI en-US
Grecia GR en-US, el-GR
Groenlandia GL en-US
Grenada GD en-US
Guadalupa GP en-US
Guam GU en-US
Guatemala GT en-US, es-ES
Guernsey GG en-US
Guinea GN en-US
Guinea-Bissau GW en-US
Guyana GY en-US
Haiti HT en-US
Heard e McDonald HM en-US
Honduras HN en-US, es-ES
Regione speciale di Hong Kong Amministrazione istrative HK en-US, zh-HK
Ungheria HU en-US, hu-HU
Islanda IS en-US
India IN en-US, hi-IN
Indonesia ID en-US, id-ID
Iraq IQ en-US, ar-SA
Irlanda Internet Explorer en-US
Isola di Man IM en-US
Israele IL en-US, he-IL
Italia IT en-US, it-IT
Giamaica JM en-US
Jan Mayen XJ en-US
Giappone JP en-US, ja-JP
Jersey JE en-US
Giordania JO en-US, ar-SA
Kazakhstan KZ en-US, kk-KZ
Kenya KE en-US
Kiribati KI en-US
Corea del Sud KR en-US, ko-KR
Kosovo XK en-US
Kuwait KW en-US, ar-SA
Kirghizistan KG en-US, ru-RU
Laos LA en-US
Lettonia LV en-US, lv-LV
Libano LB en-US, ar-SA
Lesotho LS en-US
Liberia LR en-US
Libia LY en-US, ar-SA
Liechtenstein LI en-US, de-DE
Lituania LT en-US, lt-LT
Lussemburgo LU en-US, fr-FR
Regione speciale di Macao Amministrazione istrativa MO en-US, zh-HK
Madagascar MG en-US
Malawi MW en-US
Malaysia MY en-US, ms-MY
Maldive MV en-US
Mali ML en-US
Malta MT en-US
Isole Marshall MH en-US
Martinica MQ en-US
Mauritania MR en-US
Mauritius MU en-US, ar-SA
Mayotte YT en-US
Messico MX en-US, es-ES
Micronesia FM en-US
Moldova MD en-US, ro-RO
Monaco MC en-US, fr-FR
Mongolia MN en-US
Montenegro ME en-US
Montserrat MS en-US
Marocco MA en-US, fr-FR, en-US
Mozambico MZ en-US
Myanmar MM en-US
Namibia N/D en-US
Nauru NR en-US
Nepal NP en-US
Paesi Bassi NL en-US, nl-NL
Nuova Caledonia NC en-US
Nuova Zelanda NZ en-US
Nicaragua NI en-US, es-ES
Niger NE en-US
Nigeria NG en-US
Niue NU en-US
Isola Norfolk NF en-US
Isole Marianne settentrionali Punto di gestione (MP) en-US
Macedonia del Nord MK en-US
Norvegia NO en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau PW en-US
Autorità Palestinese PS en-US
Panama PA en-US, es-ES
Papua Nuova Guinea PG en-US
Paraguay PY en-US, es-ES
Perù PE en-US, es-ES
Filippine PH en-US
Isole Pitcairn PN en-US
Polonia PL en-US, pl-PL
Portogallo PT en-US, pt-PT
Portorico PR en-US, en-US
Qatar Domande e risposte en-US, ar-SA
Riunione RE en-US
Romania RO en-US, ro-RO
Russia RU en-US, ru-RU
Ruanda RW en-US, fr-FR
São Tomé e Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts e Nevis KN en-US
Saint Lucia LC en-US, en-US
Saint Martin MF en-US, en-US
Saint Pierre e Miquelon Pomeriggio en-US
Saint Vincent e Grenadine VC en-US
Samoa WS en-US
San Marino SM en-US
Arabia Saudita SA en-US
Senegal SN en-US, fr-FR
Serbia RS en-US, sr-Latn-RS, en-US
Seychelles SC en-US
Sierra Leone SL en-US
Singapore SG en-US, zh-SG
Sint Eustatius XE en-US
Sint Maarten SX en-US, en-US
Slovacchia SK en-US, sk-SK
Slovenia SI en-US, sl-SI
Isole Salomone SB en-US
Somalia SO en-US
Sudafrica ZA en-US
Georgia del Sud e Isole Sandwich Australi GS en-US
Sud Sudan Server del sito (SS) en-US
Spagna ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Sant’Elena, Ascensione, Tristan da Cunha SH en-US
Suriname SR en-US
Svalbard SJ en-US
Svezia SE en-US, sv-edizione Standard
Svizzera CH en-US, fr-FR, en-US, en-US
Taiwan TW en-US, zh-HK
Tagikistan TJ en-US
Tanzania TZ en-US
Thailandia TH en-US, th-TH
Timor Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga TO en-US
Trinidad e Tobago TT en-US
Tunisia TN en-US, fr-FR, en-US
Türkiye TR en-US, tr-TR
Turkmenistan TM en-US
Isole Turks e Caicos TC en-US
Tuvalu TV en-US
Stati Uniti Altre isole americane del Pacifico UM en-US
U.S. Vergini Americane VI en-US
Uganda UG en-US
Ucraina UA en-US, uk-UA
Emirati Arabi Uniti (EAU) AE en-US, ar-SA
Regno Unito GB en-US
Stati Uniti Stati Uniti en-US
Uruguay UY en-US, es-ES
Uzbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Città del Vaticano VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis e Futuna WF en-US
Yemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US