通过

GoogleImportJob 数据对象 - 市场活动管理

  • 项目

定义可运行一次或定期计划的 Google 导入作业。

注意

  • 从 2023 年 2 月 1 日开始，你将无法再从 Google Ads 导入扩展文本广告。 可以重新导入之前导入的任何扩展文本广告，我们将继续导入状态更改， (例如暂停、取消暂停) Google Ads。
  • 详细了解此更改。

一个帐户最多可以有 100 个计划的 Google 导入作业。

提示

有关实现概述，请参阅 Google Ads 导入 技术指南。

语法

<xs:complexType name="GoogleImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ImportJob">
      <xs:sequence>
        <xs:element minOccurs="0" name="CampaignAdGroupIds" nillable="true" type="tns:ArrayOfCampaignAdGroupIds" />
        <xs:element name="CredentialId" nillable="true" type="xs:string" />
        <xs:element name="GoogleAccountId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="GoogleUserName" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

GoogleImportJob 对象具有以下元素：CampaignAdGroupIds、CredentialId、GoogleAccountId、GoogleUserName。

元素 说明 数据类型
CampaignAdGroupIds 要从 Google Ads 导入的市场活动及其广告组的列表。

创建导入作业时，会保存标识符，但不会验证这些标识符。 如果包含无效的市场活动或广告组 ID，或者它们变得无效（例如，以后将从 Google Ads 中删除实体），则导入期间将跳过无效实体。

加： 自选。 如果未设置此元素，则 Google Ads 帐户 中的所有市场活动和广告组都有资格导入。 导入的实体集还取决于 导入选项。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 CampaignAdGroupIds 数组
CredentialId 授权 Google Ads 用户将帐户导入Microsoft广告。

获取 GoogleImportJob 时，不会返回此元素。

有关更多详细信息，请参阅 获取导入凭据 ID 指南。

加： 必填
更新： 只读		 string
GoogleAccountId 要导入的 Google Ads 帐户。

加： 必填
更新： 只读		 long
GoogleUserName Google 帐户，即有权访问 Google Ads 帐户的 Google 用户凭据。

加： 只读
更新： 只读		 string

GoogleImportJob 对象具有 Inherited Elements。

继承的元素

从 ImportJob 继承的元素

GoogleImportJob 对象派生自 ImportJob 对象，并继承以下元素：CreatedByUserId、CreatedByUserName、CreatedDateTimeInUTC、Frequency、Id、ImportOption、LastRunTimeInUTC、Name、NotificationEmail、NotificationType、Status、Type。 以下说明特定于 GoogleImportJob，可能不适用于从 ImportJob 对象继承相同元素的其他对象。

元素 说明 数据类型
CreatedByUserId 创建导入作业的Microsoft广告用户的唯一标识符。

加： 只读
更新： 只读		 long
CreatedByUserName 创建导入作业的 Microsoft Advertising 用户的登录用户名。

加： 只读
更新： 只读		 string
CreatedDateTimeInUTC 创建导入作业的日期和时间。

日期和时间以协调世界时 (UTC) 表示。

加： 只读
更新： 只读		 dateTime
频率 确定导入作业应运行一次还是定期计划。

若要立即运行导入作业，此元素必须为 nil 或空。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 Frequency
ID 导入作业的唯一Microsoft广告标识符。

加： 只读
更新： 只读		 long
ImportOption 通过 API 提供的 Google 导入选项。

若要自定义 Google 导入选项，可以包含 GoogleImportOption 对象。 否则，若要使用默认的 Google 导入选项，可以将此元素保留为 null 或空。 有关默认选项的详细信息，请参阅 GoogleImportOption。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 ImportOption
LastRunTimeInUTC 此作业的最新导入日期和时间。

日期和时间以协调世界时 (UTC) 表示。

加： 只读
更新： 只读		 dateTime
名称 导入作业的名称。

名称的长度在 1 到 255 个字符之间。

加： 必填
更新： 只读		 string
NotificationEmail 应在其中发送导入结果的电子邮件地址。

默认情况下不返回此元素。 若要获取此元素，请在调用 GetImportJobsByIds 和 GetImportResults 服务操作时，在 ReturnAdditionalFields 元素中包含 NotificationEmail 值。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
NotificationType 确定是否以及想要接收有关导入作业结果电子邮件通知的频率。

支持的值为“None” (无电子邮件) ，“更改” (仅当) 有更改或错误时，“错误” (仅当) 错误时，“EveryTime” (每次运行此导入时) 。

加： 自选。 如果未设置，则服务默认将此元素设置为“None”。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
状态 导入作业的状态。

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

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

检索 Google 导入作业时，此值为 GoogleImportJob 。

有关导入作业类型的详细信息，请参阅 ImportJob 数据对象备注。

加： 只读
更新： 只读		 string

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13