AddImportJobs 服務作業 - 行銷活動管理
建立新的匯入作業。
GoogleImportJob可以定期執行一次或排程。
提示
如需實作概觀,請參閱 Google Ads 匯入 技術指南。
要求專案
AddImportJobsRequest物件會定義服務作業要求的主體和標頭元素。 元素的順序必須與 要求 SOAP中所示的順序相同。
注意事項
除非下面另有說明,否則所有要求專案都是必要的。
要求本文專案
元素 | 說明 | 資料類型 |
---|---|---|
ImportJobs | 要建立的匯入作業。 雖然此元素是陣列,但每個呼叫最多可以包含一個 GoogleImportJob 物件。 您可以透過GoogleImportJob物件中的GoogleAccountId元素,設定要從中匯入的 Google 帳戶。 您想要匯入的 Microsoft Advertising 廣告帳戶取決於此AddImportJobs服務作業的必要CustomerAccountId標頭元素。 |
ImportJob 數 組 |
要求標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
AuthenticationToken | OAuth 存取權杖,代表具有 Microsoft Advertising 帳戶許可權之使用者的認證。 如需詳細資訊,請 參閱使用 OAuth 進行驗證。 |
string |
CustomerAccountId | 擁有或與要求中實體相關聯之廣告帳戶的識別碼。 當兩者都需要時,此標頭元素必須具有與 AccountId body 元素相同的值。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
CustomerId | (使用者存取或操作之使用者) 客戶的管理員帳戶識別碼。 使用者可以存取多個管理員帳戶。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
DeveloperToken | 用來存取 Bing 廣告 API 的開發人員權杖。 如需詳細資訊 ,請參閱取得開發人員權杖。 |
string |
密碼 | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
UserName | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
Response 元素
AddImportJobsResponse物件會定義服務作業回應的主體和標頭元素。 這些元素的傳回順序與 回應 SOAP中所示的順序相同。
回應本文專案
元素 | 說明 | 資料類型 |
---|---|---|
ImportJobIds | 對應至已新增匯入作業的唯一系統識別碼清單。 識別碼清單會直接對應至要求中的匯入作業清單。 清單的專案可能會傳回為 Null。 對於未新增匯入作業的每個清單索引,對應的專案會是 Null。 |
long 陣列 |
PartialErrors |
BatchError物件的清單,其中包含任何未成功之清單專案要求的詳細資料。 錯誤清單不會直接對應至要求中的專案清單。 如果沒有錯誤,清單將會是空的。 |
BatchError 數 組 |
回應標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
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">AddImportJobs</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>
<AddImportJobsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<ImportJobs i:nil="false">
<ImportJob i:type="-- derived type specified here with the appropriate prefix --">
<CreatedByUserId i:nil="false">ValueHere</CreatedByUserId>
<CreatedByUserName i:nil="false">ValueHere</CreatedByUserName>
<CreatedDateTimeInUTC i:nil="false">ValueHere</CreatedDateTimeInUTC>
<Frequency i:nil="false">
<Cron i:nil="false">ValueHere</Cron>
<TimeZone i:nil="false">ValueHere</TimeZone>
<Type i:nil="false">ValueHere</Type>
</Frequency>
<Id i:nil="false">ValueHere</Id>
<ImportOption i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
<ForwardCompatibilityMap xmlns:e47="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e47:KeyValuePairOfstringstring>
<e47:key i:nil="false">ValueHere</e47:key>
<e47:value i:nil="false">ValueHere</e47:value>
</e47:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Type i:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to GoogleImportOption-->
<AccountUrlOptions i:nil="false">ValueHere</AccountUrlOptions>
<AdScheduleUseSearcherTimezone i:nil="false">ValueHere</AdScheduleUseSearcherTimezone>
<AdjustmentForBids i:nil="false">ValueHere</AdjustmentForBids>
<AdjustmentForCampaignBudgets i:nil="false">ValueHere</AdjustmentForCampaignBudgets>
<AssociatedStoreId i:nil="false">ValueHere</AssociatedStoreId>
<AssociatedUetTagId i:nil="false">ValueHere</AssociatedUetTagId>
<AutoDeviceBidOptimization i:nil="false">ValueHere</AutoDeviceBidOptimization>
<DeleteRemovedEntities i:nil="false">ValueHere</DeleteRemovedEntities>
<EnableAutoCurrencyConversion i:nil="false">ValueHere</EnableAutoCurrencyConversion>
<EnableParentLocationMapping i:nil="false">ValueHere</EnableParentLocationMapping>
<NewAccountNegativeKeywords i:nil="false">ValueHere</NewAccountNegativeKeywords>
<NewActiveAdsForExistingAdGroups i:nil="false">ValueHere</NewActiveAdsForExistingAdGroups>
<NewActiveCampaignsAndChildEntities i:nil="false">ValueHere</NewActiveCampaignsAndChildEntities>
<NewAdCustomizerFeeds i:nil="false">ValueHere</NewAdCustomizerFeeds>
<NewAdGroupsAndChildEntitiesForExistingCampaigns i:nil="false">ValueHere</NewAdGroupsAndChildEntitiesForExistingCampaigns>
<NewAdSchedules i:nil="false">ValueHere</NewAdSchedules>
<NewAppAdExtensions i:nil="false">ValueHere</NewAppAdExtensions>
<NewAudienceTargets i:nil="false">ValueHere</NewAudienceTargets>
<NewCallAdExtensions i:nil="false">ValueHere</NewCallAdExtensions>
<NewCalloutAdExtensions i:nil="false">ValueHere</NewCalloutAdExtensions>
<NewConversionGoals i:nil="false">ValueHere</NewConversionGoals>
<NewDemographicTargets i:nil="false">ValueHere</NewDemographicTargets>
<NewDeviceTargets i:nil="false">ValueHere</NewDeviceTargets>
<NewEntities i:nil="false">ValueHere</NewEntities>
<NewImageAdExtensions i:nil="false">ValueHere</NewImageAdExtensions>
<NewKeywordUrls i:nil="false">ValueHere</NewKeywordUrls>
<NewKeywordsForExistingAdGroups i:nil="false">ValueHere</NewKeywordsForExistingAdGroups>
<NewLabels i:nil="false">ValueHere</NewLabels>
<NewLeadFormAdExtensions i:nil="false">ValueHere</NewLeadFormAdExtensions>
<NewLocationAdExtensions i:nil="false">ValueHere</NewLocationAdExtensions>
<NewLocationTargets i:nil="false">ValueHere</NewLocationTargets>
<NewLogoAdExtensions i:nil="false">ValueHere</NewLogoAdExtensions>
<NewNegativeKeywordLists i:nil="false">ValueHere</NewNegativeKeywordLists>
<NewNegativeKeywordsForExistingParents i:nil="false">ValueHere</NewNegativeKeywordsForExistingParents>
<NewNegativeSites i:nil="false">ValueHere</NewNegativeSites>
<NewPageFeeds i:nil="false">ValueHere</NewPageFeeds>
<NewPausedAdsForExistingAdGroups i:nil="false">ValueHere</NewPausedAdsForExistingAdGroups>
<NewPausedCampaignsAndChildEntities i:nil="false">ValueHere</NewPausedCampaignsAndChildEntities>
<NewPriceAdExtensions i:nil="false">ValueHere</NewPriceAdExtensions>
<NewProductFilters i:nil="false">ValueHere</NewProductFilters>
<NewPromotionAdExtensions i:nil="false">ValueHere</NewPromotionAdExtensions>
<NewReviewAdExtensions i:nil="false">ValueHere</NewReviewAdExtensions>
<NewSitelinkAdExtensions i:nil="false">ValueHere</NewSitelinkAdExtensions>
<NewStructuredSnippetAdExtensions i:nil="false">ValueHere</NewStructuredSnippetAdExtensions>
<NewUrlOptions i:nil="false">ValueHere</NewUrlOptions>
<PauseAIMAdGroupIfAllAudienceCriterionNotImported i:nil="false">ValueHere</PauseAIMAdGroupIfAllAudienceCriterionNotImported>
<PauseCampaignsWithoutSupportedLocations i:nil="false">ValueHere</PauseCampaignsWithoutSupportedLocations>
<PauseNewCampaigns i:nil="false">ValueHere</PauseNewCampaigns>
<RaiseBidsToMinimum i:nil="false">ValueHere</RaiseBidsToMinimum>
<RaiseCampaignBudgetsToMinimum i:nil="false">ValueHere</RaiseCampaignBudgetsToMinimum>
<RaiseProductGroupBidsToMinimum i:nil="false">ValueHere</RaiseProductGroupBidsToMinimum>
<RenameCampaignNameWithSuffix i:nil="false">ValueHere</RenameCampaignNameWithSuffix>
<SearchAndDsaMixedCampaignAsSearchCampaign i:nil="false">ValueHere</SearchAndDsaMixedCampaignAsSearchCampaign>
<SearchAndReplaceForCampaignNames i:nil="false">
<ReplaceString i:nil="false">ValueHere</ReplaceString>
<SearchString i:nil="false">ValueHere</SearchString>
</SearchAndReplaceForCampaignNames>
<SearchAndReplaceForCustomParameters i:nil="false">
<ReplaceString i:nil="false">ValueHere</ReplaceString>
<SearchString i:nil="false">ValueHere</SearchString>
</SearchAndReplaceForCustomParameters>
<SearchAndReplaceForFinalURLSuffix i:nil="false">
<ReplaceString i:nil="false">ValueHere</ReplaceString>
<SearchString i:nil="false">ValueHere</SearchString>
</SearchAndReplaceForFinalURLSuffix>
<SearchAndReplaceForTrackingTemplates i:nil="false">
<ReplaceString i:nil="false">ValueHere</ReplaceString>
<SearchString i:nil="false">ValueHere</SearchString>
</SearchAndReplaceForTrackingTemplates>
<SearchAndReplaceForUrls i:nil="false">
<ReplaceString i:nil="false">ValueHere</ReplaceString>
<SearchString i:nil="false">ValueHere</SearchString>
</SearchAndReplaceForUrls>
<SuffixForCampaignNames i:nil="false">ValueHere</SuffixForCampaignNames>
<SuffixForTrackingTemplates i:nil="false">ValueHere</SuffixForTrackingTemplates>
<SuffixForUrls i:nil="false">ValueHere</SuffixForUrls>
<UpdateAccountNegativeKeywords i:nil="false">ValueHere</UpdateAccountNegativeKeywords>
<UpdateAdCustomizerAttributes i:nil="false">ValueHere</UpdateAdCustomizerAttributes>
<UpdateAdCustomizerFeeds i:nil="false">ValueHere</UpdateAdCustomizerFeeds>
<UpdateAdGroupNetwork i:nil="false">ValueHere</UpdateAdGroupNetwork>
<UpdateAdSchedules i:nil="false">ValueHere</UpdateAdSchedules>
<UpdateAdUrls i:nil="false">ValueHere</UpdateAdUrls>
<UpdateAppAdExtensions i:nil="false">ValueHere</UpdateAppAdExtensions>
<UpdateAudienceTargets i:nil="false">ValueHere</UpdateAudienceTargets>
<UpdateBiddingStrategies i:nil="false">ValueHere</UpdateBiddingStrategies>
<UpdateBids i:nil="false">ValueHere</UpdateBids>
<UpdateCallAdExtensions i:nil="false">ValueHere</UpdateCallAdExtensions>
<UpdateCalloutAdExtensions i:nil="false">ValueHere</UpdateCalloutAdExtensions>
<UpdateCampaignAdGroupLanguages i:nil="false">ValueHere</UpdateCampaignAdGroupLanguages>
<UpdateCampaignBudgets i:nil="false">ValueHere</UpdateCampaignBudgets>
<UpdateCampaignNames i:nil="false">ValueHere</UpdateCampaignNames>
<UpdateConversionGoals i:nil="false">ValueHere</UpdateConversionGoals>
<UpdateDemographicTargets i:nil="false">ValueHere</UpdateDemographicTargets>
<UpdateDeviceTargets i:nil="false">ValueHere</UpdateDeviceTargets>
<UpdateEntities i:nil="false">ValueHere</UpdateEntities>
<UpdateImageAdExtensions i:nil="false">ValueHere</UpdateImageAdExtensions>
<UpdateKeywordUrls i:nil="false">ValueHere</UpdateKeywordUrls>
<UpdateLabels i:nil="false">ValueHere</UpdateLabels>
<UpdateLeadFormAdExtensions i:nil="false">ValueHere</UpdateLeadFormAdExtensions>
<UpdateLocationAdExtensions i:nil="false">ValueHere</UpdateLocationAdExtensions>
<UpdateLocationTargets i:nil="false">ValueHere</UpdateLocationTargets>
<UpdateLogoAdExtensions i:nil="false">ValueHere</UpdateLogoAdExtensions>
<UpdateNegativeKeywordLists i:nil="false">ValueHere</UpdateNegativeKeywordLists>
<UpdateNegativeSites i:nil="false">ValueHere</UpdateNegativeSites>
<UpdatePageFeeds i:nil="false">ValueHere</UpdatePageFeeds>
<UpdatePriceAdExtensions i:nil="false">ValueHere</UpdatePriceAdExtensions>
<UpdateProductFilters i:nil="false">ValueHere</UpdateProductFilters>
<UpdatePromotionAdExtensions i:nil="false">ValueHere</UpdatePromotionAdExtensions>
<UpdateReviewAdExtensions i:nil="false">ValueHere</UpdateReviewAdExtensions>
<UpdateSitelinkAdExtensions i:nil="false">ValueHere</UpdateSitelinkAdExtensions>
<UpdateSitelinkUrls i:nil="false">ValueHere</UpdateSitelinkUrls>
<UpdateStatusForAdGroups i:nil="false">ValueHere</UpdateStatusForAdGroups>
<UpdateStatusForAds i:nil="false">ValueHere</UpdateStatusForAds>
<UpdateStatusForCampaigns i:nil="false">ValueHere</UpdateStatusForCampaigns>
<UpdateStatusForKeywords i:nil="false">ValueHere</UpdateStatusForKeywords>
<UpdateStructuredSnippetAdExtensions i:nil="false">ValueHere</UpdateStructuredSnippetAdExtensions>
<UpdateUrlOptions i:nil="false">ValueHere</UpdateUrlOptions>
<!--No additional fields are applicable if the derived type attribute is set to FileImportOption-->
</ImportOption>
<LastRunTimeInUTC i:nil="false">ValueHere</LastRunTimeInUTC>
<Name i:nil="false">ValueHere</Name>
<NotificationEmail i:nil="false">ValueHere</NotificationEmail>
<NotificationType i:nil="false">ValueHere</NotificationType>
<Status i:nil="false">ValueHere</Status>
<Type i:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to GoogleImportJob-->
<CampaignAdGroupIds i:nil="false">
<CampaignAdGroupIds>
<ActiveAdGroupsOnly i:nil="false">ValueHere</ActiveAdGroupsOnly>
<AdGroupIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</AdGroupIds>
<CampaignId>ValueHere</CampaignId>
</CampaignAdGroupIds>
</CampaignAdGroupIds>
<CredentialId i:nil="false">ValueHere</CredentialId>
<GoogleAccountId i:nil="false">ValueHere</GoogleAccountId>
<GoogleUserName i:nil="false">ValueHere</GoogleUserName>
<!--These fields are applicable if the derived type attribute is set to FileImportJob-->
<FileSource i:nil="false">ValueHere</FileSource>
<FileUrl i:nil="false">ValueHere</FileUrl>
</ImportJob>
</ImportJobs>
</AddImportJobsRequest>
</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>
<AddImportJobsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<ImportJobIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<a1:long>ValueHere</a1:long>
</ImportJobIds>
<PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
<Code>ValueHere</Code>
<Details d4p1:nil="false">ValueHere</Details>
<ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
<FieldPath d4p1:nil="false">ValueHere</FieldPath>
<ForwardCompatibilityMap xmlns:e48="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e48:KeyValuePairOfstringstring>
<e48:key d4p1:nil="false">ValueHere</e48:key>
<e48:value d4p1:nil="false">ValueHere</e48:value>
</e48:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Index>ValueHere</Index>
<Message d4p1:nil="false">ValueHere</Message>
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to EditorialError-->
<Appealable d4p1:nil="false">ValueHere</Appealable>
<DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
<Location d4p1:nil="false">ValueHere</Location>
<PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
<ReasonCode>ValueHere</ReasonCode>
</BatchError>
</PartialErrors>
</AddImportJobsResponse>
</s:Body>
</s:Envelope>
程式碼語法
範例語法可以與 Bing 廣告 SDK搭配使用。 如需更多範例,請參閱 Bing 廣告 API 程式碼范 例。
public async Task<AddImportJobsResponse> AddImportJobsAsync(
IList<ImportJob> importJobs)
{
var request = new AddImportJobsRequest
{
ImportJobs = importJobs
};
return (await CampaignManagementService.CallAsync((s, r) => s.AddImportJobsAsync(r), request));
}
static AddImportJobsResponse addImportJobs(
ArrayOfImportJob importJobs) throws RemoteException, Exception
{
AddImportJobsRequest request = new AddImportJobsRequest();
request.setImportJobs(importJobs);
return CampaignManagementService.getService().addImportJobs(request);
}
static function AddImportJobs(
$importJobs)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new AddImportJobsRequest();
$request->ImportJobs = $importJobs;
return $GLOBALS['CampaignManagementProxy']->GetService()->AddImportJobs($request);
}
response=campaignmanagement_service.AddImportJobs(
ImportJobs=ImportJobs)
需求
服務: CampaignManagementService.svc v13
命名 空間: https://bingads.microsoft.com/CampaignManagement/v13
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應