Condividi tramite

Aggiornare le qualifiche di un cliente in modo asincrono

  • Articolo

Aggiorna le qualifiche di un cliente in modo asincrono.

Un partner può aggiornare le qualifiche di un cliente in modo asincrono in modo che sia "Education", "GovernmentCommunityCloud" o "StateOwnedEntity". Non è possibile impostare altri valori, ad esempio "Nessuno" e "No profit".

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

  • Solo per le qualifiche GCC (Government Community Cloud): sono necessari almeno uno dei seguenti ruoli di amministratore delegato granulare (GDAP). Per altre informazioni su GDAP, vedere gli articoli di MS Learn, a partire da Introduzione a GDAP.

    • Ruolo con autorizzazioni di lettura della directory
    • Ruolo con autorizzazioni di scrittura nella directory
    • Amministratore licenze
    • Amministratore utenti

C#

Per creare prima di tutto la qualifica di un cliente per "Education", creare un CustomerQualificationRequest oggetto di tipo e specificare il Education tipo di qualificazione e EducationSegment, insieme a un Website (facoltativo).

Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente.

Usare quindi la proprietà Qualification per recuperare un'interfaccia ICustomerQualification.

Infine, chiamare CreateQualifications() o CreateQualificationsAsync() con l'oggetto CustomerQualificationRequest tipo come parametro di input.

// 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);

Esempio: App di esempio console. Progetto: Classe SdkSamples: CreateCustomerQualification.cs

Per aggiornare la qualifica di un cliente a GovernmentCommunityCloud su un cliente esistente senza qualifica, il partner deve includere anche il codice di convalida del cliente.

Creare prima di tutto un CustomerQualificationRequest oggetto tipo e specificare il GovernmentCommunityCloud tipo di qualificazione e il codice di convalida.

Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente.

Usare quindi la proprietà Qualification per recuperare un'interfaccia ICustomerQualification.

Infine, chiamare CreateQualifications() o CreateQualificationsAsync() con l'oggetto CustomerQualificationRequest tipo come parametro di input.

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

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

Esempio: App di esempio console. Progetto: Classe SdkSamples: CreateCustomerQualificationWithGCC.cs

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

Parametro URI

Usare il parametro di query seguente per aggiornare la qualifica.

Nome Digita Obbligatorio Descrizione
customer-tenant-id GUID Sì Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Questa tabella descrive l'oggetto di qualificazione nel corpo della richiesta.

Proprietà Type Obbligatorio Descrizione
Qualification string Sì Valore stringa dell'enumerazione CustomerQualification .

Questa tabella descrive in modo specifico il corpo della richiesta per la qualifica di istruzione.

Proprietà Type Obbligatorio Descrizione
Qualification string Sì Education
EducationSegment string Sì K12, HigherEducation
Website string No Sito Web per l'entità education

Se la qualifica è per Education , il segmento Education è un campo obbligatorio.

  • I valori consentiti per EducationSegment sono K12 e HigherEducation
  • Il sito Web rimane un campo facoltativo ed è rilevante solo se la qualifica è per l'istruzione. Tuttavia, includerlo se disponibile/applicabile è altamente consigliato

Questa tabella descrive in modo specifico il corpo della richiesta per la qualifica governmentCommunityCloud.

Proprietà Type Obbligatorio Descrizione
Qualification string Sì GovernmentCommunityCloud
ValidationCode string Sì Codice di convalida GCC del partner. Esempio - 123456

Se la qualifica è per GovernmentCommunityCloud , ValidationCode è un campo obbligatorio.

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

Risposta REST

In caso di esito positivo, questo metodo restituisce un oggetto qualifica nel corpo della risposta. Di seguito è riportato un esempio della chiamata POST su un cliente (con una qualifica precedente di None) con la qualifica Education .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}