本指南將詳細說明建立及更新最高成效廣告活動時，如何建構複雜的要求。設計整合時，這份文件可做為實用資源。本指南說明如何處理變更最高成效廣告活動的請求，並可做為最高成效疑難排解指南和最高成效批次處理指南的輔助資源。
建立最高成效廣告活動
在 Google Ads API 中，最高成效廣告活動實體會以多個專屬資源的組合表示。
標準最高成效廣告活動
標準最高成效廣告活動必須具備最少數量的素材資源，才能放送廣告。
如果廣告活動已啟用品牌宣傳指南，則建立 Campaign 的作業和必要 CampaignAsset 資源必須包含在單一要求中，且 CampaignAsset 資源必須符合素材資源規定門檻和規格。
請注意，建立 AssetGroup 和 AssetGroupAsset 實體的作業必須一併納入單一要求，且 AssetGroupAsset 資源必須合併，才能符合所有最低素材資源規定和規格；請參閱零售廣告活動的差異。如果要求建立 AssetGroup，但未提供所有必要的 AssetGroupAsset 實體，就會發生錯誤。詳情請參閱「無效狀態與無效要求」。
建立最高成效廣告活動時，有多種要求結構選項。如何將作業分組及建構要求，主要取決於您的目標和基礎架構。
- 在建立
AssetGroup和AssetGroupAsset資源之前，請先在個別要求中建立CampaignBudget、Campaign、Asset和CampaignAsset資源。(如果廣告活動已啟用品牌宣傳指南，則必須在單一要求中同時加入Campaign和必要CampaignAsset資源) - 在單一變更要求中加入所有資源。
雖然您可以在先前的個別要求中成功建立 CampaignBudget、Campaign、Asset 和 CampaignAsset 資源，但最高成效廣告活動必須建立 AssetGroup 和 AssetGroupAsset 資源，才能放送廣告。
放送中最高成效廣告活動的最低規定
如要進一步自訂最高成效廣告活動，請按照圖表所示建立其他資源。
您可以在建立 AssetGroup 和 AssetGroupAsset 資源的同一個要求中，加入建立 AssetGroupSignal 資源的作業。或者，您也可以在建立 AssetGroup 後，透過個別要求建立 AssetGroupSignal 實體。
最高成效廣告活動 (含額外選項)
零售業專用最高成效廣告活動
零售廣告活動的獨特之處在於，建立素材資源群組的方式有兩種，且都能放送有效的廣告活動：
- 沒有任何素材資源的素材資源群組
- 包含「所有」必要素材資源的素材資源群組 (建議)
如果選擇從素材資源群組中排除素材資源，Google 會自動使用連結的 Merchant Center 帳戶中提供的素材資源來建立廣告。不過，我們建議您提供素材資源，以便在所有廣告空間中放送廣告。 零售業最高成效廣告活動至少需要下列資源，才能放送。
CampaignBudgetCampaign(已填入ShoppingSettings)AssetGroupAssetGroupListingGroupFilter
請務必注意，零售廣告活動必須填入 Campaign.shopping_settings 欄位。此外，每個 AssetGroup 中列出的 final_urls，必須與 Campaign.shopping_settings 中指定的 Merchant Center 帳戶 ID 相關聯的網址相符。最後，每個 AssetGroup 都必須有相關聯的有效產品商家資訊群組樹狀結構，由一或多個 AssetGroupListingGroupFilter 資源組成。您至少必須建立一個節點樹狀結構，才能涵蓋指定 Merchant Center 動態饋給中的所有產品。
您可以分別建立這些資源，也可以在單一要求中建立。不過，必須正確建立所有資源，廣告活動才能放送。
放送中的零售最高成效廣告活動必須符合的最低規定
零售廣告活動可使用標準最高成效廣告活動的所有選項，包括建立素材資源群組信號、廣告活動轉換目標和廣告活動條件。如果您在建立 AssetGroup 資源時選擇將廣告素材資源新增至 AssetGroup，則 AssetGroup 必須符合最低廣告素材資源規定。也就是說，您可以不加入任何素材資源，也可以加入所有必要素材資源。
零售業專用最高成效廣告活動 (含額外選項)
無效狀態與無效要求
在 Google Ads API 中使用最高成效廣告活動時，請務必區分無效狀態和無效要求。
- 州/省錯誤
- 廣告活動設定有誤，因此不符合放送資格。舉例來說，您可以建立獨立的
Campaign資源，並將advertising_channel_type設為PERFORMANCE_MAX。雖然廣告活動建立要求成功，但您必須在廣告活動中加入至少一個AssetGroup，才能放送廣告。如果要求成功，但廣告活動或素材資源群組未放送，您可以使用CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus和AssetGroupPrimaryStatusReason找出原因，詳情請參閱疑難排解指南。 - 無效的要求
- 要求會導致廣告活動或資源進入無效狀態，因此無法成功。舉例來說，如果您嘗試為非零售廣告活動建立
AssetGroup，但未納入最低必要素材資源，Google Ads API 就會擲回錯誤。因此，您必須在同一要求中包含AssetGroup及其AssetGroupAsset資源。這也表示所有AssetGroupAsset資源都必須符合特定field_type的正確規格，以免整個要求失敗。
使用變更要求將作業分組
最高成效廣告活動由多項資源組成，您可以選擇在不重複的要求中建立這些個別資源，也可以在單一大量變更要求中建立。不過，如前所述，標準最高成效廣告活動中的 AssetGroups 和相關聯的 AssetGroupAssets，必須在單一原子要求中建立。
您必須先成功建立本指南中提及的所有必要資源，廣告活動才能放送。發出個別要求時，請在後續要求中使用參照資源的實際資源名稱。發出包含多項作業的大量變更要求時，請使用臨時 ID 構成的資源名稱。
作業順序
無論是否使用大量變更要求建立最高成效廣告活動，都必須排序要求和作業，確保不會在資源建立前就參照該資源。如果是大量變更要求，則表示作業的排序方式應為：先列出參照的資源，再列出參照這些資源的資源。
如果您選擇在建立 AssetGroup 及其 AssetGroupAsset 資源的同一項大量變更要求中建立資產資源，則所有 AssetOperations 都應位於所有 AssetGroupAssetOperations 之前，如圖所示。
Google Ads 伺服器會將連續的 AssetGroupAssetOperations 批次處理，並在該群組的最後一項作業完成後，評估 AssetGroup 是否符合最低素材資源規定。如果您在要求中交替使用 AssetOperations 和 AssetGroupAssetOperations，API 伺服器會在第一個 AssetGroupAssetOperation 後評估最低素材資源需求，並傳回錯誤，不會繼續執行要求中的其餘作業。因此，要求中的所有素材資源都不會新增至您的 Google Ads 帳戶。此外，系統不會建立 AssetGroup 或任何相關聯的 AssetGroupAsset 資源。
更新素材資源群組
建立有效的 AssetGroup 後，您無法發出後續要求，導致素材資源不符合最低規定，而進入無效狀態。這類要求都會擲回錯誤。舉例來說，如果您建立的 AssetGroup 只有一個 MARKETING_IMAGE (最低要求)，任何移除與該 MARKETING_IMAGE 相關聯 AssetGroupAsset 的要求都會傳回錯誤。
如果零售廣告活動中的素材資源群組，在建立時沒有任何相關聯的素材資源，這點就特別重要。後續要求建立 AssetGroupAsset 資源，將廣告素材資源新增至 AssetGroup 時，只有在要求符合所有廣告素材資源規定時，才會成功。換句話說，您無法逐步將廣告素材資源新增至這些素材資源群組。