本指南將詳細說明建立及更新最高成效廣告活動的請求結構。設計整合時，這份文件可做為實用資源。本指南說明如何處理變更最高成效廣告活動的請求，並可做為最高成效疑難排解指南和最高成效批次處理指南的輔助資源。
建立最高成效廣告活動
在 Google Ads API 中，最高成效廣告活動實體是由多個專屬資源組合而成。
標準最高成效廣告活動
標準最高成效廣告活動必須具備一定數量的資源，才能放送廣告。
如果廣告活動已啟用品牌宣傳指南，則建立 Campaign 的作業和必要 CampaignAsset 資源必須包含在單一要求中，且 CampaignAsset 資源必須符合素材資源規定門檻和規格。
請注意，建立 AssetGroup 和 AssetGroupAsset 實體的操作必須一併納入單一要求，且 AssetGroupAsset 資源必須合併，才能符合所有最低素材資源規定和規格；請參閱零售廣告活動的差異。如果建立 AssetGroup 的要求缺少所有必要 AssetGroupAsset 實體，就會導致錯誤；如需更多背景資訊，請參閱「無效狀態與無效要求」。
建立最高成效廣告活動時，您可以選擇不同的要求結構。如何將作業分組及建構要求，主要取決於您的目標和基礎架構。
- 請先在個別要求中建立
CampaignBudget、Campaign、Asset和CampaignAsset資源，再建立AssetGroup和AssetGroupAsset資源。(如果廣告活動已啟用品牌宣傳指南，則必須在單一要求中同時加入Campaign和必要CampaignAsset資源) - 在單一變動要求中加入所有這些資源。
雖然您可以在先前的個別要求中成功建立 CampaignBudget、Campaign、Asset 和 CampaignAsset 資源，但最高成效廣告活動必須建立 AssetGroup 和 AssetGroupAsset 資源，才能放送廣告。
放送中最高成效廣告活動的最低規定
您可以建立其他資源，進一步自訂最高成效廣告活動，如圖所示。
您可以在建立 AssetGroup 和 AssetGroupAsset 資源的同一個要求中，加入建立 AssetGroupSignal 資源的作業。或者，您也可以在建立 AssetGroup 後，在另一個要求中建立 AssetGroupSignal 實體。
最高成效廣告活動 (含其他選項)
零售業專用最高成效廣告活動
零售廣告活動的獨特之處在於，建立素材資源群組的方式有兩種，都能產生有效的放送廣告活動：
- 沒有任何素材資源的素材資源群組
- 包含所有必要素材資源的素材資源群組 (建議)
選擇從素材資源群組排除素材資源後，Google 會自動使用已連結 Merchant Center 帳戶中提供的素材資源來製作廣告。不過，我們建議您提供素材資源，以便在所有廣告空間中放送廣告。 如要放送零售最高成效廣告活動，必須提供下列最低資源組合。
CampaignBudgetCampaign(已填入ShoppingSettings)AssetGroupAssetGroupListingGroupFilter
請注意，Campaign.shopping_settings 欄位必須在零售廣告活動中填入資料。此外，每個 final_urls 中列出的 AssetGroup 必須與 Campaign.shopping_settings 中指定的 Merchant Center 帳戶 ID 相關聯的網址相符。最後，每個 AssetGroup 都「必須」有相關聯且有效的產品資訊群組樹狀結構，該結構由一或多個 AssetGroupListingGroupFilter 資源組成。你至少必須建立單一節點樹狀結構，才能納入指定 Merchant Center 動態饋給中的所有產品。
您可以分別建立這些資源，也可以在單一要求中建立。不過，廣告活動必須等到所有資源都正確建立後，才能放送。
放送中的零售最高成效廣告活動必須符合的最低規定
零售廣告活動可使用標準最高成效廣告活動的所有選項，包括建立素材資源群組信號、廣告活動轉換目標和廣告活動條件。如果您在建立 AssetGroup 資源時選擇將素材資源加入 AssetGroup，則 AssetGroup 必須符合最低素材資源規定。換句話說，您可以選擇不加入任何資產，或是加入所有必要資產。
零售業專用最高成效廣告活動 (含其他選項)
無效狀態與無效要求
在 Google Ads API 中使用最高成效廣告活動時，無效狀態和無效請求之間有重要差異。
- 州/省錯誤
- 廣告活動設定有誤，因此不符合放送資格。舉例來說，您可以建立具有
PERFORMANCE_MAXadvertising_channel_type的獨立Campaign資源。雖然建立廣告活動的要求成功，但您必須在廣告活動中至少新增一個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，後續要求必須符合所有資產規定，才能成功。換句話說，您無法逐步將素材資源新增至這些素材資源群組。