Condividi tramite

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

  • Articolo

Si applica a: Partner Center

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 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 come descritto in autenticazione del Partner Center. Questo scenario supporta solo l'autenticazione app+utente.

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

  • Lingua in cui deve essere localizzato il modello 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 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 o 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 un 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 contratto del cliente Microsoft:

  1. Recuperare i metadati del contratto per il Contratto del cliente Microsoft. È necessario ottenere il templateId del Contratto del cliente Microsoft. Per ulteriori informazioni, vedere Ottieni i metadati del Contratto Cliente Microsoft.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Utilizzare la collezione IAggregatePartner.AgreementTemplates.

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

  4. Recupera la proprietà Documento.

  5. Chiamare il metodo ByCountry e specificare il paese/area geografica del cliente a cui si applica il modello di contratto. Per impostazione predefinita, la query passa a US 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 è sensibile al contesto .

  6. Chiamare il metodo ByLanguage e specificare la lingua in cui deve essere localizzato il modello di contratto. Per impostazione predefinita, la query viene 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 test console.

Richiesta REST

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

  1. Recuperare i metadati del contratto per il Contratto del cliente Microsoft. È necessario ottenere il templateId del Contratto del cliente Microsoft. Per ulteriori informazioni, vedere Ottieni i metadati del Contratto Cliente Microsoft.

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

    • Il templateId del Contratto Cliente Microsoft
    • Paese/area geografica a cui si applica il modello contratto del cliente Microsoft
    • Lingua in cui deve essere localizzato il modello contratto del cliente Microsoft

Sintassi della richiesta

Usare la sintassi di richiesta seguente per questa risorsa:

Metodo URI della richiesta
OTTIENI {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 Tipo Obbligatorio Descrizione
id-modello-di-accordo corda Sì Identificatore univoco del tipo di contratto. È possibile ottenere il templateId per il Contratto del cliente Microsoft recuperando i metadati del contratto per il Contratto del cliente Microsoft. Per ulteriori informazioni, vedere Ottieni i metadati del Contratto Cliente Microsoft. Questo parametro fa distinzione tra maiuscole e minuscole.
paese corda No Indica il paese/area geografica a cui si applica il modello di contratto. Per impostazione predefinita, la query viene impostata su USA se il parametro non è specificato. Per un elenco dei codici paese/area geografica supportati, vedere Elenco di paesi/aree geografiche e lingue supportati.
Lingua corda No Indica la lingua in cui deve essere localizzato il modello di contratto. Per impostazione predefinita, la query è impostata a en-US se il parametro non è specificato oppure il codice paese/area geografica specificato 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 della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Centro 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 un AgreementDocument risorsa 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 esito positivo 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, vedere Codici di errore del Centro per i Partner REST.

Esempio di risposta

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 di paese/regione fa distinzione tra maiuscole e minuscole. Assicurati di usare i casi corretti specificati 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 COME en-US
Andorra ANNUNCIO en-US
Angola AO en-US, pt-PT
Anguilla Intelligenza artificiale en-US
Antartide AQ en-US
Antigua e Barbuda AG en-US
Argentina Realtà Aumentata en-US, es-ES
Armenia di mattina en-US
Aruba AW en-US
Australia AU en-US
Austria A 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
Belarus DA en-US, ru-RU
Belgio ESSERE 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 Business Intelligence en-US
Côte d'Ivoire CI en-US, fr-FR
Cabo Verde Curriculum Vitae en-US, pt-PT
Cambogia KH en-US
Camerun cm 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 Monossido di carbonio en-US, es-ES
Comore km en-US
Congo (DRC) 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-CZ
Danimarca DK en-US, da-DK
Gibuti DJ en-US
Dominica DM en-US
Repubblica Dominicana FARE en-US, es-ES
Ecuador CE en-US
Egitto Ad esempio en-US, ar-SA
El Salvador SV en-US, es-ES
Guinea Equatoriale GQ en-US
Eritrea Pronto soccorso en-US
Estonia EE en-US, et-EE
eSwatini SZ en-US
Etiopia ET en-US
Isole Falkland FK en-US
Isole Faroe FO en-US
Figi FJ en-US
Finlandia FI en-US, fi-FI
Francia FR en-US, fr-FR
Guyana francese GF en-US, fr-FR
Polinesia francese PF en-US
Territori meridionali francesi TF en-US
Gabon GA en-US
Gambia GM en-US
Georgia GE en-US
Germania DE en-US, de-DE
Ghana GH en-US
Gibilterra Gastrointestinale en-US
Grecia GR en-US, el-GR
Groenlandia GL en-US
Grenada GD en-US
Guadalupa medico di base 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
Isole Heard e McDonald HM en-US
Honduras HN en-US, es-ES
Regione amministrativa speciale di Hong Kong HK en-US, zh-HK
Ungheria HU en-US, hu-HU
Islanda IS en-US
India IN en-US, hi-IN
Indonesia ID (identificativo) en-US, id-ID
Iraq IQ en-US, ar-SA
Irlanda IE en-US
Isola di Man IM en-US
Israele IL Inglese (Stati Uniti), Ebraico (Israele)
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
Kenia KE en-US
Kiribati KI en-US
Corea 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 in inglese (en-US), in lettone (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 amministrativa speciale di Macao MO en-US, zh-HK
Madagascar MG en-US
Malawi MW en-US
Malaysia MIO 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 Sig. en-US
Mauritius MU inglese (Stati Uniti), arabo (Arabia Saudita)
Mayotte YT en-US
Messico MX en-US, es-ES
Micronesia FM en-US
Moldavia Dottore in Medicina en-US, ro-RO
Monaco MC en-US, fr-FR
Mongolia MN en-US
Montenegro me en-US
Montserrat MS en-US
Marocco MAMMA en-US, fr-FR, en-US
Mozambico MZ en-US
Myanmar MILLIMETRO en-US
Namibia NA 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 Mariana settentrionali Deputato en-US
Macedonia settentrionale MK en-US
Norvegia NO en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau Prg. en-US
Autorità palestinese PS en-US
Panama Pennsylvania 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 relazioni pubbliche en-US, en-US
Qatar Assicurazione di Qualità en-US, ar-SA
Isola della Réunion RI 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 Laurea in Giurisprudenza 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 Sì en-US, sl-SI
Isole Salomone SB en-US
Somalia COSÌ en-US
Sud Africa ZA en-US
Georgia meridionale e Isole Sandwich del Sud GS en-US
Sud Sudan SS en-US
Spagna ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Sant'Helena, Ascensione, Tristan da Cunha ZITTO en-US
Suriname SR en-US
Svalbard SJ en-US
Svezia SE en-US, sv-SE
Svizzera CH en-US, fr-FR, en-US, en-US
Taiwan Taiwan en-US, zh-HK
Tagikistan TJ en-US
Tanzania TZ en-US
Thailandia ° en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga A en-US
Trinidad e Tobago TT en-US
Tunisia TN en-US, fr-FR, en-US
Turchia TR en-US, tr-TR
Turkmenistan TM en-US
Isole Turks e Caicos TC en-US
Tuvalu televisione en-US
Isole Periferiche degli Stati Uniti UM en-US
Isole Vergini Americane VI en-US
Uganda UG en-US
Ucraina UA en-US, uk-UA
Emirati Arabi Uniti AE en-US, ar-SA
Regno Unito GB en-US
Stati Uniti USA 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 VOI en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US