A Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítése Partnerközpont API-k használatával
A következőre vonatkozik: Partnerközpont
Nem vonatkozik a 21Vianet által üzemeltetett Partnerközpontra | Partnerközpont a Microsoft Cloud for US Government számára
A Partnerközpont jelenleg csak a Microsoft nyilvános felhőjében támogatja a Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítését.
Ez a cikk a Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítését vagy ismételt megerősítését ismerteti.
Előfeltételek
- Ha a Partnerközpont .NET SDK-t használja, az 1.14-es vagy újabb verzióra van szükség.
Fontos
2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.
A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak az App+User hitelesítést támogatja.
Ügyfélazonosító (
customer-tenant-id
). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id
).Az a dátum (dátumA megállapodás), amikor az ügyfél elfogadta a Microsoft Ügyfélszerződés.
A Microsoft Ügyfélszerződés elfogadó ügyfélszervezet felhasználójának adatai. This includes:
- First name
- Last name
- Email address
- Telefon szám (nem kötelező)
Ha a következő értékek módosulnak egy ügyfél esetében, a Partnerközpont engedélyezi egy másik szerződés létrehozását az adott ügyfél számára: Vezetéknév vezetéknév e-mail-címe Telefon szám Ellenkező esetben a partnerek a következő hibakódot kapják, mert ismétlődő ügyfél jön létre
{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}
.NET
A Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítése vagy ismételt megerősítése:
Kérje le a szerződés metaadatait a Microsoft Ügyfélszerződés. Be kell szereznie a Microsoft Ügyfélszerződés sablonazonosítóját. További információ: Szerződés metaadatainak lekérése Microsoft Ügyfélszerződés.
// IAggregatePartner partnerOperations; string agreementType = "MicrosoftCustomerAgreement"; var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
Hozzon létre egy új szerződésobjektumot , amely tartalmazza a megerősítés részleteit.
Használja az IAgreggatePartner.Customers gyűjteményt, és hívja meg a ById metódust a megadott ügyfél-bérlő azonosítóval.
Használja a Szerződések tulajdonságot, majd hívja meg a Create vagy a CreateAsync parancsot.
// string selectedCustomerId; var agreementToCreate = new Agreement { DateAgreed = DateTime.UtcNow, TemplateId = microsoftCustomerAgreementDetails.TemplateId, PrimaryContact = new Contact { FirstName = "Tania", LastName = "Carr", Email = "someone@example.com", PhoneNumber = "1234567890" } }; Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);
A konzoltesztelési alkalmazás projektjének CreateCustomerAgreement osztályában teljes minta található.
REST-kérés
A Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítése vagy ismételt megerősítése:
- Kérje le a szerződés metaadatait a Microsoft Ügyfélszerződés. Be kell szereznie a Microsoft Ügyfélszerződés sablonazonosítóját. További információ: Szerződés metaadatainak lekérése Microsoft Ügyfélszerződés.
- Hozzon létre egy új szerződési erőforrást annak ellenőrzéséhez, hogy az ügyfél elfogadta-e a Microsoft Ügyfélszerződés. Használja az alábbi REST-kérés szintaxisát.
Kérés szintaxisa
Method | Kérés URI-ja |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1 |
URI-paraméter
A következő lekérdezési paraméterrel adhatja meg a megerősítendő ügyfelet.
Name | Type | Kötelező | Leírás |
---|---|---|---|
ügyfél-bérlő-azonosító | GUID | Igen | Az érték egy GUID formátumú ügyfél-bérlő azonosító, amely egy olyan azonosító, amely lehetővé teszi az ügyfél megadását. |
Kérésfejlécek
További információ: Partnerközpont – REST fejlécek.
Kérés törzse
Ez a táblázat a REST-kérelem törzsében található szükséges tulajdonságokat ismerteti.
Name | Type | Description |
---|---|---|
Agreement | object | A partner által megadott adatok a Microsoft Ügyfélszerződés ügyfél általi elfogadásának megerősítéséhez. |
Agreement
Ez a táblázat a szerződés-erőforrás létrehozásához minimálisan szükséges mezőket ismerteti.
Tulajdonság | Type | Description |
---|---|---|
primaryContact | Kapcsolatfelvétel | A Microsoft Ügyfélszerződés elfogadó ügyfél szervezetének felhasználójára vonatkozó információk, beleértve a következőket: firstName, lastName, e-mail és phoneNumber (nem kötelező) |
dateAgreed | sztring UTC dátum időformátumban | Az a dátum, amikor az ügyfél elfogadta a szerződést. |
templateId | sztring | Az ügyfél által elfogadott szerződéstípus egyedi azonosítója. A Microsoft Ügyfélszerződés sablonazonosítóját a Microsoft Ügyfélszerződés szerződés metaadatainak lekérésével szerezheti be. Részletekért tekintse meg a Microsoft Ügyfélszerződés szerződés metaadatainak lekérése című témakört. |
típus | sztring | Az ügyfél által elfogadott szerződéstípus. Használja a "MicrosoftCustomerAgreement" kifejezést, ha az ügyfél elfogadta a Microsoft Ügyfélszerződés. |
Példa kérése
POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
"primaryContact": {
"firstName": "Tania",
"lastName": "Carr",
"email": "someone@example.com",
"phoneNumber": "1234567890"
},
"templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
"dateAgreed": "2018-06-14T00:00:00.000Z",
"type": "MicrosoftCustomerAgreement"
}
REST-válasz
Ha sikeres, ez a metódus egy szerződési erőforrást ad vissza.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat.
A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.
Példa válaszra
HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
"userId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"primaryContact": {
"firstName": "Tania",
"lastName": "Carr",
"email": "someone@example.com",
"phoneNumber": "1234567890"
},
"templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
"dateAgreed": "2018-06-14T00:00:00.000Z",
"type": "MicrosoftCustomerAgreement"
}