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 minOccurs="0" name="CampaignTypes" nillable="true" type="q150:ArrayOfstring" xmlns:q150="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <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、CampaignTypes、CredentialId、GoogleAccountId、GoogleUserName。

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

创建导入作业时,会保存标识符,但不会验证标识符。 如果您添加了无效的广告系列或广告组 ID,或者它们变得无效(例如,这些实体后来从 Google Ads 中删除),则导入过程中将跳过无效的实体。

添加: 可选。 如果未设置此元素,则 Google Ads 帐号 中的所有广告系列和广告组都有资格导入。 导入的实体集还取决于 导入选项。
更新: 可选。 如果没有为更新设置任何值,则不会更改此设置。
CampaignAdGroupIds 数组
CampaignTypes 要包含在导入中的市场活动类型。 字符串 数组
CredentialId 授权 Google Ads 用户将帐号导入到 Microsoft Advertising。

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

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

添加: 必选
更新: 只读
string
GoogleAccountId 要导入的 Google Ads 帐号。

添加: 必选
更新: 只读
long
GoogleUserName Google 帐户,即有权访问 Google Ads 帐户的 Google 用户凭据。

添加: 只读
更新: 只读
string

GoogleImportJob 对象具有继承的元素。

继承的元素

从 ImportJob 继承的元素

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

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

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

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

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

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

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

添加: 可选
更新: 可选。 如果没有为更新设置任何值,则不会更改此设置。
Frequency
ID 导入作业的唯一 Microsoft Advertising 标识符。

添加: 只读
更新: 只读
long
ImportOption 可通过 API 使用的 Google 导入选项。

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

添加: 可选
更新: 可选。 如果没有为更新设置任何值,则不会更改此设置。
ImportOption
LastRunTimeInUTC 此作业最近的导入日期和时间。

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

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

名称的长度可介于 1 到 255 个字符之间。

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

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

添加: 可选
更新: 可选。 如果没有为更新设置任何值,则不会更改此设置。
string
NotificationType 确定是否要以及多久接收一次有关导入作业结果的电子邮件通知。

受支持的值为“无” (“无电子邮件) ”、“更改” (“仅当有更改或错误时) ”、“错误” (“仅当有错误时) ”和“每次” (每次此导入运行时都会) 。

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

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

添加: 只读
更新: 可选。 如果没有为更新设置任何值,则不会更改此设置。
string
类型 导入作业的类型。

如果检索 Google 导入作业,则此值为 GoogleImportJob 。

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

添加: 只读
更新: 只读
string

要求

服务: CampaignManagementService.svc v13
命名空间: https://bingads.microsoft.com/CampaignManagement/v13