共用方式為

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 匯入的活動及其廣告群組清單。

當您建立匯入作業時，會儲存識別碼，但不會進行驗證。 如果您包含不正確行銷活動或廣告群組識別碼，或它們變成無效，例如，稍後會從 Google Ads 中刪除實體，則會在匯入期間略過不正確實體。

添加： 選。 如果未設定此元素，則 Google Ads 帳戶 中的所有行銷活動和廣告群組都有資格匯入。 匯入的實體集合也取決於您的 匯入選項。
更新： 選。 如果未設定更新的值，則此設定不會變更。		 CampaignAdGroupIds 數 組
CredentialId 授權 Google Ads 使用者將帳戶匯入 Microsoft Advertising。

當您取得 GoogleImportJob時，不會傳回此元素。

如需詳細資訊，請參閱 取得匯入認證標識 符指南。

添加： 必填
更新： 唯讀		 string
GoogleAccountId 要匯入的 Google Ads 帳戶。

添加： 必填
更新： 唯讀		 長
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 Advertising 使用者的唯一識別碼。

添加： 唯讀
更新： 唯讀		 長
CreatedByUserName 建立匯入作業之 Microsoft Advertising 使用者的登入使用者名稱。

添加： 唯讀
更新： 唯讀		 string
CreatedDateTimeInUTC 建立匯入作業的日期和時間。

日期和時間是以國際標準時間 (UTC) 表示。

添加： 唯讀
更新： 唯讀		 Datetime
頻率 判斷匯入作業應該定期執行一次或排程一次。

若要立即執行匯入作業，此元素必須是 nil 或空白。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。		 Frequency
識別碼 匯入作業的唯一 Microsoft Advertising 識別碼。

添加： 唯讀
更新： 唯讀		 長
ImportOption 可透過 API 取得的 Google 匯入選項。

若要自訂 Google 匯入選項，您可以包含 GoogleImportOption 物件。 否則，若要使用預設的 Google 匯入選項，您可以將此元素保留為 nil 或空白。 如需預設選項的詳細資訊，請參閱 GoogleImportOption。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。		 ImportOption
LastRunTimeInUTC 此作業的最新匯入日期和時間。

日期和時間是以國際標準時間 (UTC) 表示。

添加： 唯讀
更新： 唯讀		 Datetime
名稱 匯入作業的名稱。

名稱的長度可以介於 1 到 255 個字元之間。

添加： 必填
更新： 唯讀		 string
NotificationEmail 應傳送匯入結果的電子郵件地址。

預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetImportJobsByIds 和 GetImportResults 服務作業時，在 ReturnAdditionalFields 元素中包含 NotificationEmail 值。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。		 string
NotificationType 判斷您是否要接收有關匯入作業結果的電子郵件通知，以及其頻率。

支援的值為 「None」 ([沒有電子郵件) ]、[變更] (只有當) 有變更或錯誤時，[錯誤] (只有在) 發生錯誤時，以及 [每次] (每次執行此匯入時) 。

添加： 選。 如果未設定，服務預設會將此專案設定為 「None」。
更新： 選。 如果未設定更新的值，則此設定不會變更。		 string
狀態 匯入作業的狀態。

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

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

當您擷取 Google 匯入作業時，此值為 GoogleImportJob 。

如需匯入作業類型的詳細資訊，請參閱 ImportJob 資料物件備註。

添加： 唯讀
更新： 唯讀		 string

需求

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