Obtener un vínculo de descarga para la plantilla del Contrato de cliente de Microsoft

  • Artículo

Se aplica a: Centro de partners

No se aplica a: Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

El recurso AgreementDocument solo es compatible actualmente con el Centro de partners en la nube pública de Microsoft.

En este artículo se describe cómo obtener un vínculo para descargar la plantilla de Contrato de cliente de Microsoft, en función del país o región del cliente y el idioma.

Requisitos previos

  • Si usa el SDK de .NET del Centro de partners, se requiere la versión 1.14 o posterior.

    Importante

    A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

    Se recomienda a los partners seguir usando las API REST del Centro de partners.

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario solo es compatible con la autenticación con el usuario y la aplicación.

  • País o región del cliente al que se aplica la plantilla de Contrato de cliente de Microsoft.

  • Idioma en el que se debe localizar la plantilla de Contrato de cliente de Microsoft.

Importante

  • El Contrato de cliente de Microsoft es específico del país o región. Al solicitar un vínculo para descargar la plantilla de Contrato de cliente de Microsoft, asegúrese de especificar el país o región correctos en función de la ubicación del cliente. o la lista de países o regiones admitidos, consulte Lista de países o regiones admitidos e idiomas.
  • Para algunos países o regiones, el Contrato de cliente de Microsoft está disponible en varios idiomas. Para obtener la mejor experiencia del cliente, elija el idioma que mejor se adapte a las necesidades del cliente. Para obtener una lista de idiomas admitidos, consulte Lista de países o regiones admitidos e idiomas.
  • Este método solo se admite con el Contrato de cliente de Microsoft.

.NET

Para recuperar un vínculo para descargar la plantilla de Contrato de cliente de Microsoft:

  1. Recupera los metadatos del Contrato de cliente de Microsoft. Debes obtener el valor de templateId del Contrato de cliente de Microsoft. Para obtener más información, consulte Obtención de los metadatos del Contrato de cliente de Microsoft.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Use la colección IAggregatePartner.AgreementTemplates.

  3. Llame al método ById y especifique el templateId del Contrato de cliente de Microsoft.

  4. Captura la propiedad Document .

  5. Llame al método ByCountry y especifique el país o región del cliente al que se aplica la plantilla de contrato. El valor predeterminado de la consulta es EE. UU . si no se especifica el método . Para obtener una lista de códigos de país o región admitidos, consulte Lista de países o regiones admitidos e idiomas. Este método distingue mayúsculas de minúsculas.

  6. Llame al método ByLanguage y especifique el idioma en el que se debe localizar la plantilla de contrato. La consulta tiene como valor predeterminado en-US si no se especifica el método o no se admite el código de país o región especificado para el país o región especificado. Para obtener una lista de códigos de idioma admitidos, consulte Lista de países o regiones admitidos e idiomas.

  7. Llame al método 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();

Puede encontrar un ejemplo completo en la clase GetAgreementDetails del proyecto de aplicación de prueba de consola.

Solicitud REST

Para recuperar un vínculo para descargar la plantilla de Contrato de cliente de Microsoft:

  1. Recupera los metadatos del Contrato de cliente de Microsoft. Debes obtener el valor de templateId del Contrato de cliente de Microsoft. Para obtener más información, consulte Obtención de los metadatos del Contrato de cliente de Microsoft.

  2. Cree una solicitud REST para capturar un recurso AgreementDocument. Para obtener un ejemplo, vea el ejemplo de sintaxis de solicitud. Debe especificar la siguiente información:

    • TemplateId del Contrato de cliente de Microsoft
    • País o región a la que se aplica la plantilla de Contrato de cliente de Microsoft
    • Idioma en el que se debe localizar la plantilla de Contrato de cliente de Microsoft

Sintaxis de la solicitud

Use la siguiente sintaxis de solicitud para este recurso:

Método URI de solicitud
GET {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

Parámetros de URI

Puede usar los siguientes parámetros de URI con la solicitud:

Nombre Type Obligatorio Descripción
agreement-template-id string Sí Identificador único del tipo de contrato. Puedes obtener el valor de templateId para el Contrato de cliente de Microsoft mediante la recuperación de los metadatos del Contrato del cliente de Microsoft. Para obtener más información, consulte Obtención de los metadatos del Contrato de cliente de Microsoft. Este parámetro distingue mayúsculas de minúsculas.
country string No Indica el país o región al que se aplica la plantilla de contrato. El valor predeterminado de la consulta es EE. UU . si no se especifica el parámetro . Para obtener una lista de códigos de país o región admitidos, consulte Lista de países o regiones admitidos e idiomas.
language string No Indica el idioma en el que se debe localizar la plantilla de contrato. La consulta tiene como valor predeterminado en-US si el parámetro no se especifica o el código de país o región especificado en no se admite para el país o región especificado. Para obtener una lista de códigos de país o región admitidos, consulte Lista de países o regiones admitidos e idiomas.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

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

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso AgreementDocument en el cuerpo de la respuesta.

El recurso tiene una propiedad downloadUri , que contiene una cadena de dirección URL que se puede usar para descargar la plantilla de contrato. Se devuelve un vínculo diferente cada vez que se realiza una consulta. Este vínculo expira después de cinco minutos.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración.

Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplo de respuesta

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"
}

Lista de países o regiones y idiomas admitidos

Importante

La propiedad de código de país o región distingue mayúsculas de minúsculas. Asegúrese de usar el uso de mayúsculas y minúsculas correctos especificados en esta tabla:

País/región Código de país Códigos de idioma admitidos
Islas Åland AX en-US
Afganistán AF en-US
Albania AL en-US
Argelia DZ en-US, fr-FR, en-US
Samoa Americana AS en-US
Andorra AD en-US
Angola AO en-US, pt-PT
Anguila INTELIGENCIA ARTIFICIAL en-US
Antártida AQ en-US
Antigua y Barbuda AG en-US
Argentina AR en-US, es-ES
Armenia AM en-US
Aruba AW en-US
Australia AU en-US
Austria AT en-US, de-DE
Azerbaiyán AZ en-US
Bahamas BS en-US
Bahréin BH en-US, ar-SA
Bangladés BD en-US
Barbados BB en-US
Bielorrusia BY en-US, ru-RU
Bélgica BE en-US, nl-NL
Belice BZ en-US, es-ES
Benín BJ en-US
Bermudas BM en-US
Bután BT en-US
Bolivia BO en-US, es-ES
Bonaire BQ en-US
Bosnia y Herzegovina BA en-US
Botsuana BW en-US
Isla Bouvet BV en-US
Brasil BR en-US, pt-BR
Territorio Británico del Océano Índico IO en-US
Islas Vírgenes Británicas VG en-US
Brunéi BN en-US
Bulgaria BG en-US, bg-BG
Burkina Faso BF en-US
Burundi BI en-US
Costa de Marfil CI en-US, fr-FR
Cabo Verde CV en-US, pt-PT
Camboya KH en-US
Camerún CM en-US, fr-FR
Canadá CA en-US, fr-FR
Islas Caimán KY en-US, en-US
República Centroafricana CF en-US
Chad TD en-US
Chile CL en-US, es-ES
Isla de Navidad CX en-US
Islas Cocos CC en-US
Colombia CO en-US, es-ES
Comoras KM en-US
Congo (RDC) CD en-US
Congo CG en-US
Islas Cook CK en-US
Costa Rica CR en-US, es-ES
Croacia HR en-US, hr-HR
Curazao CW en-US
Chipre CY en-US
Chequia CZ en-US, cs-CZ
Dinamarca DK en-US, da-DK
Yibuti DJ en-US
Dominica DM en-US
República Dominicana DO en-US, es-ES
Ecuador EC en-US
Egipto EG en-US, ar-SA
El Salvador SV en-US, es-ES
Guinea Ecuatorial GQ en-US
Eritrea ER en-US
Estonia EE en-US, et-EE
Suazilandia SZ en-US
Etiopía ET en-US
Islas Malvinas FK en-US
Islas Feroe FO en-US
Islas Fiji FJ en-US
Finlandia FI en-US, fi-FI
Francia VF en-US, fr-FR
Guayana Francesa GF en-US, fr-FR
Polinesia Francesa PF en-US
Territorios Australes Franceses TF en-US
Gabón GA en-US
Gambia GM en-US
Georgia GE en-US
Alemania DE en-US, de-DE
Ghana GH en-US
Gibraltar GI en-US
Grecia GR en-US, el-GR
Groenlandia GL en-US
Granada GD en-US
Guadalupe GP en-US
Guam GU en-US
Guatemala GT en-US, es-ES
Guernsey GG en-US
Guinea GN en-US
Guinea-Bisáu GW en-US
Guyana GY en-US
Haití HT en-US
Islas Heard y McDonald HM en-US
Honduras HN en-US, es-ES
Región Administrativa Especial de Hong Kong HK en-US, zh-HK
Hungría HU en-US, hu-HU
Islandia IS en-US
India IN en-US, hi-IN
Indonesia ID en-US, id-ID
Iraq IQ en-US, ar-SA
Irlanda IE en-US
Isla de Man IM en-US
Israel IL en-US, he-IL
Italia IT en-US, it-IT
Jamaica JM en-US
Jan Mayen XJ en-US
Japón JP en-US, ja-JP
Jersey JE en-US
Jordania JO en-US, ar-SA
Kazajistán 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
Kirguistán KG en-US, ru-RU
Laos Los Ángeles en-US
Letonia LV en-US, lv-LV
Líbano LB en-US, ar-SA
Lesoto 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
Luxemburgo LU en-US, fr-FR
Región administrativa especial de Macao MO en-US, zh-HK
Madagascar MG en-US
Malaui MW en-US
Malasia MY en-US, ms-MY
Maldivas MV en-US
Mali ML en-US
Malta MT en-US
Islas Marshall MH en-US
Martinica MQ en-US
Mauritania MR en-US
Mauricio MU en-US, ar-SA
Mayotte YT en-US
México MX en-US, es-ES
Micronesia FM en-US
Moldavia MD en-US, ro-RO
Mónaco MC en-US, fr-FR
Mongolia MN en-US
Montenegro ME en-US
Montserrat MS en-US
Marruecos MA en-US, fr-FR, en-US
Mozambique MZ en-US
Myanmar MM en-US
Namibia N/D en-US
Nauru NR en-US
Nepal NP en-US
Países Bajos NL en-US, nl-NL
Nueva Caledonia NC en-US
Nueva Zelanda NZ en-US
Nicaragua NI en-US, es-ES
Níger NE en-US
Nigeria NG en-US
Niue NU en-US
Isla Norfolk NF en-US
Islas Marianas del Norte MP en-US
Macedonia del Norte MK en-US
Noruega NO en-US, nb-NO
Omán OM en-US, ar-SA
Pakistán PK en-US
Palaos PW en-US
Autoridad palestina PS en-US
Panamá PA en-US, es-ES
Papúa Nueva Guinea PG en-US
Paraguay PY en-US, es-ES
Perú PE en-US, es-ES
Filipinas PH en-US
Islas Pitcairn PN en-US
Polonia PL en-US, pl-PL
Portugal PT en-US, pt-PT
Puerto Rico PR en-US, en-US
Qatar QA en-US, ar-SA
Reunión RE en-US
Rumanía RO en-US, ro-RO
Rusia RU en-US, ru-RU
Ruanda RW en-US, fr-FR
Santo Tomé y Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
San Cristóbal y Nieves KN en-US
Santa Lucía LC en-US, en-US
San Martín MF en-US, en-US
San Pedro y Miquelón PM en-US
San Vicente y las Granadinas VC en-US
Samoa WS en-US
San Marino SM en-US
Arabia Saudí SA en-US
Senegal SN en-US, fr-FR
Serbia RS en-US, sr-Latn-RS, en-US
Seychelles SC en-US
Sierra Leona SL en-US
Singapur SG en-US, zh-SG
San Eustaquio XE en-US
Sint Maarten SX en-US, en-US
Eslovaquia SK en-US, sk-SK
Eslovenia SI en-US, sl-SI
Islas Salomón SB en-US
Somalia SO en-US
Sudáfrica ZA en-US
Islas Georgia del Sur y Sandwich del Sur GS en-US
Sudán del Sur SS en-US
España ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Santa Elena, Ascensión y Tristán da Cunha SH en-US
Surinam SR en-US
Svalbard SJ en-US
Suecia SE en-US, sv-SE
Suiza CH en-US, fr-FR, en-US, en-US
Taiwán TW en-US, zh-HK
Tayikistán TJ en-US
Tanzania TZ en-US
Tailandia TH en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga TO en-US
Trinidad y Tobago TT en-US
Túnez TN en-US, fr-FR, en-US
Turquía TR en-US, tr-TR
Turkmenistán TM en-US
Islas Turcas y Caicos TC en-US
Tuvalu TV en-US
EE. UU. alejadas de los EE.UU. UM en-US
EE. UU. Vírgenes de EE. UU. VI en-US
Uganda UG en-US
Ucrania UA en-US, uk-UA
Emiratos Árabes Unidos AE en-US, ar-SA
Reino Unido GB es-ES
Estados Unidos US en-US
Uruguay UY en-US, es-ES
Uzbekistán UZ en-US, ru-RU
Vanuatu VU en-US
Ciudad del Vaticano VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis y Futuna WF en-US
Yemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabue ZW en-US