通过

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 用户的唯一标识符。 long
CreatedByUserName 创建导入作业的 Microsoft Advertising 用户的登录用户名。 string
CreatedDateTimeInUTC 创建导入作业的日期和时间。

日期和时间以协调世界时 (UTC) 表示。		 dateTime
频率 确定导入作业应运行一次还是定期计划。

若要立即运行导入作业，此元素应为 nil 或空。		 Frequency
Id 导入作业的唯一 Microsoft Advertising 标识符。 long
ImportOption 通过 API 提供的导入选项。 ImportOption
LastRunTimeInUTC 此作业的最新导入日期和时间。

日期和时间以协调世界时 (UTC) 表示。		 dateTime
名称 导入作业的名称 string
NotificationEmail 应在其中发送导入结果的电子邮件地址。

默认情况下不返回此元素。 若要获取此元素，请在调用 GetImportJobsByIds 和 GetImportResults 服务操作时，在 ReturnAdditionalFields 元素中包含 NotificationEmail 值。		 string
NotificationType 确定是否以及想要接收有关导入作业结果电子邮件通知的频率。 string
状态 导入作业的状态。

可能的值为 Active、 Pause 和 Deleted。 计划的导入将具有 “活动” 状态，无论作业是计划一次还是将来定期进行。 暂停的导入作业将具有 “暂停” 状态。 导入后，仅运行一次的导入作业的状态将设置为 “已删除 ”。

添加： 只读
更新： 选。 如果未为更新设置任何值，则不会更改此设置。		 string
类型 导入作业的类型。

有关导入作业类型的详细信息，请参阅 备注。		 string

备注

如果手动生成 SOAP，请使用节点的 <ImportJob>type 属性（如以下示例中所示）指定导入计划的类型。

<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