パートナーの法的ビジネス プロファイルを更新する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
パートナーの法的ビジネス プロファイルを更新する方法。
前提条件
- パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
C#
パートナーの法的ビジネス プロファイルを更新するには、最初に LegalBusinessProfile オブジェクトをインスタンス化し、それに既存のプロファイルを設定します。 詳細については、「 パートナーの法的ビジネス プロファイルを取得する」を参照してください。 その後、変更する必要があるプロパティを更新します。 次のコード例は、住所と主要連絡先電話番号の変更を示しています。
次に、IAggregatePartner.Profiles プロパティからパートナーのプロファイル操作コレクションへのインターフェイスを取得します。 その後、LegalBusinessProfile プロパティの値を取得して、法的ビジネス プロファイル操作へのインターフェイスを取得します。 最後に、Update メソッドまたは UpdateAsync メソッドを、変更されたオブジェクトと共に呼び出してプロファイルを更新します。
// IAggregatePartner partnerOperations;
var legalBusinessProfile = partnerOperations.Profiles.LegalBusinessProfile.Get();
// Change the address and primary contact phone number.
legalBusinessProfile.Address.PhoneNumber = "4255550110";
legalBusinessProfile.PrimaryContact.PhoneNumber = "4255550110";
// Apply changes to the profile.
var updatedLegalBusinessProfile = partnerOperations.Profiles.LegalBusinessProfile.Update(legalBusinessProfile);
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
PUT | {baseURL}/v1/profiles/legalbusiness HTTP/1.1 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
法的ビジネス プロファイル リソース。
要求の例
PUT https://api.partnercenter.microsoft.com/v1/profiles/legalbusiness HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4549ac0c-0f1d-4d8f-b02f-6d36fadcccee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 806
Expect: 100-continue
{
"CompanyName": "Lucerne Publishing",
"Address": {
"Country": "US",
"Region": null,
"City": "Redmond",
"State": "WA",
"AddressLine1": "123 Main Street",
"AddressLine2": "",
"PostalCode": "98052",
"FirstName": "Gena",
"LastName": "Soto",
"PhoneNumber": "4255550110"
},
"PrimaryContact": {
"FirstName": "Gena",
"LastName": "Soto",
"Email": "gena@lucernepublishing.com",
"PhoneNumber": "4255550110"
},
"CompanyApproverAddress": {
"Country": "US",
"Region": null,
"City": "Redmond",
"State": "WA",
"AddressLine1": "123 Main Street",
"AddressLine2": "",
"PostalCode": "98052",
"FirstName": null,
"LastName": null,
"PhoneNumber": null
},
"CompanyApproverEmail": "gena@lucernepublishing.com",
"VettingStatus": "authorized",
"VettingSubStatus": "none",
"Links": {
"Self": {
"Uri": "/profiles/legalbusiness",
"Method": "GET",
"Headers": []
}
},
"Attributes": {
"ObjectType": "LegalBusinessProfile"
}
}
REST 応答
成功した場合、応答本文には更新された LegalBusinessProfile が含まれます
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、「 パートナー センターのエラー コード」を参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 1157
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4549ac0c-0f1d-4d8f-b02f-6d36fadcccee
MS-CV: KZLU42qJ4EObO75q.0
MS-ServerId: 030020643
Date: Tue, 21 Mar 2017 22:03:15 GMT
{
"companyName": "Lucerne Publishing",
"address": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "123 Main Street",
"addressLine2": "",
"postalCode": "98052",
"firstName": "Gena",
"lastName": "Soto",
"phoneNumber": "4255550110"
},
"primaryContact": {
"firstName": "Gena",
"lastName": "Soto",
"email": "gena@lucernepublishing.com",
"phoneNumber": "4255550110"
},
"companyApproverAddress": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "123 Main Street",
"addressLine2": "",
"postalCode": "98052"
},
"companyApproverEmail": "gena@lucernepublishing.com",
"vettingStatus": "authorized",
"vettingSubStatus": "none",
"profileType": "LegalBusinessProfile",
"links": {
"self": {
"uri": "/profiles/legalbusiness",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "LegalBusinessProfile"
}
}