Obtenir un lien de téléchargement pour le modèle de Contrat client Microsoft

2025-05-11

s’applique à: Centre de partenaires

Ne s’applique pas à : Espace partenaires exploité par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis

La ressource AgreementDocument est actuellement prise en charge par l’Espace partenaires uniquement dans le cloud public Microsoft.

Cet article explique comment obtenir un lien pour télécharger le modèle de Contrat client Microsoft, en fonction du pays/de la région et de la langue du client.

Conditions préalables

Si vous utilisez le SDK .NET de l’Espace partenaires, la version 1.14 ou ultérieure est requise.

Important

Depuis juin 2023, la dernière version du Kit de développement logiciel (SDK) .NET de l’Espace partenaires version 3.4.0 est désormais archivée. Vous pouvez télécharger la version de la release du SDK à partir de GitHub, ainsi qu'un fichier README contenant des informations utiles.

Les partenaires sont encouragés à continuer à utiliser les API REST du Partner Center.
Informations d’identification décrites dans l’authentification de l’Espace partenaires. Ce scénario ne prend en charge que l’authentification App+User.
Pays/région du client auquel le modèle de Contrat client Microsoft s’applique.
Langue dans laquelle le modèle de Contrat client Microsoft doit être localisé.

Important

Le Contrat client Microsoft est spécifique à un pays ou à une région. Lorsque vous demandez un lien pour télécharger le modèle de Contrat client Microsoft, assurez-vous de spécifier le pays/la région corrects en fonction de l’emplacement du client. ou la liste des pays/régions pris en charge, reportez-vous à la liste des pays/régions et des langues pris en charge.
Pour certains pays/régions, le Contrat client Microsoft est disponible en plusieurs langues. Pour une expérience client optimale, choisissez la langue qui correspond le mieux aux besoins du client. Pour obtenir la liste des langues prises en charge, reportez-vous à la section Liste des pays/régions et des langues pris en charge.
Cette méthode n’est prise en charge qu’avec le Contrat client Microsoft.

.FILET

Pour récupérer un lien permettant de télécharger le modèle de Contrat client Microsoft :

Récupérez les métadonnées du contrat pour le Contrat client Microsoft. Vous devez obtenir le templateId du Contrat client Microsoft. Pour plus d’informations, consultez Obtenir les métadonnées du contrat pour le Contrat client Microsoft.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

AgreementMetaData microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.   ByAgreementType(agreementType).Get().Items.Single();
```
Utilisez la collection IAggregatePartner.AgreementTemplates.
Appelez la méthode ById et spécifiez le templateId du Contrat client Microsoft.
Récupérez la propriété Document .
Appelez la méthode ByCountry et spécifiez le pays/la région du client auquel le modèle d’accord s’applique. La requête est définie par défaut sur US si la méthode n’est pas spécifiée. Pour obtenir la liste des codes de pays/régions pris en charge, reportez-vous à la section Liste des pays/régions et des langues pris en charge. Cette méthode est sensible à la casse.
Appelez la méthode ByLanguage et spécifiez la langue dans laquelle le modèle d’accord doit être localisé. La valeur par défaut de la requête esten-US si la méthode n’est pas spécifiée ou si le code de pays/région spécifié n’est pas pris en charge pour le pays/la région spécifié. Pour obtenir la liste des codes de langue pris en charge, reportez-vous à la section Liste des pays/régions et des langues pris en charge.

Appelez la méthode 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();

Un exemple complet est disponible dans la classe GetAgreementDetails du projet d’application de test de console .

Requête REST

Pour récupérer un lien permettant de télécharger le modèle de Contrat client Microsoft :

Récupérez les métadonnées du contrat pour le Contrat client Microsoft. Vous devez obtenir le templateId du Contrat client Microsoft. Pour plus d’informations, consultez Obtenir les métadonnées du contrat pour le Contrat client Microsoft.
Créez une requête REST pour récupérer une ressource AgreementDocument. Pour obtenir un exemple, consultez l’exemple de syntaxe de requête . Vous devez spécifier les informations suivantes :
- Le templateId du Contrat client Microsoft
- Pays/région auquel s’applique le modèle de Contrat client Microsoft
- Langue dans laquelle le modèle de Contrat client Microsoft doit être localisé

Syntaxe de la requête

Utilisez la syntaxe de requête suivante pour cette ressource :

Méthode	URI de la requête
AVOIR	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document ?language={language}&country={country} HTTP/1.1

Paramètres d’URI

Vous pouvez utiliser les paramètres d’URI suivants avec votre requête :

Nom	Catégorie	Obligatoire	Descriptif
id_modèle-accord	ficelle	Oui	Identifiant unique du type d’accord. Vous pouvez obtenir le templateId pour le Contrat client Microsoft en récupérant les métadonnées du contrat pour le Contrat client Microsoft. Pour plus d’informations, consultez Obtenir les métadonnées du contrat pour le Contrat client Microsoft. Ce paramètre est sensible à la casse.
pays	ficelle	Non	Indique le pays/la région auquel le modèle d’accord s’applique. La valeur par défaut de la requête est US si le paramètre n’est pas spécifié. Pour obtenir la liste des codes de pays/régions pris en charge, reportez-vous à la section Liste des pays/régions et des langues pris en charge.
Langue	ficelle	Non	Indique la langue dans laquelle le modèle d’accord doit être localisé. La requête par défaut esten-US si le paramètre n’est pas spécifié ou si le code de pays/région spécifié n’est pas pris en charge pour le pays/la région spécifié. Pour obtenir la liste des codes de pays/régions pris en charge, reportez-vous à la section Liste des pays/régions et des langues pris en charge.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la requête

Aucun.

Exemple de requête

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

Réponse REST

En cas de réussite, cette méthode retourne une ressource AgreementDocument dans le corps de la réponse.

La ressource possède une propriété downloadUri , qui contient une chaîne d’URL qui peut être utilisée pour télécharger le modèle d’accord. Un lien différent est renvoyé chaque fois que vous effectuez une requête. Ce lien expire au bout de cinq minutes.

Réussite de la réponse et codes d’erreur

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage.

Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de Partner Center.

Exemple de réponse

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

Liste des pays/régions et langues pris en charge