GetUserMFAStatus サービス操作 - Customer Management
アプリケーションのユーザーによる多要素認証 (MFA) の導入を見積もるために使用されます。
この操作は、2021 年のカレンダー中に、ユーザーが Microsoft Advertising Online、Microsoft Advertising エディター、または Microsoft Advertising モバイルを介して MFA を通過した場合に true を返します。 これは方向的なものであり、アプリケーションに同意を与えながら MFA を通過することを保証することはできません。
Request 要素
GetUserMFAStatusRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。 要素は、 要求 SOAP に示されている順序と同じ順序である必要があります。
注:
以下に特に記載がない限り、すべての要求要素が必要です。
要求本文要素
操作の要求本文には要素がありません。
要求ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
AuthenticationToken | Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。 詳細については、「 OAuth による認証」を参照してください。 |
string |
DeveloperToken | Bing Ads API へのアクセスに使用される開発者トークン。 詳細については、「 開発者トークンを取得する」を参照してください。 |
string |
Password | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
UserName | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
Response 要素
GetUserMFAStatusResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 応答 SOAP に示されている順序と同じ順序で返されます。
応答本文の要素
応答ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
TrackingId | API 呼び出しの詳細を含むログ エントリの識別子。 | string |
SOAP を要求する
このテンプレートは、SOAP 要求の本文要素とヘッダー要素の順序を示すツールによって生成されました。 このサービス操作で使用できるサポートされる型については、上記の 要求本文要素 のリファレンスを参照してください。
<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<Action mustUnderstand="1">GetUserMFAStatus</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetUserMFAStatusRequest xmlns="https://bingads.microsoft.com/Customer/v13" />
</s:Body>
</s:Envelope>
応答 SOAP
このテンプレートは、SOAP 応答の 本文 要素と ヘッダー 要素の順序を示すツールによって生成されました。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<GetUserMFAStatusResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<MFAStatus>ValueHere</MFAStatus>
</GetUserMFAStatusResponse>
</s:Body>
</s:Envelope>
コード構文
構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。
public async Task<GetUserMFAStatusResponse> GetUserMFAStatusAsync()
{
var request = new GetUserMFAStatusRequest
{
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetUserMFAStatusAsync(r), request));
}
static GetUserMFAStatusResponse getUserMFAStatus() throws RemoteException, Exception
{
GetUserMFAStatusRequest request = new GetUserMFAStatusRequest();
return CustomerManagementService.getService().getUserMFAStatus(request);
}
static function GetUserMFAStatus()
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetUserMFAStatusRequest();
return $GLOBALS['CustomerManagementProxy']->GetService()->GetUserMFAStatus($request);
}
response=customermanagement_service.GetUserMFAStatus()
要件
サービス: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
要求 URL
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/UserMFAStatus/Query
Request 要素
GetUserMFAStatusRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。
注:
以下に特に記載がない限り、すべての要求要素が必要です。
要求本文要素
操作の要求本文には要素がありません。
要求ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
Authorization | Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。 トークンのプレフィックスに "Bearer" があることを確認してください。これは、適切な認証に必要です。 詳細については、「 OAuth による認証」を参照してください。 |
string |
DeveloperToken | Bing Ads API へのアクセスに使用される開発者トークン。 詳細については、「 開発者トークンを取得する」を参照してください。 |
string |
Password | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
UserName | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
Response 要素
GetUserMFAStatusResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 Response JSON に示されている順序と同じ順序で返されます。
応答本文の要素
応答ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
TrackingId | API 呼び出しの詳細を含むログ エントリの識別子。 | string |
JSON を要求する
このテンプレートは、JSON 要求の 本文 と ヘッダー 要素を表示するツールによって生成されました。 このサービス操作で使用できるサポートされる型については、上記の 要求本文要素 のリファレンスを参照してください。
{}
応答 JSON
このテンプレートは、JSON 応答の 本文 と ヘッダー 要素を表示するツールによって生成されました。
{
"MFAStatus": "ValueHere"
}
コード構文
SDK を使用して REST API を呼び出すには、SDK を特定のバージョンにアップグレードし、システム パラメーターを構成する必要があります。構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。
public async Task<GetUserMFAStatusResponse> GetUserMFAStatusAsync()
{
var request = new GetUserMFAStatusRequest
{
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetUserMFAStatusAsync(r), request));
}
static GetUserMFAStatusResponse getUserMFAStatus() throws RemoteException, Exception
{
GetUserMFAStatusRequest request = new GetUserMFAStatusRequest();
return CustomerManagementService.getService().getUserMFAStatus(request);
}
static function GetUserMFAStatus()
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetUserMFAStatusRequest();
return $GLOBALS['CustomerManagementProxy']->GetService()->GetUserMFAStatus($request);
}
response=customermanagement_service.GetUserMFAStatus()