Partilhar via

Obter um link de download para o modelo de Contrato de Cliente Microsoft

  • Artigo

Aplica-se a: Partner Center

Não se aplica a: Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Atualmente , o recurso AgreementDocument é suportado pelo Partner Center apenas na nuvem pública da Microsoft.

Este artigo descreve como obter um link para baixar o modelo de Contrato de Cliente da Microsoft, com base no país/região e idioma do cliente.

Pré-requisitos

  • Se você estiver usando o SDK .NET do Partner Center, a versão 1.14 ou mais recente será necessária.

    Importante

    A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do .NET do Partner Center foi arquivada. Você pode baixar a versão do SDK do GitHub, juntamente com um arquivo readme que contém informações úteis.

    Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

  • Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta apenas a autenticação App+User.

  • O país/região do cliente ao qual o modelo de Contrato de Cliente da Microsoft se aplica.

  • O idioma no qual o modelo de Contrato de Cliente da Microsoft deve ser localizado.

Importante

  • O Contrato de Cliente Microsoft é específico de país/região. Ao solicitar um link para baixar o modelo de Contrato de Cliente Microsoft, certifique-se de especificar o país/região correto com base na localização do cliente. ou lista de países/regiões suportados, consulte Lista de países/regiões e idiomas suportados.
  • Para alguns países/regiões, o Contrato de Cliente Microsoft está disponível em vários idiomas. Para uma melhor experiência do cliente, escolha o idioma que melhor corresponda às necessidades do cliente. Para obter uma lista de idiomas suportados, consulte Lista de países/regiões e idiomas suportados.
  • Este método só é suportado com o Contrato de Cliente da Microsoft.

.NET

Para recuperar um link para baixar o modelo de Contrato de Cliente da Microsoft:

  1. Recupere os metadados do contrato para o Contrato de Cliente da Microsoft. Você deve obter o templateId do Contrato de Cliente Microsoft. Para obter mais informações, consulte Obter metadados de contrato para o Contrato de Cliente Microsoft.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Use a coleção IAggregatePartner.AgreementTemplates.

  3. Chame o método ById e especifique o templateId do Contrato de Cliente da Microsoft.

  4. Buscar a propriedade Document .

  5. Chame o método ByCountry e especifique o país/região do cliente ao qual o modelo de contrato se aplica. O padrão da consulta será US se o método não for especificado. Para obter uma lista de códigos de país/região suportados, consulte Lista de países/regiões e idiomas suportados. Este método diferencia maiúsculas de minúsculas.

  6. Chame o método ByLanguage e especifique o idioma no qual o modelo de contrato deve ser localizado. O padrão da consulta é en-US se o método não for especificado ou se o código de país/região especificado não for suportado para o país/região especificado. Para obter uma lista de códigos de idiomas suportados, consulte Lista de países/regiões e idiomas suportados.

  7. Chame o método Get ou GetAsync .

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Um exemplo completo pode ser encontrado na classe GetAgreementDetails do projeto de aplicativo de teste de console.

Pedido REST

Para recuperar um link para baixar o modelo de Contrato de Cliente da Microsoft:

  1. Recupere os metadados do contrato para o Contrato de Cliente da Microsoft. Você deve obter o templateId do Contrato de Cliente Microsoft. Para obter mais informações, consulte Obter metadados de contrato para o Contrato de Cliente Microsoft.

  2. Crie uma solicitação REST para buscar um recurso AgreementDocument. Para obter um exemplo, consulte o exemplo de sintaxe de solicitação. Você deve especificar as seguintes informações:

    • O templateId do Contrato de Cliente Microsoft
    • O país/região ao qual o modelo de Contrato de Cliente Microsoft se aplica
    • O idioma no qual o modelo de Contrato de Cliente da Microsoft deve ser localizado

Sintaxe da solicitação

Use a seguinte sintaxe de solicitação para este recurso:

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

Parâmetros de URI

Você pode usar os seguintes parâmetros de URI com sua solicitação:

Nome Type Obrigatório Description
Acordo-modelo-ID string Sim Identificador exclusivo do tipo de contrato. Você pode obter o templateId para o Contrato de Cliente Microsoft recuperando os metadados do contrato para o Contrato de Cliente Microsoft. Para obter mais informações, consulte Obter metadados de contrato para o Contrato de Cliente Microsoft. Este parâmetro diferencia maiúsculas de minúsculas.
país/região string Não Indica o país/região ao qual o modelo de contrato se aplica. O padrão da consulta será US se o parâmetro não for especificado. Para obter uma lista de códigos de país/região suportados, consulte Lista de países/regiões e idiomas suportados.
idioma string Não Indica o idioma no qual o modelo de contrato deve ser localizado. O padrão da consulta é en-US se o parâmetro não for especificado ou se o código de país/região especificado não for suportado para o país/região especificado. Para obter uma lista de códigos de país/região suportados, consulte Lista de países/regiões e idiomas suportados.

Cabeçalhos do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhum.

Exemplo de solicitação

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

Resposta do REST

Se bem-sucedido, esse método retorna um recurso AgreementDocument no corpo da resposta.

O recurso tem uma propriedade downloadUri , que contém uma cadeia de caracteres de URL que pode ser usada para baixar o modelo de contrato. Um link diferente é retornado cada vez que você faz uma consulta. Este link expira após cinco minutos.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração.

Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

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

Lista de países/regiões e idiomas suportados

Importante

A propriedade do código de país/região diferencia maiúsculas de minúsculas. Certifique-se de usar o invólucro correto especificado nesta tabela:

País/Região Indicativo do país Código(s) de idioma suportado(s)
Ilhas Alanda AX en-US
Afeganistão AF en-US
Albânia AL en-US
Argélia DZ en-US, fr-FR, en-US
Samoa Americana AS en-US
Andorra AD en-US
Angola AO pt-EUA, pt-PT
Anguila IA en-US
Antártica QA en-US
Antígua e Barbuda AG en-US
Argentina AR pt-EUA, es-ES
Arménia AM en-US
Aruba AW en-US
Austrália AU en-US
Áustria AT en-US, de-DE
Azerbaijão AZ en-US
Baamas BS en-US
Barém BH en-EUA, ar-SA
Bangladesh BD en-US
Barbados BB en-US
Bielorrússia BY en-EUA, ru-RU
Bélgica BE pt-EUA, nl-NL
Belize BZ pt-EUA, es-ES
Benim BJ en-US
Bermudas BM en-US
Butão BT en-US
Bolívia BO pt-EUA, es-ES
Bonaire BQ en-US
Bósnia e Herzegovina BA en-US
Botsuana BW en-US
Ilha Bouvet BV en-US
Brasil BR pt-EUA, pt-BR
Território Britânico do Oceano Índico IO en-US
Ilhas Virgens Britânicas VG en-US
Brunei BN en-US
Bulgária BG en-EUA, bg-BG
Burkina Faso BF en-US
Burundi BI en-US
Costa do Marfim (Côte d’Ivoire) IC en-US, fr-FR
Cabo Verde CV pt-EUA, pt-PT
Camboja KH en-US
Camarões CM en-US, fr-FR
Canadá CA en-US, fr-FR
Ilhas Caimão KY en-US, en-US
República Centro-Africana CF en-US
Chade TD en-US
Chile CL pt-EUA, es-ES
Ilha do Natal CX en-US
Ilhas dos Cocos (Keeling) CC en-US
Colômbia CO pt-EUA, es-ES
Comoros KM en-US
República Democrática do Congo CD en-US
Congo CG en-US
Ilhas Cook CK en-US
Costa Rica CR pt-EUA, es-ES
Croácia HR pt-EUA, hr-HR
Curaçao CW en-US
Chipre CY en-US
Chéquia CZ pt-EUA, cs-CZ
Dinamarca DK en-EUA, da-DK
Jibuti DJ en-US
Dominica DM en-US
República Dominicana DO pt-EUA, es-ES
Equador EC en-US
Egito EG en-EUA, ar-SA
Salvador SV pt-EUA, es-ES
Guiné Equatorial GQ en-US
Eritreia ER en-US
Estónia EE en-EUA, et-EE
Essuatíni SZ en-US
Etiópia ET en-US
Ilhas Falkland (Malvinas) FK en-US
Ilhas Faroé FO en-US
Fiji FJ en-US
Finlândia FI pt-EUA, fi-FI
França FR en-US, fr-FR
Guiana Francesa GF en-US, fr-FR
Polinésia Francesa PF en-US
Territórios Austrais Franceses TF en-US
Gabão GA en-US
Gâmbia GM en-US
Geórgia GE en-US
Alemanha DE en-US, de-DE
Gana GH en-US
Gibraltar IG en-US
Grécia GR pt-EUA, el-GR
Gronelândia Orientações en-US
Granada GD en-US
Guadalupe GP en-US
Guame GU en-US
Guatemala GT pt-EUA, es-ES
Guernesey GG en-US
Guiné GN en-US
Guiné-Bissau GW en-US
Guiana GY en-US
Haiti HT en-US
Ilhas Heard e McDonald EA en-US
Honduras HN pt-EUA, es-ES
Região Administrativa Especial de Hong Kong HK en-EUA, zh-HK
Hungria HU pt-EUA, hu-HU
Islândia IS en-US
Índia IN pt-BR, oi-IN
Indonésia ID en-US, ID ID
Iraque IQ en-EUA, ar-SA
Irlanda IE en-US
Ilha de Man MI en-US
Israel IL en-EUA, he-IL
Itália TI pt-EUA, it-IT
Jamaica JM en-US
Jan Mayen XJ en-US
Japão JP en-EUA, ja-JP
Jersey JE en-US
Jordânia JO en-EUA, ar-SA
Cazaquistão KZ en-EUA, kk-KZ
Quénia KE en-US
Quiribáti KI en-US
Coreia do Sul KR en-EUA, ko-KR
Kosovo XK en-US
Koweit KW en-EUA, ar-SA
Quirguistão KG en-EUA, ru-RU
Laos LA en-US
Letónia LV en-EUA, lv-LV
Líbano LB en-EUA, ar-SA
Lesoto LS en-US
Libéria LR en-US
Líbia LY en-EUA, ar-SA
Listenstaine LI en-US, de-DE
Lituânia LT pt-EUA, lt-LT
Luxemburgo LU en-US, fr-FR
Região Administrativa Especial de Macau MO en-EUA, zh-HK
Madagáscar MG en-US
Maláui MW en-US
Malásia MY pt-BR, ms-MY
Maldivas MV en-US
Mali ML en-US
Malta MT en-US
Ilhas Marshall EM en-US
Martinica MQ en-US
Mauritânia MR en-US
Maurícias MU en-EUA, ar-SA
Maiote Ano Até à Data en-US
México MX pt-EUA, es-ES
Micronésia FM en-US
Moldávia MD pt-EUA, ro-RO
Mónaco MC en-US, fr-FR
Mongólia MN en-US
Montenegro ME en-US
Montserrate MS en-US
Marrocos MA en-US, fr-FR, en-US
Moçambique MZ en-US
Mianmar MM en-US
Namíbia ND en-US
Nauru NR en-US
Nepal NP en-US
Países Baixos NL pt-EUA, nl-NL
Nova Caledónia N.º en-US
Nova Zelândia NZ en-US
Nicarágua NI pt-EUA, es-ES
Níger NE en-US
Nigéria NG en-US
Niuê NU en-US
Ilha Norfolk NF en-US
Ilhas Marianas do Norte MP en-US
Macedónia do Norte MK en-US
Noruega Não pt-BR, nb-NÃO
Omã OM en-EUA, ar-SA
Paquistão PK en-US
Palau PW en-US
Autoridade Palestiniana PS en-US
Panamá PA pt-EUA, es-ES
Papua-Nova Guiné PG en-US
Paraguai PY pt-EUA, es-ES
Peru PE pt-EUA, es-ES
Filipinas PH en-US
Ilhas Pitcairn PN en-US
Polónia PL pt-EUA, pl-PL
Portugal PT pt-EUA, pt-PT
Porto Rico PR en-US, en-US
Catar Perguntas e Respostas en-EUA, ar-SA
Reunião RE en-US
Roménia RO pt-EUA, ro-RO
Rússia RU en-EUA, ru-RU
Ruanda RW en-US, fr-FR
São Tomé e Príncipe ST en-US, fr-FR
Saba XS en-US
São Bartolomeu BL en-US
São Cristóvão e Neves KN en-US
Santa Lúcia LC en-US, en-US
São Martinho (Saint Martin) MF en-US, en-US
São Pedro e Miquelão PM en-US
São Vicente e Granadinas VC en-US
Samoa WS en-US
São Marino SM en-US
Arábia Saudita SA en-US
Senegal SN en-US, fr-FR
Sérvia RS en-US, sr-Latn-RS, en-US
Seicheles SC en-US
Serra Leoa SL en-US
Singapura SG pt-EUA, zh-SG
Santo Eustáquio XE en-US
São Martinho (Sint Maarten) SX en-US, en-US
Eslováquia SK en-EUA, sk-SK
Eslovénia SI pt-EUA, sl-SI
Ilhas Salomão SB en-US
Somália SO en-US
África do Sul ZA en-US
Ilhas Geórgia do Sul e Sandwich do Sul GS en-US
Sudão do Sul SS en-US
Espanha ES en-US, es-ES, en-US, en-US
Sri Lanca LK en-US
Santa Helena, Ascensão e Tristão da Cunha SH en-US
Suriname SR en-US
Svalbard SJ en-US
Suécia SE en-EUA, sv-SE
Suíça CH en-US, fr-FR, en-US, en-US
Taiwan TW en-EUA, zh-HK
Tajiquistão TJ en-US
Tanzânia TZ en-US
Tailândia TH en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Toquelau 5 Mil en-US
Tonga TO en-US
Trindade e Tobago TT en-US
Tunísia TN en-US, fr-FR, en-US
Türkiye TR en-EUA, tr-TR
Turquemenistão TM en-US
Ilhas Turcas e Caicos TC en-US
Tuvalu TV en-US
Ilhas Menores Afastadas dos EUA UM en-US
Ilhas Virgens dos EUA VI en-US
Uganda UG en-US
Ucrânia UA pt-EUA, Reino Unido-UA
Emirados Árabes Unidos AE en-EUA, ar-SA
Reino Unido GB en-US
Estados Unidos da América E.U.A. en-US
Uruguai UY pt-EUA, es-ES
Usbequistão UZ en-EUA, ru-RU
Vanuatu VU en-US
Cidade do Vaticano VA en-US
Venezuela VE pt-EUA, es-ES
Vietname VN en-EUA, vi-VN
Wallis e Futuna WF en-US
Iémen YE en-EUA, ar-SA
Zâmbia ZM en-US
Zimbabué ZW en-US