GetImportResults サービス操作 - キャンペーン管理

[アーティクル]
10/04/2023

過去 90 日以内に完了したインポートジョブの結果を取得します。

同じインポートジョブに対して複数の結果を返すことができます。たとえば、複数回実行されたスケジュールされた GoogleImportJob の結果などです。

ヒント

実装の概要については、 Google 広告のインポートに関するテクニカルガイドを参照してください。

Request 要素

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

注:

以下に特に記載がない限り、すべての要求要素が必要です。

要求本文要素

要素	説明	データ型
ImportJobIds	結果を取得するインポートジョブの識別子。最大 100 個の識別子を指定できます。この要素が指定されていない場合、操作は過去 90 日以内に広告アカウント内のすべてのインポートジョブの結果を返します。	long 配列
ImportType	結果を取得するインポートジョブの種類。 GoogleImportJob の結果を取得するには、この要素を "GoogleImportJob" に設定します。	string
Pageinfo	ページごとのインポート結果のインデックスとサイズを決定します。この要求要素は省略可能です。この要素が指定されていない場合、デフラウトページのインデックスは 0 、既定の Size は 1,000 です。	ページング
ReturnAdditionalFields	追加のフィールド値を使用すると、現在のバージョンの Campaign Management API を使用して最新の機能を取得できます。次のバージョンでは、対応する要素が既定で含まれます。この要求要素は省略可能です。	ImportAdditionalField

要求ヘッダー要素

要素	説明	データ型
AuthenticationToken	Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセストークン。詳細については、「 OAuth による認証」を参照してください。	string
CustomerAccountId	要求のエンティティを所有または関連付けられている広告アカウントの識別子。両方が必要な場合、このヘッダー要素の値は AccountId 本文要素と同じである必要があります。この要素は、ほとんどのサービス操作に必要であり、ベストプラクティスとして常に設定する必要があります。詳細については、「アカウントと顧客 ID を取得する」を参照してください。	string
Customerid	ユーザーがアクセスまたは操作しているマネージャーアカウント (顧客) の識別子。ユーザーは複数のマネージャーアカウントにアクセスできます。この要素は、ほとんどのサービス操作に必要であり、ベストプラクティスとして常に設定する必要があります。詳細については、「アカウントと顧客 ID を取得する」を参照してください。	string
DeveloperToken	Bing Ads API へのアクセスに使用される開発者トークン。詳細については、「開発者トークンを取得する」を参照してください。	string
Password	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string
UserName	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string

Response 要素

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

応答本文の要素

要素	説明	データ型
ImportResults	実行された各インポートの状態、実行時間、統計結果が含まれます。同じインポートジョブに対して複数の結果を返すことができます。たとえば、複数回実行されたスケジュールされた GoogleImportJob の結果などです。	ImportResult 配列

応答ヘッダー要素

要素	説明	データ型
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/CampaignManagement/v13">
    <Action mustUnderstand="1">GetImportResults</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>
    <GetImportResultsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ImportType i:nil="false">ValueHere</ImportType>
      <PageInfo i:nil="false">
        <Index>ValueHere</Index>
        <Size>ValueHere</Size>
      </PageInfo>
      <ImportJobIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </ImportJobIds>
      <ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
    </GetImportResultsRequest>
  </s:Body>
</s:Envelope>

応答 SOAP

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetImportResultsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ImportResults d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <ImportResult>
          <EntityStatistics d4p1:nil="false">
            <ImportEntityStatistics>
              <Additions d4p1:nil="false">ValueHere</Additions>
              <Changes d4p1:nil="false">ValueHere</Changes>
              <Deletions d4p1:nil="false">ValueHere</Deletions>
              <EntityType d4p1:nil="false">ValueHere</EntityType>
              <Errors d4p1:nil="false">ValueHere</Errors>
              <Total d4p1:nil="false">ValueHere</Total>
            </ImportEntityStatistics>
          </EntityStatistics>
          <ErrorLogUrl d4p1:nil="false">ValueHere</ErrorLogUrl>
          <ForwardCompatibilityMap xmlns:e149="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e149:KeyValuePairOfstringstring>
              <e149:key d4p1:nil="false">ValueHere</e149:key>
              <e149:value d4p1:nil="false">ValueHere</e149:value>
            </e149:KeyValuePairOfstringstring>
          </ForwardCompatibilityMap>
          <Id d4p1:nil="false">ValueHere</Id>
          <ImportJob d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
            <CreatedByUserId d4p1:nil="false">ValueHere</CreatedByUserId>
            <CreatedByUserName d4p1:nil="false">ValueHere</CreatedByUserName>
            <CreatedDateTimeInUTC d4p1:nil="false">ValueHere</CreatedDateTimeInUTC>
            <Frequency d4p1:nil="false">
              <Cron d4p1:nil="false">ValueHere</Cron>
              <TimeZone d4p1:nil="false">ValueHere</TimeZone>
              <Type d4p1:nil="false">ValueHere</Type>
            </Frequency>
            <Id d4p1:nil="false">ValueHere</Id>
            <ImportOption d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <ForwardCompatibilityMap xmlns:e150="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
                <e150:KeyValuePairOfstringstring>
                  <e150:key d4p1:nil="false">ValueHere</e150:key>
                  <e150:value d4p1:nil="false">ValueHere</e150:value>
                </e150:KeyValuePairOfstringstring>
              </ForwardCompatibilityMap>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--These fields are applicable if the derived type attribute is set to GoogleImportOption-->
              <AccountUrlOptions d4p1:nil="false">ValueHere</AccountUrlOptions>
              <AdScheduleUseSearcherTimezone d4p1:nil="false">ValueHere</AdScheduleUseSearcherTimezone>
              <AdjustmentForBids d4p1:nil="false">ValueHere</AdjustmentForBids>
              <AdjustmentForCampaignBudgets d4p1:nil="false">ValueHere</AdjustmentForCampaignBudgets>
              <AssociatedStoreId d4p1:nil="false">ValueHere</AssociatedStoreId>
              <AssociatedUetTagId d4p1:nil="false">ValueHere</AssociatedUetTagId>
              <AutoDeviceBidOptimization d4p1:nil="false">ValueHere</AutoDeviceBidOptimization>
              <DeleteRemovedEntities d4p1:nil="false">ValueHere</DeleteRemovedEntities>
              <EnableAutoCurrencyConversion d4p1:nil="false">ValueHere</EnableAutoCurrencyConversion>
              <EnableParentLocationMapping d4p1:nil="false">ValueHere</EnableParentLocationMapping>
              <NewAccountNegativeKeywords d4p1:nil="false">ValueHere</NewAccountNegativeKeywords>
              <NewActiveAdsForExistingAdGroups d4p1:nil="false">ValueHere</NewActiveAdsForExistingAdGroups>
              <NewActiveCampaignsAndChildEntities d4p1:nil="false">ValueHere</NewActiveCampaignsAndChildEntities>
              <NewAdCustomizerFeeds d4p1:nil="false">ValueHere</NewAdCustomizerFeeds>
              <NewAdGroupsAndChildEntitiesForExistingCampaigns d4p1:nil="false">ValueHere</NewAdGroupsAndChildEntitiesForExistingCampaigns>
              <NewAdSchedules d4p1:nil="false">ValueHere</NewAdSchedules>
              <NewAppAdExtensions d4p1:nil="false">ValueHere</NewAppAdExtensions>
              <NewAudienceTargets d4p1:nil="false">ValueHere</NewAudienceTargets>
              <NewCallAdExtensions d4p1:nil="false">ValueHere</NewCallAdExtensions>
              <NewCalloutAdExtensions d4p1:nil="false">ValueHere</NewCalloutAdExtensions>
              <NewConversionGoals d4p1:nil="false">ValueHere</NewConversionGoals>
              <NewDemographicTargets d4p1:nil="false">ValueHere</NewDemographicTargets>
              <NewDeviceTargets d4p1:nil="false">ValueHere</NewDeviceTargets>
              <NewEntities d4p1:nil="false">ValueHere</NewEntities>
              <NewImageAdExtensions d4p1:nil="false">ValueHere</NewImageAdExtensions>
              <NewKeywordUrls d4p1:nil="false">ValueHere</NewKeywordUrls>
              <NewKeywordsForExistingAdGroups d4p1:nil="false">ValueHere</NewKeywordsForExistingAdGroups>
              <NewLabels d4p1:nil="false">ValueHere</NewLabels>
              <NewLeadFormAdExtensions d4p1:nil="false">ValueHere</NewLeadFormAdExtensions>
              <NewLocationAdExtensions d4p1:nil="false">ValueHere</NewLocationAdExtensions>
              <NewLocationTargets d4p1:nil="false">ValueHere</NewLocationTargets>
              <NewLogoAdExtensions d4p1:nil="false">ValueHere</NewLogoAdExtensions>
              <NewNegativeKeywordLists d4p1:nil="false">ValueHere</NewNegativeKeywordLists>
              <NewNegativeKeywordsForExistingParents d4p1:nil="false">ValueHere</NewNegativeKeywordsForExistingParents>
              <NewNegativeSites d4p1:nil="false">ValueHere</NewNegativeSites>
              <NewPageFeeds d4p1:nil="false">ValueHere</NewPageFeeds>
              <NewPausedAdsForExistingAdGroups d4p1:nil="false">ValueHere</NewPausedAdsForExistingAdGroups>
              <NewPausedCampaignsAndChildEntities d4p1:nil="false">ValueHere</NewPausedCampaignsAndChildEntities>
              <NewPriceAdExtensions d4p1:nil="false">ValueHere</NewPriceAdExtensions>
              <NewProductFilters d4p1:nil="false">ValueHere</NewProductFilters>
              <NewPromotionAdExtensions d4p1:nil="false">ValueHere</NewPromotionAdExtensions>
              <NewReviewAdExtensions d4p1:nil="false">ValueHere</NewReviewAdExtensions>
              <NewSitelinkAdExtensions d4p1:nil="false">ValueHere</NewSitelinkAdExtensions>
              <NewStructuredSnippetAdExtensions d4p1:nil="false">ValueHere</NewStructuredSnippetAdExtensions>
              <NewUrlOptions d4p1:nil="false">ValueHere</NewUrlOptions>
              <PauseAIMAdGroupIfAllAudienceCriterionNotImported d4p1:nil="false">ValueHere</PauseAIMAdGroupIfAllAudienceCriterionNotImported>
              <PauseCampaignsWithoutSupportedLocations d4p1:nil="false">ValueHere</PauseCampaignsWithoutSupportedLocations>
              <PauseNewCampaigns d4p1:nil="false">ValueHere</PauseNewCampaigns>
              <RaiseBidsToMinimum d4p1:nil="false">ValueHere</RaiseBidsToMinimum>
              <RaiseCampaignBudgetsToMinimum d4p1:nil="false">ValueHere</RaiseCampaignBudgetsToMinimum>
              <RaiseProductGroupBidsToMinimum d4p1:nil="false">ValueHere</RaiseProductGroupBidsToMinimum>
              <RenameCampaignNameWithSuffix d4p1:nil="false">ValueHere</RenameCampaignNameWithSuffix>
              <SearchAndDsaMixedCampaignAsSearchCampaign d4p1:nil="false">ValueHere</SearchAndDsaMixedCampaignAsSearchCampaign>
              <SearchAndReplaceForCampaignNames d4p1:nil="false">
                <ReplaceString d4p1:nil="false">ValueHere</ReplaceString>
                <SearchString d4p1:nil="false">ValueHere</SearchString>
              </SearchAndReplaceForCampaignNames>
              <SearchAndReplaceForCustomParameters d4p1:nil="false">
                <ReplaceString d4p1:nil="false">ValueHere</ReplaceString>
                <SearchString d4p1:nil="false">ValueHere</SearchString>
              </SearchAndReplaceForCustomParameters>
              <SearchAndReplaceForFinalURLSuffix d4p1:nil="false">
                <ReplaceString d4p1:nil="false">ValueHere</ReplaceString>
                <SearchString d4p1:nil="false">ValueHere</SearchString>
              </SearchAndReplaceForFinalURLSuffix>
              <SearchAndReplaceForTrackingTemplates d4p1:nil="false">
                <ReplaceString d4p1:nil="false">ValueHere</ReplaceString>
                <SearchString d4p1:nil="false">ValueHere</SearchString>
              </SearchAndReplaceForTrackingTemplates>
              <SearchAndReplaceForUrls d4p1:nil="false">
                <ReplaceString d4p1:nil="false">ValueHere</ReplaceString>
                <SearchString d4p1:nil="false">ValueHere</SearchString>
              </SearchAndReplaceForUrls>
              <SuffixForCampaignNames d4p1:nil="false">ValueHere</SuffixForCampaignNames>
              <SuffixForTrackingTemplates d4p1:nil="false">ValueHere</SuffixForTrackingTemplates>
              <SuffixForUrls d4p1:nil="false">ValueHere</SuffixForUrls>
              <UpdateAccountNegativeKeywords d4p1:nil="false">ValueHere</UpdateAccountNegativeKeywords>
              <UpdateAdCustomizerAttributes d4p1:nil="false">ValueHere</UpdateAdCustomizerAttributes>
              <UpdateAdCustomizerFeeds d4p1:nil="false">ValueHere</UpdateAdCustomizerFeeds>
              <UpdateAdGroupNetwork d4p1:nil="false">ValueHere</UpdateAdGroupNetwork>
              <UpdateAdSchedules d4p1:nil="false">ValueHere</UpdateAdSchedules>
              <UpdateAdUrls d4p1:nil="false">ValueHere</UpdateAdUrls>
              <UpdateAppAdExtensions d4p1:nil="false">ValueHere</UpdateAppAdExtensions>
              <UpdateAudienceTargets d4p1:nil="false">ValueHere</UpdateAudienceTargets>
              <UpdateBiddingStrategies d4p1:nil="false">ValueHere</UpdateBiddingStrategies>
              <UpdateBids d4p1:nil="false">ValueHere</UpdateBids>
              <UpdateCallAdExtensions d4p1:nil="false">ValueHere</UpdateCallAdExtensions>
              <UpdateCalloutAdExtensions d4p1:nil="false">ValueHere</UpdateCalloutAdExtensions>
              <UpdateCampaignAdGroupLanguages d4p1:nil="false">ValueHere</UpdateCampaignAdGroupLanguages>
              <UpdateCampaignBudgets d4p1:nil="false">ValueHere</UpdateCampaignBudgets>
              <UpdateCampaignNames d4p1:nil="false">ValueHere</UpdateCampaignNames>
              <UpdateConversionGoals d4p1:nil="false">ValueHere</UpdateConversionGoals>
              <UpdateDemographicTargets d4p1:nil="false">ValueHere</UpdateDemographicTargets>
              <UpdateDeviceTargets d4p1:nil="false">ValueHere</UpdateDeviceTargets>
              <UpdateEntities d4p1:nil="false">ValueHere</UpdateEntities>
              <UpdateImageAdExtensions d4p1:nil="false">ValueHere</UpdateImageAdExtensions>
              <UpdateKeywordUrls d4p1:nil="false">ValueHere</UpdateKeywordUrls>
              <UpdateLabels d4p1:nil="false">ValueHere</UpdateLabels>
              <UpdateLeadFormAdExtensions d4p1:nil="false">ValueHere</UpdateLeadFormAdExtensions>
              <UpdateLocationAdExtensions d4p1:nil="false">ValueHere</UpdateLocationAdExtensions>
              <UpdateLocationTargets d4p1:nil="false">ValueHere</UpdateLocationTargets>
              <UpdateLogoAdExtensions d4p1:nil="false">ValueHere</UpdateLogoAdExtensions>
              <UpdateNegativeKeywordLists d4p1:nil="false">ValueHere</UpdateNegativeKeywordLists>
              <UpdateNegativeSites d4p1:nil="false">ValueHere</UpdateNegativeSites>
              <UpdatePageFeeds d4p1:nil="false">ValueHere</UpdatePageFeeds>
              <UpdatePriceAdExtensions d4p1:nil="false">ValueHere</UpdatePriceAdExtensions>
              <UpdateProductFilters d4p1:nil="false">ValueHere</UpdateProductFilters>
              <UpdatePromotionAdExtensions d4p1:nil="false">ValueHere</UpdatePromotionAdExtensions>
              <UpdateReviewAdExtensions d4p1:nil="false">ValueHere</UpdateReviewAdExtensions>
              <UpdateSitelinkAdExtensions d4p1:nil="false">ValueHere</UpdateSitelinkAdExtensions>
              <UpdateSitelinkUrls d4p1:nil="false">ValueHere</UpdateSitelinkUrls>
              <UpdateStatusForAdGroups d4p1:nil="false">ValueHere</UpdateStatusForAdGroups>
              <UpdateStatusForAds d4p1:nil="false">ValueHere</UpdateStatusForAds>
              <UpdateStatusForCampaigns d4p1:nil="false">ValueHere</UpdateStatusForCampaigns>
              <UpdateStatusForKeywords d4p1:nil="false">ValueHere</UpdateStatusForKeywords>
              <UpdateStructuredSnippetAdExtensions d4p1:nil="false">ValueHere</UpdateStructuredSnippetAdExtensions>
              <UpdateUrlOptions d4p1:nil="false">ValueHere</UpdateUrlOptions>
              <!--No additional fields are applicable if the derived type attribute is set to FileImportOption-->
            </ImportOption>
            <LastRunTimeInUTC d4p1:nil="false">ValueHere</LastRunTimeInUTC>
            <Name d4p1:nil="false">ValueHere</Name>
            <NotificationEmail d4p1:nil="false">ValueHere</NotificationEmail>
            <NotificationType d4p1:nil="false">ValueHere</NotificationType>
            <Status d4p1:nil="false">ValueHere</Status>
            <Type d4p1:nil="false">ValueHere</Type>
            <!--These fields are applicable if the derived type attribute is set to GoogleImportJob-->
            <CampaignAdGroupIds d4p1:nil="false">
              <CampaignAdGroupIds>
                <ActiveAdGroupsOnly d4p1:nil="false">ValueHere</ActiveAdGroupsOnly>
                <AdGroupIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                  <a1:long>ValueHere</a1:long>
                </AdGroupIds>
                <CampaignId>ValueHere</CampaignId>
              </CampaignAdGroupIds>
            </CampaignAdGroupIds>
            <CredentialId d4p1:nil="false">ValueHere</CredentialId>
            <GoogleAccountId d4p1:nil="false">ValueHere</GoogleAccountId>
            <GoogleUserName d4p1:nil="false">ValueHere</GoogleUserName>
            <!--These fields are applicable if the derived type attribute is set to FileImportJob-->
            <FileSource d4p1:nil="false">ValueHere</FileSource>
            <FileUrl d4p1:nil="false">ValueHere</FileUrl>
          </ImportJob>
          <StartTimeInUTC>ValueHere</StartTimeInUTC>
          <Status d4p1:nil="false">ValueHere</Status>
        </ImportResult>
      </ImportResults>
    </GetImportResultsResponse>
  </s:Body>
</s:Envelope>

コード構文

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

public async Task<GetImportResultsResponse> GetImportResultsAsync(
	string importType,
	Paging pageInfo,
	IList<long> importJobIds,
	ImportAdditionalField? returnAdditionalFields)
{
	var request = new GetImportResultsRequest
	{
		ImportType = importType,
		PageInfo = pageInfo,
		ImportJobIds = importJobIds,
		ReturnAdditionalFields = returnAdditionalFields
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.GetImportResultsAsync(r), request));
}

static GetImportResultsResponse getImportResults(
	java.lang.String importType,
	Paging pageInfo,
	ArrayOflong importJobIds,
	ArrayList<ImportAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
	GetImportResultsRequest request = new GetImportResultsRequest();

	request.setImportType(importType);
	request.setPageInfo(pageInfo);
	request.setImportJobIds(importJobIds);
	request.setReturnAdditionalFields(returnAdditionalFields);

	return CampaignManagementService.getService().getImportResults(request);
}

static function GetImportResults(
	$importType,
	$pageInfo,
	$importJobIds,
	$returnAdditionalFields)
{

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

	$request = new GetImportResultsRequest();

	$request->ImportType = $importType;
	$request->PageInfo = $pageInfo;
	$request->ImportJobIds = $importJobIds;
	$request->ReturnAdditionalFields = $returnAdditionalFields;

	return $GLOBALS['CampaignManagementProxy']->GetService()->GetImportResults($request);
}

response=campaignmanagement_service.GetImportResults(
	ImportType=ImportType,
	PageInfo=PageInfo,
	ImportJobIds=ImportJobIds,
	ReturnAdditionalFields=ReturnAdditionalFields)

要件

サービス: CampaignManagementService.svc v13
名前空間： https://bingads.microsoft.com/CampaignManagement/v13

次の方法で共有