TagRecommendations サービス操作 - Ad Insight

Request 要素

TagRecommendationsRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。 要素は、 要求 SOAP に示されている順序と同じ順序である必要があります。

要求本文要素

要求ヘッダー要素

Response 要素

TagRecommendationsResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 応答 SOAP に示されている順序と同じ順序で返されます。

応答本文の要素

応答ヘッダー要素

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/AdInsight/v13">
    <Action mustUnderstand="1">TagRecommendations</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <TagRecommendationsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <RecommendationType i:nil="false">ValueHere</RecommendationType>
      <RecommendationsInfo i:nil="false">
        <RecommendationInfo i:type="-- derived type specified here with the appropriate prefix --">
          <RecommendationHash i:nil="false">ValueHere</RecommendationHash>
          <RecommendationId i:nil="false">ValueHere</RecommendationId>
          <!--This field is applicable if the derived type attribute is set to RSARecommendationInfo-->
          <AdId i:nil="false">ValueHere</AdId>
        </RecommendationInfo>
      </RecommendationsInfo>
      <Lable i:nil="false">ValueHere</Lable>
    </TagRecommendationsRequest>
  </s:Body>
</s:Envelope>

応答 SOAP

このテンプレートは、SOAP 応答の 本文 要素と ヘッダー 要素の順序を示すツールによって生成されました。

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <TagRecommendationsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <BatchError>
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <Index>ValueHere</Index>
          <Message d4p1:nil="false">ValueHere</Message>
        </BatchError>
      </PartialErrors>
    </TagRecommendationsResponse>
  </s:Body>
</s:Envelope>

コード構文

構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。

public async Task<TagRecommendationsResponse> TagRecommendationsAsync(
	string recommendationType,
	IList<RecommendationInfo> recommendationsInfo,
	string lable)
{
	var request = new TagRecommendationsRequest
	{
		RecommendationType = recommendationType,
		RecommendationsInfo = recommendationsInfo,
		Lable = lable
	};

	return (await AdInsightService.CallAsync((s, r) => s.TagRecommendationsAsync(r), request));
}

static TagRecommendationsResponse tagRecommendations(
	java.lang.String recommendationType,
	ArrayOfRecommendationInfo recommendationsInfo,
	java.lang.String lable) throws RemoteException, Exception
{
	TagRecommendationsRequest request = new TagRecommendationsRequest();

	request.setRecommendationType(recommendationType);
	request.setRecommendationsInfo(recommendationsInfo);
	request.setLable(lable);

	return AdInsightService.getService().tagRecommendations(request);
}

static function TagRecommendations(
	$recommendationType,
	$recommendationsInfo,
	$lable)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new TagRecommendationsRequest();

	$request->RecommendationType = $recommendationType;
	$request->RecommendationsInfo = $recommendationsInfo;
	$request->Lable = $lable;

	return $GLOBALS['AdInsightProxy']->GetService()->TagRecommendations($request);
}

response=adinsight_service.TagRecommendations(
	RecommendationType=RecommendationType,
	RecommendationsInfo=RecommendationsInfo,
	Lable=Lable)

要件

Service: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13

要求 URL

https://adinsight.api.bingads.microsoft.com/AdInsight/v13/Recommendations/Tag

https://adinsight.api.sandbox.bingads.microsoft.com/AdInsight/v13/Recommendations/Tag

Request 要素

TagRecommendationsRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。

要求本文要素

要求ヘッダー要素

Response 要素

TagRecommendationsResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 Response JSON に示されている順序と同じ順序で返されます。

応答本文の要素

応答ヘッダー要素

JSON を要求する

このテンプレートは、JSON 要求の 本文 と ヘッダー 要素を表示するツールによって生成されました。 このサービス操作で使用できるサポートされる型については、上記の 要求本文要素 のリファレンスを参照してください。

RecommendationInfo の種類が RSARecommendationInfo の場合に適用可能な例を次に示します。

{
  "RecommendationType": "ValueHere",
  "RecommendationsInfo": [
    {
      "RecommendationHash": "ValueHere",
      "RecommendationId": "ValueHere",
      "Type": "RSARecommendationInfo",
      "AdId": "LongValueHere"
    }
  ],
  "Lable": "ValueHere"
}

応答 JSON

このテンプレートは、JSON 応答の 本文 と ヘッダー 要素を表示するツールによって生成されました。

{
  "PartialErrors": [
    {
      "Code": IntValueHere,
      "Details": "ValueHere",
      "ErrorCode": "ValueHere",
      "Index": IntValueHere,
      "Message": "ValueHere"
    }
  ]
}

コード構文

SDK を使用して REST API を呼び出すには、SDK を特定のバージョンにアップグレードし、システム パラメーターを構成する必要があります。構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。

public async Task<TagRecommendationsResponse> TagRecommendationsAsync(
	string recommendationType,
	IList<RecommendationInfo> recommendationsInfo,
	string lable)
{
	var request = new TagRecommendationsRequest
	{
		RecommendationType = recommendationType,
		RecommendationsInfo = recommendationsInfo,
		Lable = lable
	};

	return (await AdInsightService.CallAsync((s, r) => s.TagRecommendationsAsync(r), request));
}

static TagRecommendationsResponse tagRecommendations(
	java.lang.String recommendationType,
	ArrayOfRecommendationInfo recommendationsInfo,
	java.lang.String lable) throws RemoteException, Exception
{
	TagRecommendationsRequest request = new TagRecommendationsRequest();

	request.setRecommendationType(recommendationType);
	request.setRecommendationsInfo(recommendationsInfo);
	request.setLable(lable);

	return AdInsightService.getService().tagRecommendations(request);
}

static function TagRecommendations(
	$recommendationType,
	$recommendationsInfo,
	$lable)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new TagRecommendationsRequest();

	$request->RecommendationType = $recommendationType;
	$request->RecommendationsInfo = $recommendationsInfo;
	$request->Lable = $lable;

	return $GLOBALS['AdInsightProxy']->GetService()->TagRecommendations($request);
}

response=adinsight_service.TagRecommendations(
	RecommendationType=RecommendationType,
	RecommendationsInfo=RecommendationsInfo,
	Lable=Lable)