共用方式為

ImportJob 資料物件 - 行銷活動管理

  • 發行項

定義匯入作業的基底物件。

注意事項

  • 在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。 在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。 如需詳細資訊，請 參閱關於回應式搜尋廣告。
  • 現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
  • 您仍然可以暫停、啟用或移除展開的文字廣告。
  • 深入瞭解這項變更。

請勿嘗試具現化 ImportJob。 您可以建立一或多個衍生自它的下列物件。

語法

<xs:complexType name="ImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CreatedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CreatedByUserName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CreatedDateTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Frequency" nillable="true" type="tns:Frequency" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ImportOption" nillable="true" type="tns:ImportOption" />
    <xs:element minOccurs="0" name="LastRunTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="NotificationEmail" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="NotificationType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

ImportJob物件具有下列元素：CreatedByUserId、CreatedByUserName、CreatedDateTimeInUTC、Frequency、Id、ImportOption、LastRunTimeInUTC、Name、NotificationEmail、NotificationType、Status、Type。

元素 說明 資料類型
CreatedByUserId 建立匯入作業之 Microsoft Advertising 使用者的唯一識別碼。 長
CreatedByUserName 建立匯入作業之 Microsoft Advertising 使用者的登入使用者名稱。 string
CreatedDateTimeInUTC 建立匯入作業的日期和時間。

日期和時間是以國際標準時間 (UTC) 表示。		 Datetime
頻率 判斷匯入作業應該定期執行一次或排程一次。

若要立即執行匯入作業，此元素應該是 nil 或空白。		 Frequency
識別碼 匯入作業的唯一 Microsoft Advertising 識別碼。 長
ImportOption 可透過 API 取得的匯入選項。 ImportOption
LastRunTimeInUTC 此作業的最新匯入日期和時間。

日期和時間是以國際標準時間 (UTC) 表示。		 Datetime
名稱 匯入作業的名稱 string
NotificationEmail 應傳送匯入結果的電子郵件地址。

預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetImportJobsByIds 和 GetImportResults 服務作業時，在 ReturnAdditionalFields 元素中包含 NotificationEmail 值。		 string
NotificationType 判斷您是否要接收有關匯入作業結果的電子郵件通知，以及其頻率。 string
狀態 匯入作業的狀態。

可能的值為 Active、 Pause 和 Deleted。 無論作業是排 程一次 ，還是未來會週期性排程，排程的匯入都會有作用中狀態。 暫停的匯入作業會有 暫停 狀態。 匯入之後，只會執行一次的匯入作業狀態會設定為 [刪除] 。

添加： 唯讀
更新： 選。 如果未設定更新的值，則此設定不會變更。		 string
類型 匯入作業的類型。

如需匯入作業類型的詳細資訊，請參閱。		 string

註解

如果您手動產生 SOAP，請使用節點的 <ImportJob>類型屬性，如下列範例所示，指定匯入排程的類型。

<ImportJob i:type="GoogleImportJob" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</ImportJob>

需求

服務： CampaignManagementService.svc v13
命名 空間： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AddImportJobs
GetImportJobsByIds
ImportResult
UpdateImportJobs