Partager via

Mettre à jour les qualifications d’un client de manière asynchrone

  • Article

Mises à jour les qualifications d’un client de façon asynchrone.

Un partenaire peut mettre à jour les qualifications d’un client de façon asynchrone pour être « Éducation », « GovernmentCommunityCloud » ou « StateOwnedEntity ». D’autres valeurs telles que « None » et « Association à but non lucratif » ne peuvent pas être définies.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

  • Pour les qualifications gcc (Government Community Cloud) uniquement : vous aurez besoin d’au moins l’un des rôles d’administrateur délégués (GDAP) suivants. Pour en savoir plus sur GDAP, explorez nos articles MS Learn, à partir de l’introduction au GDAP.

    • Lecteur de répertoire
    • Enregistreur d’annuaire
    • Administrateur de licence
    • Administrateur d’utilisateurs

C#

Pour créer la qualification d’un client pour « Éducation », commencez par créer un CustomerQualificationRequest objet de type et spécifiez le Education type de qualification et le EducationSegment, ainsi qu’un Website (facultatif).

Ensuite, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client.

Utilisez ensuite la propriété Qualification pour récupérer une interface ICustomerQualification.

Enfin, appelez CreateQualifications() ou CreateQualificationsAsync() utilisez l’objet CustomerQualificationRequest de type comme paramètre d’entrée.

// Education
var eduRequestBody = new CustomerQualificationRequest 
{
    Qualification = "Education",
    EducationSegment = "K12", // could also be "HigherEducation"
    Website = "example.edu"
};

var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(eduRequestBody);

// State Owned Entity
var soeRequestBody = new CustomerQualificationRequest 
{
    Qualification = "StateOwnedEntity"
};

var soeCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(soeRequestBody);

Exemple : Exemple d’application de console. Project : SdkSamples , classe : CreateCustomerQualification.cs

Pour mettre à jour la qualification d’un client vers GovernmentCommunityCloud sur un client existant sans qualification, le partenaire doit également inclure le code de validation du client.

Tout d’abord, créez un CustomerQualificationRequest objet de type et spécifiez le GovernmentCommunityCloud type de qualification et le code de validation.

Ensuite, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client.

Utilisez ensuite la propriété Qualification pour récupérer une interface ICustomerQualification.

Enfin, appelez CreateQualifications() ou CreateQualificationsAsync() utilisez l’objet CustomerQualificationRequest de type comme paramètre d’entrée.

var gccRequestBody = new CustomerQualificationRequest 
{
    Qualification = "GovernmentCommunityCloud",
    ValidationCode = "<validation code>"
};

var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(gccRequestBody);

Exemple : Exemple d’application de console. Projet : SdkSamples , classe : CreateCustomerQualificationWithGCC.cs

Demande REST

Syntaxe de la requête

Méthode URI de demande
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour mettre à jour la qualification.

Nom Type Requise Description
id-locataire-client GUID Oui La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné qui appartient au revendeur.

En-têtes de requête

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

Corps de la demande

Ce tableau décrit l’objet de qualification dans le corps de la requête.

Propriété Type Requise Description
Qualification string Oui Valeur de chaîne de l’énumération CustomerQualification .

Ce tableau décrit spécifiquement le corps de la demande pour la qualification éducation.

Propriété Type Requise Description
Qualification string Oui Education
EducationSegment string Oui K12, HigherEducation
Website string Non Site web pour l’entité éducation

Si la qualification est pour l’éducation, le segment Éducation est un champ obligatoire.

  • Les valeurs autorisées pour EducationSegment sont K12 et HigherEducation
  • Le site web reste un champ facultatif et n’est pertinent que si la qualification est pour l’éducation. Toutefois, il est vivement recommandé de l’inclure si disponible/applicable.

Ce tableau décrit spécifiquement le corps de la demande de qualification GovernmentCommunityCloud.

Propriété Type Requise Description
Qualification string Oui GovernmentCommunityCloud
ValidationCode string Oui Code de validation GCC du partenaire. Exemple : 123456

Si la qualification concerne GovernmentCommunityCloud , ValidationCode est un champ obligatoire.

Exemple de requête

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

// SOE
{
    "qualification": "StateOwnedEntity"
}

// Education
{
    "qualification": "Education",
    "educationSegment": "HigherEducation", // could also be "K12"
    "website": "contoso.edu"
}

// GCC
{
    "qualification": "GovernmentCommunityCloud",
    "validationCode": "123456"
}

Réponse REST

Si elle réussit, cette méthode renvoie un objet de qualification dans le corps de la réponse. Voici un exemple d’appel POST sur un client (avec une qualification précédente de None) avec la qualification Éducation .

Codes d’erreur et de réussite de la réponse

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 trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}