Získání odkazu ke stažení pro šablonu smlouvy se zákazníkem Microsoftu

2025-05-11

platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Partner Center v současné době podporuje prostředek AgreementDocument pouze ve veřejném cloudu Microsoftu.

Tento článek popisuje, jak získat odkaz ke stažení šablony Smlouvy se zákazníkem Microsoftu na základě země nebo oblasti a jazyka zákazníka.

Požadavky

Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.14 nebo novější.

Důležitý

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.
Přihlašovací údaje, jak je popsáno v ověřování v Partnerském centru. Tento scénář podporuje pouze ověřování aplikací a uživatelů.
Země nebo oblast zákazníka, na kterou se vztahuje šablona Smlouvy se zákazníkem Microsoftu.
Jazyk, ve kterém by se měla lokalizovat šablona smlouvy se zákazníkem Microsoftu.

Důležitý

Smlouva se zákazníkem Microsoftu je specifická pro zemi nebo oblast. Při žádosti o odkaz ke stažení šablony Smlouvy se zákazníkem Microsoftu nezapomeňte zadat správnou zemi nebo oblast na základě umístění zákazníka. nebo seznam podporovaných zemí/oblastí, přečtěte si Seznam podporovaných zemí/oblastí a jazyků.
V některých zemích nebo oblastech je smlouva se zákazníkem Microsoftu dostupná v několika jazycích. Nejlepší prostředí pro zákazníky dosáhnete, když vyberete jazyk, který nejlépe odpovídá potřebám zákazníka. Seznam podporovaných jazyků najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.
Tato metoda se podporuje pouze se smlouvou se zákazníkem Microsoftu.

.SÍŤ

Chcete-li získat odkaz ke stažení šablony smlouvy se zákazníkem Microsoftu:

Získejte metadata smlouvy pro Smlouvu se zákazníkem společnosti Microsoft. Musíte získat templateId Smlouvy Microsoftu se zákazníkem. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

Použijte kolekci IAggregatePartner.AgreementTemplates.
Zavolejte metodu ById a zadejte templateId smlouvy se zákazníkem Microsoftu.
Získejte vlastnost dokumentu.
Zavolejte metodu ByCountry a zadejte zemi nebo oblast zákazníka, na kterou se šablona smlouvy vztahuje. Pokud není metoda zadána, dotaz se ve výchozím nastavení nastaví na USA. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků. Tato metoda rozlišuje velká a malá písmena.
Zavolejte metodu ByLanguage a zadejte jazyk, ve kterém má být šablona smlouvy lokalizována. Dotaz se nastaví na en-US, pokud není specifikována metoda nebo pokud zadaný kód země nebo oblasti není podporován pro zadanou zemi či oblast ve výchozím nastavení. Seznam podporovaných kódů jazyků najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.

Volejte metodu Get nebo GetAsync.

// IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Úplnou ukázku najdete ve třídě GetAgreementDetails v rámci projektu testovací konzolové aplikace.

Požadavek REST

Chcete-li získat odkaz ke stažení šablony smlouvy se zákazníkem Microsoftu:

Získejte metadata smlouvy pro Smlouvu se zákazníkem společnosti Microsoft. Musíte získat templateId Smlouvy Microsoftu se zákazníkem. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.
Vytvořte požadavek REST na načtení prostředku AgreementDocument. Příklad najdete v příkladu syntaxe požadavku . Musíte zadat následující informace:
- identifikátor šablony Smlouvy se zákazníkem společnosti Microsoft
- Země/oblast, na kterou se vztahuje šablona Smlouvy se zákazníkem Microsoftu
- Jazyk, ve kterém by se měla lokalizovat šablona smlouvy se zákazníkem Microsoftu

Syntaxe požadavku

Pro tento prostředek použijte následující syntaxi požadavku:

Metoda	Požadavek URI
ZÍSKAT	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

Parametry identifikátoru URI

U požadavku můžete použít následující parametry identifikátoru URI:

Jméno	Typ	Vyžadováno	Popis
šablona-dohody-id	řetězec	Ano	Jedinečný identifikátor typu smlouvy. ID šablony pro smlouvu se zákazníkem Microsoftu můžete získat načtením jejích metadat. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu. Tento parametr rozlišuje malá a velká písmena.
země	řetězec	Ne	Určuje zemi nebo oblast, na kterou se šablona smlouvy vztahuje. Dotaz se nastaví na výchozí hodnotu US, pokud není parametr zadaný. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.
Jazyk	řetězec	Ne	Označuje jazyk, ve kterém má být šablona smlouvy lokalizována. Výchozí hodnoty dotazu jsou en-US, pokud není určen parametr nebo pokud není kód země/oblasti podporován pro zadanou zemi nebo oblast. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.

Hlavičky požadavku

Pro více informací viz REST hlavičky Partnerského centra.

Text požadavku

Žádný.

Příklad požadavku

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

Odpověď REST

V případě úspěchu tato metoda vrátí prostředek AgreementDocument v textu odpovědi.

Prostředek má vlastnost downloadUri, která obsahuje řetězec adresy URL, který lze použít ke stažení šablony smlouvy. Pokaždé, když vytvoříte dotaz, se vrátí jiný odkaz. Platnost tohoto odkazu vyprší po pěti minutách.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění.

Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu kódy chyb REST rozhraní Partnerského centra.

Příklad odpovědi

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

Seznam podporovaných zemí/oblastí a jazyků