部分失敗

某些 AdWords 服務允許您請求執行有效操作，而對失敗的操作返回錯誤。此功能（稱為部分失敗）允許您在結束時單獨處理失敗的操作。

技術細節

要使用此功能，您需要設定此可選的 SOAP 標頭：

<partialFailure>true</partialFailure>

該服務將執行沒有錯誤的操作。它將返回成功操作的結果和失敗操作的錯誤。對於非 Mutate 操作，將忽略此標頭。

以下服務支援此功能：

• AdGroupAdService
• AdGroupBidModifierService
• AdGroupCriterionService
• AdGroupExtensionSettingService
• AdGroupService
• BudgetService
• CampaignCriterionService
• CampaignExtensionSettingService
• CampaignService
• CustomerExtensionSettingService
• FeedItemService
• OfflineConversionFeedService
• SharedSetService
  （從 201710 版開始提供）

• 對 BatchJobService 的所有請求一定在 partialFailure 標記設定為 true 的情況下執行。
• 在進行修改購物 ProductPartition 節點的 AdGroupCriterionService.mutate 呼叫時，只有在操作進行非結構性更改（例如，對現有節點進行出價更改）時，才能使用 partialFailure。如果您的操作是新增或移除節點，則不能使用 partialFailure。

使用方法

假設您需要在帳號中新增一組關鍵字。但是，某些關鍵字可能違反了編輯政策。您希望提交有效的關鍵字，但返回失敗的關鍵字及其錯誤。

建立服務

首先啟用 partialFailure 模式，如下所示：

建立操作並進行 API 呼叫

按照常規方式建立 mutate 操作並進行 API 呼叫。

處理成功的操作

成功的操作會返回服務的結果值。可以根據需要進行輸出：

處理失敗的操作

失敗的操作會在 partialFailureErrors 欄位返回錯誤資訊。您可以通過檢視 partialFailures 列表中 ApiError 物件的 fieldPathElements 屬性或 fieldPath 屬性找到失敗操作的索引。