顧客の検証状態を取得する

[アーティクル]
10/07/2024

パートナーは、必要に応じて顧客検証の状態を取得できます。

前提条件

パートナーセンター認証の説明に従って確立された資格情報。このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
顧客 ID (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで [顧客] ワークスペースを選び、顧客一覧から顧客を選び、[アカウント] を選んで調べることができます。顧客の [アカウント] ページの [顧客のアカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

C#

顧客のアカウントの検証状態を取得するには、まず、取得する ValidationType を表す列挙型を作成します。次に、顧客識別子を使用して IAggregatePartner.Customers.ById メソッドを呼び出します。次に、ValidationStatus プロパティを使用して IValidationStatus インターフェイスを取得します。最後に、入力パラメーターとして検証型の列挙型変数を呼び出 GetValidationStatus() すか、または GetValidationStatusAsync() 指定します。

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

サンプル: コンソールサンプルアプリ。 プロジェクト: SdkSamples クラス: GetValidationStatus.cs

REST 要求

要求の構文

Method	URI
GET	{baseURL}/v1/customers/{customer-id}/validationStatus?type=account

URI パラメーター

検証の状態を取得する顧客を指定するには、次のクエリパラメーターを使用します。

名前	タイプ	必須	説明
{customer-id}	guid	年	値は、顧客を指定できる GUID 形式の CustomerTenantId です。
type	string	年	取得する検証状態の種類。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

REST 応答

各応答には、成功または失敗とその他のデバッグ情報を示す HTTP 状態コードが付属しています。ネットワークトレースツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。完全な一覧については、パートナーセンターの REST エラーコードに関する記事を参照してください。

応答フィールド

フィールド	タイプ	説明設定	メモ
Type	列挙型	検証情報の種類	検証の種類と同じデータ。検証の種類は、応答の種類としてアカウントを返します。
状態	string	検証ステータス	使用可能な状態: 不明、UnderReview、Allowed、NotAllowed、Not Ready
最新の更新時刻	string	UTC での最終状態の更新時刻	日付時刻は設定されなくなり、空の文字列になります。

応答例

許可されている状態

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": ""
}

校繂状態

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": ""
}

NotAllowed 状態

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": ""
}

[不明] 状態

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": ""
}

準備ができていない状態

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": ""
}

404 が見つかりませんエラー

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

購入資格

お客様のアカウントに次のいずれかの状態がある場合、顧客のトランザクションはブロックされます。

UnderReview
禁止
Unknown

顧客が次の条件を満たしている場合、顧客のトランザクションはブロックされません。

お客様の状態が [許可] になっている
顧客がアカウントの状態を持っていない

次の方法で共有