定义可运行一次或定期计划的 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