Aracılığıyla paylaş

İş Ortağı Merkezi API'lerini kullanarak Microsoft Müşteri Sözleşmesi'ni müşteri kabulü onaylayın

İş Ortağı Merkezi için geçerlidir.

için geçerli değildir: 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

İş Ortağı Merkezi şu anda yalnızca Microsoft genel bulutunda Microsoft Müşteri Sözleşmesi'nin müşteri kabulünün onaylanmasını desteklemektedir.

Bu makalede, Microsoft Müşteri Sözleşmesi'nin müşteri kabulünü onaylama veya yeniden onaylama işlemleri açıklanmaktadır.

Önkoşullar

  • İş Ortağı Merkezi .NET SDK'sını kullanıyorsanız, sürüm 1.14 veya üzeri gereklidir.

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü GitHub'dan, yararlı bilgiler içeren bir benioku dosyası ile birlikte indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

  • İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik doğrulamayı destekler.

  • Bir müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi içinde Müşteriler çalışma alanını seçip, ardından müşteri listesinden müşteriyi ve sonra Hesap'ı seçerek bulabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği arayın. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

  • Müşterinin Microsoft Müşteri Sözleşmesi'ni kabul ettiği tarih (dateAgreed).

  • Microsoft Müşteri Sözleşmesi'ni kabul eden müşteri kuruluşundan kullanıcı hakkındaki bilgiler. Buna şunlar dahildir:

    • İsim
    • Soyadı
    • E-posta adresi
    • Telefon numarası (isteğe bağlı)

  • Bir müşteri için aşağıdaki değerler değişirse, İş Ortağı Merkezi bu müşteri için başka bir sözleşme oluşturulmasına izin verir: Ad Soyadı E-posta adresi Telefon numarası Aksi takdirde, yinelenen bir müşteri oluşturulduğu için iş ortakları aşağıdaki hata kodunu alır

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

Microsoft Müşteri Sözleşmesi'nin müşteri kabulünü onaylamak veya yeniden onaylamak için:

  1. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alın. Microsoft Müşteri Sözleşmesi'nin templateId edinmeniz gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Onayın ayrıntılarını içeren yeni bir Sözleşmesi nesnesi oluşturun.

  3. IAgreggatePartner.Customers koleksiyonunu kullanın ve belirtilen customer-tenant-idile ById yöntemini çağırın.

  4. Sözleşmeleri özelliğini kullanın, ardından Create veya CreateAsyncçağrısını yapın.

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

konsol test uygulaması projesinden CreateCustomerAgreement sınıfında eksiksiz bir örnek bulunabilir.

REST isteği

Microsoft Müşteri Sözleşmesi'nin müşteri kabulünü onaylamak veya yeniden onaylamak için:

  1. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alın. Microsoft Müşteri Sözleşmesi'nin templateId edinmeniz gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma.
  2. Müşterinin Microsoft Müşteri Sözleşmesi'ni kabul ettiğini onaylamak için yeni bir Sözleşmesi kaynak oluşturun. Aşağıdaki REST isteği söz diziminikullanın.

İstek söz dizimi

Yöntem İstek URI'si
GÖNDERİ {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI parametresi

Onayladığınız müşteriyi belirtmek için aşağıdaki sorgu parametresini kullanın.

Ad Tür Gerekli Açıklama
müşteri-kiracı kimliği GUID Evet Değer, bir müşteriyi belirtmenize olanak tanıyan, müşteri kiracı kimliği olarak kullanılan GUID biçiminde bir tanımlayıcıdır: customer-tenant-id.

İstek başlıkları

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST başlıkları.

İstek içeriği

Bu tabloda REST isteği gövdesindeki gerekli özellikler açıklanmaktadır.

İsim Tip Açıklama
Anlaşma nesne Microsoft Müşteri Sözleşmesi'nin müşteri tarafından kabul edildiğini onaylamak için iş ortağı tarafından sağlanan ayrıntılar.

Anlaşma

Bu tabloda, Sözleşmesi kaynağıoluşturmak için gerekli minimum alanlar açıklanmaktadır.

Mülk Tür Açıklama
ana iletişim kişisi İletişim Microsoft Müşteri Sözleşmesi'ni kabul eden müşteri kuruluşundan kullanıcı hakkında bilgiler: firstName, lastName, e-postave phoneNumber (isteğe bağlı)
Anlaşılan tarih UTC tarih saat biçiminde dize Müşterinin sözleşmeyi kabul etme tarihi.
templateId karakter dizisi Müşteri tarafından kabul edilen sözleşme türünün benzersiz tanımlayıcısı. Microsoft Müşteri Sözleşmesi'nin sözleşme meta verilerini alarak templateId alabilirsiniz. Ayrıntılar için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma.
tür karakter dizisi Müşteri tarafından kabul edilen sözleşme türü. Müşteri Microsoft Müşteri Sözleşmesi'ni kabul ettiyse "MicrosoftCustomerAgreement" kullanın.

İstek örneği

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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

REST yanıtı

Başarılı olursa, bu yöntem Sözleşmesi kaynağıdöndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir.

Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}